cloudbees/cloudbees-core-oc

CloudBees CI Operations Center 镜像文档

1. 镜像概述和主要用途

CloudBees CI Operations Center 是 CloudBees CI 在传统平台（非Kubernetes环境）中的核心管理组件，用于集中管控多个 CloudBees CI 控制器（Controller）。其核心定位是提供企业级 CI/CD 环境的统一管理平面，支持跨控制器的配置同步、安全策略统一、资源监控及操作审计，适用于需要规模化管理多团队、多项目构建环境的场景。

2. 核心功能和特性

2.1 多控制器集中管理

• 支持注册、监控及生命周期管理（启动/停止/升级）多个 CloudBees CI 控制器
• 提供跨控制器的统一视图，展示各控制器的运行状态、资源使用率及任务执行情况

2.2 配置标准化与分发

• 集中定义全局配置（如工具安装、构建环境、代理模板），并自动同步至关联控制器
• 支持配置版本控制与回滚，确保环境一致性

2.3 统一安全管控

• 集中管理用户认证与授权策略，支持 LDAP/AD、SAML 等企业级身份提供商集成
• 基于角色的访问控制（RBAC），细化不同管理员对控制器的操作权限

2.4 企业级安全增强

• 内置安全扫描与合规检查，检测控制器配置漏洞并提供修复建议
• 支持敏感信息加密存储（如凭证、API密钥），符合企业数据安全标准

2.5 监控与可观测性

• 集成监控指标采集，支持对接 Prometheus/Grafana 等监控系统
• 提供审计日志功能，记录跨控制器的关键操作（如配置变更、权限调整）

2.6 高可用性支持

• 支持主从部署模式，实现 Operations Center 自身的故障转移
• 与外部数据库（如 PostgreSQL、MySQL）集成，确保配置数据持久化与高可用

3. 使用场景和适用范围

3.1 适用场景

• 企业级多团队协作：管理多个独立团队的 CI/CD 控制器，确保资源隔离与统一治理
• 跨地域/数据中心部署：管控分布在不同物理位置的控制器，实现全局构建资源调度
• 合规性要求严格的环境：需满足审计、配置标准化、安全策略统一的***、***等行业场景
• 规模化 CI/CD 平台：单控制器无法满足并发构建需求时，通过多控制器集群扩展能力

3.2 不适用场景

• 单团队/小型项目：直接使用独立 CloudBees CI 控制器即可满足需求，无需额外管理 overhead
• 纯 Kubernetes 环境：Kubernetes 环境下的 CloudBees CI 管理需使用 CloudBees CD 或 Kubernetes Operator

4. 使用方法和配置说明

4.1 前提条件

• Docker 19.03+ 环境
• 至少 4GB 内存（推荐 8GB+，根据管理的控制器数量调整）
• 持久化存储（本地目录或网络存储，用于保存配置与状态数据）
• 外部数据库（可选，生产环境推荐使用 PostgreSQL 12+ 或 MySQL 8.0+，默认使用内置 H2 数据库）

4.2 快速启动（Docker Run）

4.2.1 基础启动命令（内置数据库，仅测试用）

bash
docker run -d \
  --name cloudbees-oc \
  -p 8080:8080 \
  -v /opt/cloudbees-oc/data:/var/lib/cloudbees-oc \
  -e ADMIN_USER=admin \
  -e ADMIN_PASSWORD=SecurePass123! \
  cloudbees/cloudbees-ci-operations-center:latest

4.2.2 生产环境启动（外部PostgreSQL数据库）

