livelink/terragrunt

Dice CI/CD Runner 镜像文档

镜像概述

Dice CI/CD Runner 是专为Dice平台设计的任务执行组件，作为CI/CD流水线的核心执行单元，负责接收并处理Dice平台下发的自动化任务，包括代码拉取、构建编译、自动化测试、产物打包及应用部署等全流程操作，支持与Dice平台的深度集成和任务生命周期管理。

核心功能与特性

核心功能

• 任务执行：接收并执行Dice平台定义的CI/CD流水线任务，支持多步骤任务流程
• 环境管理：自动配置任务所需的运行环境，支持多种编程语言和构建工具
• 状态同步：实时向Dice平台上报任务进度、状态及结果
• 日志采集：完整记录任务执行日志，支持实时查看和历史追溯

主要特性

• 平台集成：与Dice平台无缝对接，支持任务调度、资源分配和权限控制
• 隔离性：基于容器化技术实现任务环境隔离，避免依赖冲突
• 可扩展性：支持水平扩展，通过多实例部署提升任务并发处理能力
• 资源控制：支持CPU、内存等资源限制，确保任务执行稳定性
• 兼容性：支持Maven、Gradle、npm、Go等主流构建工具和运行时环境

使用场景与适用范围

典型使用场景

• 企业级CI/CD流水线：构建从代码提交到应用部署的全自动化流程
• 自动化测试：集成单元测试、集成测试、性能测试等自动化测试环节
• 持续部署：支持将构建产物自动部署至开发、测试、预发及生产环境
• 多环境适配：满足不同环境（如开发、测试、生产）的差异化部署需求

适用范围

• 使用Dice平台进行DevOps管理的企业或开发团队
• 需要标准化、自动化软件交付流程的中大型软件开发项目
• 对任务执行效率、稳定性和可追溯性有较高要求的场景

使用方法与配置说明

环境要求

• Docker 19.03及以上版本
• 网络可访问Dice平台服务端
• 最低配置：2核CPU、4GB内存、20GB可用磁盘空间

部署方式

1. Docker Run 部署

bash
docker run -d \
  --name dice-cicd-runner \
  --restart always \
  -e DICE_SERVER=https://dice.example.com \
  -e RUNNER_TOKEN=your_auth_token \
  -e RUNNER_LABELS=build,test \
  -e RESOURCE_CPU=2 \
  -e RESOURCE_MEM=4G \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /data/dice-runner:/runner/workspace \
  dice/cicd-runner:latest

2. Docker Compose 部署

yaml
version: '3.8'
services:
  dice-runner:
    image: dice/cicd-runner:latest
    container_name: dice-cicd-runner
    restart: always
    environment:
      - DICE_SERVER=https://dice.example.com  # Dice平台服务端地址
      - RUNNER_TOKEN=your_auth_token          # 与Dice平台通信的认证令牌
      - RUNNER_NAME=runner-node-01            # 运行器名称（可选，默认自动生成）
      - RUNNER_LABELS=build,test,deploy       # 运行器标签，用于任务调度匹配（可选）
      - RESOURCE_CPU=2                        # CPU资源限制（单位：核，可选）
      - RESOURCE_MEM=4G                       # 内存资源限制（可选）
      - LOG_LEVEL=info                        # 日志级别（debug/info/warn/error，默认info）
      - TASK_TIMEOUT=120                      # 单个任务超时时间（单位：分钟，默认60）
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载Docker套接字（如需容器内构建）
      - /data/dice-runner:/runner/workspace        # 工作目录，存储任务数据和缓存
    network_mode: bridge

配置参数说明

环境变量配置

数据卷说明

• /var/run/docker.sock：如需在任务中使用Docker（如构建镜像），需挂载宿主机Docker套接字
• /runner/workspace：任务工作目录，用于存储代码、依赖和构建产物
• /runner/cache：构建缓存目录，用于加速重复构建（如启用缓存）

任务执行流程

1. 连接平台：运行器启动后通过DICE_SERVER和RUNNER_TOKEN与Dice平台建立连接
2. 任务接收：监听并接收Dice平台下发的CI/CD任务
3. 环境准备：根据任务定义拉取代码、配置环境变量、安装依赖
4. 任务执行：按步骤执行构建、测试、部署等任务操作
5. 状态上报：实时向Dice平台推送任务进度、日志和执行结果
6. 资源清理：任务完成后清理临时文件和环境（可选保留缓存）

注意事项

• 令牌安全：RUNNER_TOKEN为敏感信息，需妥善保管，避免泄露
• 资源配置：根据实际任务需求调整CPU/内存限制，避免资源不足导致任务失败
• 网络连通性：确保运行器可访问Dice平台、代码仓库及目标部署环境
• 存储管理：定期清理工作目录和缓存，避免磁盘空间溢出
• 版本更新：建议定期更新镜像版本以获取最新功能和安全修复