voipbin/gitlab-runner

voipbin-gitlab_runner

镜像概述和主要用途

voipbin-gitlab_runner是专为voipbin项目设计的基础GitLab Runner镜像，旨在提供一站式的CI/CD环境支持。该镜像集成了项目开发、部署过程中常用的各类工具，可直接用于GitLab CI/CD流水线，简化环境配置流程，提升开发部署效率。

核心功能和特性

该镜像包含以下核心工具和组件：

• GCP SDK：用于Google Cloud Platform资源管理和操作
• Ansible：自动化配置管理和应用部署工具
• Terraform：基础设施即代码（IaC）工具，用于云资源编排
• Golang：Go语言开发环境
• Git：版本控制工具
• Python3：Python运行环境
• GCC：GNU编译器集合，用于C/C++等语言编译
• Kustomize：Kubernetes配置管理工具
• alembic：数据库迁移工具（基于SQLAlchemy）

使用场景和适用范围

• voipbin项目的持续集成（CI）流程，包括代码拉取、编译、测试等环节
• voipbin项目的持续部署（CD）流程，支持通过Ansible、Terraform等工具进行环境部署和资源管理
• 需要Golang开发环境的项目构建任务
• 涉及GCP云资源操作、Kubernetes配置管理的自动化流程
• 数据库版本迁移（通过alembic）的自动化执行

使用方法和配置说明

基本使用方式

将该镜像作为GitLab Runner的执行环境，需先在GitLab中注册Runner，并指定该镜像作为执行器。

Docker运行示例

bash
# 拉取镜像
docker pull [镜像仓库地址]/voipbin-gitlab_runner:latest

# 运行容器（需结合GitLab Runner注册流程）
docker run -d --name voipbin-runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /etc/gitlab-runner:/etc/gitlab-runner \
  [镜像仓库地址]/voipbin-gitlab_runner:latest

GitLab CI/CD配置示例

在项目的.gitlab-ci.yml中可直接使用该镜像：

yaml
stages:
  - build
  - deploy

build:
  stage: build
  image: [镜像仓库地址]/voipbin-gitlab_runner:latest
  script:
    - go version  # 验证Golang环境
    - terraform --version  # 验证Terraform环境
    - ansible --version  # 验证Ansible环境
    - go build -o app main.go  # 编译Go应用

deploy:
  stage: deploy
  image: [镜像仓库地址]/voipbin-gitlab_runner:latest
  script:
    - gcloud auth activate-service-account --key-file=key.json  # GCP认证
    - terraform init && terraform apply -auto-approve  # 部署基础设施
    - ansible-playbook deploy.yml  # 应用部署

注意事项

• 使用前需确保GitLab Runner已正确注册并配置
• 涉及敏感信息（如GCP密钥）建议通过GitLab CI/CD变量管理
• 根据实际需求调整容器挂载卷（如持久化Runner配置）