CAUTION: If you're using the Helm chart, beware to review changes to CRDs and do manually upgrade CRDs! Helm installs CRDs only on installing a chart. It doesn't automatically upgrade CRDs. Otherwise you end up with troubles like #427, #467, and #468. Please refer to the UPGRADING docs for the latest process.

This is a big release with lots of new features! (sorry if you're off the list, this release included a lot of changes so I've only mentioned the major stuff below, all changes are highly appreciated!)

This release includes the following major changes from the following contributors:

• Lots and lots of documentation improvements and fixes from lots of great people :D
• @rofafor added docker registry configuration option (#478)
• @mumoshu added scale from 0 runner count functionality (#465)
• @thejasn made the ephemerality configuration optional allowing for long lived static runners (#465)
• @mumoshu added scaling schedules (#513 #515 #524)
• @Carus11 bumped kube-proxy to 0.10.0 (#609)
• @mumoshu parameterised the github-api-cache-duration in the kustomize build and the Helm chart (#535)
• @mumoshu made the log level configurable (#541)
• @mumoshu @ToMe25 Fixes for the CI tests
• @mumoshu kubectl diff / dry-run support (#549)
• @js-timbirkett added STARTUP_DELAY option to runner entrypoint.sh (#592)
• @backjo added support for seLinuxOptions (#599)

CAUTION: If you're using the Helm chart, beware to review changes to CRDs and do manually upgrade CRDs! Helm installs CRDs only on installing a chart. It doesn't automatically upgrade CRDs. Otherwise you end up with troubles like #427, #467, and #468

This release includes the following changes from contributors. Thank you!

• @cbrand fixed the runner to properly get up and running when dockerdWithinRunnerContainer: false (#432)

CAUTION: If you're using the Helm chart, beware to review changes to CRDs and do manually upgrade CRDs! Helm installs CRDs only on installing a chart. It doesn't automatically upgrade CRDs. Otherwise you end up with troubles like #427, #467, and #468

This release includes the following changes from contributors. Thank you!

• @mumoshu fixed dindWithinRunnerContainer: true not to crash-loop runner pods (#419)
• @gabriel-dantas98 fixed some readme typos (#423)
• @mumoshu Fixed MTU configuration for dockerd (#421)
• @FloThinksPi added proper quoting of shell vars in runner's entrypoint.sh to prevent unwanted argument split (#420)
  • Runner group names and runner labels that contain spaces is now valid and should just work

CAUTION: If you're using the Helm chart, beware to review changes to CRDs and do manually upgrade CRDs! Helm installs CRDs only on installing a chart. It doesn't automatically upgrade CRDs. Otherwise you end up with troubles like #427, #467, and #468

This release includes the following changes from contributors. Thank you!

• Webhook-based autoscaling to go beyond GitHub API rate limit (#282, follow-ups #363, #381, #386, #390, #391, #395, #398, #404, $406, #407)
  • Documentation available at https://github.com/summerwind/actions-runner-controller#faster-autoscaling-with-github-webhook
  • Also thanks to @robwhitby for implementing the loadbalancer healthcheck endpoint (#378)
• @alex-mozejko has fixed the entrypoint script to gracefully handle self-updates (#284)
• TotalNumberOfQueuedAndInProgressWorkflowRuns has been fixed to support large-scale deployment (#295)
• actions-runner-controller is now able to automatically retry registration timeouts (#297, and #309 by @jonico)
• @jonico enhanced the controller to gracefully handle crashed nodes and stuck runner pods (#307)
• You can now add common runner labels per controller for e.g. easy "environment" labeling (#327)
• Runner registration check if now more reliable and has smaller chance of being rate limited by GitHub API (#405)
• @jonico fixed setting the runner group for enterprise runners (#376)
• actions-runner-controller is now able to restrict itself to a single namespace. This gives more chances to scale (#380, also #377 for related discussion and experience managing 100+ runners with actions-runer-controller)
• @tapih enhanced the controller support two or more RunnerDeployments in a namespace (#355, follow-up #386, #371)
• Rolling-update on RunnerDeployment has much smaller chance of disrupting progressing workflow jobs (#392)
• Various controller is now reliable- It has smaller chances of conflicts because it's updated to use Patch instead of Update whereas possible
• @int128 added metrics useful for observing the number of runners (#408)
• Runner controller is now part of our integration test suite. It should make subsequent releases more reliable (#409)
• Documentation has been greatly enhanced thanks to @callum-tait-pbx, and received various fixes from @mikeperry-kr, @ba32107, @robwhitby! (enhancements #303, #359 and #379, fixes #370, #373, #394, )
• Controller logs are now easier to read (#311 by @jonico, #410)
• actions-runner-controller is now listed in awesome-runners 🎉

This release includes the following changes from contributors. Thank you!

• @donovanmuller added support for additional environment variables (#271)
• @thrawny fixed the controller to actually use 'dockerdContainerResources' to set resources on the dind (#273)
• @clementlecorre fixed install installation method in the docs (#275)
• @donovanmuller fixed the Helm chart to have the up-to-date appVersion of 0.6.1 (#272)
• @donovanmuller updated the default and latest GitHub runner version (#280)
• @ap0phi5 added github.sha to DockerHub push for users who prefer immutable tags (#286)
• @zetaab added support for enterprise runners (#290)

Changelog

This release includes the following changes from numerous contributors. Thank you!

• @jonico improved our documentation and examples (#260, #261, #259)
• @callum-tait-pbx enhanced the Helm chart to support authSecret (#254)
• @jonico fixed the autoscaler to scale-down enough and not to scale-up too much (#267)
• @jolestar, @achedeuzot, @hfuss, and everyone involved in #252, #264, and #268 managed to fix the failure auto-upgrading runners to 2.276.0 (#253)

Changelog

This release includes the following changes from numerous contributors. Thank you!

• @reiniertimmer removed beta GitHub client implementations (#228)
• @ZacharyBenamramZachary Added "PercentageRunnersBusy" horizontal runner autoscaler metric type (#223, #235, #237)

Helm Chart:

• @callum-tait-pbx added config for dind sidecar (#232)
• @callum-tait-pbx added ability to add custom labels (#231)

Changelog

This release includes the following changes from numerous contributors. Thank you!

• @Hi-Fi fixed the unnecessary hourly restart(recreation) of runner pods (#227)
• @mumoshu added support for EKS IAM roles for service accounts (#226)
  • Documentation
• @mumoshu enhanced the default runner image to support ruby/setup-ruby (#224)

Changelog

This release includes the following changes from numerous contributors. Thank you!

• @Warashi secured connection between the runner agent and dockerd by enabling TLS (#192)
  • WARNING: You'll be required to update your actions workflow to create a docker context used by crazymax/ghaction-docker-buildx and docker/setup-buildx-action. See https://github.com/summerwind/actions-runner-controller/pull/192#issuecomment-739437432 for more information and the exact change you'll need on your workflow config files.
• @ZacharyBenamram made runner containers to restart faster and reduced GitHub API calls (#214)
• @ahmad-hamade enhanced the Helm chart for priorityClassName support (#215)
• @ap0phi5 updated our GitHub Actions workflow powering automated releases to use docker's official actions (#197)
• @erikkn upgraded go-github to v33 (#222)

Changelog

• Fix broken release workflow since v0.13.0

Changelog

• @Warashi added dockerEnabled to the doc (#193)
• @erikkn fixed the but that the dind container was missing /externals that is required for various actions like actions/checkout (#203)
• @reiniertimmer parametrized working directory, so that jobs work consistently across different runners (#185)

Changelog

• @Warashi enabled docker access without sudo, by changing the runner container to use TCP instead of docker.sock (#177)
• @Warashi added an ability to set dockerEnabled: false to disable the dind sidecar, so that you can run runner pod on clusters on where privileged pods are disallowed (#191)

Changelog

• @reiniertimmer Updated Runner to 2.274.1 (#176)
• @Hi-Fi Increase memory limit (#173)
• @reiniertimmer Enabled matrix build for runner image (#179)
• @emaincourt Added read-only permissions to actions for being able to autoscale (#180)
• @droidpl Improved the documentation for permissions and replication (#175)
• @callum-tait-pbx improved the documentation to add a "common errors" section and reordered the permissions section for clarity (#182)
• @mumoshu Added acceptance test (#168)
• @mumoshu Added the initial version of Helm chart (#187)
• @mumoshu Made Runner{Deployment,ReplicaSet} replicas actually optional (#186, #189)
• @callum-tait-pbx Enhanced the manifests to include --sync-period (#188)

Changelog

• Fix token registration broken since v0.11.0 (#167)

Changelog

• @reiniertimmer fix label argument in entrypoint (#162)

Changelog

• @Hi-Fi Check token validity only when creating new pod (#159)
• @mumoshu Fix panic on startup when misconfigured (#154)
• @Hi-Fi Add GHE URL to transport (#152)
• @damacus Adds RUNNER_GROUP argument to the runner registration (#157)
• Bump Go to 1.15 (#160)

Changelog

• Push latest controller image on master push (#147)
• Add support for non-public GitHub URL (#146)

Changelog

• Fix permission error with the default setup since v0.9.4 (#142)

Changelog

• Manifests valid for K8s 1.18 and 1.19 (#123)
• Inject Env Vars into Runner defined Container Spec (#127)
• Patch additional protocol instances during manifest generation (#129)
• Configurable "runner and DinD in a single container" (#126)
• Possibility to define resources for DIND container (#125)
• Restart if pod ends up succeeded (#136)

Changelog

• Fix release build (#122)