PodCreate

Create a pod on a Kubernetes cluster, wait until the pod stops and collect its logs.

yaml
type: "io.kestra.plugin.kubernetes.PodCreate"

Launch a Pod

yaml
id: kubernetes_pod_create
namespace: company.team

tasks:
  - id: pod_create
    type: io.kestra.plugin.kubernetes.PodCreate
    namespace: default
    metadata:
      labels:
        my-label: my-value
    spec:
      containers:
      - name: unittest
        image: debian:stable-slim
        command:
          - 'bash'
          - '-c'
          - 'for i in {1..10}; do echo $i; sleep 0.1; done'
      restartPolicy: Never

Launch a Pod with input files and gather its output files.

yaml
id: kubernetes
namespace: company.team

inputs:
  - id: file
    type: FILE

tasks:
  - id: kubernetes
    type: io.kestra.plugin.kubernetes.PodCreate
    spec:
      containers:
      - name: unittest
        image: centos
        command:
          - cp
          - "{{workingDir}}/data.txt"
          - "{{workingDir}}/out.txt"
      restartPolicy: Never
    waitUntilRunning: PT3M
    inputFiles:
      data.txt: "{{inputs.file}}"
    outputFiles:
      - out.txt

Dynamic YES

Default true

Dynamic YES

Default default

The namespace where the pod will be created

Dynamic YES

Default true

Dynamic YES

The YAML spec of the pod.

Dynamic YES

Default PT1H

Format duration

The maximum duration to wait for the job completion.

Dynamic YES

Default PT10M

Format duration

The maximum duration to wait until the job and the pod is created.

This timeout is the maximum time that Kubernetes scheduler will take to

schedule the job
pull the pod image
and start the pod.

Dynamic NO

The connection parameters to the Kubernetes cluster

If no connection is defined, we try to load the connection from the current context in the following order:

System properties
Environment variables
Kube config file
Service account token and a mounted CA certificate.

You can pass a full configuration with all options if needed.

Dynamic NO

Default { "image": "busybox" }

The configuration of the file sidecar container that handle download and upload of files.

SubType string

Dynamic YES

The files to create on the local filesystem. It can be a map or a JSON object.

The files will be available inside the kestra/working-dir directory of the container. You can use the special variable {{workingDir}} in your command to refer to it.

Dynamic YES

The YAML metadata of the pod.

SubType string

Dynamic YES

The files from the container filesystem to send to Kestra's internal storage.

Only files created inside the kestra/working-dir directory of the container can be retrieved. Must be a list of glob expressions relative to the current working directory, some examples: my-dir/**, my-dir/*/** or my-dir/my-file.txt..

Dynamic YES

Default PT2S

Format duration

Additional time after the pod ends to wait for late logs.

The pod metadata.

SubType string

The output files URI in Kestra's internal storage

The pod status.

The output variables extracted from the logs of the commands

Dynamic YES

Default v1

The API version

Dynamic YES

CA certificate as data

Dynamic YES

CA certificate as file path

Dynamic YES

Client certificate as data

Dynamic YES

Client certificate as a file path

Dynamic YES

Default RSA

Client key encryption algorithm

default is RSA

Dynamic YES

Client key as data

Dynamic YES

Client key as a file path

Dynamic YES

Client key passphrase

Dynamic YES

Key store file

Dynamic YES

Key store passphrase

Dynamic YES

Default https://kubernetes.default.svc

The url to the Kubernetes API

Dynamic YES

The namespace used

Dynamic YES

Oauth token

Dynamic NO

Oauth token provider

Dynamic YES

Password

Dynamic YES

Truststore file

Dynamic YES

Truststore passphrase

Dynamic YES

Username

Dynamic NO

SubType string

Dynamic NO

List of all annotations of the resource

Dynamic NO

Name of the current cluster

Dynamic NO

Format date-time

Creation datetime

Dynamic NO

Deletetion grace period in seconds

Dynamic NO

Format date-time

Deletetion datetime

SubType string

Dynamic NO

List of finalizers

Dynamic NO

Generate name of the resource

Dynamic NO

Generation

SubType string

Dynamic NO

List of labels

SubType

Dynamic NO

List of managed fields

Dynamic NO

Name of the resource

Dynamic NO

Namespace of the resource

SubType

Dynamic NO

List of owner reference

Dynamic NO

Resource version

Dynamic NO

Direct link on the api of this resource

Dynamic NO

Generated Uid of this resource

Dynamic NO

SubType

Dynamic NO

SubType

Dynamic NO

SubType

Dynamic NO

SubType

Dynamic NO

SubType

Dynamic NO

SubType

Dynamic NO

SubType

Dynamic NO

SubType

Dynamic NO

Format date-time

Dynamic NO

Dynamic YES

Default busybox

The image used for the file sidecar container.

SubType

Dynamic NO

SubType

Dynamic NO

​Pod​Create

PodCreate