github-runner
github-runner 是一套用于部署、管理和排查自托管 GitHub Actions Runner 的技能资料,覆盖 systemd 服务、Docker 容器、Kubernetes(Actions Runner Controller)以及 Scale Set Client 等部署方式。自托管 Runner 是执行 CI/CD 工作流作业的机器,可让用户掌控硬件、操作系统和工具链,但需要自行维护环境。资料按触发场景组织:搭建 CI、Runner 注册失败、自动扩缩容、安全加固、自定义镜像、网络与防火墙、标签与分组路由、监控与故障排查等。核心要点包括 ACCESS_TOKEN 与 RUNNER_TOKEN 的区别(注册需用长期有效的 PAT,RUNNER_TOKEN 仅用于注销且 60 分钟过期)、PAT 权限范围(仓库级 repo、组织级 admin:org、企业级 manage_runners:enterprise)、标签策略(默认 self-hosted + 操作系统 + 架构,多标签为 AND 逻辑)以及常见陷阱(404 注册错误、分组名称不匹配、EPHEMERAL=0 在 bash 中为真值、卷删除导致凭据丢失等)。资料还提供 docker-compose 与自定义 Dockerfile 模板,以及架构、部署、安全、扩缩容、管理、自定义镜像、网络等参考文件。