From 330aea4d16245ad936e057ed366c0d88c736afcc Mon Sep 17 00:00:00 2001 From: voson Date: Fri, 30 Jan 2026 11:02:08 +0800 Subject: [PATCH] =?UTF-8?q?refactor(gitea):=20=E4=BC=98=E5=8C=96=20runner?= =?UTF-8?q?=20=E6=A0=87=E7=AD=BE=E7=B3=BB=E7=BB=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit **标签简化**： - 移除所有标签的 :host 后缀重复，统一添加单个 host 标签 - 删除私网 IP 标签（不适用于实际场景） **发行版检测增强**： - 自动检测 Linux 发行版（debian, ubuntu, centos 等） - 添加发行版版本标签（如 debian-12, ubuntu-22） - 保留 ubuntu-latest 作为兼容标签，适用于所有 Linux 系统 **新的标签结构**： - 基础标签：host, ubuntu-latest, self-hosted, x64, linux-x86_64 - 发行版标签：debian, debian-12, linux（实际系统信息） - 配置标签：4c3g（保留，用于资源调度） **标签示例（Debian 12）**： host, ubuntu-latest, self-hosted, x64, linux-x86_64, debian, debian-12, linux, 4c3g **优势**： - 更简洁的标签结构 - 精确的系统信息（实际发行版） - 保持 GitHub Actions 兼容性（ubuntu-latest） - 支持多种匹配策略（兼容模式、精确模式、配置筛选） --- skill/gitea/create-runner.md | 126 +++++++++++++++++++++++++---------- 1 file changed, 92 insertions(+), 34 deletions(-) diff --git a/skill/gitea/create-runner.md b/skill/gitea/create-runner.md index deb1a49..8a0663c 100644 --- a/skill/gitea/create-runner.md +++ b/skill/gitea/create-runner.md @@ -22,33 +22,62 @@ agent: general Runner 会自动检测系统配置并生成以下标签： -**标准标签**： -- `ubuntu-latest:host` - 兼容 GitHub Actions（仅 Linux） -- `ubuntu:host` / `macOS:host` - 操作系统 -- `self-hosted:host` - 自托管标识 -- `x64:host` / `ARM64:host` - CPU 架构 -- `linux-x86_64:host` / `darwin-arm64:host` - 系统-架构组合 +**基础标签**： +- `host` - 运行模式标识 +- `self-hosted` - 自托管标识 +- `ubuntu-latest` - GitHub Actions 兼容标签（所有 Linux 系统） +- `x64` / `ARM64` - CPU 架构 +- `linux-x86_64` / `darwin-arm64` - 系统-架构组合 + +**发行版标签**（自动检测）： +- `debian` - Debian 系统 +- `debian-12` - Debian 12 版本 +- `ubuntu` - Ubuntu 系统 +- `ubuntu-22` - Ubuntu 22.04 版本 +- `centos` - CentOS 系统 +- `macOS` - macOS 系统 +- `linux` - 通用 Linux 标签 **设备配置标签**（自动检测）： -- `4c8g:host` - CPU核心数 + 内存大小（如 4核8G） -- `ip-172-20-0-81:host` - 服务器 IP 地址 +- `4c8g` - CPU 核心数 + 内存大小（如 4核8G内存） -**示例**： +**标签示例（Debian 12 系统）**： ``` -ubuntu-latest:host, ubuntu:host, self-hosted:host, x64:host, -linux-x86_64:host, 4c8g:host, ip-172-20-0-81:host +host, ubuntu-latest, self-hosted, x64, linux-x86_64, +debian, debian-12, linux, 4c3g +``` + +**标签示例（Ubuntu 22.04 系统）**： +``` +host, ubuntu-latest, self-hosted, x64, linux-x86_64, +ubuntu, ubuntu-22, linux, 8c16g +``` + +**标签示例（macOS ARM64 系统）**： +``` +host, ubuntu-latest, self-hosted, ARM64, darwin-arm64, +macOS, 8c16g ``` **在 Workflow 中使用**： ```yaml -# 使用标准标签 +# 兼容模式 - 匹配所有 Linux Host Runner runs-on: ubuntu-latest -# 使用配置标签筛选特定配置的 runner -runs-on: [self-hosted, 4c8g] +# 精确匹配 - 只在 Debian 系统上运行 +runs-on: [self-hosted, debian] -# 使用 IP 标签指定特定服务器 -runs-on: [self-hosted, ip-172-20-0-81] +# 更精确 - 指定 Debian 版本 +runs-on: [self-hosted, debian-12] + +# 根据配置筛选 - 需要 8核16G 的 runner +runs-on: [self-hosted, 8c16g] + +# 组合条件 - Debian 系统且 8核16G +runs-on: [debian, 8c16g] + +# macOS 环境 +runs-on: [self-hosted, macOS] ``` ### Docker 模式标签 @@ -59,6 +88,12 @@ Docker 模式使用预定义的镜像映射： - `ubuntu-20.04:docker://catthehacker/ubuntu:act-20.04` - `linux:docker://catthehacker/ubuntu:act-latest` +**标签设计说明**： +1. **`ubuntu-latest` 是兼容标签**：所有 Linux Host Runner 都包含此标签，方便兼容 GitHub Actions workflow +2. **实际发行版标签提供精确控制**：如 `debian`、`ubuntu` 等，用于需要特定系统的场景 +3. **`host` 标签**：用于区分 Host 模式和 Docker 模式的 runner +4. **配置标签**：如 `4c8g`，方便根据资源需求调度任务 + ## 📦 快速使用 ### 方法一：直接执行（推荐） @@ -665,42 +700,65 @@ create_runner() { if [ "$mode" = "host" ]; then OS=$(uname -s) - case "$OS" in - Darwin) os_label="macOS" ;; - Linux) os_label="ubuntu" ;; - *) os_label="unknown" ;; - esac - ARCH=$(uname -m) + + # 检测架构 case "$ARCH" in arm64|aarch64) arch_label="ARM64" ;; x86_64) arch_label="x64" ;; *) arch_label="unknown" ;; esac + # 检测操作系统和发行版 + if [ "$OS" = "Darwin" ]; then + os_label="macOS" + distro_label="" + distro_version_label="" + elif [ "$OS" = "Linux" ]; then + # 检测 Linux 发行版 + if [ -f /etc/os-release ]; then + . /etc/os-release + distro_label="$ID" # debian, ubuntu, centos, etc. + distro_version_label="${ID}-${VERSION_ID%%.*}" # debian-12, ubuntu-22, etc. + else + distro_label="linux" + distro_version_label="" + fi + os_label="$distro_label" + else + os_label="unknown" + distro_label="" + distro_version_label="" + fi + # 检测设备配置 cpu_cores=$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo "unknown") mem_gb=$(free -g 2>/dev/null | awk '/^Mem:/{print $2}' || sysctl -n hw.memsize 2>/dev/null | awk '{print int($1/1024/1024/1024)}' || echo "unknown") - ip_addr=$(hostname -I 2>/dev/null | awk '{print $1}' || ipconfig getifaddr en0 2>/dev/null || echo "unknown") - ip_label=$(echo "$ip_addr" | tr '.' '-') combined=$(echo "${OS}-${ARCH}" | tr '[:upper:]' '[:lower:]') + # 构建标签（移除 :host 后缀，统一添加 host 模式标签） # 添加 ubuntu-latest 以兼容 GitHub Actions workflow - if [ "$os_label" = "ubuntu" ]; then - labels="ubuntu-latest:host,ubuntu:host,self-hosted:host,${arch_label}:host,${combined}:host" - else - labels="self-hosted:host,${os_label}:host,${arch_label}:host,${combined}:host" + labels="host,ubuntu-latest,self-hosted,${arch_label},${combined}" + + # 添加实际发行版标签 + if [ -n "$distro_label" ] && [ "$distro_label" != "linux" ]; then + labels="${labels},${distro_label}" + if [ -n "$distro_version_label" ]; then + labels="${labels},${distro_version_label}" + fi + elif [ "$os_label" != "unknown" ]; then + labels="${labels},${os_label}" + fi + + # 添加通用 linux 标签（用于区分 macOS） + if [ "$OS" = "Linux" ]; then + labels="${labels},linux" fi # 添加设备配置标签 if [ "$cpu_cores" != "unknown" ] && [ "$mem_gb" != "unknown" ]; then - labels="${labels},${cpu_cores}c${mem_gb}g:host" - fi - - # 添加 IP 标签 - if [ "$ip_addr" != "unknown" ]; then - labels="${labels},ip-${ip_label}:host" + labels="${labels},${cpu_cores}c${mem_gb}g" fi else