docker/tcc-operator-catalog

Testcontainers Cloud Operator for OpenShift

概述

Testcontainers Cloud Operator for OpenShift是专为OpenShift平台设计的操作器（Operator），旨在简化Testcontainers Cloud在OpenShift集群中的部署、配置与生命周期管理。通过OpenShift原生的自定义资源（Custom Resource）和控制器（Controller）机制，该操作器可自动化Testcontainers Cloud组件的部署、升级及故障恢复，帮助用户在OpenShift环境中高效集成Testcontainers Cloud提供的容器化测试服务。

核心功能与特性

• 自动化生命周期管理：自动处理Testcontainers Cloud核心组件的部署、版本升级和故障自愈，减少手动运维成本。
• OpenShift原生集成：与OpenShift的Deployment、Service、ConfigMap等原生资源深度兼容，符合OpenShift平台操作习惯。
• 声明式配置：通过自定义资源定义（CRD）支持声明式配置，用户可通过YAML文件定义Testcontainers Cloud实例参数，实现配置即代码（Configuration as Code）。
• 安全合规：遵循OpenShift的安全上下文（Security Context）和RBAC权限模型，确保组件在OpenShift安全约束下运行。

使用场景

• 开发测试环境：开发团队在OpenShift集群中进行应用集成测试时，通过该操作器快速部署Testcontainers Cloud，简化容器化测试环境的搭建与管理。
• CI/CD流水线：在OpenShift内置CI/CD流水线（如Tekton）中集成Testcontainers Cloud，通过操作器动态管理测试依赖服务，提升流水线执行效率。
• 多团队共享集群：企业级OpenShift集群中，多团队可通过操作器隔离管理各自的Testcontainers Cloud实例，实现资源按需分配与权限控制。

部署与使用方法

前提条件

• OpenShift集群版本4.8及以上
• 集群管理员权限（用于部署CRD和Operator）
• Testcontainers Cloud API密钥（从Testcontainers Cloud控制台获取）

部署步骤（Helm方式）

1. 添加Helm仓库：

   bash
   helm repo add testcontainers-cloud https://testcontainers.github.io/helm-charts
   helm repo update
   

2. 安装Operator：

   bash
   helm install testcontainers-cloud-operator testcontainers-cloud/testcontainers-cloud-operator \
     --namespace testcontainers-cloud --create-namespace \
     --set platform=openshift \
     --set cloud.apiKey=YOUR_TESTCONTAINERS_CLOUD_API_KEY
   

3. 创建Testcontainers Cloud实例： 通过自定义资源配置实例参数，示例testcontainers-cloud-cr.yaml：

   yaml
   apiVersion: cloud.testcontainers.com/v1alpha1
   kind: TestcontainersCloud
   metadata:
     name: my-tc-cloud-instance
     namespace: testcontainers-cloud
   spec:
     replicas: 2
     resources:
       limits:
         cpu: "1"
         memory: "1Gi"
       requests:
         cpu: "500m"
         memory: "512Mi"
     cloud:
       region: "us-west-2"
       logLevel: "info"
   

4. 应用配置：

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

验证部署

• 检查Operator Pod状态：

  bash
  oc get pods -n testcontainers-cloud -l app.kubernetes.io/name=testcontainers-cloud-operator
  

• 检查自定义资源状态：

  bash
  oc get testcontainersclouds.cloud.testcontainers.com -n testcontainers-cloud
  oc describe testcontainersclouds.cloud.testcontainers.com my-tc-cloud-instance -n testcontainers-cloud
  

配置参数

环境变量

部署时可通过环境变量调整核心配置：

• TESTCONTAINERS_CLOUD_API_KEY：Testcontainers Cloud API密钥（必填）
• TESTCONTAINERS_CLOUD_REGION：服务区域（默认：us-west-2）
• LOG_LEVEL：日志级别（默认：info，可选：debug/warn/error）

自定义资源（CR）参数

卸载

1. 卸载Helm release：

   bash
   helm uninstall testcontainers-cloud-operator -n testcontainers-cloud
   

2. 删除命名空间及残留资源：

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