CloudBees CI 现代云平台版 - 托管控制器 Docker 镜像文档

镜像概述

CloudBees CI 现代云平台版 - 托管控制器（Managed Controller）是 CloudBees CI 在容器化环境中的核心组件，作为集中管理的 CI/CD 控制器，用于在现代云平台（如 Kubernetes、AWS、Azure 等）中运行，提供自动化构建、测试、部署的完整流程支持。该镜像旨在简化企业级 CI/CD 基础设施的部署与管理，支持多团队协作与资源隔离，满足大规模开发场景需求。

核心功能和特性

1. 集中化管理

• 与 CloudBees CI 操作中心（Operations Center）无缝集成，实现跨控制器的统一监控、配置与权限管理。
• 支持通过操作中心远程配置插件、更新版本及应用安全策略，降低管理复杂度。

2. 云原生架构

• 基于容器化设计，原生支持 Kubernetes 等容器编排平台，可通过 Helm Chart 或 Operator 实现自动化部署与扩缩容。
• 适配现代云环境的弹性资源调度，根据工作负载自动调整计算资源，优化资源利用率。

3. 企业级可靠性与可扩展性

• 内置高可用性支持，通过分布式架构避免单点故障，保障 CI/CD 流程稳定运行。
• 支持动态扩展代理节点，应对大规模并行构建任务，提升构建效率。

4. 安全性增强

• 集成 CloudBees 安全特性，包括角色基础访问控制（RBAC）、凭证加密管理、漏洞扫描集成等。
• 符合企业级合规标准，支持审计日志与安全事件追踪。

5. 插件生态与兼容性

• 兼容 Jenkins 丰富的插件生态，同时提供 CloudBees 专属企业插件（如多分支管道增强、部署仪表盘等）。
• 支持插件版本锁定与批量更新，确保构建环境一致性。

使用场景和适用范围

企业级 CI/CD 流程自动化

适用于需要统一管理多项目、多团队构建流程的企业，支持从代码提交到生产部署的全流程自动化。

现代云环境部署

针对 AWS、Azure、Google Cloud 等公有云或 OpenShift 等私有云环境，提供开箱即用的云原生 CI/CD 控制器。

多团队协作与资源隔离

支持按团队或项目创建独立的构建环境，实现资源隔离与权限管控，满足大型组织的协作需求。

高可用与灾备需求

通过集群化部署与数据持久化，保障关键业务 CI/CD 流程的高可用性与数据安全性。

使用方法和配置说明

前提条件

• Docker 19.03+ 或兼容的容器运行时
• 至少 4GB RAM 与 2 vCPU 资源
• 与 CloudBees CI 操作中心的网络连通性（用于注册与管理）
• 持久化存储卷（推荐，用于保存配置与构建数据）

基本启动命令

bash
docker run -d \
  --name cloudbees-ci-managed-controller \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /path/to/persistence:/var/jenkins_home \
  -e CBCI_MANAGED_CONTROLLER_NAME="my-managed-controller" \
  -e CBCI_OPERATIONS_CENTER_URL="[***]" \
  -e CBCI_AGENT_SECRET="your-agent-secret" \
  cloudbees/cloudbees-ci-managed-controller:latest

参数说明：

• -p 8080:8080: 映射控制器 Web 界面端口
• -p 50000:50000: 映射代理节点通信端口
• -v /path/to/persistence:/var/jenkins_home: 挂载持久化卷，保存控制器配置、插件与构建数据
• 环境变量用于配置控制器与操作中心的连接信息及基本参数

关键环境变量配置

持久化存储配置

推荐使用命名卷或绑定挂载本地目录，确保容器重启后配置与数据不丢失：

bash
# 创建持久化卷（推荐）
docker volume create cbci-managed-controller-data

# 使用卷启动容器
docker run -d \
  --name cloudbees-ci-managed-controller \
  -p 8080:8080 \
  -p 50000:50000 \
  -v cbci-managed-controller-data:/var/jenkins_home \
  -e CBCI_MANAGED_CONTROLLER_NAME="my-controller" \
  -e CBCI_OPERATIONS_CENTER_URL="[***]" \
  -e CBCI_AGENT_SECRET="your-secret" \
  cloudbees/cloudbees-ci-managed-controller:latest

与操作中心注册

1. 启动容器后，控制器将自动尝试连接操作中心
2. 在操作中心控制台的“托管控制器”页面确认注册状态
3. 注册成功后，可通过操作中心访问控制器 Web 界面并配置项目

升级与维护

• 版本更新：停止现有容器，拉取新版本镜像后重新启动（需确保持久化数据卷挂载正确）
• 插件管理：推荐通过操作中心集中管理插件，避免单个控制器手动升级导致版本不一致
• 日志查看：使用 docker logs -f cloudbees-ci-managed-controller 查看运行日志，排查启动或运行故障

参考文档

• CloudBees CI ***文档
• 托管控制器配置指南
• Docker 镜像仓库