Kestra 工作流编排平台

Kestra：安装说明

这个工具包里只有安装说明，由 Mindket 编写。Kestra 本身从它的 Docker 镜像、Helm chart 和部署模板运行，这些都来自 Kestra 的仓库：https://github.com/kestra-io/kestra

这些说明不是 Kestra Technologies 写的，也没有得到它的认可。README 说 Kestra 是“an open-source, event-driven orchestration platform for data, AI, and infrastructure workflows.”（面向数据、AI 和基础设施工作流的开源事件驱动编排平台）。文档在 https://kestra.io/docs

许可证：Apache-2.0。LICENSE 文件（https://github.com/kestra-io/kestra/blob/develop/LICENSE）是 Apache License 2.0，结尾是“Copyright 2019 Kestra Technologies.”。README 写着“Kestra is licensed under the Apache 2.0 License © Kestra Technologies.”。这些说明讲的是开源版。企业版是单独的付费产品，镜像从私有镜像仓库拉取，说明里只在命令不同的地方提到它。

README 把 Kestra 2.0 介绍为一个带破坏性变更的大版本。为 1.x 写的流程可能要改：https://kestra.io/docs/migration-guide/v2.0.0

会安装什么

• Kestra 本身，来自 Docker 镜像 kestra/kestra。-slim 版本不带插件，在本地服务器上，某个流程第一次用到某个插件时才安装它。README 说插件来源是 Maven Central。来源见 https://github.com/kestra-io/kestra/blob/develop/README.md 和 https://kestra.io/docs/installation/docker
• 一个数据库。单容器命令把内嵌的 H2 数据库保存在一个 Docker 数据卷里。Docker Compose 文件会在 Kestra 旁边启动 PostgreSQL。来源见 https://kestra.io/docs/installation/docker-compose
• 给编程智能体用的三样东西，各自来自 Kestra 自己的页面：Docs MCP 服务器（由 Kestra 托管，不用安装）、Agent Skills（由 npx skills add 写进你项目的 SKILL.md 文件）和 Kestra 的命令行 kestractl。来源见 https://kestra.io/docs/claude-code-quickstart

事先需要准备

• Docker，Windows 上要启用 WSL。快速入门推荐 Docker Desktop。来源见 https://kestra.io/docs/quickstart
• 至少 2 个 vCPU 和 4 GiB 内存。来源见 https://kestra.io/docs/installation
• 电脑上的 8080 端口空着，因为命令把界面发布在这个端口。
• 走智能体这条路的话：用来运行 npx 的 Node.js、macOS 或 Linux 终端（Windows 上用 WSL），以及一个正在运行的 Kestra 2.0 实例。来源见 https://kestra.io/docs/claude-code-quickstart

主安装命令

快速入门给出了这一条命令来启动本地实例。运行前 Docker 要先跑起来。

docker run --pull=always --rm -it -p 8080:8080 --user=root \
  --name kestra \
  -v kestra_data:/app/storage \
  -v kestra_db:/app/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /tmp:/tmp \
  kestra/kestra:latest-slim server local

等日志里出现 Main server is running at http://...:8080，打开 http://localhost:8080 并创建你的用户。来源见 https://kestra.io/docs/quickstart

快速入门说这套设置“for local evaluation”（用于本地评估）。在别人或其他网络能访问 Kestra 之前，先按安全加固指南操作：https://kestra.io/docs/security-hardening

各平台说明

• setup/docker.md：单个容器，附 PowerShell、CMD 和 WSL 版本的命令
• setup/docker-compose.md：Kestra 加 PostgreSQL
• setup/cloud-and-kubernetes.md：Helm、AWS、Azure 和 Google Cloud
• setup/claude-code.md：在 Claude Code 里接上 Docs MCP 服务器、Agent Skills 和 kestractl
• setup/codex.md：在 Codex 里接上同样的三样
• setup/cursor.md：在 Cursor 里接上同样的三样
• setup/other-agents.md：Windsurf、OpenCode，以及任何能读技能文件或通过 HTTP 使用 MCP 的智能体
• setup/kestractl.md：命令行
• setup/vscode.md：VS Code 扩展
• setup/ai-copilot.md：产品内置的助手，以及它需要的模型提供方
• setup/flow-mcp-servers.md：让外部智能体把你的流程当工具来运行

