Docker Push

Docker Push
Certified
Push Docker images to a registry

Pushes existing local images by tag to a remote registry using the available Docker daemon and optional registry credentials. Tags must already exist locally.

yaml
type: io.kestra.plugin.docker.Push

Examples

Push a previously built image to DockerHub

yaml
id: docker_push
namespace: company.team

tasks:
  - id: push
    type: io.kestra.plugin.docker.Push
    tags:
      - image/demo:latest
    credentials:
      registry: https://index.docker.io/v1/
      username: "{{ secret('DOCKERHUB_USERNAME') }}"
      password: "{{ secret('DOCKERHUB_PASSWORD') }}"

Push the image from a previous Build task

yaml
id: docker_push_with_tag
namespace: company.team

tasks:
  - id: build
    type: io.kestra.plugin.docker.Build
    dockerfile: |
      FROM alpine
      RUN echo "hello"
    tags:
      - my-registry.example.com/my-app:latest

  - id: push
    type: io.kestra.plugin.docker.Push
    tags:
      - my-registry.example.com/my-app:latest
    credentials:
      registry: my-registry.example.com
      username: "{{ secret('REGISTRY_USERNAME') }}"
      password: "{{ secret('REGISTRY_PASSWORD') }}"

Properties

tags *array

SubTypestring

Image tags to push

Provide one or more tags; use fully qualified references for custom registries.

config stringobject

Docker configuration file

Docker configuration file that can set access credentials to private container registries. Usually located in ~/.docker/config.json.

credentials

Credentials for a private container registry

Definitions

Credentials for a private container registry.

authstring

The registry authentication.

The auth field is a base64-encoded authentication string of username: password or a token.

identityTokenstring

The identity token.

passwordstring

The registry password.

registrystring

The registry URL.

If not defined, the registry will be extracted from the image name.

registryTokenstring

The registry token.

usernamestring

The registry username.

host string

The URI of your Docker host e.g. localhost

pluginDefaultsRef string

Reference (ref) of the pluginDefaults to apply to this task.

Core Plugins and tasks

Tasks that provide Kestra's built-in orchestration, I/O, and observability capabilities.

Core

NetBox

Enterprise

Enterprise NetBox tasks to create, update, and query devices, IP addresses, and sites over the NetBox API.

Infrastructure

Docker PushCertifiedPush Docker images to a registry

More Plugins in this Category

Core Plugins and tasks

NetBox

Docker Push
Certified
Push Docker images to a registry