2022-06-02 19:48:53 +00:00
---
properties :
2022-11-24 12:55:22 +00:00
- name : dry_run
2022-06-02 19:48:53 +00:00
description : Disable docker push.
type : bool
required : false
2022-11-24 12:55:22 +00:00
- name : mirror
2022-06-02 19:48:53 +00:00
description : Use a registry mirror to pull images.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : storage_driver
2022-06-02 19:48:53 +00:00
description : The docker daemon storage driver.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : storage_path
2022-06-02 19:48:53 +00:00
description : The docker daemon storage path.
defaultValue : /var/lib/docker
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : bip
2022-06-02 19:48:53 +00:00
description : Allows the docker daemon to bride IP address.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : mtu
2022-06-02 19:48:53 +00:00
description : A docker daemon custom MTU.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : custom_dns
2022-06-02 19:48:53 +00:00
description : Custom docker daemon DNS server.
type : list
required : false
2022-11-24 12:55:22 +00:00
- name : custom_dns_search
2022-06-02 19:48:53 +00:00
description : Custom docker daemon DNS search domain.
type : list
required : false
2022-11-24 12:55:22 +00:00
- name : insecure
2022-06-02 19:48:53 +00:00
description : Enable the usage of insecure registries.
type : bool
defaultValue : false
required : false
2022-11-24 12:55:22 +00:00
- name : ipv6
2022-06-02 19:48:53 +00:00
description : Enable docker daemon IPv6 support.
type : bool
defaultValue : false
required : false
2022-11-24 12:55:22 +00:00
- name : experimental
2022-06-02 19:48:53 +00:00
description : Enable docker daemon experimental mode.
type : bool
defaultValue : false
required : false
2022-11-24 12:55:22 +00:00
- name : debug
2022-06-02 19:48:53 +00:00
description : Enable verbose debug mode for the docker daemon.
type : string
defaultValue : false
required : false
2022-11-24 12:55:22 +00:00
- name : daemon_off
2022-06-02 19:48:53 +00:00
description : Disable the startup of the docker daemon.
type : string
defaultValue : false
required : false
2022-11-24 12:55:22 +00:00
- name : buildkit_config
2023-01-08 13:41:49 +00:00
description : |
Content of the docker buildkit toml [config](https://github.com/moby/buildkit/blob/master/docs/buildkitd.toml.md). Example :
2023-06-29 19:30:58 +00:00
```yaml
steps :
- name : Build
2023-08-13 20:08:53 +00:00
image : thegeeklab/wp-docker-buildx:23
2023-06-29 19:30:58 +00:00
settings :
repo : example/repo
buildkit_config : |
[ registry."registry.local:30081"]
http = true
insecure = true
2023-01-08 13:41:49 +00:00
```
2022-06-02 19:48:53 +00:00
type : string
defaultValue : false
required : false
2023-09-03 20:33:59 +00:00
- name : max_concurrent_uploads
description : |
By default the Docker daemon will push five layers of an image at a time. If you are on a low bandwidth connection this may cause
timeout issues and you may want to lower with this option.
type : string
defaultValue : 5
required : false
2023-08-14 07:39:28 +00:00
- name : containerfile
description : Set the containerfile to use for the image build.
defaultValue : Containerfile
2022-06-02 19:48:53 +00:00
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : context
2022-06-02 19:48:53 +00:00
description : Set the path of the build context to use.
defaultValue : .
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : named_context
2022-07-24 10:48:02 +00:00
description : Set additional named [build contexts](https://docs.docker.com/engine/reference/commandline/buildx_build/#build-context) (e.g., name=path).
type : list
required : false
2022-11-24 12:55:22 +00:00
- name : tags
2022-06-02 19:48:53 +00:00
description : Set repository tags to use for the image. Tags can also be loaded from a `.tags` file.
defaultValue : latest
type : list
required : false
2022-11-24 12:55:22 +00:00
- name : auto_tag
2022-06-02 19:48:53 +00:00
description : |
Generate tag names automatically based on git branch and git tag. When this feature is enabled and the event type is `tag`,
the plugin will automatically tag the image using the standard semVer convention. For example :
- `1.0.0` produces docker tags `1`, `1.0`, `1.0.0`
- `1.0.0-rc.1` produces docker tags `1.0.0-rc.1`
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
2022-11-24 12:55:22 +00:00
- name : auto_tag_suffix
2022-06-02 19:48:53 +00:00
description : Generate tag names with the given suffix.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : extra_tags
2022-10-09 12:05:05 +00:00
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
2022-11-24 12:55:22 +00:00
- name : build_args
2023-06-13 12:39:46 +00:00
description : Custom build arguments to pass to the build.
2022-06-02 19:48:53 +00:00
type : list
required : false
2022-11-24 12:55:22 +00:00
- name : build_args_from_env
2022-06-02 19:48:53 +00:00
description : Forward environment variables as custom arguments to the build.
type : list
required : false
2022-11-24 12:55:22 +00:00
- name : quiet
2022-06-02 19:48:53 +00:00
description : Enable suppression of the build output.
defaultValue : false
type : bool
required : false
2022-11-24 12:55:22 +00:00
- name : target
2022-06-02 19:48:53 +00:00
description : The docker build target.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : cache_from
2022-11-01 20:49:13 +00:00
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 :
2023-06-29 19:30:58 +00:00
```yaml
steps :
- name : Build
2023-08-13 20:08:53 +00:00
image : thegeeklab/wp-docker-buildx:23
2023-06-29 19:30:58 +00:00
settings :
repo : example/repo
cache_from :
# while using quotes, double-escaping is required
- "type=registry\\\\,ref=example"
- 'type=foo\\,ref=bar'
2022-11-01 20:49:13 +00:00
```
2022-06-02 19:48:53 +00:00
type : list
required : false
2022-11-24 12:55:22 +00:00
- name : cache_to
2022-08-21 20:47:59 +00:00
description : |
[ Cache destination](https://docs.docker.com/engine/reference/commandline/buildx_build/#cache-to) for the build cache.
2022-08-08 11:36:23 +00:00
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : pull_image
2022-06-02 19:48:53 +00:00
description : Enforce to pull the base image at build time.
defaultValue : true
type : bool
required : false
2022-11-24 12:55:22 +00:00
- name : compress
2022-06-02 19:48:53 +00:00
description : Enable compression of the build context using gzip.
defaultValue : false
type : bool
required : false
2022-11-24 12:55:22 +00:00
- name : output
2022-06-02 19:48:53 +00:00
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
2022-11-24 12:55:22 +00:00
- name : repo
2022-12-21 08:54:17 +00:00
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.
2023-08-11 08:10:32 +00:00
type : string
2022-06-02 19:48:53 +00:00
required : false
2022-11-24 12:55:22 +00:00
- name : registry
2022-06-02 19:48:53 +00:00
description : Docker registry to upload images.
defaultValue : https://index.docker.io/v1/
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : username
2022-06-02 19:48:53 +00:00
description : Username for authentication with the registry.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : password
2022-06-02 19:48:53 +00:00
description : Password for authentication with the registry.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : email
2022-06-02 19:48:53 +00:00
description : E-Mail address for authentication with the registry.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : config
2022-06-02 19:48:53 +00:00
description : Content of the docker daemon json config.
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : no_cache
2022-06-02 19:48:53 +00:00
description : Disable the usage of cached intermediate containers.
defaultValue : false
type : string
required : false
2022-11-24 12:55:22 +00:00
- name : add_host
2022-06-02 19:48:53 +00:00
description : Additional `host:ip` mapping.
type : list
required : false
2022-11-24 12:55:22 +00:00
- name : platforms
2022-06-02 19:48:53 +00:00
description : Target platforms for build.
type : list
required : false
2022-09-20 19:35:29 +00:00
2022-11-24 12:55:22 +00:00
- name : labels
2022-09-20 19:35:29 +00:00
description : Labels to add to the image.
type : list
required : false
2023-01-12 10:28:22 +00:00
- 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
2023-03-08 14:51:24 +00:00
- 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
2023-06-28 18:26:07 +00:00
- name : secrets
2023-06-29 19:30:58 +00:00
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.
```yaml
steps :
- name : Build
2023-08-13 20:08:53 +00:00
image : thegeeklab/wp-docker-buildx:23
2023-06-29 19:30:58 +00:00
privileged : true
environment :
SECURE_TOKEN :
from_secret : secure_token
settings :
secrets :
# while using quotes, double-escaping is required
- "id=raw_file_secret\\\\,src=file.txt"
- 'id=other_raw_file_secret\\,src=other_file.txt'
- "id=SECRET_TOKEN"
```
2023-08-29 07:06:19 +00:00
To use secrets from files a [host volume](https://woodpecker-ci.org/docs/usage/volumes) is required.
2023-06-29 19:30:58 +00:00
This should be used with caution and avoided whenever possible.
2023-06-28 18:26:07 +00:00
type : list
required : false