Github runner image builder

Learn about configurations >

• app-channel | string

  Default: stable

  The application channel to deploy (i.e. stable, edge)

• architecture | string

  The image architecture to build for using external builder (i.e. amd64, arm64).

• base-image | string

  Default: noble

  The base ubuntu OS image to use for the runners. Codename (e.g. "noble") or version tag (e.g. 24.04) is supported as input. Currently only supports LTS versions of noble and higher, i.e. jammy, noble.

• build-interval | int

  Default: 6

  The interval in hours between each scheduled image builds.

• dockerhub-cache | string

  The DockerHub cache to use to enable cached image pull requests for initializing MicroK8s.

• experimental-external-build | boolean

  (Experimental) Whether to use external OpenStack builder VM to build a snapshot image.

• experimental-external-build-flavor | string

  (Experimental) The flavor to use when launching a builder VM machine. Will default to minimum matching flavor: 2 vCPU, 8G Memory, 20G Disk.

• experimental-external-build-network | string

  (Experimental) The network to launch the builder VM machine on. Will default to whatever network with accessible subnet is available.

• juju-channels | string

  The comma separated Juju versions to download in <track>/<risk> format. E.g. to create images with Juju version 2.9/stable and 3.1/edge, juju-channels="2.9/stable,3.1/edge".

• microk8s-channels | string

  The comma separated Microk8s versions to download in <track>/<risk> format. E.g. to create images with Microk8s version 1.31-strict/stable and 1.28/stable, microk8s-channels="1.31-strict/stable, 1.28/stable".

• openstack-auth-url | string

  The auth_url section of the clouds.yaml contents, used to authenticate the OpenStack
  client (e.g. http://my-openstack-deployment/openstack-keystone). See https://docs.
  openstack.org/python-openstackclient/queens/configuration/index.html for more information.

• openstack-password | string

  The password section of the clouds.yaml contents, used to authenticate the OpenStack
  client (e.g. myverysecurepassword). See https://docs.openstack.org/python-openstackclient/
  queens/configuration/index.html for more information.

• openstack-project-domain-name | string

  The project_domain_name section of the clouds.yaml contents, used to find the OpenStack project-domain to use to store images. See https://docs.openstack.org/python-
  openstackclient/queens/configuration/index.html for more information.

• openstack-project-name | string

  The project_name section of the clouds.yaml contents, used to find the OpenStack project to use to store images. See https://docs.openstack.org/python-openstackclient/queens/
  configuration/index.html for more information.

• openstack-user-domain-name | string

  The user_domain_name section of the clouds.yaml contents, used to find the OpenStack user domain to authenticate the client. See https://docs.openstack.org/python-
  openstackclient/queens/configuration/index.html for more information.

• openstack-user-name | string

  The username section of the clouds.yaml contents, used to find the OpenStack user to
  authenticate the client. See https://docs.openstack.org/python-openstackclient/queens/
  configuration/index.html for more information.

• revision-history-limit | int

  Default: 5

  Number of image revisions to keep before deletion.

• runner-version | string

  The GitHub runner version to use, e.g. 2.317.0. Empty default value will fetch the latest version by default. See https://github.com/actions/runner/releases.

• script-url | string

  URL to external script to run during cloud-init. Allows user-defined customization scripts to be run. This script is run as root, within the cloud-init user-data script.