CloudBees CI 传统平台客户端控制器镜像文档

概述

本镜像为CloudBees CI在传统平台（如物理服务器、虚拟机等非容器编排平台）环境下的客户端控制器（Client Controller），负责管理CI/CD构建作业的生命周期、集成构建代理（Agents）、协调自动化流程，并提供与CloudBees CI服务端的交互能力，适用于企业级开发团队实现标准化、可扩展的持续集成与持续部署（CI/CD）流程。

核心功能与特性

• 作业管理：支持创建、配置和调度CI/CD构建作业，集成版本控制系统（如Git、SVN）及构建工具（如Maven、Gradle）。
• 代理集成：动态发现、注册和管理构建代理，分配构建任务至可用代理，实现分布式构建能力。
• 企业级安全：集成RBAC（基于角色的访问控制）、LDAP/Active Directory认证及作业权限精细化管理，确保构建环境安全合规。
• 扩展性：支持通过插件扩展功能，兼容Jenkins生态系统插件，满足自定义构建流程、报告生成等需求。
• 状态监控：提供作业执行状态、代理健康状态及资源利用率监控，支持日志聚合与问题排查。

使用场景

• 企业内部传统IT环境（非Kubernetes等容器编排平台）下的CI/CD流程自动化。
• 开发团队需要集中管理多项目构建作业、统一构建标准的场景。
• 需与现有企业级认证系统（如LDAP）集成，确保开发流程安全可控的环境。
• 要求支持大规模构建任务分发与代理资源弹性调度的场景。

使用方法与配置说明

基本部署命令

通过docker run快速启动客户端控制器容器：

bash
docker run -d \
  --name cloudbees-ci-client-controller \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /path/to/local/data:/var/jenkins_home \
  -e ADMIN_USER=admin \
  -e ADMIN_PASSWORD=securepassword \
  cloudbees/cloudbees-ci-client-controller:latest

参数说明

• -p 8080:8080：映射Web管理界面端口。
• -p 50000:50000：映射代理通信端口（用于与构建代理建立连接）。
• -v /path/to/local/data:/var/jenkins_home：挂载本地目录作为持久化存储，保存配置、作业数据及插件。
• 环境变量：
  • ADMIN_USER：默认管理员用户名（可选，首次启动时若未设置将自动生成）。
  • ADMIN_PASSWORD：默认管理员密码（可选，首次启动时若未设置需从日志获取初始密码）。
  • JAVA_OPTS：自定义JVM参数（如-Xmx2g -Xms1g调整内存分配）。

持久化存储

为确保配置、作业数据及插件在容器重启后不丢失，需挂载/var/jenkins_home目录至宿主机或持久化存储卷：

bash
# 宿主机目录挂载示例
mkdir -p /data/cloudbees-ci/client-controller
docker run -d \
  --name cloudbees-ci-client-controller \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /data/cloudbees-ci/client-controller:/var/jenkins_home \
  cloudbees/cloudbees-ci-client-controller:latest

集成构建代理

客户端控制器需与构建代理建立连接以执行构建任务，支持两种方式：

1. 控制器主动发现代理：在控制器管理界面配置代理注册地址，代理启动时自动注册。
2. 代理主动连接控制器：通过控制器生成的代理连接令牌，在代理节点执行连接命令（需确保50000端口可访问）。

注意事项

• 资源要求：建议分配至少2GB内存及2CPU核心，根据构建任务规模调整资源配置。
• 版本兼容性：需与CloudBees CI服务端及构建代理版本保持兼容，具体版本对应关系参考***文档。
• 安全加固：生产环境中建议禁用默认管理员账户，通过环境变量设置强密码，并配置HTTPS加密通信（可通过反向代理实现）。
• 备份策略：定期备份/var/jenkins_home目录数据，避免配置及作业信息丢失。