From 725c6b1d65500e9b2f6da4b931a6240b2ea962e4 Mon Sep 17 00:00:00 2001 From: Matrix Music Bot Dev Date: Fri, 3 Jul 2026 00:16:47 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20.gitea=20=E6=96=87=E6=A1=A3=E8=AE=B0?= =?UTF-8?q?=E5=BD=95=20hermes-runner=20=E6=A0=87=E7=AD=BE=20+=20workflow?= =?UTF-8?q?=20=E5=90=8C=E6=AD=A5=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 变更： - .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"状态。 --- .gitea/README.md | 6 ++++-- .gitea/workflows/build-image.yml | 2 ++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/.gitea/README.md b/.gitea/README.md index 17df45c..cf283f0 100644 --- a/.gitea/README.md +++ b/.gitea/README.md @@ -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 \ - --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. **网络可达性** diff --git a/.gitea/workflows/build-image.yml b/.gitea/workflows/build-image.yml index d68577f..91def52 100644 --- a/.gitea/workflows/build-image.yml +++ b/.gitea/workflows/build-image.yml @@ -8,6 +8,8 @@ # 前置要求： # 1. Gitea 实例已开启 Container Registry（packages 功能） # 2. 仓库已注册一个 Gitea Actions runner（带 docker 能力） +# 当前实例的 runner：hermes-runner，标签 ubuntu-22.04（全局） +# 若用其它 runner，请同步修改下面 jobs 里的 runs-on: ubuntu-22.04 # 3. 仓库设置 → Actions → Secrets 无需手动配置 # （本 workflow 使用 Gitea 内置的 ${{ gitea.token }} 自动认证）