MongoDB Atlas Operator 内部CI专用镜像文档

1. 镜像概述和主要用途

1.1 镜像概述

本镜像为MongoDB Atlas Operator的内部专用构建版本，专为公司内部CI（持续集成）流水线设计，未对外公开分发。该镜像基于官方MongoDB Atlas Operator核心功能开发，针对CI环境进行了适配优化，确保在自动化测试流程中高效运行。

1.2 主要用途

• 支持CI流水线中MongoDB Atlas Operator的自动化部署验证
• 提供Operator与MongoDB Atlas服务集成的测试环境
• 验证Operator功能更新及兼容性测试
• 加速开发团队在CI流程中的集成测试环节

2. 核心功能和特性

2.1 核心功能

• 与MongoDB Atlas API深度集成，支持集群、备份、网络等资源的自动化管理
• 提供自定义资源定义（CRD），支持通过Kubernetes API管理Atlas资源
• 内置状态同步机制，确保Atlas资源状态与Kubernetes集群一致

2.2 内部CI优化特性

• 精简镜像体积，减少CI环境拉取时间
• 内置CI环境适配逻辑，支持快速启动与资源清理
• 增强日志输出，适配CI流水线日志收集系统
• 支持调试模式，便于定位集成测试中的问题

3. 使用场景和适用范围

3.1 典型使用场景

• 开发团队在CI流水线中验证Operator新功能
• 自动化测试环节验证Atlas资源部署流程
• 多版本兼容性测试（Operator与MongoDB Atlas服务）
• 内部工具链与Operator集成验证

3.2 适用范围

• 环境限制：公司内部CI/CD流水线，非生产环境
• 用户范围：内部开发团队、QA团队
• 资源限制：仅用于测试目的，不支持生产级资源管理

4. 使用方法和配置说明

4.1 前置条件

• 已配置内部Docker仓库访问权限
• 拥有MongoDB Atlas测试环境API密钥（需具备项目管理权限）
• CI环境已安装Docker或Kubernetes集群（v1.21+）
• 网络连通性：CI环境可访问MongoDB Atlas API（[***]

4.2 镜像拉取

从内部Docker仓库拉取镜像：

docker pull internal-docker-registry.example.com/mongodb/atlas-operator:ci-latest

4.3 环境变量配置

4.4 部署步骤

4.4.1 Docker单机部署（用于基础功能测试）

docker run -d \
  --name atlas-operator-ci \
  -e ATLAS_PUBLIC_KEY="pk-xxxxxx" \
  -e ATLAS_PRIVATE_KEY="sk-xxxxxx" \
  -e ATLAS_PROJECT_ID="62fxxxxxxxxx123" \
  -e LOG_LEVEL="debug" \
  internal-docker-registry.example.com/mongodb/atlas-operator:ci-latest

4.4.2 Docker Compose部署（用于多组件集成测试）

创建docker-compose.yml：

version: '3.8'
services:
  atlas-operator:
    image: internal-docker-registry.example.com/mongodb/atlas-operator:ci-latest
    environment:
      - ATLAS_PUBLIC_KEY=pk-xxxxxx
      - ATLAS_PRIVATE_KEY=sk-xxxxxx
      - ATLAS_PROJECT_ID=62fxxxxxxxxx123
      - LOG_LEVEL=info
      - DEBUG_MODE=false
    ports:
      - "8080:8080"  # 健康检查端口
    restart: unless-stopped
    volumes:
      - ./ci-config:/etc/operator/config  # 挂载自定义配置（可选）

启动命令：

docker-compose up -d

4.4.3 Kubernetes环境部署（CI流水线标准方式）

1. 创建命名空间：

kubectl create namespace ci-test

2. 创建Atlas凭证密钥：

kubectl create secret generic atlas-credentials -n ci-test \
  --from-literal=publicKey=pk-xxxxxx \
  --from-literal=privateKey=sk-xxxxxx

3. 部署Operator：

# atlas-operator-ci.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: mongodb-atlas-operator
  namespace: ci-test
spec:
  replicas: 1
  selector:
    matchLabels:
      app: atlas-operator
  template:
    metadata:
      labels:
        app: atlas-operator
    spec:
      containers:
      - name: operator
        image: internal-docker-registry.example.com/mongodb/atlas-operator:ci-latest
        env:
        - name: ATLAS_PROJECT_ID
          value: "62fxxxxxxxxx123"
        - name: LOG_LEVEL
          value: "info"
        - name: ATLAS_PUBLIC_KEY
          valueFrom:
            secretKeyRef:
              name: atlas-credentials
              key: publicKey
        - name: ATLAS_PRIVATE_KEY
          valueFrom:
            secretKeyRef:
              name: atlas-credentials
              key: privateKey
        ports:
        - containerPort: 8080

应用部署配置：

kubectl apply -f atlas-operator-ci.yaml

4.5 部署验证

• 检查容器状态：

  # Docker环境
  docker ps | grep atlas-operator-ci
  
  # Kubernetes环境
  kubectl get pods -n ci-test
  

• 查看日志确认启动成功：

  # Docker环境
  docker logs atlas-operator-ci | grep "Operator started successfully"
  
  # Kubernetes环境
  kubectl logs -n ci-test <operator-pod-name> | grep "Operator started successfully"
  

5. 配置参数说明

5.1 核心配置参数

5.2 配置方式优先级

1. 命令行参数（最高）
2. 环境变量
3. 配置文件（最低）

6. 注意事项

• 本镜像为内部专用，禁止向外部环境分发
• API密钥等敏感信息需通过CI环境密钥管理系统注入，禁止明文配置
• CI流水线执行完毕后，需清理测试环境中的Operator及关联资源
• 如遇功能异常，联系内部DevOps团队或查看/var/log/atlas-operator/目录下的详细日志