管理端 · 执行机 · 部署节点

从一次提交,
到服务上线全自动

在 Web 控制台配置一次项目,之后每次触发都由执行机完成 拉取代码 → 打包 → 安全扫描 → 上传 → 部署 → 启动,全过程实时日志可查、产物可下载、 关键环境可设人工卡点。

拉码构建 安全扫描 SSH / 节点 Kubernetes 通知回调
任务 / #1024 · 项目 demo-api 执行中
已入队 · 当前第 2 位(等待派发) queued
匹配执行机 · node-sh-02 dispatched
拉取代码 · release/2026.11 build
Maven 打包 · target/demo.jar build
安全扫描 · SCA / SAST 未发现阻断项 security
上传产物 → 10.0.0.21:/srv/demo upload
人工卡点 · 生产环境等待放行 waiting
停 / 部 / 启脚本 · 启动完成 deploy
任务进度 64%
扫描通过才继续SCA · SAST
部署结果已推送飞书 · 邮件 · Webhook
3
端协同(管理端 / 执行机 / 节点)
5
个执行阶段
4
种触发方式
5
类构建能力
Architecture

三端分离,构建机与目标机都不必暴露数据库

管理端是唯一的 Web 服务与控制台,独占 MySQL;执行机与部署节点部署在内网机器上, 主动连接管理端并长轮询取指令,不需要开放入站端口。

  • 管理端:配置管理、权限、队列派发、Webhook 接收、通知与产物归档; 前端已嵌入二进制,部署一个进程即可。
  • 执行机:装在构建机上,负责 Git 密钥、拉码、构建、安全扫描与上传; 按能力与并发容量自动匹配,最闲优先。
  • 部署节点:装在目标服务器上,产物经管理端中转后在本机落地, 目标机无需开放 SSH。
  • 不可变执行计划:任务入队时合成为 RunPlan 快照(变量展开、资源解析、凭据解密), 排队期间修改项目配置不会影响已入队任务。
部署拓扑
管理端 · Web 控制台配置 / 权限 / 队列 / Webhook / 通知 / 产物归档 · 独占 MySQL
Token 鉴权 · 长轮询取指令
执行机 · 构建机拉码 · 构建 · 扫描 · 上传 · 远程部署
部署节点 · 目标机本机落地产物 · 执行停 / 部 / 启
两条部署链路
SSH 直连密码 / 密钥 · su / sudo 切换用户
部署节点中转目标机免 SSH · 节点拉取落地
执行机与部署节点都不连接数据库;令牌仅在新建时展示一次,遗失只能重置后同步更新配置并重启。
Pipeline Core

围绕打包部署的四项核心能力

从代码获取到服务启动,每一步都可配置、可观察、可回溯;失败时能定位到具体阶段并重试。

有序构建步骤

一次取码后按顺序串行构建,各步骤共用工作目录,前序产物可被后续步骤直接使用。

  • Java · Maven
  • Go · 前端 · uni-app
  • Docker 镜像交付
  • 构建前文件切换

部署编排

多产物条目按目录与覆盖策略落地,覆盖前自动备份轮转,再执行停 / 部 / 启三段脚本。

  • 文件 / glob / 目录
  • 覆盖 · 合并 · 清空
  • 备份与保留份数
  • kubectl · Helm

安全扫描

依赖漏洞与源码风险在构建后自动检测,按风险级别决定仅告警或阻断任务。

  • SCA · OSV 漏洞库
  • SAST · Semgrep
  • 豁免规则
  • warn / block

人工卡点

关键环境在打包与上传完成后暂停,等待有权限的人放行才继续部署,超时自动失败。

  • 放行 / 驳回
  • operate 权限
  • 等待超时
  • 通知提醒
Project Configuration

一次配置,之后只关心触发

项目必须归属分组,分组承载任务变量、目标服务器范围、通知渠道与 Git 密钥; 项目本身用七个 Tab 描述完整的交付过程。

  • 代码获取:仓库地址、分支 / Tag、SSH / HTTPS 认证;SSH 使用租户级或分组级密钥, 执行机自动拉取,无需逐台配置。
  • 构建:Java / Go / 前端 / uni-app / Docker 步骤自由组合,步骤受环境资源约束, 可声明构建前文件切换。
  • 任务变量:分组 / 项目 / 触发临时变量三级合并,敏感变量加密存储、 日志脱敏,支持 ${now}、${random} 等动态表达式。
  • 模板复用:项目模板保存配置骨架(不含凭据),内容模板用 Go 模板语法生成 启停脚本、配置片段或 K8s 清单;均支持 JSON 导入导出。
