docs: .gitea 文档记录 hermes-runner 标签 + workflow 同步注释
build-and-push-image / build-push (push) Failing after 17m29s
build-and-push-image / vulnerability-scan (push) Has been skipped

变更:
  - .gitea/README.md 记录 Gitea 实例已有的 hermes-runner
    (标签 ubuntu-22.04,全局),避免后续再猜错标签
  - build-image.yml 顶部注释更新:标明 runner 实际标签
  - README 注册命令示例从 --labels ubuntu-latest:docker 改为
    --labels ubuntu-22.04(与实际匹配)

运维经验:act_runner --labels 标签必须与 workflow runs-on 一致,
否则 job 会一直显示"等待 runner"状态。
This commit is contained in:
Matrix Music Bot Dev
2026-07-03 00:16:47 +08:00
parent 89ee450d6e
commit 725c6b1d65
2 changed files with 6 additions and 2 deletions
+4 -2
View File
@@ -59,16 +59,18 @@ services:
chmod +x act_runner-0.2.11-linux-amd64
mv act_runner-0.2.11-linux-amd64 /usr/local/bin/act_runner
# 2. 注册 runner(用 Gitea UI 提供的注册 token
# 2. 注册 runner(用 Gitea UI 提供的注册 token;标签要记好!
act_runner register \
--instance http://192.168.6.200:3080 \
--token <RUNNER_REGISTRATION_TOKEN> \
--labels ubuntu-latest:docker
--labels ubuntu-22.04 # ← 必须与 workflow 中 runs-on 一致
# 3. 启动 runner(前台或 daemon
act_runner daemon
```
- **重要**`--labels` 指定的标签必须与 workflow 中 `runs-on` 完全一致
- 本项目 Gitea 实例现有 runner`hermes-runner`,标签 `ubuntu-22.04`(全局)
- Runner 必须有 `docker buildx` 可用(Docker 20.10+
3. **网络可达性**
+2
View File
@@ -8,6 +8,8 @@
# 前置要求:
# 1. Gitea 实例已开启 Container Registrypackages 功能)
# 2. 仓库已注册一个 Gitea Actions runner(带 docker 能力)
# 当前实例的 runnerhermes-runner,标签 ubuntu-22.04(全局)
# 若用其它 runner,请同步修改下面 jobs 里的 runs-on: ubuntu-22.04
# 3. 仓库设置 → Actions → Secrets 无需手动配置
# (本 workflow 使用 Gitea 内置的 ${{ gitea.token }} 自动认证)