2023-08-14 20:16:02 +00:00
---
properties :
2024-01-03 20:35:24 +00:00
- name : add_host
description : |
Additional `host:ip` mapping.
type : list
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : auto_tag
description : |
Generate tag names automatically based on git branch and git tag.
2023-08-14 20:16:02 +00:00
2024-01-03 20:35:24 +00:00
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.
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : auto_tag_suffix
description : |
Generate tag names with the given suffix.
2023-08-14 20:16:02 +00:00
type : string
required : false
- name : bip
2024-01-03 20:35:24 +00:00
description : |
Allow the docker daemon to bride IP address.
2023-08-14 20:16:02 +00:00
type : string
required : false
2024-01-03 20:35:24 +00:00
- name : build_args
description : |
2024-11-15 20:54:41 +00:00
Custom build arguments for the build. Example :
```yaml
steps :
- name : Build
image : quay.io/thegeeklab/wp-docker-buildx
settings :
repo : example/repo
build_args :
FOO : bar
API_KEY :
from_secret : API_KEY
```
type : map
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : build_args_from_env
description : |
2024-11-15 20:54:41 +00:00
Forward environment variables to the build as build arguments. If the same key
already exists in `build_args`, it will not be overwritten. Example :
```yaml
steps :
- name : Build
image : quay.io/thegeeklab/wp-docker-buildx
environment :
CUSTOM_ENVIRONMENT : custom_value
settings :
repo : example/repo
build_args_from_env :
- CUSTOM_ENVIRONMENT
```
2023-08-14 20:16:02 +00:00
type : list
required : false
- name : buildkit_config
description : |
Content of the docker buildkit toml [config](https://github.com/moby/buildkit/blob/master/docs/buildkitd.toml.md). Example :
```yaml
steps :
- name : Build
2024-01-03 20:35:24 +00:00
image : quay.io/thegeeklab/wp-docker-buildx
2023-08-14 20:16:02 +00:00
settings :
repo : example/repo
buildkit_config : |
[ registry."registry.local:30081"]
http = true
insecure = true
```
type : string
required : false
2024-01-03 20:35:24 +00:00
- name : cache_from
2023-09-03 20:37:03 +00:00
description : |
2024-01-03 20:35:24 +00:00
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-09-03 20:37:03 +00:00
2024-01-03 20:35:24 +00:00
```yaml
steps :
- name : Build
image : quay.io/thegeeklab/wp-docker-buildx
settings :
repo : example/repo
cache_from :
# while using quotes, double-escaping is required
- "type=registry\\\\,ref=example"
- 'type=foo\\,ref=bar'
```
type : list
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : cache_to
description : |
[ Cache destination](https://docs.docker.com/engine/reference/commandline/buildx_build/#cache-to) for the build cache.
2023-08-14 20:16:02 +00:00
type : string
required : false
2024-01-03 20:35:24 +00:00
- name : compress
description : |
Enable compression of the build context using gzip.
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-11-13 22:32:40 +00:00
- name : registry_config
2024-01-03 20:35:24 +00:00
description : |
2024-11-13 22:32:40 +00:00
Content of the registry credentials store file.
2024-01-03 20:35:24 +00:00
type : string
2024-11-13 22:32:40 +00:00
defaultValue : $DOCKER_REGISTRY_CONFIG
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : containerfile
2023-08-14 20:16:02 +00:00
description : |
2024-01-03 20:35:24 +00:00
Containerfile to use for the image build.
type : string
2024-01-03 22:36:02 +00:00
defaultValue : "Containerfile"
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : context
description : |
Path of the build context.
2023-08-14 20:16:02 +00:00
type : string
2024-01-03 22:36:02 +00:00
defaultValue : "."
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : custom_dns
2023-08-14 20:16:02 +00:00
description : |
2024-01-03 20:35:24 +00:00
Custom docker daemon dns server.
2023-08-14 20:16:02 +00:00
type : list
required : false
2024-01-03 20:35:24 +00:00
- name : custom_dns_search
description : |
Custom docker daemon dns search domain.
2023-08-14 20:16:02 +00:00
type : list
required : false
2024-01-03 20:35:24 +00:00
- name : daemon_off
description : |
Disable the startup of the docker daemon.
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : debug
description : |
Enable verbose debug mode for the docker daemon.
2023-08-14 20:16:02 +00:00
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : dry_run
description : |
Disable docker push.
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : email
2023-08-14 20:16:02 +00:00
description : |
2024-01-03 20:35:24 +00:00
Email address for registry authentication.
type : string
2024-01-03 22:36:02 +00:00
defaultValue : $DOCKER_EMAIL
2024-01-03 20:35:24 +00:00
required : false
2023-08-14 20:16:02 +00:00
2024-01-03 20:35:24 +00:00
- name : experimental
description : |
Enable docker daemon experimental mode.
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : extra_tags
2023-08-14 20:16:02 +00:00
description : |
2024-01-03 20:35:24 +00:00
Additional tags to use for the image including registry.
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
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : insecure
description : |
Allow the docker daemon to use insecure registries.
2023-08-14 20:16:02 +00:00
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-05-05 11:17:34 +00:00
- name : insecure_skip_verify
description : |
Skip SSL verification.
type : bool
defaultValue : false
required : false
2024-01-03 20:35:24 +00:00
- name : ipv6
description : |
Enable docker daemon IPv6 support.
2023-08-14 20:16:02 +00:00
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : labels
2023-08-14 20:16:02 +00:00
description : |
2024-01-03 20:35:24 +00:00
Labels to add to image.
type : list
2023-08-14 20:16:02 +00:00
required : false
2024-05-05 11:17:34 +00:00
- name : log_level
description : |
Plugin log level.
type : string
defaultValue : "info"
required : false
2024-01-03 20:35:24 +00:00
- name : max_concurrent_uploads
2023-08-14 20:16:02 +00:00
description : |
2024-01-03 20:35:24 +00:00
Max concurrent uploads for each push.
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.
2023-08-14 20:16:02 +00:00
type : string
required : false
2024-01-03 20:35:24 +00:00
- name : mirror
description : |
Registry mirror to pull images.
2023-08-14 20:16:02 +00:00
type : string
2024-01-03 22:36:02 +00:00
defaultValue : $DOCKER_PLUGIN_MIRROR
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : mtu
description : |
Docker daemon custom MTU setting.
2023-08-14 20:16:02 +00:00
type : string
required : false
2024-01-03 20:35:24 +00:00
- name : named_context
description : |
Additional named [build contexts](https://docs.docker.com/engine/reference/commandline/buildx_build/#build-context) (format : `name=path`).
type : list
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : no_cache
description : |
Disable the usage of cached intermediate containers.
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- 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]`).
2023-08-14 20:16:02 +00:00
type : string
required : false
2024-01-03 20:35:24 +00:00
- name : password
description : |
Password for registry authentication.
2023-08-14 20:16:02 +00:00
type : string
2024-01-03 22:36:02 +00:00
defaultValue : $DOCKER_PASSWORD
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : platforms
description : |
Target platform for build.
2023-08-14 20:16:02 +00:00
type : list
required : false
2024-01-03 20:35:24 +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
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : pull_image
description : |
Enforce to pull base image at build time.
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : true
2023-08-14 20:16:02 +00:00
required : false
2024-01-03 20:35:24 +00:00
- name : quiet
description : |
Enable suppression of the build output.
type : bool
2024-01-03 22:36:02 +00:00
defaultValue : false
2024-01-03 20:35:24 +00:00
required : false
- name : registry
description : |
Docker registry to authenticate with.
type : string
2024-01-03 22:36:02 +00:00
defaultValue : "https://index.docker.io/v1/"
2024-01-03 20:35:24 +00:00
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.
2023-08-14 20:16:02 +00:00
type : string
required : false
- name : sbom
2024-01-03 20:35:24 +00:00
description : |
Generate [SBOM](https://docs.docker.com/build/attestations/sbom/) attestation for the build (shorthand for `--attest type=sbom`).
2023-08-14 20:16:02 +00:00
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.
```yaml
steps :
- name : Build
2024-01-03 20:35:24 +00:00
image : quay.io/thegeeklab/wp-docker-buildx
2023-08-14 20:16:02 +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:10:30 +00:00
To use secrets from files a [host volume](https://woodpecker-ci.org/docs/usage/volumes) is required.
2023-08-14 20:16:02 +00:00
This should be used with caution and avoided whenever possible.
type : list
required : false
2024-01-03 20:35:24 +00:00
- name : storage_driver
description : |
Docker daemon storage driver.
type : string
required : false
- name : storage_path
description : |
Docker daemon storage path.
type : string
2024-01-03 22:36:02 +00:00
defaultValue : "/var/lib/docker"
2024-01-03 20:35:24 +00:00
required : false
- name : tags
description : |
Repository tags to use for the image.
Tags can also be loaded from a `.tags` file.
type : list
required : false
- name : target
description : |
Build target to use.
type : string
required : false
- name : username
description : |
Username for registry authentication.
type : string
2024-01-03 22:36:02 +00:00
defaultValue : $DOCKER_USERNAME
2024-01-03 20:35:24 +00:00
required : false