bash
docker run -d \
  --name cloudbees-oc \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /opt/cloudbees-oc/data:/var/lib/cloudbees-oc \
  -v /opt/cloudbees-oc/logs:/var/log/cloudbees-oc \
  -e ADMIN_USER=admin \
  -e ADMIN_PASSWORD=SecurePass123! \
  -e DB_TYPE=postgresql \
  -e DB_HOST=pg-db.example.com \
  -e DB_PORT=5432 \
  -e DB_NAME=cloudbees_oc \
  -e DB_USER=oc_db_user \
  -e DB_PASSWORD=DBUserPass456! \
  -e JVM_OPTS="-Xms2g -Xmx4g -XX:MaxPermSize=512m" \
  cloudbees/cloudbees-ci-operations-center:latest

4.3 Docker Compose 配置示例（生产环境）

yaml
version: '3.8'

services:
  cloudbees-oc:
    image: cloudbees/cloudbees-ci-operations-center:latest
    container_name: cloudbees-oc
    restart: always
    ports:
      - "8080:8080"    # Web管理端口
      - "50000:50000"  # 控制器通信端口（用于注册控制器）
    environment:
      # 管理员账户配置
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=SecurePass123!
      # JVM参数（根据资源调整）
      - JVM_OPTS="-Xms4g -Xmx8g -XX:+UseG1GC -XX:MaxGCPauseMillis=200"
      # 数据库配置（PostgreSQL）
      - DB_TYPE=postgresql
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=cloudbees_oc
      - DB_USER=oc_db_user
      - DB_PASSWORD=DBUserPass456!
      # 日志配置
      - LOG_LEVEL=INFO
      - LOG_ROTATION_MAX_SIZE=100M
      - LOG_ROTATION_MAX_HISTORY=30
    volumes:
      - /opt/cloudbees-oc/data:/var/lib/cloudbees-oc  # 数据持久化目录
      - /opt/cloudbees-oc/logs:/var/log/cloudbees-oc  # 日志目录
      - /opt/cloudbees-oc/conf:/etc/cloudbees-oc      # 自定义配置文件挂载
    depends_on:
      - postgres

  # 外部PostgreSQL数据库（生产环境推荐）
  postgres:
    image: postgres:14-alpine
    container_name: oc-postgres
    restart: always
    environment:
      - POSTGRES_DB=cloudbees_oc
      - POSTGRES_USER=oc_db_user
      - POSTGRES_PASSWORD=DBUserPass456!
    volumes:
      - /opt/postgres/data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

4.4 环境变量配置说明

4.5 卷挂载说明

5. 控制器注册与管理

5.1 控制器注册流程

1. 访问 Operations Center 管理界面：http://<宿主机IP>:8080，使用ADMIN_USER和ADMIN_PASSWORD登录
2. 导航至 Manage Jenkins > Manage Controllers，点击 New Controller
3. 选择 Existing Controller（已有控制器）或 New Controller（新建控制器），按向导填写控制器URL、认证信息（如API令牌）
4. 完成注册后，控制器状态将显示为"Online"，可在 Operations Center 中直接管理其配置与任务

5.2 配置同步策略

在 Manage Jenkins > Configuration as Code 中定义全局配置，通过以下方式同步至控制器：

• 自动同步：启用"Auto-sync to all controllers"，配置变更实时推送
• 手动触发：在控制器列表中选择目标控制器，点击 Sync Configuration

6. 注意事项

6.1 数据备份

• 定期备份 /var/lib/cloudbees-oc 目录（包含配置与状态数据）
• 外部数据库需单独配置备份策略（如PostgreSQL的pg_dump）

6.2 安全加固

• 生产环境必须修改默认管理员密码，并禁用ADMIN_PASSWORD环境变量（通过界面手动更新）
• 配置HTTPS（通过反向代理如Nginx，或直接修改JVM参数启用SSL）
• 限制AGENT_PORT（50000）的网络访问，仅允许受信控制器IP连接

6.3 升级说明

• 升级前需备份数据目录及数据库
• 通过docker pull获取新版本镜像后，停止旧容器并使用相同卷挂载参数启动新容器

7. 参考链接

• CloudBees CI 官方文档
• Operations Center 管理指南
• 控制器注册与配置同步