GitHub Actions Runner初始化容器阶段卡住 求助排查方案

1. 查看Runner Pod的日志与状态 #

• 定位目标Runner Pod：kubectl get pods -n <arc命名空间>
• 查看Runner容器的完整日志，重点关注容器初始化阶段的输出：kubectl logs <runner-pod名称> -n <arc命名空间> -c runner
• 若存在init容器，同步检查其日志：kubectl logs <runner-pod名称> -n <arc命名空间> -c <init容器名称>
• 通过Pod描述排查事件异常：kubectl describe pod <runner-pod名称> -n <arc命名空间>，重点看Events栏是否有资源不足、权限拒绝、镜像拉取失败等提示

2. 验证Kubernetes集群层面的资源与权限 #

• 检查节点资源余量：kubectl describe node <节点名称>，确认CPU、内存、存储未耗尽，且未触发资源配额限制
• 核查Runner使用的ServiceAccount权限：确保该账号拥有拉取镜像、创建临时容器（若使用）的必要权限
• 检查集群网络策略：确认未阻止Runner Pod与镜像仓库、GitHub API的通信
• 查看容器运行时日志：比如containerd或docker的系统日志，排查容器启动失败的底层原因

3. 排查镜像拉取与容器本身的问题 #

• 在集群节点手动拉取任务镜像，验证镜像可访问性与完整性：docker pull <任务镜像名> 或 crictl pull <任务镜像名>
• 手动运行镜像，检查entrypoint/cmd是否正常：docker run --rm <任务镜像名>，确认容器能正常启动并执行基础命令
• 若使用私有镜像，检查ARC的RunnerDeployment/RunnerSet配置：确认已正确挂载镜像拉取Secret

4. 验证ARC控制器与GitHub的交互状态 #

• 查看ARC控制器日志：kubectl logs <arc-controller-pod名称> -n <arc命名空间>，排查任务调度、Runner与GitHub通信的异常
• 核对Runner标签与工作流配置：确保工作流中runs-on指定的标签与ARC定义的Runner标签完全匹配
• 在GitHub仓库后台确认Runner状态：进入Settings -> Actions -> Runners，确认目标Runner处于在线状态且未被禁用

5. 简化工作流排查配置问题 #

• 检查工作流中container字段的配置：排查是否存在错误的镜像名、无效的端口映射或环境变量
• 尝试最简工作流测试，排除复杂配置干扰：

  jobs:
    test-container:
      runs-on: <你的ARC Runner标签>
      container:
        image: alpine:latest
      steps:
        - name: Test
          run: echo "Hello from container"
  

• 若任务需要特权模式，确认工作流中已配置：privileged: true

内容的提问来源于stack exchange，提问作者Peter