docker/tcc-operator-bundle

Testcontainers Cloud Operator for OpenShift 镜像文档

概述

Testcontainers Cloud Operator for OpenShift是专为OpenShift容器平台设计的Kubernetes操作器（Operator），旨在简化Testcontainers在OpenShift集群中的集成与管理。该操作器通过自动化测试容器的创建、启动、扩展和清理流程，帮助开发与测试团队高效构建、部署和维护容器化测试环境，降低测试基础设施的手动管理成本，提升测试流程的稳定性与可重复性。

核心功能与特性

• 自动化生命周期管理：自动处理Testcontainers的全生命周期（创建、启动、健康检查、停止、清理），减少人工干预
• 深度OpenShift集成：适配OpenShift的安全上下文约束（SCC）、网络策略、项目隔离机制及资源配额管理
• 测试环境隔离：支持按测试场景、团队或项目划分独立的测试容器环境，避免资源冲突与干扰
• 资源优化调度：基于测试负载动态调整容器资源分配（CPU/内存），提高集群资源利用率
• 监控与可观测性：集成OpenShift监控组件，提供容器运行状态、资源使用量及测试执行指标的可视化监控

使用场景与适用范围

• CI/CD流水线集成：在OpenShift CI/CD流水线（如Jenkins、Tekton）中嵌入集成测试，自动为测试阶段部署隔离的依赖服务容器（如数据库、消息队列）
• 开发环境测试：开发人员在本地通过OpenShift集群模拟生产环境，使用操作器快速拉起测试容器进行应用调试
• 多团队协作测试：大型团队共享OpenShift集群时，通过命名空间隔离与资源配额控制，实现多项目并行测试环境管理
• 复杂依赖测试：针对微服务架构应用，自动化部署多组件依赖容器，验证服务间交互逻辑

使用方法

前提条件

• OpenShift集群版本4.6+
• oc命令行工具已配置并具备集群管理员权限
• 集群已启用Operator Lifecycle Manager（OLM）

部署步骤

1. 添加Operator CatalogSource
   创建CatalogSource资源以引入Testcontainers Cloud Operator仓库：

   yaml
   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: testcontainers-cloud-operator-catalog
     namespace: openshift-marketplace
   spec:
     sourceType: grpc
     image: testcontainers/testcontainers-cloud-operator-catalog:latest
     displayName: Testcontainers Cloud Operator Catalog
     publisher: Testcontainers
   

   应用配置：oc apply -f catalog-source.yaml

2. 创建OperatorGroup
   在目标命名空间（如test-env）创建OperatorGroup，定义操作器作用范围：

   yaml
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: testcontainers-operator-group
     namespace: test-env
   spec:
     targetNamespaces:
     - test-env
   

   应用配置：oc apply -f operator-group.yaml

3. 部署Operator
   创建Subscription资源安装Operator：

   yaml
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: testcontainers-cloud-operator
     namespace: test-env
   spec:
     channel: stable
     name: testcontainers-cloud-operator
     source: testcontainers-cloud-operator-catalog
     sourceNamespace: openshift-marketplace
     startingCSV: testcontainers-cloud-operator.v1.0.0
   

   应用配置：oc apply -f subscription.yaml

4. 验证部署状态
   检查Operator Pod运行状态：

   bash
   oc get pods -n test-env | grep testcontainers-cloud-operator
   

配置说明

自定义资源（CR）配置

通过创建TestcontainersConfig自定义资源定义测试环境配置，示例：

yaml
apiVersion: testcontainers.cloud/v1alpha1
kind: TestcontainersConfig
metadata:
  name: integration-test-config
  namespace: test-env
spec:
  # 资源限制配置
  resourceConstraints:
    cpuLimit: "1"        # CPU限制（核）
    memoryLimit: "1Gi"   # 内存限制
    cpuRequest: "500m"   # CPU请求
    memoryRequest: "512Mi" # 内存请求
  # 容器配置
  containerConfig:
    imagePullPolicy: Always  # 镜像拉取策略
    imagePullSecret: "test-registry-secret" # 私有镜像仓库密钥（可选）
  # 隔离配置
  isolation:
    enableNamespaceIsolation: true # 是否启用命名空间级隔离
    networkPolicy: "deny-all-except-test" # 关联的网络策略名称

环境变量配置

Operator部署时可通过环境变量调整运行参数，常用配置如下：

卸载方法

1. 删除Subscription：

   bash
   oc delete subscription testcontainers-cloud-operator -n test-env
   

2. 删除OperatorGroup：

   bash
   oc delete operatorgroup testcontainers-operator-group -n test-env
   

3. 删除CatalogSource：

   bash
   oc delete catalogsource testcontainers-cloud-operator-catalog -n openshift-marketplace