1. Kestra 1.3 is here: production-grade controls release
Item 1 of 1

Best Practices

OVERVIEW

Created by

Kestra Core Team

Managed by

Kestra Core Team

Best practices for building reliable workflows in Kestra, including guidance on choosing the right patterns for common design decisions.

Apply best practices for Kestra workflows

Kestra often provides multiple ways to achieve the same outcome. This section helps you choose the approach that best fits your use case, with guidance on design decisions, implementation patterns, and tradeoffs.

Flow Best Practices – Design flows for Performance and Reliability

Design Kestra flows for optimal performance and reliability by managing task count, data volume, and parallelism.

Moving from Development to Production

Recommended patterns for promoting Kestra flows from development to production environments using Git and CI/CD.

Choosing Where to Store Sensitive and Shared Values

Learn how to choose between Kestra credentials, secrets, and the KV Store for authentication, sensitive values, and runtime state.

Designing Data Retention and Purging in Kestra

Learn how to choose the right purge strategy in Kestra for executions, logs, key-value pairs, Namespace files, assets, and other retained data.

Naming Conventions

Learn the best practices for naming namespaces, flows, tasks, and other identifiers in Kestra for a clean and scalable hierarchy.

Manage Environments

Best practices for managing Kestra environments, including separate instances for development and production, and using tenants.

Managing pip Package Dependencies

Efficiently manage Python pip dependencies in Kestra using custom Docker images, server startup installs, or caching.

Expressions with Namespace Files

Learn how to pass Kestra expressions to scripts stored in Namespace Files using environment variables or CLI arguments.

Version Control with Git

Best practices for using Git with Kestra for version control, including SyncFlows, PushFlows, and CI/CD integration.

Managing and Purging Flow Outputs

Best practices for managing flow outputs in Kestra, including purging large files and handling conditional outputs efficiently.

Business Units Separation

Strategies for isolating business units in Kestra Enterprise using Tenants and Namespaces for security and governance.

Best Practices for Secrets in Kestra

Best practices for securely managing and using secrets in Kestra workflows to prevent accidental exposure.

Was this page helpful?