When the event type is `push` and the target branch is your default branch, the plugin will automatically tag the image
as `latest`. All other event types and branches are ignored.
defaultValue:false
type:bool
required:false
- name:auto_tag_suffix
description:Generate tag names with the given suffix.
type:string
required:false
- name:extra_tags
description:|
Set additional tags to be used for the image. Additional tags can also be loaded from an `.extratags` file. This function can be used
to push images to multiple registries at once. Therefore, it is necessary to use the `config` flag to provide a configuration file
that contains the authentication information for all used registries.
type:list
required:false
- name:build_args
description:Custom build arguments to pass to the build.
type:list
required:false
- name:build_args_from_env
description:Forward environment variables as custom arguments to the build.
type:list
required:false
- name:quiet
description:Enable suppression of the build output.
defaultValue:false
type:bool
required:false
- name:target
description:The docker build target.
type:string
required:false
- name:cache_from
description:|
Images to consider as [cache sources](https://docs.docker.com/engine/reference/commandline/buildx_build/#cache-from). To properly work,
commas used in the cache source entries need to be escaped:
```yaml
steps:
- name:Build
image:thegeeklab/wp-docker-buildx:23
settings:
repo:example/repo
cache_from:
# while using quotes, double-escaping is required
- "type=registry\\\\,ref=example"
- 'type=foo\\,ref=bar'
```
type:list
required:false
- name:cache_to
description:|
[Cache destination](https://docs.docker.com/engine/reference/commandline/buildx_build/#cache-to) for the build cache.
type:string
required:false
- name:pull_image
description:Enforce to pull the base image at build time.
defaultValue:true
type:bool
required:false
- name:compress
description:Enable compression of the build context using gzip.
defaultValue:false
type:bool
required:false
- name:output
description:|
[Export action](https://docs.docker.com/engine/reference/commandline/buildx_build/#output) for the build result
(format:`path` or `type=TYPE[,KEY=VALUE]`).
defaultValue:false
type:bool
required:false
- name:repo
description:|
Repository name for the image. If the image is to be pushed to registries other than the default DockerHub,
it is necessary to set `repo` as fully-qualified name.
type:string
required:false
- name:registry
description:Docker registry to upload images.
defaultValue:https://index.docker.io/v1/
type:string
required:false
- name:username
description:Username for authentication with the registry.
type:string
required:false
- name:password
description:Password for authentication with the registry.
type:string
required:false
- name:email
description:E-Mail address for authentication with the registry.
type:string
required:false
- name:config
description:Content of the docker daemon json config.
type:string
required:false
- name:no_cache
description:Disable the usage of cached intermediate containers.
defaultValue:false
type:string
required:false
- name:add_host
description:Additional `host:ip` mapping.
type:list
required:false
- name:platforms
description:Target platforms for build.
type:list
required:false
- name:labels
description:Labels to add to the image.
type:list
required:false
- name:provenance
description:Generate [provenance](https://docs.docker.com/build/attestations/slsa-provenance/) attestation for the build (shorthand for `--attest=type=provenance`).
type:string
required:false
- name:sbom
description:Generate [sbom](https://docs.docker.com/build/attestations/sbom/) attestation for the build (shorthand for `--attest type=sbom`).
type:string
required:false
- name:secrets
description:|
Exposes [secrets](https://docs.docker.com/engine/reference/commandline/buildx_build/#secret) to the build.
The secrets can be used by the build using `RUN --mount=type=secret` mount.