briceburg/build-dockerfile

Cache aware building and publishing of Dockerfiles.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stalelast commit Dec 9, 2024
License
MIT

Pinned Snippet

workflow.ymlSHA-pinned
uses: briceburg/github-action-build-dockerfile@33f5dd08e8b687cd9c4b130db159d5ddc9eb34a3 # v0

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
build-argsNewline separated build arguments, e.g. "VERSION=foo\nAUTHOR=bar".
build-secretsNewline separated build secrets, e.g. "VERSION=foo\nAUTHOR=bar".
build-targetTarget stage to build
cache-branchesJSON array of branches which trigger publishing layers to gha cache. Use long lived branches. E.g. '["main", "master"]'. If empty, uses the default branch.["${{ github.event.repository.default_branch }}"]
contextDocker build context directory. Defaults to "Git context" so you don't need to use actions/checkout, but it will not pickup local changes. Point to a directory to pickup local changes from a checkout, e.g. '.' or './alt/docker/build/path'.{{defaultContext}}:.
dockerfile-pathDockerfile path (relative to build context).Dockerfile
image-labelsNewline list of Image Labels (in name=value format)
imagesNewline list of images (in registry/image-name:tag format)
platformstarget platforms to build image(s) for, e.g. 'linux/amd64,linux/arm64'.linux/amd64
pushThe string 'true' to push the built image to registry, otherwise the string 'false'.true
skip-summaryThe string 'true' to skip writing the job summary, otherwise the string 'false'.false
namedescription
image-digestImage Digest