docker/tcc-di-kubevirt

Testcontainers Cloud Operator for OpenShift

概述

Testcontainers Cloud Operator for OpenShift是基于Kubernetes Operator模式构建的管理工具，专为OpenShift平台设计，用于自动化Testcontainers Cloud在容器化测试环境中的资源管理。作为OpenShift原生组件，它通过自定义资源定义（CRD）抽象测试环境配置逻辑，简化Testcontainers Cloud与OpenShift集群的集成过程，提升测试环境的一致性和运维效率。

核心功能与特性

• OpenShift原生集成：深度适配OpenShift安全上下文、网络策略及资源管理机制，支持SCC（Security Context Constraints）和RBAC权限模型。
• 自动化资源编排：自动部署、更新和回收Testcontainers Cloud相关资源（如代理、缓存服务），减少手动操作成本。
• 声明式配置管理：通过自定义资源（TestcontainersCloud CR）定义测试环境参数，支持版本化配置与多环境复用。
• 监控与自愈能力：实时监控Testcontainers Cloud资源健康状态，自动触发故障恢复（如重启异常实例、重建资源）。
• CI/CD流水线集成：提供与OpenShift Pipelines（Tekton）的原生对接能力，支持测试环境的动态按需创建。

使用场景与适用范围

• 容器化应用测试：为OpenShift集群中的微服务应用提供隔离、一致的集成测试环境。
• 开发环境标准化：确保开发、测试、CI环境中Testcontainers配置的一致性，消除"环境差异"问题。
• 大规模测试资源管理：在多租户OpenShift集群中高效分配、隔离Testcontainers Cloud资源。
• 测试成本优化：通过自动扩缩容和闲置资源回收，降低长期运行测试环境的基础设施成本。

使用方法与配置说明

前提条件

• OpenShift集群版本4.6+
• oc命令行工具（配置集群管理员权限）
• Testcontainers Cloud账户及API密钥（从Testcontainers Cloud控制台获取）
• 集群已安装Operator Lifecycle Manager（OLM）

部署步骤

方法1：通过OperatorHub部署（推荐）

1. 登录OpenShift Web控制台，导航至Operators > OperatorHub
2. 搜索"Testcontainers Cloud Operator"，选择对应Operator
3. 点击Install，配置安装参数：
   • 安装模式：选择"All namespaces on the cluster"或指定命名空间
   • 更新通道：选择稳定通道（如stable-v1）
   • 审批策略：选择"Automatic"或"Manual"
4. 点击Subscribe完成部署，等待Operator变为"Running"状态

方法2：手动部署

1. 应用CRD定义：

   bash
   oc apply -f https://raw.githubusercontent.com/testcontainers/testcontainers-cloud-operator/main/config/crd/bases/cloud.testcontainers.com_testcontainersclouds.yaml
   

2. 创建专用命名空间：

   bash
   oc create namespace testcontainers-system
   

3. 部署Operator控制器：

   bash
   oc apply -f https://raw.githubusercontent.com/testcontainers/testcontainers-cloud-operator/main/deploy/operator.yaml -n testcontainers-system
   

配置Testcontainers Cloud实例

创建TestcontainersCloud自定义资源（CR）配置文件（示例）：

yaml
apiVersion: cloud.testcontainers.com/v1alpha1
kind: TestcontainersCloud
metadata:
  name: test-env
  namespace: testcontainers-system
spec:
  # Testcontainers Cloud API密钥（必填）
  apiKey: "tc-cloud-api-key-xxxx"
  # 资源分配配置
  resources:
    limits:
      cpu: "2"
      memory: "2Gi"
    requests:
      cpu: "1"
      memory: "1Gi"
  # 代理服务配置
  proxy:
    enabled: true
    port: 8080
    image: "testcontainers/cloud-proxy:latest"
  # 日志配置
  logging:
    level: "info"
    destination: "stdout"
  # 自动扩缩容配置（可选）
  autoscaling:
    minReplicas: 1
    maxReplicas: 3
    targetCPUUtilizationPercentage: 70

应用配置：

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

验证部署状态

检查Operator运行状态：

bash
oc get pods -n testcontainers-system
# 预期输出包含运行中的operator pod：testcontainers-cloud-operator-xxxx-xxxx

检查Testcontainers Cloud资源状态：

bash
oc get testcontainersclouds -n testcontainers-system
# 预期输出：NAME        READY   STATUS    AGE
#          test-env   True    Running   5m

环境变量配置

Operator控制器支持通过Deployment资源调整以下环境变量：

修改方法：

bash
oc set env deployment/testcontainers-cloud-operator -n testcontainers-system OPERATOR_LOG_LEVEL=debug

卸载流程

1. 删除Testcontainers Cloud资源实例：

   bash
   oc delete testcontainersclouds test-env -n testcontainers-system
   

2. 卸载Operator（OperatorHub部署场景）：

   • 导航至Operators > Installed Operators
   • 选择对应Operator，点击Uninstall

3. 清理CRD及残留资源：

   bash
   oc delete crd testcontainersclouds.cloud.testcontainers.com
   oc delete namespace testcontainers-system