30 lines
1.9 KiB
Markdown
30 lines
1.9 KiB
Markdown
# Installing ARC
|
|
|
|
> [!WARNING]
|
|
> This documentation covers the legacy mode of ARC (resources in the `actions.summerwind.net` namespace). If you're looking for documentation on the newer autoscaling runner scale sets, it is available in [GitHub Docs](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller). To understand why these resources are considered legacy (and the benefits of using the newer autoscaling runner scale sets), read [this discussion (#2775)](https://github.com/actions/actions-runner-controller/discussions/2775).
|
|
|
|
## Installation
|
|
|
|
By default, actions-runner-controller uses [cert-manager](https://cert-manager.io/docs/installation/kubernetes/) for certificate management of Admission Webhook. Make sure you have already installed cert-manager before you install. The installation instructions for the cert-manager can be found below.
|
|
|
|
- [Installing cert-manager on Kubernetes](https://cert-manager.io/docs/installation/kubernetes/)
|
|
|
|
After installing cert-manager, install the custom resource definitions and actions-runner-controller with `kubectl` or `helm`. This will create an actions-runner-system namespace in your Kubernetes and deploy the required resources.
|
|
|
|
**Kubectl Deployment:**
|
|
|
|
```shell
|
|
# REPLACE "v0.25.2" with the version you wish to deploy
|
|
kubectl create -f https://github.com/actions/actions-runner-controller/releases/download/v0.25.2/actions-runner-controller.yaml
|
|
```
|
|
|
|
**Helm Deployment:**
|
|
|
|
Configure your values.yaml, see the chart's [README](../charts/actions-runner-controller/README.md) for the values documentation
|
|
|
|
```shell
|
|
helm repo add actions-runner-controller https://actions-runner-controller.github.io/actions-runner-controller
|
|
helm upgrade --install --namespace actions-runner-system --create-namespace \
|
|
--wait actions-runner-controller actions-runner-controller/actions-runner-controller
|
|
```
|