docker/tcc-wsproxy

Testcontainers Cloud Operator for OpenShift 镜像文档

1. 镜像概述和主要用途

Testcontainers Cloud Operator 镜像专为 OpenShift 容器平台设计，是管理 Testcontainers Cloud 资源的核心组件。该 Operator 旨在自动化 Testcontainers Cloud 在 OpenShift 环境中的部署、配置与运维流程，减少手动操作，确保测试环境的一致性和稳定性，助力开发与测试团队高效构建容器化测试环境。

2. 核心功能和特性

• 自动化部署管理：自动部署 Testcontainers Cloud 所需的核心组件（如代理、控制器等），无需手动配置复杂依赖。
• 资源监控与维护：实时监控 Testcontainers Cloud 相关资源（Pod、Service、ConfigMap 等）的运行状态，异常时自动触发修复机制。
• OpenShift 原生集成：深度整合 OpenShift 平台功能，支持通过 ServiceAccount、RoleBinding 实现权限管理，通过 ConfigMap/Secret 注入配置参数。
• 配置动态更新：支持通过 OpenShift 原生资源（如 CustomResourceDefinition）动态调整 Testcontainers Cloud 配置，无需重启 Operator。
• 日志与指标集成：兼容 OpenShift 日志收集（如 EFK 栈）和监控体系（如 Prometheus），便于问题排查与性能分析。

3. 使用场景和适用范围

• OpenShift 环境中的容器化测试：适用于在 OpenShift 集群内构建基于 Testcontainers 的单元测试、集成测试环境。
• CI/CD 流水线集成：作为 CI/CD 流程的一部分，自动为测试阶段配置 Testcontainers Cloud 环境，提升流水线自动化程度。
• 多团队共享测试资源：在企业级 OpenShift 集群中，统一管理多团队的 Testcontainers Cloud 资源，实现资源隔离与高效利用。
• 复杂测试环境运维：简化包含多个依赖服务（如数据库、消息队列）的测试环境的部署与版本管理。

4. 使用方法和配置说明

4.1 前置条件

• OpenShift 集群版本 4.6+
• 集群管理员权限（用于部署 Operator 及相关 RBAC 资源）
• Testcontainers Cloud 账户及 API 密钥（获取方式：Testcontainers Cloud 控制台）

4.2 部署方式

推荐通过 OpenShift Operator Lifecycle Manager (OLM) 部署，步骤如下：

1. 在 OpenShift 控制台中导航至 Operators > OperatorHub，搜索 "Testcontainers Cloud Operator"。
2. 选择最新版本，点击 Install，指定目标命名空间（如 testcontainers-system）。
3. 等待 Operator 部署完成（状态显示 "Succeeded"）。

4.3 配置 Testcontainers Cloud 实例

通过创建 TestcontainersCloud 自定义资源（CR）配置实例：

yaml
apiVersion: testcontainers.cloud/v1alpha1
kind: TestcontainersCloud
metadata:
  name: testcontainers-cloud-instance
  namespace: testcontainers-system
spec:
  apiKey: "<your-testcontainers-cloud-api-key>"  # Testcontainers Cloud API 密钥
  resourceLimits:
    cpu: "1"
    memory: "1Gi"
  logLevel: "info"  # 日志级别：debug/info/warn/error
  proxy:
    enabled: true
    port: 8080

应用配置：

bash
oc apply -f testcontainers-cloud-cr.yaml -n testcontainers-system

4.4 环境变量配置

Operator 支持通过环境变量调整运行参数，常见配置如下：

4.5 验证部署

检查 Operator Pod 运行状态：

bash
oc get pods -n testcontainers-system | grep testcontainers-cloud-operator

检查自定义资源状态：

bash
oc get testcontainersclouds.testcontainers.cloud -n testcontainers-system

5. 注意事项

• Operator 需与 Testcontainers Cloud 服务版本兼容，部署前请确认版本匹配（参考 Testcontainers Cloud 版本说明）。
• 生产环境中建议为 Operator 配置资源限制（CPU/内存），避免资源争抢。
• Testcontainers Cloud API 密钥需妥善保管，建议通过 OpenShift Secret 注入，而非明文配置。