​Task ​Runners

Manage the environment your code is executed with Task Runners.

Overview

Task Runners are extensible, pluggable systems capable of executing your tasks in arbitrary remote environments.

Each taskRunner is identified by its type. The Process and Docker task runners are fully open-source and located within the Kestra repository. By default, Kestra runs all script tasks using the Docker task runner.

Here's an example of the Docker Task Runner configured to use the centos container image:

id: docker_task_runner
namespace: company.team

tasks:
  - id: shell
    type: io.kestra.plugin.scripts.shell.Commands
    containerImage: centos
    taskRunner:
      type: io.kestra.plugin.scripts.runner.docker.Docker
      cpu:
        cpus: 1
    commands:
      - echo "Hello World!"

You can learn more in the Docker Task Runner documentation.

Here's an example of the Process Task Runner:

id: process_task_runner
namespace: company.team

tasks:
  - id: shell
    type: io.kestra.plugin.scripts.shell.Commands
    taskRunner:
      type: io.kestra.plugin.core.runner.Process
    commands:
      - echo "Hello World!"

You can learn more in the Process Task Runner documentation.

Find out more information on the dedicated Task Runners documentation.