phybuilder/action-runner-ubuntu-22.04

镜像概述

本镜像是一个专为在内部Kubernetes集群环境中运行GitHub Actions工作流设计的CI运行器。它提供了与GitHub Actions生态系统的无缝集成能力，允许团队在内部K8s基础设施上安全、高效地执行自动化构建、测试和部署任务。

核心功能和特性

• GitHub Actions兼容性：完全支持标准GitHub Actions工作流语法，可执行各类Actions步骤和任务
• Kubernetes集成：针对内部Kubernetes集群环境优化，可直接部署并运行于K8s集群中
• 安全执行环境：遵循内部安全规范，确保对内部代码仓库和资源的访问控制
• 资源优化：轻量级设计，最小化资源占用，适合在集群内进行规模化部署

使用场景和适用范围

• 企业内部CI/CD流程自动化，需在私有Kubernetes集群中执行GitHub Actions工作流
• 对代码和构建资源有严格访问控制要求的开发团队
• 需要将GitHub Actions工作流与内部Kubernetes基础设施整合的场景
• 自动化构建、测试、打包和部署内部应用程序的流程

使用方法和配置说明

基本部署

Docker Run命令示例

bash
docker run -d \
  -e GITHUB_TOKEN=<your-github-personal-access-token> \
  -e RUNNER_NAME=<custom-runner-name> \
  -e RUNNER_REPOSITORY=<github-owner/repo> \
  -e KUBERNETES_NAMESPACE=<internal-k8s-namespace> \
  --name github-actions-runner \
  <your-image-registry>/ci-runner:latest

环境变量配置

Kubernetes部署

可通过Kubernetes Deployment资源部署到内部集群：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: github-actions-runner
  namespace: ci-namespace
spec:
  replicas: 3
  selector:
    matchLabels:
      app: github-actions-runner
  template:
    metadata:
      labels:
        app: github-actions-runner
    spec:
      containers:
      - name: runner
        image: <your-image-registry>/ci-runner:latest
        env:
        - name: GITHUB_TOKEN
          valueFrom:
            secretKeyRef:
              name: github-secrets
              key: token
        - name: RUNNER_REPOSITORY
          value: "your-org/your-repo"
        - name: KUBERNETES_NAMESPACE
          value: "ci-namespace"
        - name: RUNNER_LABELS
          value: "k8s,internal,ci"

注意事项

• 确保GITHUB_TOKEN具有足够权限（至少需要repo范围）
• 内部Kubernetes集群需能访问GitHub API
• 根据工作负载需求调整资源限制（CPU/内存）
• 定期更新镜像以获取最新安全补丁和功能改进