docker/tcc-vm-driver

Testcontainers Cloud Operator for OpenShift 镜像文档

镜像概述和主要用途

本镜像为Testcontainers Cloud Operator的容器化部署包，专为OpenShift平台优化，用于在Kubernetes/OpenShift环境中管理Testcontainers资源的生命周期。Testcontainers是一款用于集成测试的工具，可通过真实容器模拟依赖服务；而本Operator作为编排层，负责自动化Testcontainers实例的部署、扩展、监控及资源调度，降低容器化测试环境的运维复杂度。

核心功能和特性

• OpenShift原生集成：适配OpenShift的安全策略、RBAC权限模型及资源管理机制，支持在受限容器环境中运行。
• Testcontainers生命周期管理：自动化测试容器的创建、启动、停止及清理，确保测试环境一致性。
• 资源优化调度：基于测试需求动态调整CPU、内存等资源分配，避免资源浪费。
• 监控与日志集成：对接OpenShift监控组件（如Prometheus）及日志系统，提供测试容器运行状态可观测性。
• 配置持久化：支持测试环境配置的保存与复用，简化重复测试场景的环境准备。

使用场景和适用范围

• 开发团队集成测试：在本地或CI环境中，通过OpenShift集群快速搭建包含数据库、消息队列等依赖的测试环境。
• QA自动化测试：为自动化测试流水线提供隔离、一致的容器化依赖服务，提升测试稳定性。
• 多团队共享测试资源：在企业级OpenShift集群中，通过Operator统一管理测试容器资源，避免资源冲突。
• 复杂依赖场景测试：适用于需要多服务协同的测试场景（如微服务交互测试、分布式系统测试）。

使用方法和配置说明

前提条件

• 运行中的OpenShift集群（4.6+版本推荐）
• 集群管理员权限（用于部署Operator及相关CRD）
• oc命令行工具或OpenShift Web Console访问权限

部署示例（OpenShift CLI）

1. 创建命名空间（可选，用于隔离测试资源）：

   bash
   oc new-project testcontainers-operator
   

2. 部署Operator（通过容器镜像直接部署，或使用OperatorHub）：

   bash
   oc run testcontainers-cloud-operator \
     --image=testcontainers/cloud-operator:latest \
     --namespace=testcontainers-operator \
     --env="OPENSHIFT_API_URL=https://api.openshift-cluster.example.com:6443" \
     --env="LOG_LEVEL=info" \
     --serviceaccount=testcontainers-operator-sa
   

   注：实际部署推荐通过OperatorHub或Helm Chart，上述命令为简化示例。

3. 创建Testcontainers资源（CR）： 创建TestcontainersEnvironment自定义资源（CR）配置测试环境：

   yaml
   apiVersion: testcontainers.cloud/v1alpha1
   kind: TestcontainersEnvironment
   metadata:
     name: demo-test-env
     namespace: testcontainers-operator
   spec:
     dependencies:
       - name: postgres
         image: postgres:14
         port: 5432
         env:
           - name: POSTGRES_PASSWORD
             valueFrom:
               secretKeyRef:
                 name: test-db-secret
                 key: password
     resourceLimits:
       cpu: "1"
       memory: "1Gi"
   

   应用配置：

   bash
   oc apply -f testcontainers-env.yaml
   

核心配置参数

验证部署

检查Operator运行状态：

bash
oc get pods -n testcontainers-operator

检查创建的Testcontainers资源：

bash
oc get testcontainersenvironments -n testcontainers-operator

清理资源

删除测试环境及Operator：

bash
oc delete testcontainersenvironment demo-test-env -n testcontainers-operator
oc delete pod testcontainers-cloud-operator -n testcontainers-operator