blue-build/github-action
Inputs
recipe:
(required)
The recipe file to build the image from, relative to the config/
or recipes/
directory.
Default: recipe.yml
cosign_private_key:
(required)
The Sigstore/cosign secret used to sign the image.
Example: ${{ secrets.SIGNING_SECRET }}
registry_token:
(optional)
The token used to sign into the container registry.
Example: ${{ github.token }}
Default: “
registry_username:
(optional)
The username used to sign into the container registry.
Default: ${{ github.repository_owner }}
pr_event_number:
(required)
The event number used to tag images pushed from pull requests.
Example: ${{ github.event.number }}
maximize_build_space:
(optional)
Whether to run the unwanted software remover to maximize build space in the GitHub builder. Disable this with ‘false’ if your image doesn’t take up a lot of space and you’d rather have shorter build times.
Default: true
use_unstable_cli:
(optional)
If true, this action pulls the main
branch of blue-build/cli instead of the stable version the current action version is configured to use by default.
This feature is useful for testing new features, but should not be used in production.
Input must match the string ‘true’ for the unstable version to be used.
Default: false
cli_version:
(optional)
Set this with a tag, sha, or branch name for the blue-build/cli repo to use that particular version of the CLI tool. This will override the use_unstable_cli
input for the action.
registry:
(optional)
The container registry to push the built image to.
Default: ghcr.io
registry_namespace:
(optional)
The namespace on the registry to push to.
Example: ublue-os
Default: ${{ github.repository_owner }}
use_cache:
(optional)
Make use of docker buildx cache. This is an experimental feature of docker buildx so it isn’t guaranteed to work. Input must match the string ‘true’ for the step to be enabled.
Default: true
squash:
(optional)
Uses buildah to squash the build’s layers into a single layer. Use of this option disables cache. Conflicts with adding —build-driver or —squash to the build opts.
Default: false
build_opts:
(optional)
Provide options to the call to the BlueBuild CLI build command. If you use this with the squash input set to true and provide either of the —build-driver or —squash flags an error will occur and the action will not run.
Default:
working_directory:
(optional)
Changes working directory for whole build.
For example, setting this to ./abc/
would cause for the recipe to be read from ./abc/recipes/recipe.yml
.
Default: ./
skip_checkout:
(optional)
Set to true to skip doing the actions/checkout step. This allows you to checkout manually before calling bluebuild/github-action and to modify files (such as supplying build information to other scripts) before building.
Default: false