Gitea Act CI/CD工具集成镜像

镜像概述与主要用途

该Docker镜像基于Gitea Act构建，集成多种常用CI/CD工具，提供本地运行Gitea Actions工作流的完整环境。无需依赖远程Gitea服务器，开发者可在本地开发环境中快速运行、测试和调试Gitea Actions工作流，验证自动化逻辑及工具链兼容性。

核心功能与特性

• Gitea Act完整支持：兼容Gitea Actions语法，可直接运行项目中.gitea/workflows/目录下的工作流文件
• 丰富工具集：预安装以下CI/CD常用工具：
  • Kubernetes生态：kubectl（Kubernetes命令行工具）、helm（Kubernetes包管理器）、kustomize（Kubernetes配置管理）
  • 基础设施即代码：terraform（多云资源编排工具）
  • 配置文件处理：yamllint（YAML语法校验）、yq（YAML处理工具）、jq（JSON处理工具）
• 轻量级设计：基于精简基础镜像构建，启动快速且资源占用低
• 即开即用：无需手动安装依赖，拉取镜像后可直接运行工作流

使用场景与适用范围

• 本地工作流调试：开发者在提交代码前，本地验证Gitea Actions工作流是否正常执行
• CI/CD流程测试：测试工作流中涉及kubectl部署、helm打包、terraform资源创建等操作的逻辑正确性
• 工具链兼容性验证：确保工作流中使用的各类工具版本匹配，避免因版本差异导致的执行失败
• 自动化脚本开发：编写涉及YAML/JSON处理（如yq/jq）、配置校验（如yamllint）的自动化脚本时，提供一致的运行环境
• 团队协作环境统一：标准化开发环境，减少因本地工具缺失或版本不一致导致的协作问题

使用方法与配置说明

基本使用流程

1. 拉取镜像

docker pull [镜像标签]  # 替换为实际镜像标签，如gitea-act-cicd:latest

2. 列出可用工作流

挂载当前项目目录（需包含.gitea/workflows/）到容器，查看工作流列表：

docker run --rm -it \
  -v $(pwd):/workspace \  # 挂载本地项目到容器工作目录
  -w /workspace \          # 设置容器工作目录
  [镜像标签] \
  act -l                   # 列出项目中的Gitea Actions工作流

3. 执行指定工作流

运行项目中名为ci-test.yml的工作流：

docker run --rm -it \
  -v $(pwd):/workspace \
  -w /workspace \
  [镜像标签] \
  act -W .gitea/workflows/ci-test.yml  # -W指定工作流文件路径

高级配置

传递环境变量

通过-e参数为工作流传递环境变量（如API密钥、配置参数）：

docker run --rm -it \
  -v $(pwd):/workspace \
  -w /workspace \
  -e "APP_ENV=production" \  # 传递环境变量
  -e "API_TOKEN=xxx" \
  [镜像标签] \
  act

挂载外部配置文件

如需使用本地工具配置（如kubectl集群配置、helm仓库配置），可通过挂载文件实现：

# 挂载kubectl配置示例（用于集群访问）
docker run --rm -it \
  -v $(pwd):/workspace \
  -v ~/.kube/config:/root/.kube/config \  # 挂载本地kubectl配置
  -w /workspace \
  [镜像标签] \
  act -W .gitea/workflows/deploy.yml

工具直接调用

可进入容器交互模式，直接使用集成的工具：

# 进入容器终端
docker run --rm -it \
  -v $(pwd):/workspace \
  -w /workspace \
  [镜像标签] \
  sh

# 在容器内使用工具示例
kubectl version --client          # 查看kubectl版本
helm list --all-namespaces        # 查看helm发布（需挂载kubeconfig）
terraform init                    # 初始化terraform项目
yamllint deployment.yaml          # 校验YAML文件语法
yq eval '.spec.replicas' deployment.yaml  # 使用yq提取YAML字段
jq '.data' config.json            # 使用jq处理JSON文件