empowill/ci

CI加速工具集成镜像

镜像概述

本镜像为CI/CD流程专用，集成了构建、测试、代码检查（lint）与部署所需的全套工具，旨在避免CI/CD环境中重复安装依赖，显著提升任务执行效率，加速Runner处理流程。

核心功能与特性

• Docker / Compose：支持Docker镜像构建、容器生命周期管理及多容器应用编排
• Golang：提供Go语言项目的编译、依赖管理与单元测试能力
• Node：支持Node.js项目的依赖安装（npm/yarn）、代码构建与测试执行
• Google Cloud SDK (gcloud)：集成GCP资源管理工具，支持云服务部署与配置
• rsync：提供高效文件同步功能，支持跨服务器/环境的文件传输与备份

使用场景与适用范围

• 多语言项目CI/CD：同时涉及Go和Node.js技术栈的应用构建与测试流程
• Docker化应用开发：需在CI环节完成Docker镜像构建、标签管理与仓库推送的场景
• GCP云服务部署：依赖Google Cloud SDK进行应用部署、资源配置的云原生项目
• 代码质量管控：需集成代码lint、静态分析等质量检查工具的开发流程
• 跨环境文件同步：需要在CI/CD流程中实现工作目录与目标服务器文件同步的场景

使用方法与配置说明

基础运行方式

通过以下命令启动容器，挂载工作目录并使用集成工具：

bash
docker run -it --rm -v $(pwd):/workspace my-ci-image:latest /bin/bash

说明：-v $(pwd):/workspace 将本地当前目录挂载至容器内/workspace，便于工具访问项目文件

典型使用示例

1. Go项目构建与测试

bash
# 在容器内执行Go项目构建与测试
cd /workspace
go mod download          # 拉取依赖
go build -o app ./cmd    # 编译应用
go test -v ./internal/...  # 执行单元测试

2. Node.js项目依赖安装与构建

bash
# 在容器内处理Node.js项目
cd /workspace
npm install              # 安装依赖
npm run lint             # 执行代码检查
npm run build            # 构建生产版本

3. Docker镜像构建与推送

bash
# 构建并推送Docker镜像（需提前配置Docker仓库认证）
cd /workspace
docker build -t my-app:v1.0 .  # 构建镜像
docker tag my-app:v1.0 registry.example.com/my-app:v1.0  # 标记镜像
docker push registry.example.com/my-app:v1.0  # 推送至仓库

4. 通过gcloud部署至GCP

bash
# 激活GCP服务账号并部署应用（需提前准备密钥文件）
gcloud auth activate-service-account --key-file=/workspace/gcp-sa-key.json
gcloud config set project my-gcp-project  # 配置目标项目
gcloud run deploy my-service --image gcr.io/my-gcp-project/my-app:v1.0 --region us-central1

5. 使用rsync同步文件至目标服务器

bash
# 将构建产物同步至目标服务器
rsync -avz /workspace/dist/ user@target-server:/var/www/app/ --delete

配置说明

本镜像无需额外环境变量或配置文件，所有工具均已预安装并配置基础路径。可通过挂载卷（如示例中的/workspace）、绑定Docker守护进程（如需使用宿主机Docker服务，可添加-v /var/run/docker.sock:/var/run/docker.sock）或映射密钥文件（如GCP服务账号密钥）实现自定义配置。