SHA256
forked from course-team/tjhlp-gitea
feat(ci): 落地 main 自动部署的可复用件(runner 配置/部署脚本/定制断言/工作流)
按 deploy/ci-cd.md 方案把除推送触发之外的东西都准备好:
- customization/check.sh <base-url>: 把 preview.sh check 里的"定制生效"断言抽成
任意实例可跑的脚本(首页/页脚/meta/官网链接/登录页两张卡/无通行密钥方框/
无「工单」/无 example.com), 另加生产才有的 OIDC 入口 307 断言(404 = 认证源没注册上)。
实测对生产 17/17 通过。
- deploy/scripts/auto-deploy.sh: build.py -> compose up -d -> verify.sh + check.sh,
失败自动回滚到 deploy/.state/last-deployed; flock 串行; 结束时把 clone 所有权还给
ymy(job 容器里是 root); 内网验证强制不走代理。
- deploy/runner/{compose.yaml,config.yaml,.env.example}: act_runner v0.6.1 跑在容器里
(不需要 root), network: host + 同路径挂载部署克隆 + 宿主 docker CLI/compose 插件,
capacity 1 保证部署串行。
- .gitea/workflows/deploy.yml: push main + workflow_dispatch, [skip deploy] 跳过,
concurrency 串行, 只做"同步到 github.sha + 调 auto-deploy.sh"。
- .gitignore: deploy/.state/、deploy/runner/{.env,data/}。
依据见 deploy/ci-cd.md(含全部实测证据与待确认项)。
This commit is contained in:
@@ -0,0 +1,10 @@
|
||||
# 复制成 .env 后填写(deploy/runner/.env 已 gitignore)
|
||||
#
|
||||
# RUNNER_REGISTRATION_TOKEN: 仓库 → Settings → Actions → Runners → 创建 Runner 时给的令牌。
|
||||
# 一次性, 用完即弃; 注册成功后身份存在 ./data/.runner, 重启不会再注册。
|
||||
RUNNER_REGISTRATION_TOKEN=
|
||||
|
||||
# 默认值在 compose.yaml 里, 需要时再覆盖
|
||||
#GITEA_INSTANCE_URL=https://cpp.tongji.sh/QA
|
||||
#RUNNER_NAME=tjhlp-gitea-1
|
||||
# runner 的 label 不在这里配: 以 config.yaml 的 runner.labels 为准(实测 env 会被忽略)
|
||||
@@ -0,0 +1,33 @@
|
||||
# Gitea Actions runner —— 跑在容器里, 由 docker 自己拉起(不需要 root, ymy 在 docker 组即可)。
|
||||
#
|
||||
# cd deploy/runner
|
||||
# cp .env.example .env # 填 RUNNER_REGISTRATION_TOKEN(仓库 → Settings → Actions → Runners)
|
||||
# docker compose up -d
|
||||
# docker compose logs -f runner
|
||||
#
|
||||
# 详见 ../ci-cd.md §4.2。注册结果存在 ./data/.runner, 重启不会重复注册。
|
||||
name: gitea-runner
|
||||
|
||||
services:
|
||||
runner:
|
||||
image: gitea/act_runner:latest # 实测 arm64 / v0.6.1
|
||||
container_name: gitea-runner
|
||||
restart: unless-stopped
|
||||
environment:
|
||||
# 变量名与镜像里 /usr/local/bin/run.sh 一致
|
||||
GITEA_INSTANCE_URL: ${GITEA_INSTANCE_URL:-https://cpp.tongji.sh/QA}
|
||||
GITEA_RUNNER_REGISTRATION_TOKEN: ${RUNNER_REGISTRATION_TOKEN:?deploy/runner/.env 里给 RUNNER_REGISTRATION_TOKEN}
|
||||
GITEA_RUNNER_NAME: ${RUNNER_NAME:-tjhlp-gitea-1}
|
||||
# 注意: 不要在这里设 GITEA_RUNNER_LABELS —— act_runner 会警告
|
||||
# "Labels from command will be ignored, use labels defined in config file.",
|
||||
# label 以 config.yaml 的 runner.labels 为准(实测)。
|
||||
CONFIG_FILE: /config/config.yaml
|
||||
volumes:
|
||||
- /var/run/docker.sock:/var/run/docker.sock # runner 用它拉起 job 容器
|
||||
- ./data:/data # 注册凭据 / 缓存(gitignore)
|
||||
- ./config.yaml:/config/config.yaml:ro
|
||||
logging:
|
||||
driver: json-file
|
||||
options:
|
||||
max-size: "10m"
|
||||
max-file: "3"
|
||||
@@ -0,0 +1,36 @@
|
||||
# act_runner 配置 —— 关键项都有注释, 依据是 act_runner v0.6.1 自带的 generate-config 输出。
|
||||
log:
|
||||
level: info
|
||||
|
||||
runner:
|
||||
file: /data/.runner # 与 compose.yaml 的 ./data 挂载对应; 注册后保存在这里
|
||||
capacity: 1 # 部署必须串行: 一次只跑一个 job
|
||||
timeout: 30m
|
||||
labels:
|
||||
# job 跑在容器里(network: host), 镜像用 Gitea 官方 runner 镜像(实测 arm64 可用)。
|
||||
# 换成 catthehacker/ubuntu:act-22.04 也可以; 记得同步 compose.yaml 的 GITEA_RUNNER_LABELS。
|
||||
- "self-hosted:docker://docker.gitea.com/runner-images:ubuntu-22.04"
|
||||
|
||||
container:
|
||||
# host: job 容器与宿主共用网络 —— verify.sh 里对 127.0.0.1:2080 的检查才有效,
|
||||
# 10.80.42.185 也不需要额外放行。
|
||||
network: host
|
||||
# ★ 不要在这里挂 /var/run/docker.sock: act_runner 会自动把 docker daemon socket
|
||||
# 挂进 job 容器(container.docker_host 的默认行为), 再挂一次会直接失败:
|
||||
# failed to create container: 'Duplicate mount point: /var/run/docker.sock'
|
||||
# (2026-09-13 用 `act_runner exec` 预演 job 时实测踩到 —— 若没预演, 第一次真实
|
||||
# 部署就会以这个错误告终。)
|
||||
#
|
||||
# 下面这些挂载是 act_runner 不管的:
|
||||
# * 部署克隆同路径挂载: job 容器里 `docker compose` 会把相对挂载解析成绝对路径后
|
||||
# 交给宿主 daemon, 两边路径必须一致, 否则会挂到空目录;
|
||||
# * 宿主 docker CLI + compose 插件: 不依赖 job 镜像里带没带(宿主是 glibc, Ubuntu 镜像能用)。
|
||||
options: >-
|
||||
--volume /home/ymy/deploy:/home/ymy/deploy
|
||||
--volume /usr/bin/docker:/usr/bin/docker:ro
|
||||
--volume /usr/libexec/docker/cli-plugins:/usr/libexec/docker/cli-plugins:ro
|
||||
force_pull: false # 镜像本地已有就不再拉
|
||||
|
||||
cache:
|
||||
enabled: true
|
||||
dir: /data/cache
|
||||
Reference in New Issue
Block a user