Kestra Docker镜像文档

镜像概述和主要用途

Kestra是一个开源的事件驱动编排平台，旨在简化计划和事件驱动工作流的创建与管理。它将基础设施即代码的最佳实践引入数据、流程和微服务编排，允许用户通过UI以几行YAML直接构建可靠的工作流。无论通过UI、API调用还是其他方式修改工作流，编排逻辑始终以声明式代码管理，确保一致性和可追溯性。

核心功能和特性

• 工作流即代码与UI双向编辑：即使通过UI构建工作流，也能通过Git版本控制集成保持工作流即代码特性，YAML定义会自动调整以反映任何修改。
• 事件驱动与计划工作流：通过简单的trigger定义，同时支持计划任务和实时事件驱动工作流。
• 声明式YAML界面：使用内置代码编辑器以简洁配置定义工作流，支持语法高亮、自动补全和实时语法验证。
• 丰富的插件生态系统：数百个内置插件，支持从任何数据库、云存储或API提取数据，并运行任何语言的脚本。
• 直观的UI与代码编辑器：直接从UI构建和可视化工作流，提升开发效率。
• 高可扩展性：设计用于处理数百万工作流，具备高可用性和容错能力。
• 版本控制友好：支持从内置编辑器编写工作流并直接推送到Git分支，与CI/CD管道和版本控制系统无缝集成。
• 结构化与弹性能力：提供命名空间、标签、子流、重试、超时、错误处理、输入输出、变量、条件分支、高级调度、事件触发器、回填、动态任务、顺序和并行任务等功能，可通过disabled: true禁用任务或触发器。

Docker镜像标签

提供以下Docker镜像标签（任何镜像均可添加-no-plugins后缀以排除除核心插件外的所有插件）：

基础标签

• latest: 最新稳定版本（滚动标签），用于尝试新功能，非LTS版本，支持在下一个稳定版本（约2个月）发布时结束。
• latest-lts: 当前长期支持版本（滚动标签），跟踪活跃LTS线路（约每6个月更新到新LTS），支持约1年。
• v<X.X>: 次要系列浮动标签（如v1.0），始终指向该系列的最新补丁版本（如v1.0.5）。
• v<X.X.X>: 特定版本的不可变标签（如v1.0.1），永不更改，推荐用于生产环境版本锁定。
• develop: 来自develop分支的夜间构建，不稳定，仅用于测试。

插件版本说明

• 默认镜像（如kestra/kestra:latest）已包含所有插件
• 轻量级版本：添加-no-plugins后缀（如kestra/kestra:latest-no-plugins），仅包含核心功能

推荐生产环境镜像

• 最新稳定版（滚动更新，适合需要最新功能的场景）:
  • kestra/kestra:latest（含所有插件）
  • kestra/kestra:latest-no-plugins（仅核心功能）
• 固定版本（最大稳定性，推荐生产环境）:
  • kestra/kestra:v<X.X.X>（含所有插件）
  • kestra/kestra:v<X.X.X>-no-plugins（仅核心功能）
• LTS版本（长期支持，更新频率低）:
  • kestra/kestra:latest-lts
  • kestra/kestra:latest-lts-no-plugins

详细使用方法和配置说明

快速启动命令

Linux/macOS或WSL环境:

bash
docker run --pull=always --rm -it -p 8080:8080 --user=root \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /tmp:/tmp kestra/kestra:latest server local

Windows PowerShell:

powershell
docker run --pull=always --rm -it -p 8080:8080 --user=root `
    -v "/var/run/docker.sock:/var/run/docker.sock" `
    -v "C:/Temp:/tmp" kestra/kestra:latest server local

Windows命令提示符(CMD):

cmd
docker run --pull=always --rm -it -p 8080:8080 --user=root ^
    -v "/var/run/docker.sock:/var/run/docker.sock" ^
    -v "C:/Temp:/tmp" kestra/kestra:latest server local

使用自定义配置文件:

bash
docker run --pull=always --rm -it -p 8080:8080 --user=root \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $PWD/application.yaml:/etc/config/application.yaml \
  kestra/kestra:latest server standalone --config /etc/config/application.yaml

访问UI: 启动后通过 http://localhost:8080 访问Kestra界面

持久化存储说明

默认启动命令使用嵌入式H2数据库（非持久化）。生产环境建议使用PostgreSQL等外部数据库，详细配置请参考Docker Compose安装指南。

插件生态系统

Kestra通过插件扩展功能，支持以下核心能力：

多环境执行

• 本地/远程执行：支持本地运行、SSH远程执行或通过任务运行器扩展到无服务器容器
• 容器化支持：无缝运行Docker容器和Kubernetes作业

多语言支持

• 脚本执行：支持Python、Node.js、R、Go、Shell等多种编程语言
• 系统集成：执行shell命令、SQL查询和HTTP请求

事件驱动处理

• 实时触发器：响应文件到达、消息队列事件（Kafka、Redis、Pulsar等）
• 自定义事件：基于特定条件或外部信号触发工作流

云服务集成

• 主流云厂商：AWS、Google Cloud、Azure全栈服务集成
• 大数据处理：与Apache Spark、Google BigQuery等工具集成

监控与通知

• 多渠道告警：支持Slack、邮件、PagerDuty等通知方式

完整插件列表请查看***插件页面，或通过插件开发指南构建自定义插件。

适用场景和适用范围

Kestra适用于以下场景：

• 数据管道编排：ETL/ELT流程、数据同步与转换
• 事件驱动自动化：响应文件上传、消息队列事件、API调用等实时触发场景
• 计划任务管理：定期数据处理、报告生成、系统维护
• 跨系统集成：连接不同应用、服务和数据库的端到端业务流程
• 微服务编排：协调多个微服务的执行顺序和依赖关系
• 大数据处理：管理Spark、BigQuery等工具的大规模数据处理任务

加入社区

• Slack: 加入社区提问和分享经验
• LinkedIn: 关注***账号获取更新
• *******: 订阅频道观看教程视频
• X: 关注@kestra_io获取动态

许可证

Kestra采用Apache 2.0许可证授权 © Kestra Technologies