项目配置的七个 Tab
代码获取 构建 安全扫描 部署
任务变量 Webhook 触发器
分组是组级配置的载体
任务变量与目标范围组级变量 · 限定可选目标服务器
任务通知按事件推送 · 通知只认所属分组
分组 Git 密钥优先于租户级 · 自动下发执行机
成员与权限view / operate / manage 三档
项目、模板、内容模板均支持导出与导入;导入时按名称重新匹配分组、目标服务器与构建资源, 便于在测试与生产环境之间搬迁配置。
Build & Deploy

构建产物怎么来,就怎么落到目标机

构建步骤产出的文件、目录或镜像,在「部署」中按条目声明去向;平台负责上传、备份、 替换与启动,每一步都能在任务日志里看到。

  • 多产物条目:来源支持文件、多文件 glob 与整个目录;可指定目标目录、 子目录或直接放入、覆盖 / 合并 / 清空后放入、权限与属主。
  • 备份轮转:覆盖前按配置归档到备份目录,超过保留份数自动清理, 回退时有据可依。
  • 停 / 部 / 启脚本:三段脚本按顺序执行,默认加载目标机登录环境, 平台任务变量同名时优先,可覆盖机器旧值。
  • Kubernetes 发布:kubectl 清单 apply / delete、set image、等待就绪与失败回滚; Helm 支持仓库内 Chart、远程仓库与 OCI,可 atomic / wait。
从构建产物到服务启动
构建步骤产出jar · 前端 dist · Go 二进制 · Docker 镜像
按部署条目选择去向
上传与备份tar / sftp · 覆盖前归档 · 保留份数轮转
本机落地
停 / 部 / 启脚本非登录 shell · 加载机器环境
内容模板部署最前面生成脚本 / 配置 / 清单
容器化交付
镜像仓库push / pull · 临时 docker 配置
kubectl / Helm命名空间 · 就绪等待 · 失败回滚
目标机不方便开放 SSH 时,把「连接方式」改为部署节点即可:产物经管理端中转, 由节点本机落地并执行同样的部署脚本。
Security & Approval

先扫描,再放行,最后才部署

安全扫描给出可执行的结论,人工卡点把不可逆操作留在人的确认之后,敏感信息全程不出现在日志里。

SCA 依赖扫描

构建完成后对 Java / Go / 前端依赖做已知漏洞检测,基于 OSV.dev 漏洞库。

  • 最低风险级别
  • 仅告警 / 终止任务
  • 扫描异常策略
  • 项目级豁免

SAST 代码扫描

基于 Semgrep 的源码静态扫描,规则包集中维护,执行机就地扫描、源码不外传。

  • 规则包引用
  • 全局默认策略
  • 项目覆盖
  • 结果明细

部署前人工卡点

打包与上传完成后任务暂停,有 operate 权限的人放行或驳回,超时自动置失败并通知。

  • 等待超时
  • 驳回原因
  • 待我处理入口
  • 等待 / 通过通知

凭据与敏感变量

Git 密码、仓库密码、SSH 私钥与敏感变量加密存储,界面不回显,日志显示为掩码。

  • 密文入库
  • 临时 envfile
  • 日志脱敏
  • 操作审计
权限分 view(只读)、operate(可触发、放行、取消)、 manage(可改配置、管成员)三档,按项目或分组授权;关键操作全部写入审计日志。
Task & Scheduling

排队、派发、执行、重试,都有迹可循

所有任务统一入队,由后台派发循环按优先级与执行机容量自动派发; 运行过程通过 SSE 实时回传,刷新页面也能从断点继续看。

  • 任务队列:查看排队位次、排队原因与执行机并发占用,支持置顶、调整优先级与取消。
  • 任务详情:五阶段进度、实时日志、产物列表与下载(目录打包为 .tar.gz)、 镜像引用与失败原因。
  • 失败重试:可从失败阶段重新执行,不必从头再跑一遍构建。
  • 四种触发:手动运行、Git Webhook(GitHub / GitLab / Gitee / 通用)、 接口触发(令牌或 HMAC-SHA256)、定时触发(多条 cron,可排队或跳过)。
