cloudbees/cloudbees-core-agent

CloudBees CI代理镜像文档

镜像概述

本镜像为CloudBees CI的官方代理镜像，用于在CI/CD（持续集成/持续部署）流程中作为工作节点执行构建、测试、部署等任务。通过与CloudBees CI控制器（Controller）通信，实现任务的分布式调度与执行，扩展企业级CI/CD平台的处理能力，减轻控制器负载。

核心功能与特性

• 控制器集成：与CloudBees CI控制器无缝通信，支持任务分配、状态同步及日志传输。
• 任务执行：提供任务运行环境，支持多种构建工具（如Maven、Gradle、npm）和运行时（如Java、Python、Node.js）。
• 可定制化：支持通过环境变量、挂载卷或自定义配置扩展镜像功能，适配特定构建需求。
• 企业级安全：支持加密通信（HTTPS）及控制器认证机制，确保任务执行过程的安全性。
• 轻量高效：基于精简基础镜像构建，资源占用低，启动速度快。

使用场景

• 企业级CI/CD流水线：作为核心工作节点，支撑大规模、多项目的自动化构建与测试。
• 分布式任务处理：在多节点环境中并行执行任务，提升流水线整体效率。
• 复杂构建环境：通过定制化配置，适配包含多种依赖工具的复杂构建流程。
• 跨环境一致性：确保开发、测试、生产环境中任务执行环境的一致性，减少"在我机器上能运行"问题。

使用方法与配置说明

前提条件

• 已部署CloudBees CI控制器，并获取控制器URL、代理认证密钥（Secret）及代理名称。
• 本地环境已安装Docker引擎（20.10+版本推荐）。

基本使用（Docker Run）

通过docker run命令启动代理容器，需指定控制器连接参数：

bash
docker run -d \
  --name cloudbees-ci-agent \
  -e CLOUDBEES_CI_CONTROLLER_URL="https://<controller-url>:<port>" \
  -e AGENT_NAME="<agent-name>" \
  -e AGENT_SECRET="<agent-secret>" \
  cloudbees/cloudbees-ci-agent:latest

参数说明：

• <controller-url>：CloudBees CI控制器的访问地址（如https://ci.example.com）。
• <agent-name>：代理在控制器中显示的唯一名称（需提前在控制器配置）。
• <agent-secret>：控制器生成的代理认证密钥（在控制器的"代理管理"页面获取）。

Docker Compose配置示例

通过docker-compose.yml定义代理服务，便于管理多代理实例或集成其他服务：

yaml
version: '3.8'
services:
  ci-agent:
    image: cloudbees/cloudbees-ci-agent:latest
    container_name: cloudbees-ci-agent-01
    restart: always
    environment:
      - CLOUDBEES_CI_CONTROLLER_URL=https://ci.example.com:8443
      - AGENT_NAME=backend-build-agent
      - AGENT_SECRET=abc123xyz789
      - AGENT_LABELS=java,maven,backend  # 代理标签，用于控制器任务分配
    volumes:
      - ./agent-workdir:/home/jenkins/agent  # 挂载工作目录，持久化任务数据
      - /var/run/docker.sock:/var/run/docker.sock  # 可选，如需在容器内执行Docker命令

启动服务：

bash
docker-compose up -d

关键配置参数

自定义扩展

如需添加特定工具或依赖，可通过以下方式扩展镜像：

1. 构建自定义镜像：基于本镜像创建Dockerfile，安装所需工具：

   dockerfile
   FROM cloudbees/cloudbees-ci-agent:latest
   RUN apt-get update && apt-get install -y python3-pip && pip3 install pytest
   

2. 挂载外部工具：通过-v参数挂载宿主机工具目录至容器：

   bash
   docker run -d \
     --name custom-agent \
     -e CLOUDBEES_CI_CONTROLLER_URL="https://ci.example.com" \
     -e AGENT_NAME="python-agent" \
     -e AGENT_SECRET="your-secret" \
     -v /usr/local/python3:/usr/local/python3 \  # 挂载宿主机Python环境
     cloudbees/cloudbees-ci-agent:latest
   

镜像维护与更新

• 获取最新版本：通过docker pull cloudbees/cloudbees-ci-agent:latest拉取最新镜像。
• 版本兼容性：建议使用与CloudBees CI控制器版本匹配的代理镜像，版本信息可通过CloudBees文档查询。
• 日志查看：通过docker logs <container-name>查看代理运行日志，排查连接或任务执行问题。

参考链接

• CloudBees CI官方文档
• CloudBees CI代理配置指南