--- title: Charmhub | Deploy Github runner image builder using Charmhub - The Open Operator Collection description: Deploy the latest version of Github runner image builder on any cloud. url: https://charmhub.io/github-runner-image-builder/docs/changelog --- # Github runner image builder [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps") * [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps") Platform: 22.04 stable 155 ``` juju deploy github-runner-image-builder ``` [Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications) --- #### Relevant links * [Homepage](https://charmhub.io/github-runner-image-builder) --- #### Contacts ##### Maintainers + [https://github.com/orgs/canonical/teams/is-charms](mailto:https://github.com/orgs/canonical/teams/is-charms) * [Submit a bug](https://github.com/canonical/github-runner-image-builder-operator/issues) --- Share your thoughts on this charm with the community on discourse. [Join the discussion](https://discourse.charmhub.io/) ## [#172 feat: apt upgrade](https://github.com/canonical/github-runner-image-builder-operator/pull/172) (2025-11-26) * Apply apt-update and apt-upgrade to GH runner images by applying them during cloud-init. ## [#165 fix: raise on image download/SHASUM download failure](https://github.com/canonical/github-runner-image-builder-operator/pull/165) (2025-11-18) * Catch image/SHASUM download failure early to handle error early in the pipeline. * Unpin ARM64 base image and use latest. ## [#160 fix: run install YQ in bare cloud-init environment](https://github.com/canonical/github-runner-image-builder-operator/pull/160) (2025-10-15) > Fix `install_yq` function silently failing. ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * Fix `install_yq` function running within another bash shell, causing any errors to go undetected. ## [#155 feat: add packages to build crypto lib from source](https://github.com/canonical/github-runner-image-builder-operator/pull/155) (2025-09-29) > Add packages to build crypto lib from source. ### [New features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * Includes `cargo`, `rustc` and `pkg-config` apt packages which allows building `cryptography` library from source. ## [#150 Add proxy configuration to snap install during building image](https://github.com/canonical/github-runner-image-builder-operator/pull/150) (2025-09-12) ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * The proxy configuration was not set for the snap install of aproxy during image building, causing the image building to fail if snapstore need to be accessed through a proxy. This is fixed. ## [#144 feat(docs): Evolve and standardize the documentation workflow](https://github.com/canonical/github-runner-image-builder-operator/pull/144) (2025-08-22) * Update documentation workflows to inject local word list and check links. ## [#140 chore: use Canonical built runner binaries](https://github.com/canonical/github-runner-image-builder-operator/pull/140)(2025-08-18) > Use Canonical built runner binaries for all architectures. ## [#142 Use release from 2025-07-25 for Noble ARM64](https://github.com/canonical/github-runner-image-builder-operator/pull/142) (2025-08-15) > Use release from 2025-07-25 for Noble ARM64 base image. ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * Pin Noble ARM64 base image to release from 2025-07-25 due to issues with the latest image. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Deployments that are currently effected, need to be redeployed. Other deployments do not require redeployment. ## [#123 feat: enable logrotate](https://github.com/canonical/github-runner-image-builder-operator/pull/123)(2025-06-06) > Enable log rotation on the GitHub runner image builder application. ## [#121 reuse image id on relation changed](https://github.com/canonical/github-runner-image-builder-operator/pull/121)(2025-05-28) > Reuse the already existing image in an cloud and instead of rebuilding on image relation changed. ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * Image build propagation to newly joined units should be faster as they are not rebuilt. ## [#113 fix: skip run if relation data is not ready](https://github.com/canonical/github-runner-image-builder-operator/pull/113)(2025-04-29) > Fix: Skip image build run if relation data is not ready ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * Fixed unnecessary image build runs where unit relation data was not ready. ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * Image build propagation to newly joined units should be faster. ## [#101 feat: ppc64le images](https://github.com/canonical/github-runner-image-builder-operator/pull/101) (2025-04-02) > Add support for building ppc64le images. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Nothing in particular to consider. If PPC64LE architecture is desired, the config option `ppc64le` or `ppc64el` has to be specified. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * None ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * The charm is now able to build images for the `ppc64le` (`ppc64el`) architecture. `ppc64le` is not officially supported by GitHub, but a fork of the actions runner binary has been created, which is used in the image. Note that ppc64le support is experimental and may be removed in the future. ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * None ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ## [#91 Feature: Add focal support](https://github.com/canonical/github-runner-image-builder-operator/pull/91) (2025-03-07) > Add support for building focal images. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Nothing in particular to consider. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * None ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * Add focal as a option for base image. To build focal images specify “focal” as the `base-image` in charm configuration. Note, the focal image does not have yarn pre-installed. ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * None ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ## [#83 feat: s390x images](https://github.com/canonical/github-runner-image-builder-operator/pull/83) (2025-03-06) > Add support for building s390x images. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * The architecture option has to be specified. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * The charm expects the architecture to be specified in the configuration. ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * The charm is now able to build images for the `s390x` architecture. `s390x` is not officially supported by GitHub, but a fork of the actions runner binary has been created, which is used in the image. Note that s390x support is experimental and may be removed in the future. ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * None ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ## [#88 Fix: move external script secret out of cloud-init](https://github.com/canonical/github-runner-image-builder-operator/pull/88) (2025-03-04) > Move running the external script out of cloud-init and use SSH instead. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Nothing in particular to consider. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * None ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * None ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * cloud-init user data is preserved in the image and should not contain traces of the external script and secrets. ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ## [#85 fix: Periodic rebuilding of images](https://github.com/canonical/github-runner-image-builder-operator/pull/85) (2025-02-24) > Fix the periodic rebuilding of images. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Nothing in particular to consider. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * None ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * None ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * Periodic image building using a cron job was not working. * The upgrade charm hook did not re-initialize the builder, making the builder not work after an upgrade from revision 51. ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ## [#82 Remove Juju & MicroK8s](https://github.com/canonical/github-runner-image-builder-operator/pull/82) (2025-02-14) > Drop Juju and MicroK8s preinstallation. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Nothing in particular to consider. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * The charm no longer supports pre-installing different Juju and MicroK8s versions in the image. The configuration options `dockerhub-cache`, `juju-channels` and `microk8s-channels` have been removed. ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * None ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * None ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ## [#79 Drop chroot mode](https://github.com/canonical/github-runner-image-builder-operator/pull/79) (2025-02-12) > Drop local image building (chroot) from the charm. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * The `experimental-build-*` config options have been removed and replaced by `build-flavor`, `build-network`. Please specify those options when upgrading the charm. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * The charm no longer supports local building inside the charm unit using chroot. ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * None ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * Fixed a bug where the application log level was not set correctly (due to lower case). ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * Increased OpenStack server timeouts to 20 minutes in the application to allow for longer build/delete times. ## [#81 Drop arm charm support](https://github.com/canonical/github-runner-image-builder-operator/pull/81) (2025-02-07) > Drop ARM support from the charm. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Nothing in particular to consider. Upgrading works for amd64 only. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * No longer supports the `arm64` architecture for the charm (note that building ARM images is still supported, the charm is agnostic about the build architecture as this is done in an external VM). ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * None ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * None ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ## [#65 chore: Include application repo](https://github.com/canonical/github-runner-image-builder-operator/pull/65) (2025-02-06) > Include application repository in the charm repository. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Requires no redeployment (since previous revision). Upgrades from revisions only supporting the chroot mode require redeployment. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * No longer supports the `app-channel` configuration option. ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * None ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * Fixed a bug where the base image name was hard-coded leading to issues when multiple builders build images concurrently using the same build tenant. ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ## [#27 feat: external cloud](https://github.com/canonical/github-runner-image-builder-operator/pull/27) (2024-09-13) > Builds GitHub runner images on OpenStack VMs. ### [Upgrade Steps](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-upgrade-steps) * Requires enough capacity on the OpenStack project cloud to launch builder VMs. * Requires GitHub Runner revision 249 and above. ### [Breaking Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-breaking-changes) * None ### [New Features](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-new-features) * None ### [Bug Fixes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-bug-fixes) * None ### [Performance Improvements](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-performance-improvements) * None ### [Other Changes](https://charmhub.io/github-runner-image-builder/docs/changelog#p-37071-other-changes) * None ---