主题
什么是 deploy
一句话定位
deploy 是一个轻量、自托管的 CI/CD 平台:为项目配置工作目录和一组 Shell 命令,即可通过网页、CLI 或 HTTP Hook 执行部署,实时查看日志与退出码。
部署步骤就是普通的 Shell 脚本,无需编写流水线 DSL。命令在平台服务端所在机器上执行;使用 Docker 形态部署服务端时,命令在容器内执行。
解决什么问题
传统 CI 系统(Jenkins、GitLab CI 等)通常需要独立的调度器、Agent、插件体系与流水线语法。 对于「几台自己的服务器 + 几十个应用」的团队,这些能力大多用不上,反而带来维护成本。deploy 的取舍是:
- 不要 DSL:脚本就是 bash/PowerShell 本身,退出码决定成败,
set -e与健康检查由你掌控。 - 不要外部依赖:服务端单二进制交付,内嵌 Web 界面与 SQLite,无需外部数据库或消息队列。
- 不要 Agent:命令直接在服务端机器执行,Git 准备、构建、发布、重启服务都在同一台机器完成。
- 保留可控性:队列/并行/取消上一次三种并发策略、整体与单命令超时、进程树取消、依赖构建排序。
功能总览
| 能力 | 说明 |
|---|---|
| 项目 | 构建 + 部署单元:Git 准备阶段、有序命令、环境变量与 Secret、依赖构建 |
| 任务 | 一次性运维作业:勘察、改配置、清缓存、导数据;无 Git、无依赖,步骤 ID 稳定 |
| 运行 | 全局运行 ID + 项目内构建号;queued/running/success/failed/timeout/error/canceled 七态 |
| 实时日志 | 文件落盘 + WebSocket 推送,断线按 offset 续传;网页 xterm 终端与 CLI 同源 |
| Git 与凭据 | 按需启用 Git 准备;凭据加密保存、可测试连接;Secret 在日志中自动遮蔽 |
| 自动化 | CLI 全量 --json 与 0/1/2/3/4 退出码契约;HTTP Hook 支持同步等待与每令牌限流 |
| 工具链与中间件 | 一键安装 C/C++、Java、Maven、nvm、Node、pnpm、Go、Rust、Certbot 与 Docker、PostgreSQL、MySQL、Redis、Elasticsearch |
| 多用户 | admin/user 角色、allReadable/ownerOnly 可见性、个人 API Token、Git 凭据库 |
适用场景
- 内网或自有云服务器上的应用发布与重启(systemd 服务、静态站、Java jar、Node 应用)。
- 把「巡检 / 改配置 / 清缓存」这类运维动作沉淀为可复跑、可审计的任务。
- 给 AI Agent 一个可执行的部署接口:CLI 的
--help与--json即机器可读契约,配套 Agent 技能。
不适合的场景:需要跨多台异构 Agent 调度、容器编排级发布(K8s 滚动更新等)——deploy 的执行模型是「服务端机器上的 Shell」。