YAML for Kubernetes Set Image

View as Markdown

Update the image of a container in a Kubernetes deployment.

YAML parameters for Kubernetes Set Image

PARAMETERS

deploymentrequiredstring

The name of the deployment from the namespace.

containerrequiredstring

The name of the container.

image_namerequiredstring

The name of the image to set.

image_tagrequiredstring

The tag of the chosen image.

namespacerequiredstring

Kubernetes namespace to use.

typerequiredstring

Value: KUBERNETES_SET_IMAGE

actionrequiredstring

Unique identifier for the action within the pipeline.

record_argstring enum

Record current kubectl command in the resource annotation. If set to false, do not record the command. If set to true, record the command. If not set, default to updating the existing annotation value only if one already exists

Allowed enum:

TRUE,

FALSE,

NOT_SET

config_pathstring

Path to the Kubernetes manifest files.

kubectl_versionstring

Version of kubectl to use.

targetsobject[]

Target Kubernetes clusters for deployment.

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 Apr 27, 2026

Kubernetes Run Pod Lighthouse

YAML examples for Kubernetes Set Image

Set container image in deployment

yaml
  - action: "Set image"
    type: "KUBERNETES_SET_IMAGE"
    trigger_time: "ON_EVERY_EXECUTION"
    namespace: "default"
    deployment: "nginx-deployment"
    container: "nginx"
    image_name: "nginx"
    image_tag: "1.19.0"
    kubectl_version: "latest"
    record_arg: "NOT_SET"
    targets:
      - target: my_gke_cluster
        type: GKE
        name: My GKE Cluster
        integration: my_integration
        cluster: cluster-1
        project: tokyo-house-138923
        zone: europe-west1-c

Set image on self-managed cluster

yaml
  - action: "Update deployment image"
    type: "KUBERNETES_SET_IMAGE"
    namespace: "production"
    deployment: "web-app"
    container: "app"
    image_name: "myregistry/web-app"
    image_tag: "$BUDDY_EXECUTION_REVISION"
    kubectl_version: "v1.19.0"
    targets:
      - target: my_cluster
        type: K8S_CLUSTER
        name: My Kubernetes Cluster
        cluster: https://192.168.5.226:6443
        auth:
        method: TOKEN
        token: $KUBE_TOKEN

Set image on Amazon EKS cluster

yaml
  - action: "Set image"
    type: "KUBERNETES_SET_IMAGE"
    namespace: "default"
    deployment: "nginx-deployment"
    container: "nginx"
    image_name: "nginx"
    image_tag: "1.7.8"
    kubectl_version: "1.11.1"
    record_arg: "NOT_SET"
    targets:
      - target: my_eks_cluster
        type: EKS
        name: My EKS Cluster
        integration: my_integration
        cluster: cluster-1
        region: us-west-2
        role_arn: arn:aws:iam::344123456789:role/EKS_TESTS

Set image on Azure AKS cluster

yaml
  - action: "Set image"
    type: "KUBERNETES_SET_IMAGE"
    namespace: "default"
    deployment: "nginx-deployment"
    container: "nginx"
    image_name: "nginx"
    image_tag: "1.7.8"
    kubectl_version: "1.11.1"
    record_arg: "NOT_SET"
    targets:
      - target: my_aks_cluster
        type: AKS
        name: My AKS Cluster
        integration: my_integration
        cluster: buddy-tests
        subscription: d4fd0732-1b7f-47ff-8ca9-8b003428dcd8
        resource_group: test-buddy_group

Set image on DigitalOcean Kubernetes cluster

yaml
  - action: "Set image"
    type: "KUBERNETES_SET_IMAGE"
    namespace: "default"
    deployment: "nginx-deployment"
    container: "nginx"
    image_name: "nginx"
    image_tag: "1.7.8"
    kubectl_version: "1.11.1"
    record_arg: "NOT_SET"
    targets:
      - target: my_doks_cluster
        type: DOKS
        name: My DOKS Cluster
        integration: my_integration
        cluster: 0ec55079-0398-4cfc-9b51-97e07cb07ae7