superplanehq/superplane

GitHub: superplanehq/superplane

面向平台工程的开源控制平面,通过事件驱动的有向图工作流编排,将 CI/CD、可观测性、事件响应和通知等工具统一串联并自动化运维流程。

Stars: 2419 | Forks: 291

# SuperPlane SuperPlane 是一个**用于平台工程的开源控制平面**。 它允许你在已经使用的工具中(例如 Git、CI/CD、可观测性、事件响应、基础设施和通知)定义并运行基于事件的工作流。 ![SuperPlane 截图](https://static.pigsec.cn/wp-content/uploads/repos/2026/05/84969eb4eb064842.png) ## 项目状态

CI Status on Semaphore GitHub commit activity Discord server

本项目目前处于 Alpha 阶段,正在快速迭代中。在我们稳定核心模型和集成期间,可能会遇到一些瑕疵或偶尔的破坏性变更。 如果你在试用过程中遇到任何令人困惑的问题,请[提交 Issue](https://github.com/superplanehq/superplane/issues/new)。 早期的反馈对我们极其宝贵。 ## 功能特性 - **工作流编排**:对跨多个系统的多步骤运维工作流进行建模。 - **事件驱动自动化**:通过告警、基础设施事件、代码变更、Issue 更新、定时任务和 webhook 触发工作流。 - **控制平面 UI 和 CLI**:设计并管理平台工程流程;在同一处或通过 CLI 检查运行状态、管理 Secret 并查看历史记录。 - **记忆功能**:使用内置的数据存储组件,在同一画面的不同执行路径和过程中持久化并检索运行时数据。 - **共享运维上下文**:将工作流定义和运维意图保留在一个系统中,而不是散落在各个脚本中。 ## 工作原理 - **画布 (Canvases)**:你可以将工作流建模为一个由步骤和依赖关系组成的有向图(即“画布”)。 - **组件 (Components)**:每个步骤都是一个可复用的组件(内置或由集成提供支持),负责执行一个操作(例如:调用 CI/CD、创建事件、发送通知、等待条件满足、要求审批)。 - **事件和触发器**:传入事件(webhook、定时任务、工具事件)与触发器匹配后,将以事件 payload 作为输入启动执行流程。 - **执行和可见性**:SuperPlane 负责执行该图,跟踪状态,并在 UI 和 CLI 中提供运行记录、历史和调试信息。 - **Agent 友好**:为你的编码 Agent 配备 SuperPlane 的 CLI 和技能,使其能够自主触发工作流、管理资源和调查执行情况。 ### 示例用例 以下是一些团队使用 SuperPlane 构建的具体应用: - **策略管控的生产环境部署**:当 CI 运行成功后,如果在非工作时间则暂停,要求值班人员和产品负责人审批,然后触发部署。 - **渐进式交付 (10% → 30% → 60% → 100%)**:分批次部署,在每个步骤进行等待/验证,并在失败时通过审批关卡进行回滚。 - **多仓库发布列车的发布集**:等待一组服务的标签/构建完成,当所有服务准备就绪后进行聚合,然后发起协调部署。 - **“最初 5 分钟”的事件分诊**:在创建事件时,并行获取上下文(最近的部署和健康信号),生成证据包,并创建一个 Issue。 ## 快速开始 运行最新的演示容器: ``` docker pull ghcr.io/superplanehq/superplane-demo:stable docker run --rm -p 3000:3000 -v spdata:/app/data -ti ghcr.io/superplanehq/superplane-demo:stable ``` 然后打开 [http://localhost:3000](http://localhost:3000) 并按照[快速开始指南](https://docs.superplane.com/get-started/quickstart/)操作。 ## 支持的集成 SuperPlane 集成了你已经在使用的工具。每个集成都提供触发器(用于启动工作流的事件)和组件(你可以运行的操作)。 ### AI 和 LLM
Claude
Claude
Cursor
Cursor
OpenAI
OpenAI
Perplexity
Perplexity
### 版本控制和 CI/CD
Bitbucket
Bitbucket
CircleCI
CircleCI
GitHub
GitHub
GitLab
GitLab
Harness
Harness
Octopus Deploy
Octopus Deploy
Render
Render
Semaphore
Semaphore
### 云和基础设施
AWS ECR
AWS ECR
AWS Lambda
AWS Lambda
AWS CodeArtifact
AWS CodeArtifact
AWS CloudWatch
AWS CloudWatch
AWS SNS
AWS SNS
GCP Cloud Build
GCP Cloud Build
GCP Cloud Functions
GCP Cloud Functions
GCP Compute
GCP Compute
Cloudflare
Cloudflare
DigitalOcean
DigitalOcean
DockerHub
DockerHub
Hetzner Cloud
Hetzner Cloud
Azure
Azure
### 可观测性
DataDog
DataDog
Dash0
Dash0
Grafana
Grafana
Honeycomb
Honeycomb
New Relic
New Relic
Prometheus
Prometheus
Elastic
Elastic
Sentry
Sentry
### 事件管理
FireHydrant
FireHydrant
Incident.io
Incident.io
PagerDuty
PagerDuty
Rootly
Rootly
Statuspage
Statuspage
### 沟通协作
Discord
Discord
SendGrid
SendGrid
Slack
Slack
SMTP
SMTP
Microsoft Teams
Microsoft Teams
Telegram
Telegram
### 工单管理
Jira
Jira
ServiceNow
ServiceNow
### 开发者工具
Daytona
Daytona
JFrog Artifactory
JFrog Artifactory
LaunchDarkly
LaunchDarkly
## 生产环境安装 你可以将 SuperPlane 部署在单台主机上或 Kubernetes 上: - **[单主机安装](https://docs.superplane.com/installation/overview/#single-host-installation)** - 部署在 AWS EC2、GCP Compute Engine 或其他云服务提供商上 - **[Kubernetes 安装](https://docs.superplane.com/installation/overview/#kubernetes)** - 部署在 GKE、EKS 或任何 Kubernetes 集群上 安装管理员可以在所有者设置期间或稍后在 `/admin/settings` 中启用私有网络访问,以便 SuperPlane 能够访问 VPC、私有 Kubernetes 集群或其他封闭网络内的工具。环境变量依然具有最高优先级:设置 `BLOCKED_HTTP_HOSTS` 或 `BLOCKED_PRIVATE_IP_RANGES` 可覆盖 UI 控制的策略,将任一变量设置为空值则可完全禁用该特定的阻止列表。 ## 许可证 Apache License 2.0。请参阅 `LICENSE`。 ## 社区 - **[Discord](https://discord.superplane.com)** - 加入我们的社区参与讨论、提问和协作 - **[X](https://x.com/superplanehq)** - 关注我们以获取更新和公告
标签:API集成, CISA项目, Cloud Native, EVTX分析, GitOps, UI与CLI管理, Webhook处理, 事件驱动架构, 可观测性, 基础设施管理, 子域名突变, 定向无环图(DAG), 工作流编排, 平台工程, 平台工程工具, 开源控制平面, 文档结构分析, 日志审计, 自动化运维, 请求拦截, 跨系统集成, 集中式管理