superplanehq/superplane
GitHub: superplanehq/superplane
面向平台工程的开源控制平面,通过事件驱动的有向图工作流编排,将 CI/CD、可观测性、事件响应和通知等工具统一串联并自动化运维流程。
Stars: 2419 | Forks: 291
# SuperPlane
SuperPlane 是一个**用于平台工程的开源控制平面**。
它允许你在已经使用的工具中(例如 Git、CI/CD、可观测性、事件响应、基础设施和通知)定义并运行基于事件的工作流。

## 项目状态
本项目目前处于 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
### 版本控制和 CI/CD
### 云和基础设施
### 可观测性
### 事件管理
### 沟通协作
### 工单管理
### 开发者工具
## 生产环境安装
你可以将 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)** - 关注我们以获取更新和公告
Claude |
Cursor |
OpenAI |
Perplexity |
Bitbucket |
CircleCI |
GitHub |
GitLab |
Harness |
Octopus Deploy |
Render |
Semaphore |
AWS ECR |
AWS Lambda |
AWS CodeArtifact |
AWS CloudWatch |
AWS SNS |
GCP Cloud Build |
GCP Cloud Functions |
GCP Compute |
Cloudflare |
DigitalOcean |
DockerHub |
Hetzner Cloud |
Azure |
DataDog |
Dash0 |
Grafana |
Honeycomb |
New Relic |
Prometheus |
Elastic |
Sentry |
FireHydrant |
Incident.io |
PagerDuty |
Rootly |
Statuspage |
Discord |
SendGrid |
Slack |
SMTP |
Microsoft Teams |
Telegram |
Jira |
ServiceNow |
Daytona |
JFrog Artifactory |
LaunchDarkly |
标签:API集成, CISA项目, Cloud Native, EVTX分析, GitOps, UI与CLI管理, Webhook处理, 事件驱动架构, 可观测性, 基础设施管理, 子域名突变, 定向无环图(DAG), 工作流编排, 平台工程, 平台工程工具, 开源控制平面, 文档结构分析, 日志审计, 自动化运维, 请求拦截, 跨系统集成, 集中式管理