- Shell 94.9%
- HCL 2.1%
- Dockerfile 1.7%
- Rust 1.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| crates | ||
| scripts | ||
| .gitignore | ||
| .woodpecker.yml | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Containerfile | ||
| README.md | ||
| TROUBLESHOOTING.md | ||
actix-web-buildah-demo
用 Rust + actix-web 演示一条不依赖 Docker 的现代化交付链路:
源码 -> Buildah 声明式构建 OCI 镜像 -> Forgejo 私有镜像仓库
-> Nomad 编排(containerd 驱动)-> Consul 服务发现 -> Traefik 统一入口
全程使用 OCI 标准,构建用 Buildah,运行时用 containerd,编排用 Nomad,不使用任何 Docker 守护进程。
一、目标拓扑(6 台 Aliyun ECS,2C4G)
| 节点 | 角色 | 安装内容 | 说明 |
|---|---|---|---|
| Node 1 | 控制平面 | Consul Server + Nomad Server | 集群选举成员 |
| Node 2 | 控制平面 | Consul Server + Nomad Server | 集群选举成员 |
| Node 3 | 控制平面 | Consul Server + Nomad Server | 集群选举成员 |
| Node 4 | 工作平面 | containerd + Consul Client + Nomad Client + Traefik | 承载业务容器 |
| Node 5 | 工作平面 | containerd + Consul Client + Nomad Client + Traefik | 承载业务容器 |
| Node 6 | 构建机 | Buildah + Forgejo + Woodpecker | 构建镜像、托管仓库与 CI |
脚本已支持多机:所有地址由环境变量注入,单机默认
127.0.0.1。 参数全表见第五节。
组件与脚本对应关系
| 组件 | 版本 | 安装脚本 | 安装到哪台 |
|---|---|---|---|
| containerd / runc / crictl | 跟随 Docker 官方源(当前 2.4.2)/ 随 containerd.io 附带 / 1.37.0 | 01-install-environment.sh |
Node 4、5、6 |
| Buildah(Debian 官方源) | 跟随发行版(当前 1.39.3) | 01-install-environment.sh |
Node 6 |
| Forgejo(含 OCI 仓库) | 16.0.6 | 02-install-forgejo.sh |
Node 6 |
| Nomad / Consul / CNI | 跟随 HashiCorp 官方源(当前 2.1.1 / 2.1.0)/ v1.9.1 | 03-install-nomad-consul.sh |
Node 1-5 |
| 业务镜像构建 | — | 04-build-actix-image.sh |
Node 6 |
| 镜像推送到 Forgejo | — | 05-push-image-to-forgejo.sh |
Node 6 |
| Nomad 提交作业 | — | 06-deploy-with-nomad.sh |
Node 1(或任一控制面) |
| Traefik | 3.7.14 | 07-install-traefik.sh |
Node 4、5 |
| Woodpecker CI(官方 deb) | 3.20.1 | 08-install-woodpecker.sh |
Node 6 |
| 镜像导入 containerd 直跑 | — | 09-transfer-to-containerd.sh |
Node 4 或 5(单机验证用) |
二、执行顺序总览
整个流程分 5 个阶段,必须按顺序执行,后一阶段依赖前一阶段的结果。
阶段 1 基础环境 各节点装 containerd + Buildah
阶段 2 服务发现与编排 控制面组集群,工作节点加入
阶段 3 镜像交付 构建镜像 -> 推到 Forgejo
阶段 4 业务发布 Nomad 拉起容器 -> Consul 注册 -> Traefik 转发
阶段 5 CI 自动化(可选)Woodpecker 接管 构建 + 发布
三、分阶段操作
阶段 1:基础环境
Node 4 / 5(工作节点)
git clone <本仓库> ~/actix-web-buildah-demo
cd ~/actix-web-buildah-demo
sudo bash scripts/01-install-environment.sh
装完后验证:
containerd --version # 跟随 Docker 官方源,当前 v2.4.2
runc --version # 由 containerd.io 包附带
crictl version # v1.37.0
systemctl is-active containerd # active
Node 6(构建机)
cd ~/actix-web-buildah-demo
sudo bash scripts/01-install-environment.sh
同一个脚本会把 Buildah 一起装好(Debian 官方源,秒级完成,不再源码编译), 并配好普通用户的 rootless 环境。完成后用普通用户验证:
buildah --version # 跟随发行版,当前 1.39.3
buildah info | grep rootless # rootless: true
Node 1 / 2 / 3(控制面)
控制面不需要 containerd 和 Buildah,只装 Nomad/Consul,见阶段 2。
阶段 2:服务发现与编排集群
03 脚本用环境变量区分角色,同一份脚本在 5 台机器上跑:
| 变量 | 含义 | 示例 |
|---|---|---|
ROLE |
all(单机)/ server(控制面)/ client(工作节点) |
server |
INTERNAL_IP |
本机内网 IP,写入 bind_addr / advertise |
10.0.0.1 |
CONSUL_SERVERS |
全部 Consul server 地址(空格分隔) | 10.0.0.1 10.0.0.2 10.0.0.3 |
NOMAD_SERVERS |
全部 Nomad server 地址(空格分隔) | 同上 |
ROLE=server时bootstrap_expect = 3(三台一起自举成一个集群), Nomad 连本机 Consul(address = <本机IP>:8500),不都压在 Node 1 上ROLE=client时不装 server 组件,额外安装 containerd 驱动与 CNI, Nomad 连CONSUL_SERVERS里的第一台- 单机自测直接
sudo bash scripts/03-install-nomad-consul.sh(等价ROLE=all)
Node 1 / 2 / 3(控制面,三台命令完全相同)
sudo ROLE=server \
INTERNAL_IP=<本机内网IP,如 10.0.0.1> \
CONSUL_SERVERS="10.0.0.1 10.0.0.2 10.0.0.3" \
NOMAD_SERVERS="10.0.0.1 10.0.0.2 10.0.0.3" \
bash scripts/03-install-nomad-consul.sh
三台都执行完后,bootstrap_expect=3 才满足,集群选举完成(脚本内等待 leader 的超时约 30s,
若第一台先跑完就报未就绪,属正常,等三台都跑完再验证)。
Node 4 / 5(工作节点)
sudo ROLE=client \
INTERNAL_IP=<本机内网IP,如 10.0.0.4> \
CONSUL_SERVERS="10.0.0.1 10.0.0.2 10.0.0.3" \
NOMAD_SERVERS="10.0.0.1 10.0.0.2 10.0.0.3" \
bash scripts/03-install-nomad-consul.sh
Node 4/5 拉镜像要访问 Node 6 的
https://<Node6>:3000, 前提是 02 脚本用FORGEJO_DOMAIN/FORGEJO_EXTRA_IPS把 Node6 内网 IP 写进了证书 SAN (见阶段 3)。否则 containerd 会报证书不匹配。另外,Forgejo 的自签 CA 由 02 脚本公开在
https://<Node6>:3000/assets/forgejo-ca.crt,Node 4/5 跑 03 时会自动下载, 不用手动拷。下载失败时才需要手动指定:# Node 6 上取出 CA,拷到 Node 4/5 后用 FORGEJO_CA 指过去 sudo cat /etc/forgejo/tls/ca.crt sudo ROLE=client ... FORGEJO_CA=/root/forgejo-ca.crt bash scripts/03-install-nomad-consul.sh
验证集群(在任一节点执行):
consul members # 应看到 5 个节点,Node1-3 为 server
nomad server members # 应看到 3 个 server
nomad node status # 应看到 Node4/5 为 ready
阶段 3:镜像交付
Node 6:构建镜像
cd ~/actix-web-buildah-demo
bash scripts/04-build-actix-image.sh
产物:actix-web-demo:imperative(约 10MB,scratch 基础镜像 + 静态二进制)。
构建过程分 4 个阶段(planner / cook / builder / scratch),依赖由 cargo-chef 预编译。 第二次构建时只改业务代码,依赖不会重编——这是本方案的关键加速点。
Node 6:推送到 Forgejo
FORGEJO_HOST=10.0.0.6:3000 bash scripts/05-push-image-to-forgejo.sh
推送目标:https://10.0.0.6:3000/soso/actix-web-demo:imperative
FORGEJO_HOST默认localhost:3000(单机形态); 多机时在 Node 6 上执行要显式带上本机内网地址,否则推送/后续拉取地址对不上。
验证远端镜像:
curl -k -u soso:$(cat ~/.config/forgejo/token) \
https://<Node6内网IP>:3000/v2/soso/actix-web-demo/tags/list
阶段 4:业务发布
部署 Traefik(Node 4 / 5)
sudo bash scripts/07-install-traefik.sh
07默认连本机 Consul agent(自动取本机私网 IP),不再依赖某台控制面。
提交 Nomad 作业(Node 1 或任一控制面)
export NOMAD_ADDR=http://127.0.0.1:4646
REGISTRY_HOST=10.0.0.6:3000 IMAGE_TAG=imperative bash scripts/06-deploy-with-nomad.sh
REGISTRY_HOST必须是 Node 4/5 能访问到的 Forgejo 地址(容器在这些机器上拉镜像);IMAGE_TAG默认imperative,CI 触发时改用 commit 短 sha。
作业会从 Forgejo 拉取镜像,在 Node 4/5 上启动容器,并注册到 Consul。
09 脚本通过 nomad alloc status -json 拿到分配所在的节点 IP 与动态端口再探测
/health,所以多机下同样适用。
验证:
nomad job status actix-web-demo # 作业与分配状态
consul catalog services # 应出现 actix-web-demo
curl http://<Node4内网IP>:80/health # 经 Traefik 固定入口
单机快速验证(可选,Node 4 或 5)
不走 Nomad,直接把镜像导入本机 containerd 运行,用于排查镜像本身的问题:
bash scripts/09-transfer-to-containerd.sh
curl http://localhost:8080/health
阶段 5:CI 自动化(Woodpecker + Forgejo)
Node 6
# 域名入口模式(本仓库实际部署形态)
sudo FORGEJO_HOST=localhost:3000 \
FORGEJO_PUBLIC_URL=https://test.hisoso.top/git \
WP_EXTERNAL_HOST=test.hisoso.top/ci \
WP_EXTERNAL_URL=https://test.hisoso.top \
bash scripts/08-install-woodpecker.sh
纯 IP 调试时省略 FORGEJO_PUBLIC_URL、WP_EXTERNAL_*,脚本会按
http://<Node6 公网 IP> 的 Traefik 入口生成 OAuth 地址。
5.1 首次启用(只做一次)
- 浏览器打开
https://test.hisoso.top/ci,点 Login,用 Forgejo 管理员账号 (本部署为ecs-user)完成 OAuth 授权;第一个登录用户即 Woodpecker 管理员。 - 在 Woodpecker 的 Repositories 中添加并启用
ecs-user/actix-web-demo。 启用时 Woodpecker 会自动给 Forgejo 仓库建 webhook:https://test.hisoso.top/ci/api/hook?access_token=...。 - Forgejo 仓库里必须已有代码(首次从本地 push 一次
main)。 仓库为空时没有可构建的提交,流水线不会被触发。
5.2 一次 push 的完整链路
本地 git push
-> Forgejo 收到 push,投递 webhook 到 Woodpecker
-> Woodpecker server 建流水线
-> agent(local 后端,以构建机普通用户 ecs-user 身份)领取任务
-> clone 用令牌从 localhost:3000 克隆触发提交
-> build-image scripts/04-build-actix-image.sh(Buildah + cargo-chef)
-> push-image tag/login/push 到 REGISTRY_HOST/<owner>/actix-web-demo:<sha8>
-> deploy-nomad nomad job run 提交到控制面,等待 deployment 状态 successful
-> worker 用提交时注入的令牌从 Forgejo 仓库拉取镜像
-> 容器启动 /health,Consul 健康检查通过,Traefik 按标签转发 :443
deploy-nomad 每 3 秒查询一次部署状态,successful 才退出 0;
failed/cancelled 直接退出 1。Nomad 侧 update.auto_revert = true 会滚回
上一版本,业务不会停在坏版本上。
触发条件:push 到 main,或在 Woodpecker 页面手动触发(manual)。
5.3 流水线关键变量
| 变量 | 默认值 | 说明 |
|---|---|---|
FORGEJO_HOST |
localhost:3000 |
clone 用的 Forgejo 地址(构建机本机) |
REGISTRY_HOST |
172.23.53.230:3000 |
推镜像与作业镜像名,必须 worker 可达,不能写 localhost |
NOMAD_ADDR |
http://172.23.53.225:4646 |
CI 提交作业的控制面地址 |
HTTPS |
true |
业务是否走 Traefik :443;临时 HTTP 调试可设 false |
CI_REPO_OWNER |
Woodpecker 注入 | 镜像命名空间,部署时作为 registry_user 传给 Nomad |
~/.config/forgejo/token |
02 生成 | 克隆、推镜像、拉镜像共用的访问令牌 |
.woodpecker.yml 里需要留到 bash 运行期展开的变量必须写 $${VAR};
写成 ${VAR} 会被 Woodpecker 在配置期替换掉。
5.4 手工排查
systemctl status woodpecker-server woodpecker-agent
journalctl -u woodpecker-agent -f
# Forgejo 是否成功投递 webhook
journalctl -u forgejo --since "10 min ago" | grep -i webhook
# Nomad 作业与失败分配
NOMAD_ADDR=http://172.23.53.225:4646 nomad job status actix-web-demo
NOMAD_ADDR=http://172.23.53.225:4646 nomad alloc status "<分配ID>"
| 现象 | 原因 | 处理 |
|---|---|---|
Forgejo 日志 webhook can only call allowed HTTP servers |
域名解析到内网,默认策略拒绝 | [webhook] ALLOWED_HOST_LIST 加入 private(08 已处理) |
build-image 退出 125,potentially insufficient UIDs or GIDs |
agent 进程组不是用户主组,newuidmap/newgidmap 拒绝 | agent drop-in 增加 Group=<普通用户>(08 已处理) |
deploy 报镜像 not found,命名空间不对 |
作业 registry_user 与推送的 CI_REPO_OWNER 不一致 |
CI 必须传 -var "registry_user=${CI_REPO_OWNER}" |
| deploy 失败并自动回滚 | 新镜像启动失败或健康检查不过 | 看失败分配的 nomad alloc status/logs |
5.5 令牌轮换
~/.config/forgejo/token 被三处使用:
- Node 6:CI 的 clone、
buildah login/push - Node 6:CI 提交 Nomad 作业时注入镜像拉取凭据
- Node 1(或任何手工执行
06的控制面):手工部署时注入凭据
worker 不保存令牌:Nomad 作业提交时把凭据写进作业,worker 只负责拉取。 所以轮换时必须同时更新 Node 6 和 Node 1;只换 Node 6 的话 CI 正常, 但从 Node 1 手工重发作业会因旧令牌拉不到新镜像。
权限范围固定为:
read:package,write:package,write:repository,write:user
轮换步骤(在 Node 6 执行,用户名按实际替换):
FORGEJO_USER=ecs-user
SCOPES="read:package,write:package,write:repository,write:user"
NEW_NAME="nomad-pipeline-$(date +%Y%m%d%H%M%S)"
# 1) 生成新令牌(--raw 只输出令牌本身)
NEW_TOKEN="$(sudo -u git /usr/local/bin/forgejo \
--config /etc/forgejo/app.ini --work-path /var/lib/forgejo \
admin user generate-access-token \
--username "$FORGEJO_USER" --token-name "$NEW_NAME" \
--scopes "$SCOPES" --raw)"
# 2) 写入 Node 6
umask 077
printf '%s' "$NEW_TOKEN" > ~/.config/forgejo/token
printf '%s' "$SCOPES" > ~/.config/forgejo/token-scopes
# 3) 写入 Node 1
NODE1=ecs-user@172.23.53.225
printf '%s' "$NEW_TOKEN" | ssh "$NODE1" \
'umask 077; cat > ~/.config/forgejo/token; printf %s "read:package,write:package,write:repository,write:user" > ~/.config/forgejo/token-scopes'
# 4) 验证新令牌:都应返回 200 / Login Succeeded
curl -sk -o /dev/null -w '%{http_code}\n' \
-H "Authorization: token $(cat ~/.config/forgejo/token)" \
https://localhost:3000/api/v1/user
buildah login --username "$FORGEJO_USER" \
--password "$(cat ~/.config/forgejo/token)" 172.23.53.230:3000
# 5) 两台机器的令牌应完全一致
sha256sum ~/.config/forgejo/token
ssh "$NODE1" 'sha256sum ~/.config/forgejo/token'
确认新令牌可用后再作废旧令牌,避免中途把自己锁死:
FORGEJO_USER=ecs-user
PW="$(cat ~/.config/forgejo/admin-password)"
# 列出令牌,找到旧的 nomad-pipeline-<时间戳>
curl -sk -u "$FORGEJO_USER:$PW" \
"https://localhost:3000/api/v1/users/$FORGEJO_USER/tokens"
# 删除旧 id,返回 204 即成功
curl -sk -X DELETE -u "$FORGEJO_USER:$PW" \
"https://localhost:3000/api/v1/users/$FORGEJO_USER/tokens/<旧ID>"
最后确认旧令牌已失效并跑一次完整 CI:
# 旧令牌:API 与镜像仓库都应返回 401
curl -sk -o /dev/null -w '%{http_code}\n' \
-H "Authorization: token <旧令牌>" https://localhost:3000/api/v1/user
# 推一个提交触发链路,期望四个步骤全部 success
git commit --allow-empty -m "chore: 验证令牌轮换后的 CI"
git push forgejo main
验证点:Woodpecker 四个步骤成功;Nomad 作业版本递增,镜像标签等于新提交
前 8 位;https://<入口>/health 返回 200。
注意:
- 令牌明文只出现一次,不要写进仓库、命令历史或聊天记录。
- Nomad 作业历史里会保留旧令牌字段,但旧令牌已作废,无实际权限。
- 换完后两台机器的
~/.config/forgejo/token应完全一致(可用sha256sum核对)。
四、各节点清单速查
Node 1-3(控制平面,2C4G)
sudo ROLE=server INTERNAL_IP=<本机IP> \
CONSUL_SERVERS="10.0.0.1 10.0.0.2 10.0.0.3" \
NOMAD_SERVERS="10.0.0.1 10.0.0.2 10.0.0.3" \
bash scripts/03-install-nomad-consul.sh
- Consul Server(8500 / 8600 / 8300)
- Nomad Server(4646 / 4647)
Node 4-5(工作平面,2C4G)
sudo bash scripts/01-install-environment.sh
sudo ROLE=client INTERNAL_IP=<本机IP> \
CONSUL_SERVERS="10.0.0.1 10.0.0.2 10.0.0.3" \
NOMAD_SERVERS="10.0.0.1 10.0.0.2 10.0.0.3" \
bash scripts/03-install-nomad-consul.sh
sudo bash scripts/07-install-traefik.sh
- containerd + runc + crictl
- Consul Client + Nomad Client(containerd-driver + CNI)
- Traefik(:80 入口,:8081 dashboard)
Node 6(构建机,2C4G)
sudo bash scripts/01-install-environment.sh
# Node6 内网 IP 必须写进证书 SAN,Node4/5 才拉得动镜像
sudo FORGEJO_DOMAIN=10.0.0.6 FORGEJO_EXTRA_IPS="10.0.0.6" \
bash scripts/02-install-forgejo.sh
bash scripts/04-build-actix-image.sh
FORGEJO_HOST=10.0.0.6:3000 bash scripts/05-push-image-to-forgejo.sh
- containerd + runc + crictl
- Buildah(Debian 官方源,当前 1.39.3,rootless)
- Forgejo 16.0.6(Git + OCI 镜像仓库,:3000)
- 可选:Woodpecker CI(:8000 / :9000)
五、多机参数一览(脚本已支持,无需改代码)
所有地址均为环境变量 + 单机默认值,单机直接跑行为不变,多机传参即可。
| 脚本 | 参数 | 默认值 | 多机用途 |
|---|---|---|---|
03 |
ROLE |
all |
server(Node1-3) / client(Node4-5) |
03 |
INTERNAL_IP |
127.0.0.1 |
本机内网 IP → bind_addr / advertise |
03 |
CONSUL_SERVERS |
127.0.0.1 |
三台 Consul server 地址,生成 retry_join |
03 |
NOMAD_SERVERS |
127.0.0.1 |
三台 Nomad server 地址,生成 server_join |
03 |
CONSUL_ADDR |
本机 | Nomad 对接本机 Consul agent(一般不用改) |
02 |
FORGEJO_DOMAIN |
localhost |
Node 6 内网 IP/域名 → DOMAIN / ROOT_URL |
02 |
FORGEJO_EXTRA_IPS |
空 | 证书 SAN 追加地址(如 Node6 内网 IP) |
02 |
FORGEJO_EXTERNAL_HOST |
${DOMAIN}:3000 |
外部访问的 host:port |
03 |
FORGEJO_CA |
空(自动获取) | 指定手头的 Forgejo CA 文件;不填则自动用本机的或从 /assets/forgejo-ca.crt 下载 |
05 |
FORGEJO_HOST |
localhost:3000 |
推送目标仓库地址 |
06 |
REGISTRY_HOST |
localhost:3000 |
作业从哪拉镜像(Node4/5 必须可达) |
06 |
IMAGE_TAG |
imperative |
CI 触发时用 commit 短 sha |
06 |
NOMAD_ADDR |
http://127.0.0.1:4646 |
控制面地址 |
07 |
CONSUL_ADDR |
http://<本机私网IP>:8500(自动取) |
Traefik 从本机 Consul 发现后端 |
08 |
WP_EXTERNAL_HOST |
localhost:${UI_PORT} |
Woodpecker 外部地址(OAuth 回调依赖它) |
单机跑通全链路 → 再按上表多机分发,是推荐的落地顺序。
六、安全组与网络
| 方向 | 端口 | 用途 | 建议来源 |
|---|---|---|---|
| 入站 | 22 | SSH | 你的公网 IP |
| 入站 | 80 | Traefik 业务入口 | 公网或 SLB |
| 入站 | 3000 | Forgejo Web + 镜像仓库 | 内网 + 你的 IP |
| 入站 | 4646 | Nomad UI | 你的公网 IP(生产应关闭) |
| 入站 | 8500 | Consul UI | 你的公网 IP(生产应关闭) |
| 入站 | 8000 | Woodpecker UI | 你的公网 IP |
| 内网 | 全部 | 节点间集群通信 | 同一安全组互通 |
Consul 8300/8301/8302(server RPC、LAN/WAN gossip)、Nomad 4647/4648(RPC、serf) 只需内网互通,不要暴露公网。
七、常见问题
buildah bud 报 no subuid ranges found
第一次安装 01 已写入 /etc/subuid、/etc/subgid,但需要重新登录才生效。退出 SSH 重连即可。
改代码后构建依然很慢
确认 04 脚本用的是 buildah bud --layers。没有 --layers 就没有层缓存,
cargo-chef 预编译的依赖在下次构建会全部作废。
Node 4/5 的 Nomad client 一直 not ready
journalctl -u nomad -n 80 | grep -i -E "plugin|containerd"
通常是 containerd-driver 未加载或 containerd socket 无权限。检查
/opt/nomad/plugins/containerd-driver 是否存在、/run/containerd/containerd.sock 是否可访问。
06 脚本报 150s 内未就绪
多机环境下多半是上面说的 localhost 健康检查问题,容器其实已经起来了。
用 nomad job status 确认分配状态,再按第五节的方式手工验证端口。
Forgejo 镜像仓库 GET /v2/ 返回 401
令牌权限不足。重新生成令牌需包含 read:package 与 write:package:
sudo -u git /usr/local/bin/forgejo --config /etc/forgejo/app.ini \
admin user generate-access-token --username soso \
--token-name nomad-pipeline --scopes "read:package,write:package" --raw
八、卸载与环境重置
sudo bash scripts/99-uninstall-all.sh # 交互确认
sudo bash scripts/99-uninstall-all.sh --yes # 跳过确认
会停止并删除 Forgejo / Nomad / Consul / Traefik / Woodpecker / containerd 的服务、 二进制、数据目录与服务用户,并清理当前用户的 rootless 配置与构建缓存。
apt 依赖包(golang-go、libseccomp-dev、fuse-overlayfs 等)不会被卸载,
需要时手工执行脚本结尾提示的 apt-get autoremove --purge。
九、项目结构
actix-web-buildah-demo/
├── Cargo.toml # workspace 配置(含 release 优化)
├── Containerfile # Buildah 构建文件(cargo-chef 四阶段)
├── crates/
│ ├── core/ # 领域模型
│ ├── db/ # 数据访问
│ ├── api/ # HTTP 路由
│ └── server/ # 程序入口
├── .woodpecker.yml # CI 流水线定义
└── scripts/
├── 01-install-environment.sh # containerd / buildah / crictl / rootless 配置
├── 02-install-forgejo.sh # Forgejo + OCI 镜像仓库(含 TLS)
├── 03-install-nomad-consul.sh # Nomad + Consul + CNI(按角色生成配置)
├── 04-build-actix-image.sh # Containerfile 声明式构建
├── 05-push-image-to-forgejo.sh # 推送镜像到 Forgejo
├── 06-deploy-with-nomad.sh # Nomad 提交作业并等待滚动发布
├── 07-install-traefik.sh # Traefik 反向代理(固定入口)
├── 08-install-woodpecker.sh # Woodpecker CI(可选)
├── 09-transfer-to-containerd.sh # 镜像导入 containerd 直跑(单机验证)
├── 99-uninstall-all.sh # 全量卸载,回到安装前状态
└── actix-web-demo.nomad.hcl # Nomad 作业定义
编号即执行顺序:01→02→03→04 装环境,05→06 构建与推送镜像,07→08 发布并暴露入口, 08 可选接入 CI,09 为单机直跑验证,99 卸载。命令式构建的旧脚本已移除,不在本方案中。