YAML for Build Docker Image

View as Markdown

Build Docker image using a Dockerfile.

YAML parameters for Build Docker Image

PARAMETERS

dockerfile_pathrequiredstring

The path to the Dockerfile.

typerequiredstring

Value: DOCKERFILE

actionrequiredstring

Unique identifier for the action within the pipeline.

integrationstring

Integration identifier for cloud provider authentication.

context_pathstring

The path to the Docker build context.

provenancestring enum

The provenance attestation mode for the build.

Allowed enum:

NONE,

MIN,

MAX

build_argsstring[]

The list of build arguments to pass to the Docker build.

secretsDockerSecretYaml[]

The list of secrets to pass to the Docker build.

repositorystring

The Docker repository name.

pullboolean

If set to false, do not pull the base image before building.

cache_modestring enum

The cache mode for the Docker build.

Allowed enum:

MIN,

MAX

regionstring

Cloud region for the build (when using cloud integrations).

docker_image_tagstring

The tag of the Docker image.

docker_registrystring enum

The type of registry from which the image is retrieved.

Allowed enum:

NONE,

DOCKER_HUB,

AMAZON_ECR,

GOOGLE_GCR,

GOOGLE_ARTIFACT_REGISTRY,

OTHER,

GIT_HUB_CONTAINER_REGISTRY,

ARTIFACT_REGISTRY,

DIGITAL_OCEAN_CONTAINER_REGISTRY

artifactstring

The identifier of the artifact from artifact registry.

registrystring

The URL of the Docker registry.

insecure_registryboolean

If set to true, the registry will be accessed over HTTP instead of HTTPS.

target_stagestring

The target stage of the Dockerfile.

do_not_prune_imagesboolean

If set to true, images will not be pruned after the build.

loginstring

The username for the Docker registry.

passwordstring

The password for the Docker registry.

trigger_timestring enum

Specifies when the action should be executed.

Allowed enum:

ON_EVERY_EXECUTION,

ON_SUCCESS,

ON_FAILURE,

ON_BACK_TO_SUCCESS,

ON_WARNING,

ON_WAIT_FOR_APPROVE,

ON_TERMINATE

loopstring[]

The list of variables for dynamic action execution. The action runs once for each value.

run_only_on_first_failureboolean

Defines whether the action should be executed on each failure. Restricted to and required if the trigger_time is ON_FAILURE.

disabledboolean

When set to true the action is disabled. By default it is set to false.

timeoutinteger

The timeout in seconds.

ignore_errorsboolean

If set to true the execution will proceed, mark action as a warning and jump to the next action. Doesn't apply to deployment actions.

retry_intervalinteger

Delay time between auto retries in seconds.

retry_countinteger

Number of retries if the action fails.

run_nextstring enum

Defines whether the action should run in parallel with the next one.

Allowed enum:

WAIT_ON_SUCCESS,

IN_SOFT_PARALLEL,

IN_HARD_PARALLEL

trigger_conditionsTriggerConditionYaml[]

The list of trigger conditions to meet so that the action can be triggered.

variablesVariableYaml[]

The list of variables you can use in the action.

Last modified on Jul 31, 2025

Build Android App Build multi-arch image

YAML examples for Build Docker Image

Build Docker image from Dockerfile

yaml
  - action: "Build Docker image"
    type: "DOCKERFILE"
    dockerfile_path: "Dockerfile"
    context_path: "."
    repository: "my-app"
    docker_image_tag: "$BUDDY_EXECUTION_REVISION"
    docker_registry: "AMAZON_ECR"
    region: "us-east-1"
    build_args:
      - "NODE_ENV=production"
      - "APP_VERSION=$BUDDY_EXECUTION_REVISION"
    target_stage: "production"
    cache_mode: "MAX"
    pull: true
    integration: "my_aws_integration"

Simple Dockerfile build

yaml
  - action: "Build Dockerfile"
    type: "DOCKERFILE"
    dockerfile_path: "Dockerfile"
    repository: "my-repo"