| dockerfile | Path to the Dockerfile | — | Dockerfile |
| context | Docker build context | — | ${{ cloudbees.workspace }} |
| destination | Target image(s) that will be published to the registries configured in the file ${HOME}/.docker/config.json Type: CSV
| yes | — |
| tar-path | Full path, including filename, where the image tar file should be saved. | no | — |
| build-args | Docker build arguments. Type: CSV
| — | — |
| labels | Metadata to be associated with the resulting image. Type: CSV
| — | — |
| target | Build a specific target stage in a multi-stage Dockerfile. Type: string
| — | — |
| registry-mirrors | Registry mirror(s) to use for loading images. Type: CSV
| — | — |
| registry-configuration | CloudBees registry configuration file containing the registries to use for loading images. By default it uses the file containing the registries configured under 'Integrations' in the CloudBees platform.
| — | ${{ cloudbees.registries }} |
| skip-default-registry-fallback | If set, fails build if registry-mirrors cannot pull image. If registry-mirrors is empty, this flag is ignored. Type: Boolean
| — | false |
| verbosity | Log level verbosity - panic, fatal, error, warn, info, debug, trace
| — | info |
| commit | The commit ID from the source repository, used when registering the build artifact in CloudBees platform.
| — | ${{ cloudbees.scm.sha }} |
| repository-url | The clone URL of the source repository, used when registering the build artifact in CloudBees platform.
| — | ${{ cloudbees.scm.repositoryUrl }} |
| ref | The tag or branch of the source repository, used when registering the build artifact in CloudBees platform.
| — | ${{ cloudbees.scm.ref }} |
| artifact-name | The name of the build artifact as it will be registered. By default, the artifact name is derived from the image repository name.
| no | — |
| component-id | The ID of the component associated with the artifact. If not provided, the artifact is registered with the component of the current workflow run.
| no | ${{cloudbees.component.id}} |
| kaniko-dir | Path to the Kaniko working directory. If set, it is passed as --kaniko-dir to the executor and exported as KANIKO_DIR so Kaniko sees both the flag and the environment variable.
| no | — |