GitLab CI for Kestra – Automate Validation and Deployments

Use GitLab CI to automate the validation and deployment of your Kestra flows.

Automate Kestra deployments with GitLab CI

GitLab CI lets you define pipelines in a .gitlab-ci.yml file to automate tests, builds, and deployments. With Kestra, you can validate and deploy flows directly from your pipeline using the Kestra CLI.

labels:
  system.readOnly: true

Example pipeline

The example below defines two stages — validate and deploy — and runs the Kestra CLI in an official Kestra image. Validation runs first; if it succeeds, the deploy stage updates a target namespace with the flows from your repository.

stages:
  - validate
  - deploy

default:
  image:
    name: kestra/kestra:latest
    entrypoint: [""]

variables:
  KESTRA_HOST: https://kestra.io/

validate:
  stage: validate # Validate flows server-side
  script:
    - /app/kestra flow validate ./kestra/flows --server ${KESTRA_HOST} --api-token $KESTRA_API_TOKEN

deploy:
  stage: deploy
  script:
    - /app/kestra flow namespace update my_namespace ./kestra/flows/prod --server ${KESTRA_HOST} --api-token $KESTRA_API_TOKEN

Tips

• Pin the Docker image (e.g., kestra/kestra:1.0.x) to avoid unexpected CLI changes.