diff --git a/README.md b/README.md index f9b90eb8dd..8a3711be65 100644 --- a/README.md +++ b/README.md @@ -11,21 +11,22 @@ Actions Runner Controller (ARC) is a Kubernetes operator that orchestrates and s With ARC, you can create runner scale sets that automatically scale based on the number of workflows running in your repository, organization, or enterprise. Because controlled runners can be ephemeral and based on containers, new runner instances can scale up or down rapidly and cleanly. For more information about autoscaling, see ["Autoscaling with self-hosted runners."](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/autoscaling-with-self-hosted-runners) You can set up ARC on Kubernetes using Helm, then create and run a workflow that uses runner scale sets. For more information about runner scale sets, see ["Deploying runner scale sets with Actions Runner Controller."](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller#runner-scale-set) + ## People Actions Runner Controller (ARC) is an open-source project currently developed and maintained in collaboration with the GitHub Actions team, external maintainers @mumoshu and @toast-gear, various [contributors](https://github.com/actions/actions-runner-controller/graphs/contributors), and the [awesome community](https://github.com/actions/actions-runner-controller/discussions). If you think the project is awesome and is adding value to your business, please consider directly sponsoring [community maintainers](https://github.com/sponsors/actions-runner-controller) and individual contributors via GitHub Sponsors. -In case you are already the employer of one of contributors, sponsoring via GitHub Sponsors might not be an option. Just support them in other means! +If you are already the employer of one of the contributors, sponsoring via GitHub Sponsors might not be an option. Just support them by other means! See [the sponsorship dashboard](https://github.com/sponsors/actions-runner-controller) for the former and the current sponsors. ## Getting Started -To give ARC a try with just a handful of commands, Please refer to the [Quickstart guide](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller). +To give ARC a try with just a handful of commands, please refer to the [Quickstart guide](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller). -For an overview of ARC, please refer to [About ARC](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller) +For an overview of ARC, please refer to [About ARC](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller). With the introduction of [autoscaling runner scale sets](https://github.com/actions/actions-runner-controller/discussions/2775), the existing [autoscaling modes](./docs/automatically-scaling-runners.md) are now legacy. The legacy modes have certain use cases and will continue to be maintained by the community only. @@ -37,7 +38,7 @@ ARC documentation is available on [docs.github.com](https://docs.github.com/en/a ### Legacy documentation -The following documentation is for the legacy autoscaling modes that continue to be maintained by the community +The following documentation is for the legacy autoscaling modes that continue to be maintained by the community: - [Quickstart guide](/docs/quickstart.md) - [About ARC](/docs/about-arc.md) diff --git a/contrib/README.md b/contrib/README.md index 4cd82399e4..3c8f94a782 100644 --- a/contrib/README.md +++ b/contrib/README.md @@ -1,6 +1,6 @@ The `contrib` directory is the place for sharing various example code for deploying and operating `actions-runner-controller`. -Anything contained in this directory is provided as-is. The maintainers of `actions-runner-controller` is not yet commited to provide -full support for using, fixing, and enhancing it. However, they will do their best effort to collect feedbacks from early adopters and advanced users like you, and may eventually consider graduating any of the examples as an official addition to the project. +Anything contained in this directory is provided as-is. The maintainers of `actions-runner-controller` are not yet committed to provide +full support for using, fixing, and enhancing it. However, they will make their best effort to collect feedback from early adopters and advanced users like you, and may eventually consider graduating any of the examples as an official addition to the project. See https://github.com/actions/actions-runner-controller/pull/1375#issuecomment-1258816470 and https://github.com/actions/actions-runner-controller/pull/1559#issuecomment-1258827496 for more context. diff --git a/contrib/examples/actions-runner/README.md b/contrib/examples/actions-runner/README.md index 1c8a352a2e..fb8020eb4c 100644 --- a/contrib/examples/actions-runner/README.md +++ b/contrib/examples/actions-runner/README.md @@ -8,29 +8,29 @@ All additional docs are kept in the `docs/` folder, this README is solely for do > _Default values are the defaults set in the charts values.yaml, some properties have default configurations in the code for when the property is omitted or invalid_ -| Key | Description | Default | -|----------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------| -| `labels` | Set labels to apply to all resources in the chart | | -| `replicaCount` | Set the number of runner pods | 1 | -| `image.repository` | The "repository/image" of the runner container | summerwind/actions-runner | -| `image.tag` | The tag of the runner container | | -| `image.pullPolicy` | The pull policy of the runner image | IfNotPresent | -| `imagePullSecrets` | Specifies the secret to be used when pulling the runner pod containers | | -| `fullnameOverride` | Override the full resource names | | -| `nameOverride` | Override the resource name prefix | | -| `podAnnotations` | Set annotations for the runner pod | | -| `podLabels` | Set labels for the runner pod | | -| `podSecurityContext` | Set the security context to runner pod | | -| `nodeSelector` | Set the pod nodeSelector | | -| `affinity` | Set the runner pod affinity rules | | -| `tolerations` | Set the runner pod tolerations | | -| `env` | Set environment variables for the runner container | | -| `organization` | Github organization where runner will be registered | test | -| `repository` | Github repository where runner will be registered | | -| `runnerLabels` | Labels you want to add in your runner | test | -| `autoscaler.enabled` | Enable the HorizontalRunnerAutoscaler, if its enabled then replica count will not be used | true | -| `autoscaler.minReplicas` | Minimum no of replicas | 1 | -| `autoscaler.maxReplicas` | Maximum no of replicas | 5 | -| `autoscaler.scaleDownDelaySecondsAfterScaleOut` | [Anti-Flapping Configuration](https://github.com/actions/actions-runner-controller/blob/master/docs/automatically-scaling-runners.md#anti-flapping-configuration) | 120 | -| `autoscaler.metrics` | [Pull driven scaling](https://github.com/actions/actions-runner-controller/blob/master/docs/automatically-scaling-runners.md#pull-driven-scaling) | default | -| `autoscaler.scaleUpTriggers` | [Webhook driven scaling](https://github.com/actions/actions-runner-controller/blob/master/docs/automatically-scaling-runners.md#webhook-driven-scaling) | | +| Key | Description | Default | +| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | +| `labels` | Set labels to apply to all resources in the chart | | +| `replicaCount` | Set the number of runner pods | 1 | +| `image.repository` | The "repository/image" of the runner container | summerwind/actions-runner | +| `image.tag` | The tag of the runner container | | +| `image.pullPolicy` | The pull policy of the runner image | IfNotPresent | +| `imagePullSecrets` | Specifies the secret to be used when pulling the runner pod containers | | +| `fullnameOverride` | Override the full resource names | | +| `nameOverride` | Override the resource name prefix | | +| `podAnnotations` | Set annotations for the runner pod | | +| `podLabels` | Set labels for the runner pod | | +| `podSecurityContext` | Set the security context to runner pod | | +| `nodeSelector` | Set the pod nodeSelector | | +| `affinity` | Set the runner pod affinity rules | | +| `tolerations` | Set the runner pod tolerations | | +| `env` | Set environment variables for the runner container | | +| `organization` | Github organization where the runner will be registered | test | +| `repository` | Github repository where the runner will be registered | | +| `runnerLabels` | Labels you want to add in your runner | test | +| `autoscaler.enabled` | Enable the HorizontalRunnerAutoscaler, if its enabled then replica count will not be used | true | +| `autoscaler.minReplicas` | Minimum no of replicas | 1 | +| `autoscaler.maxReplicas` | Maximum no of replicas | 5 | +| `autoscaler.scaleDownDelaySecondsAfterScaleOut` | [Anti-Flapping Configuration](https://github.com/actions/actions-runner-controller/blob/master/docs/automatically-scaling-runners.md#anti-flapping-configuration) | 120 | +| `autoscaler.metrics` | [Pull driven scaling](https://github.com/actions/actions-runner-controller/blob/master/docs/automatically-scaling-runners.md#pull-driven-scaling) | default | +| `autoscaler.scaleUpTriggers` | [Webhook driven scaling](https://github.com/actions/actions-runner-controller/blob/master/docs/automatically-scaling-runners.md#webhook-driven-scaling) | | diff --git a/docs/gha-runner-scale-set-controller/README.md b/docs/gha-runner-scale-set-controller/README.md index 3944dab4ce..abb57a98f4 100644 --- a/docs/gha-runner-scale-set-controller/README.md +++ b/docs/gha-runner-scale-set-controller/README.md @@ -31,7 +31,7 @@ In addition to the increased reliability of the automatic scaling, we have worke [![Watch the walkthrough](thumbnail.png)](https://youtu.be/wQ0k5k6KW5Y) -> Will take you to Youtube for a short walkthrough of the Autoscaling Runner Scale Sets mode. +> Will take you to YouTube for a short walkthrough of the Autoscaling Runner Scale Sets mode. ## Setup @@ -201,7 +201,7 @@ Please evaluate these changes carefully before upgrading. 1. Document customization for containerModes [#2777](https://github.com/actions/actions-runner-controller/pull/2777) 1. Bump github.com/cloudflare/circl from 1.1.0 to 1.3.3 [#2628](https://github.com/actions/actions-runner-controller/pull/2628) 1. chore(deps): bump github.com/stretchr/testify from 1.8.2 to 1.8.4 [#2716](https://github.com/actions/actions-runner-controller/pull/2716) -1. Move gha-* docs out of preview [#2779](https://github.com/actions/actions-runner-controller/pull/2779) +1. Move gha-\* docs out of preview [#2779](https://github.com/actions/actions-runner-controller/pull/2779) 1. Prepare 0.5.0 release [#2783](https://github.com/actions/actions-runner-controller/pull/2783) 1. Security fix [#2676](https://github.com/actions/actions-runner-controller/pull/2676) diff --git a/hack/signrel/README.md b/hack/signrel/README.md index b0cea38e75..896dccc395 100644 --- a/hack/signrel/README.md +++ b/hack/signrel/README.md @@ -1,14 +1,12 @@ # signrel -`signrel` is the utility command for downloading `actions-runner-controller` release assets, sigining those, and uploading the signature files. +`signrel` is a utility command that downloads `actions-runner-controller` release assets, signs them, and uploads the resulting signature files. ## Verifying Release Assets -For users, browse https://keys.openpgp.org/search?q=D8078411E3D8400B574EDB0441B69B728F095A87 and download the public key, or refer to [the instruction](https://keys.openpgp.org/about/usage#gnupg-retrieve) to import the key onto your machine. +To get started, browse to to download the public key, or refer to [the instructions](https://keys.openpgp.org/about/usage#gnupg-retrieve) to import the key onto your machine. -Next, you'll want to verify the signature of the download asset somehow. - -With `gpg`, you would usually do that by downloading both the asset and the signature files from our specific release page, and run `gpg --verify` like: +Next, verify the signature of the downloaded asset. Using `gpg`, you can do this by downloading both the asset and its signature from our release page, then running `gpg --verify` like so: ```console # Download the asset @@ -21,7 +19,7 @@ curl -LO https://github.com/actions/actions-runner-controller/releases/download/ gpg --verify actions-runner-controller.yaml{.asc,} ``` -On succesful verification, the gpg command would output: +On successful verification, the `gpg` command will output something similar to: ``` gpg: Signature made Tue 10 May 2022 04:15:32 AM UTC @@ -35,7 +33,7 @@ gpg: Good signature from "Yusuke Kuoka " [ultimate] ## Signing Release Assets -Assuming you are a maintainer of the project who has admin permission, run the command like the below to sign assets and upload the signature files: +If you are a maintainer of the project with admin permission, you can run the following commands to sign assets and upload the signature files: ```console $ cd hack/signrel @@ -60,8 +58,8 @@ Upload completed: *snip* actions-runner-controller-0.17.2.tgz.asc"} ``` -To retrieve all the available release tags, run: +To retrieve all available release tags, run: -``` +```console $ go run . tags | jq -r .[].tag_name ``` diff --git a/pkg/hookdeliveryforwarder/README.md b/pkg/hookdeliveryforwarder/README.md index 000dfce5ee..6d6e57b000 100644 --- a/pkg/hookdeliveryforwarder/README.md +++ b/pkg/hookdeliveryforwarder/README.md @@ -3,6 +3,6 @@ That being said, we are likely accept bug reports with concrete reproduction ste To use this, you need to write some Kubernetes manifest and a container image for deployment. -For other information, please see the original pull request introduced it. +For other information, please see the original pull request that introduced it. https://github.com/actions/actions-runner-controller/pull/682