No description
  • Shell 94.9%
  • HCL 2.1%
  • Dockerfile 1.7%
  • Rust 1.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
soso 0b2326a3f1
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
文档:补充 Woodpecker/Forgejo 完整 CI 流程与令牌轮换步骤
2026-11-17 11:37:27 +08:00
crates test 2026-10-15 13:59:03 +08:00
scripts 修复 CI 构建:agent 进程组改为普通用户,rootless buildah 才能正常映射 UID 2026-11-17 11:15:37 +08:00
.gitignore cargo-chef 2026-10-14 17:13:05 +08:00
.woodpecker.yml CI 部署补传 registry_user,避免拉取错误的镜像命名空间 2026-11-17 11:19:18 +08:00
Cargo.lock 重构为多 crate workspace(core/db/api/server) 2026-10-14 17:13:07 +08:00
Cargo.toml 重构为多 crate workspace(core/db/api/server) 2026-10-14 17:13:07 +08:00
Containerfile 完善六节点部署脚本:构建机退出集群,入口改用本机 Consul 2026-11-16 14:58:48 +08:00
README.md 文档:补充 Woodpecker/Forgejo 完整 CI 流程与令牌轮换步骤 2026-11-17 11:37:27 +08:00
TROUBLESHOOTING.md 1 2026-11-13 11:26:25 +08:00

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 首次启用(只做一次)

  1. 浏览器打开 https://test.hisoso.top/ci,点 Login,用 Forgejo 管理员账号 (本部署为 ecs-user)完成 OAuth 授权;第一个登录用户即 Woodpecker 管理员。
  2. 在 Woodpecker 的 Repositories 中添加并启用 ecs-user/actix-web-demo。 启用时 Woodpecker 会自动给 Forgejo 仓库建 webhook: https://test.hisoso.top/ci/api/hook?access_token=...。
  3. 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 卸载。命令式构建的旧脚本已移除,不在本方案中。