Build Docker Image with YAML

YAML parameters for building Docker images

NameTypeDescription
action RequiredStringThe ID of the action.
type RequiredStringThe type of the action. Should be set to DOCKERFILE.
dockerfile_path RequiredStringThe path of the desired dockerfile in the repository. Default is DOCKERFILE.
context_pathStringThe docker build image context path.
docker_image_tagStringThe tag of the Docker image.
loginStringThe username required to connect to the server. Required for delivering the Dockerfile to a private registry.
passwordStringThe password required to connect to the server. Required for delivering the Dockerfile to a private registry.
integrationStringThe ID of the integration. Available values: NONE, DOCKER_HUB, AMAZON_ECR, GOOGLE_GCR, GOOGLE_ARTIFACT_REGISTRY, GIT_HUB_CONTAINER_REGISTRY, OTHER.
regionStringThe name of the Amazon S3 region. Required for delivering the Dockerfile to the Amazon ECR. The full list of regions is available here.
registryStringThe url to GCR. Can be one of gcr.io, us.gcr.io, eu.gcr.io or asia.gcr.io. Required for Google GCR.
repositoryStringThe location of the Docker repository.
build_argsString[]The arguments used when building the image from the Dockerfile.
insecure_registryBooleanIf set to true, ignore SSL errors upon connecting to the Docker registry.
do_not_prune_imagesBooleanIf set to true, dangling images will not be pruned after the build.
buildkitBooleanThe Docker BuildKit will be activated while invoking the docker build command. By default, it is set to true.
secretsDockerBuildSecret[]The list of secrets to be sent using the --secret parameter.
provenanceStringRefers to the --provenance switch of the Docker build. Available values: NONE, MIN, MAX. The default value is NONE.
cache_mode BETAStringAvailable if the cache_scope in the pipeline where this action is located, is set to WORKSPACE or PROJECT. Defines the Docker cache mode. Available values are MIN or MAX. By default, it is set to MIN.
docker_registryStringThe type of registry you authorize to. Available values: NONE, DOCKER_HUB, AMAZON_ECR, GOOGLE_GCR, GOOGLE_ARTIFACT_REGISTRY, GIT_HUB_CONTAINER_REGISTRY, OTHER. It must be provided together with image_location. If not specified, the system will automatically set it based on other data from the action.

YAML example for building Docker images

yaml
actions: - action: "Build dockerfile" type: "DOCKERFILE" region: "us-east-1" integration: "my_integration" docker_image_tag: "14.06" dockerfile_path: "dir/Dockerfile" repository: "MyDockerRepo" build_args: - "key=value" insecure_registry: true do_not_prune_images: true secrets: - id: "someSecret" value: "path_to_secret" type: "FILE" - id: "mysecret" value: "MY_ENV_VAR_KEY" type: "ENV"

DockerBuildSecret Schema

Properties

NameTypeDescription
idStringThe identifier to pass into the docker buildx --secret. This identifier is associated with the RUN --mount identifier to use in the Dockerfile.
valueStringIf type=FILE, it is a path to the file in the filesystem. If type=ENV, it is the name of the variable whose value will be passed to the secret.
typeStringThe type of the secret. Set FILE if you want to use a file from the filesystem. If you want it to be a variable value, choose ENV.

Last modified on Oct 4, 2024