任务状态流转
queued dispatched running waiting succeeded

失败、取消进入 failed / canceled;等待人工确认通过后回到 running,驳回或超时置为 failed。

触发与通知
Git Webhook验签 · 分支 / Tag / 路径过滤 · 防抖 · skip ci
接口触发令牌 / HMAC · 可复制为 curl
定时触发多条 cron · 到点冲突按策略处理
通知与回调钉钉 / 企微 / 飞书 / 邮件 / Webhook · 成功回调
Webhook 与接口触发的每次调用都记录在「Webhook 投递」中,命中、忽略与合并原因可查, 支持历史投递重放,便于调试过滤规则。
Closed Loop

一次任务,六个阶段走完交付

触发之后不再需要人工搬运产物:平台按顺序推进,任何一步失败都会停在原地并给出原因。

STEP 01

触发入队

手动、Webhook、接口或定时触发,任务统一入队并按优先级排队。

STEP 02

匹配执行机

按项目引用的环境资源与执行机容量匹配一台可用机器,生成不可变执行计划。

STEP 03

拉码与构建

检出分支或 Tag,按顺序执行构建步骤,产物自动归档到管理端。

STEP 04

安全扫描

SCA 检查依赖漏洞,SAST 检查源码风险;按策略告警或阻断后续阶段。

STEP 05

上传与部署

备份后按条目落地产物,执行停 / 部 / 启脚本,或完成 Kubernetes 发布。

STEP 06

启动与通知

确认启动结果,按分组配置推送通知,并触发项目级成功回调。

失败可恢复: 任一阶段失败会记录原因并跳过后续阶段,通知按事件发出;修复后可从失败阶段重试, 无需重复已完成的构建。
Foundation

打包部署之外,平台该有的都有

多租户、权限、单点登录、审计、通知与安全策略开箱即用,不需要再为流水线单独搭一套账号体系。

多租户协作租户隔离 · 资源共享授权 · 项目与并发配额
账号与单点登录OIDC SSO · 登录失败锁定 · 密码策略
通知渠道钉钉 · 企微 · 飞书 · 邮件 · Webhook
审计与集群操作留痕 · 多实例心跳 · 版本查看
免登录分享项目 / 内容模板 · 访问密码 · 过期撤销
邮件服务器多台 SMTP · 随机发信 · 测试发送
产物归档按任务保留 · 下载入口 · 自动回收
平台概览执行机在线 · 队列长度 · 最近失败
FAQ

接入与使用中的常见问题

关于环境依赖、部署链路、执行计划与权限控制的说明。

执行机 部署 安全

所有执行机都需要 Git;构建按项目步骤选择 JDK / Maven、Go、Node / npm、Docker; 启用代码扫描的项目还需要 Semgrep。安装完成后在控制台用「探测」确认路径可用, 再把结果登记为环境资源并关联执行机。

不必。目标机安装部署节点后,把「目标服务器」的连接方式改为部署节点并绑定即可: 产物经管理端中转,由节点在本机落地并执行部署脚本,不需要开放 SSH,也不需要填写主机凭据。

默认包含打包、安全扫描、上传、部署、启动五个阶段。运行时可以选择执行范围 (打包 / 部署 / 启动)与「从阶段开始」,关闭构建时仍会拉取代码并把仓库文件交给部署阶段。

不会。任务入队时会合成为不可变的 RunPlan 快照,变量展开、资源引用与凭据解密都在入队时完成, 之后修改项目配置只对后续新任务生效。

在项目「部署」中开启人工卡点:打包与上传完成后任务暂停,只有对项目有 operate 权限的人才能放行或驳回;超时未处理会自动失败并通知。 同时可用三档权限限制谁能改配置、谁能触发任务。

取决于命中动作:设为「仅告警」时只记录结果,设为「终止任务」时达到最低风险级别的命中会阻断后续阶段。 可配置最低风险级别、扫描异常策略与豁免规则,项目配置留空时跟随全局默认。

执行机、部署节点、环境资源、镜像仓库、目标服务器与项目模板都可以在列表行「共享」中 设为共享给所有租户或按租户授权。被共享方只读可用,修改与删除仍需切回归属租户。

把打包部署收进一条流水线

配置一次项目,之后每次提交自动完成构建、扫描、上传、部署与启动, 结果实时可见、通知及时到达、失败可以重试。