An alphanumeric string (underscores are permitted) that identifies the step.
DockerBuild for this step type.
Description of usage
|Must specify an affinity group string that is the same as specified in a subsequent DockerPush step.||Optional|
Optionally, may also specify:
In addition, these tags can be defined to support the step's native operation:
Description of usage
|Directory containing the Dockerfile, which is the file that has Docker build configuration. This file is also used as the context for the Docker build. The path provided should be relative to the root of the input GitRepo repository. If no location is provided, the default is the root of the GitRepo repository.||Required|
|Name of the Dockerfile||Required|
|The name of the Docker image to create. This can be set using environment variables or triggering a run using parameters.||Required|
|The tag for the Docker image to create. This can be set using environment variables or triggering a run using parameters.||Required|
Additional options for the docker build command.
The following examples use a GoLang Git repository represented by a GitRepo resource named
gosvc_app to create a Docker image that is published to Artifactory. They assume that an Artifactory integration named
MyArtifactory has been created, and that the Artifactory instance has a Docker repository mapped to
The following resources declarations support these examples. Not all of these resources are used in all examples.
This example builds a Docker image to a Docker registry in Artifactory. The tag for the image is set to the pipeline's run number.
This example demonstrates use of the
dockerOptions tag to set the
build-arg option for the Docker command. An environment variable named
build_number_env_variable is dynamically set to the pipeline's run number. The example assumes the environment variable is used in the Dockerfile commands.
This example builds a Docker image that relies on a private base image stored in an Artifactory Docker repository.
This example demonstrates building a Docker image that includes files outside of the current path. It pulls icon files stored in an Artifactory repository for integration art named
my-local-repo. It is assumed that the Dockerfile has a command that will include the files in
/icons into the image.
For more samples, check out Pipelines Quickstart section