Add Runner Provisioner preview documentation#10311
Open
nathanfishcircleci wants to merge 25 commits intomainfrom
Open
Add Runner Provisioner preview documentation#10311nathanfishcircleci wants to merge 25 commits intomainfrom
nathanfishcircleci wants to merge 25 commits intomainfrom
Conversation
Adds a new page covering Runner Provisioner (preview v0.1.0), a Kubernetes controller that auto-scales CircleCI runner VMs via KubeVirt. Includes quick start, cluster setup for GKE/AKS/EKS, configuration reference, scaling behavior, observability, upgrading, troubleshooting, and limitations. Also updates the self-hosted runner overview to introduce Runner Provisioner alongside container and machine runners. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ooting Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…isioner docs Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…section Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
rosieyohannan
requested changes
May 6, 2026
|
|
||
| Runner Provisioner is available to invited preview participants only. To request access, fill out the link:https://forms.gle/7W8z12EBdjuiTQJWA[Runner Provisioner preview access request form]. | ||
|
|
||
| Once access is granted, you will receive credentials for the image registry referenced in the <<quick-start,Quick Start>>. |
Contributor
There was a problem hiding this comment.
Do you also get added to the Slack channel at this point, the one described in the next section?
|
|
||
| [#upgrading] | ||
| == Upgrading | ||
|
|
Contributor
There was a problem hiding this comment.
Can we give some context around when people should follow these upgrade instructions?
| * Metrics endpoint (Prometheus-compatible). | ||
| * Windows guest OS support for runner VMs (the cloud-init startup script is Linux-only). | ||
|
|
||
| If any of these are blocking your use case, post in the `#runner-provisioner-preview` Slack channel or reach out via the preview Slack channel. |
Contributor
There was a problem hiding this comment.
post in the
#runner-provisioner-previewSlack channel or reach out via the preview Slack channel
Aren't they the same thing?
Contributor
Author
There was a problem hiding this comment.
They are.
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
Contributor
marcospereira-circleci
left a comment
marcospereira-circleci
left a comment
There was a problem hiding this comment.
Minor suggestions
| [#runner-provisioner-use-case] | ||
| === Runner Provisioner (preview) | ||
|
|
||
| Runner Provisioner is a Kubernetes controller that automatically scales CircleCI runner VMs using KubeVirt. Rather than running jobs in containers, each job runs inside a full virtual machine that is provisioned on demand and shut down after the job completes. This approach provides stronger isolation than container runner and is suited for workloads that require a full OS environment, hardware-level isolation, or privileged access that is impractical inside a container. |
Contributor
There was a problem hiding this comment.
Suggested change
| Runner Provisioner is a Kubernetes controller that automatically scales CircleCI runner VMs using KubeVirt. Rather than running jobs in containers, each job runs inside a full virtual machine that is provisioned on demand and shut down after the job completes. This approach provides stronger isolation than container runner and is suited for workloads that require a full OS environment, hardware-level isolation, or privileged access that is impractical inside a container. | |
| Runner Provisioner is a Kubernetes controller that automatically scales CircleCI runner VMs using link:https://github.com/kubevirt/kubevirt[KubeVirt]. Rather than running jobs in containers, each job runs inside a full virtual machine that is provisioned on demand and shut down after the job completes. This approach provides stronger isolation than container runner and is suited for workloads that require a full OS environment, hardware-level isolation, or privileged access that is impractical inside a container. |
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
…adoc Co-authored-by: Rosie Yohannan <rosie@circleci.com>
Co-authored-by: Marcos Pereira <marcos.pereira@circleci.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new page covering Runner Provisioner (preview v0.1.0), a Kubernetes controller that auto-scales CircleCI runner VMs via KubeVirt. Includes quick start, cluster setup for GKE/AKS/EKS, configuration reference, scaling behavior, observability, upgrading, troubleshooting, and limitations. Also updates the self-hosted runner overview to introduce Runner Provisioner alongside container and machine runners.
Description
What did you change?
Reasons
Why did you make these changes? What problem does this solve?
Content checks
Please follow our style when contributing to CircleCI docs. View our style guide or check out our CONTRIBUTING.md for more information.
Preview your changes:
ci/circleci: lintjob at the bottom of your PR. You will be redirected to thevale/lintjob output in CircleCI.ci/circleci: buildjob at the bottom of your PR and you will be redirected to CircleCI. Select the Artifacts tab and selectindex.htmlto open a preview version of the docs site built for your latest commit.Take a moment to check through the following items when submitting your PR (this is just a guide so will not be relevant for all PRs):
Content structure:
Formatting: