主题
Docker 部署
镜像构建
Dockerfile 是多阶段构建:Node 22 构建前端 → Go 1.24 编译后端 (前端产物替换占位页后 embed)→ 最终镜像只留一个二进制。
构建上下文必须是仓库根目录——Dockerfile 要同时看到 deploy-server/ 与 deploy-server-ui/:
bash
# 在仓库根目录执行
docker build -t deploy-server:local -f deploy-server/Dockerfile .
# 指定写入二进制的版本号(默认 0.1.0)
docker build -t deploy-server:1.2.3 --build-arg VERSION=1.2.3 \
-f deploy-server/Dockerfile .
# 也可以用 make(内部就是切到仓库根再 build)
cd deploy-server && make docker运行
bash
docker run -d --name deploy-server \
-p 127.0.0.1:10055:10055 \
-v /srv/deploy/data:/data \
-v /srv/deploy/workspaces:/workspaces \
--restart unless-stopped deploy-server:local要点:
- 镜像声明了
VOLUME ["/data", "/workspaces"],务必显式挂载到宿主机 目录,否则容器重建即丢数据库、密钥与日志; - 默认命令为
-listen 0.0.0.0:10055 -data-dir /data -web-root /workspaces, 监听容器内全部网卡;端口映射示例绑定宿主机回环127.0.0.1, 对外仍应走反代 + HTTPS(配置见 05); - 配置也可用环境变量注入:
-e DEPLOY_SERVER_URL=https://deploy.example.com等,全部变量见 01; - 镜像内置
TZ=Asia/Shanghai,需要其他时区用-e TZ=...覆盖; - 健康检查与版本:
bash
curl -fsS http://127.0.0.1:10055/api/v1/healthz
docker exec deploy-server deploy-server version镜像内置工具
运行层基于 debian:bookworm-slim,预装:
text
git bash curl ca-certificates rsync openssh-client tzdata这保证「开箱能跑基本部署」,但平台不代替你安装完整工具链: node、go、java、docker CLI 等按项目需要自行装进镜像(推荐派生镜像 FROM deploy-server:local 再补装),或用平台的工具链/中间件面板 安装到容器内。环境自检页会报告缺什么。
容器内执行的边界
项目命令在容器内执行,这决定了它与 systemd 形态的本质差异:
- 容器内的
systemctl管不了宿主机服务;要重启宿主机上的 Nginx/应用, 要么改用 systemd 直部署,要么把部署目标本身容器化并通过挂载的 docker socket 操作(有安全风险,需自行评估); - 访问宿主机目录必须显式挂载,例如把站点目录挂进来:
-v /var/www/site:/var/www/site,脚本里 rsync 到该路径; - 容器内安装的工具在容器重建后消失,持久化要么进镜像、要么挂卷;
- SSH 凭据/公钥作用于容器内运行用户的
~/.ssh,重建容器会丢, 需要挂载或改用数据库里的ssh_key凭据(见 04)。
与 systemd 形态的选择
| 场景 | 建议形态 |
|---|---|
| 部署宿主机应用、管理宿主机服务与目录 | systemd 直部署(05) |
| 部署目标本身是容器、构建环境要求可复现 | Docker |
| 快速试用、不想污染宿主机 | Docker(数据卷挂好即可) |
两种形态的数据目录结构完全一致,迁移时把 data/ 与 workspaces/ 整体搬移即可,密钥文件一并带走,见 07 升级、备份与恢复。
升级镜像
bash
docker build -t deploy-server:new -f deploy-server/Dockerfile .
docker stop deploy-server && docker rm deploy-server
docker run -d --name deploy-server \
-p 127.0.0.1:10055:10055 \
-v /srv/deploy/data:/data \
-v /srv/deploy/workspaces:/workspaces \
--restart unless-stopped deploy-server:new升级前建议先备份数据卷,流程见 07。