Skip to content

什么是 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」。

下一步 ​