更新或卸载

Docker 命令带 --pull=always，Compose 文件带 pull_policy: always，所以再次运行 docker run 或 docker compose up 会拉取最新镜像。从 1.x 升到 2.0 有单独的指南，migrate-kestra-2 技能会带 Kestra 1.3 实例完成升级。来源见 https://kestra.io/docs/develop-with-ai/agent-skills

要停掉单个容器，按 Ctrl+C。--rm 会删掉容器，数据卷会保留。想从头开始，快速入门给的是：

docker volume rm kestra_data kestra_db

来源见 https://kestra.io/docs/quickstart

文档没有给出卸载 Docker Compose、技能或 MCP 配置的步骤。以下是 Mindket 的说明，不是 Kestra 的：Compose 文件里有两个数据卷，postgres-data 和 kestra-data。技能安装程序在 Claude Code 下写入 .claude/skills/，在 Cursor 和 Codex 下写入 .agents/skills/，所以要删的就是这些位置里的技能文件夹。kestra 这个 MCP 配置，用你的智能体自己的 MCP 命令或配置文件删掉。

使用数据

Kestra 默认发送匿名使用数据，分两路。服务器端的报告包括主机数据（CPU、内存、操作系统、JVM 和机器指纹）、已安装的插件、流程数量、任务和触发器类型、执行次数和时长，以及服务器类型、版本、时区和 URL 等通用数据。界面会从浏览器单独发送一份报告。两个都设为 false 才能全部停掉：

kestra:
  anonymous-usage-report:
    enabled: false
  ui-anonymous-usage-report:
    enabled: false

来源见 https://kestra.io/docs/administrator-guide/usage

其他对外连接

• 插件自动安装会在流程需要时从 Maven Central 下载插件。来源见 https://github.com/kestra-io/kestra/blob/develop/README.md
• Docs MCP 服务器在 https://api.kestra.io/v1/mcp。它是公开、只读的，不会连接你的实例。来源见 https://kestra.io/docs/develop-with-ai/kestra-mcp-resources
• kestra-flow、kestra-flow-hardening 和 migrate-airflow-kestra 这三个技能需要 curl，还要能访问 https://api.kestra.io。页面说 kestra-flow 和 migrate-airflow-kestra 会从那里获取实时的流程结构。来源见 https://kestra.io/docs/develop-with-ai/agent-skills
• AI Copilot 通过你配置的模型提供方来回答。页面说，配置之前它没法回答提示。来源见 https://kestra.io/docs/develop-with-ai/ai-copilot

来源

• README：https://github.com/kestra-io/kestra/blob/develop/README.md
• 快速入门：https://kestra.io/docs/quickstart
• 安装总览：https://kestra.io/docs/installation
• Docker：https://kestra.io/docs/installation/docker
• Docker Compose：https://kestra.io/docs/installation/docker-compose
• Kubernetes：https://kestra.io/docs/installation/kubernetes
• Claude Code 快速入门：https://kestra.io/docs/claude-code-quickstart
• Docs MCP 服务器：https://kestra.io/docs/develop-with-ai/kestra-mcp-resources
• Agent Skills：https://kestra.io/docs/develop-with-ai/agent-skills
• kestractl：https://kestra.io/docs/kestra-cli/kestractl
• VS Code 扩展：https://kestra.io/docs/version-control-cicd/vscode
• AI Copilot：https://kestra.io/docs/develop-with-ai/ai-copilot
• 流程 MCP 服务器：https://kestra.io/docs/ai-orchestration/mcp-server
• 给智能体的文档：https://kestra.io/docs/develop-with-ai/docs-for-agents
• 安全加固：https://kestra.io/docs/security-hardening
• 匿名使用数据：https://kestra.io/docs/administrator-guide/usage
• 开源版与企业版：https://kestra.io/docs/oss-vs-paid