Skip to main content
New to Testkube? Unleash the power of cloud native testing in Kubernetes with Testkube. Get Started >

Scheduling Workflows

Testkube supports a cron-based scheduling mechanism that allows you to run your Test Workflows at desired intervals/times.

Scheduling a Workflow by updating the Workflow Definition

info

Schedules are defined in the Workflow YAML under a spec.events.cronjob property - Read More.

The easiest way to schedule your Workflow is to modify the Workflow definition and add the corresponding spec.events.cronjob property, for example the below workflow will be scheduled to run on a daily basis at 3 am:

kind: TestWorkflow
apiVersion: testworkflows.testkube.io/v1
metadata:
name: distributed-k6-demo
namespace: testkube
spec:
events:
- cronjob:
cron: 0 3 * * *
...
tip

Testkube's schedule data format is the same that is used to define Kubernetes Cron jobs, visit Wikipedia Cron format for details.

Schedule a Workflow from the Testkube Dashboard

You can also schedule a Test Workflow from the Testkube Dashboard under the Workflow Settings/Scheduling Panel:

Workflow Scheduling

This will add the corresponding YAML to the Workflow definition:

Workflow Scheduling Definition

info

The Dashboard will only allow you to manage one schedule, if you want to define multiple schedules, you will have to do this directly in the Workflow Definition.

Scheduling Architecture

Testkube uses the scheduling engine from Kubernetes Cron jobs for scheduling your Workflow Executions. For each schedule, a special cron job is created from this template.

Technically, it is a callback to the Testkube API server method, launching the corresponding Workflow execution.