docker/tcc-operator

Testcontainers Cloud Operator for OpenShift 镜像文档

镜像概述

Testcontainers Cloud Operator for OpenShift是由Testcontainers Cloud提供的 Kubernetes 操作器（Operator）镜像，专为OpenShift容器平台设计。该镜像旨在简化Testcontainers在OpenShift集群中的部署、配置和生命周期管理，帮助开发和测试团队在OpenShift环境中高效运行基于Testcontainers的容器化测试。

Testcontainers是一个流行的开源库，允许开发者使用真实的容器作为测试依赖，确保测试环境与生产环境一致性。本操作器进一步将Testcontainers的能力与OpenShift的云原生特性结合，提供自动化的资源管理和集成体验。

核心功能与特性

核心功能

• OpenShift原生集成：专为OpenShift集群架构设计，支持OpenShift的安全上下文、网络策略和存储配置。
• Testcontainers资源管理：自动化Testcontainers依赖容器的生命周期（创建、启动、停止、清理），减少手动操作。
• 测试环境标准化：通过操作器统一管理测试环境配置，确保团队内测试环境一致性。
• 云原生工作流支持：与CI/CD流水线集成，支持在OpenShift上实现自动化测试流程。

主要特性

• 兼容OpenShift 4.x及以上版本
• 支持自定义资源（CRD）定义Testcontainers配置
• 集成OpenShift监控和日志系统
• 轻量化设计，低资源占用

使用场景与适用范围

适用场景

• 容器化应用测试：在OpenShift集群中为微服务、数据库等应用组件提供隔离的测试依赖容器。
• CI/CD流水线集成：作为OpenShift CI/CD流程的一部分，自动启动和管理测试所需的容器环境。
• 开发环境一致性：确保开发、测试、CI环境中使用的Testcontainers配置统一。

目标用户

• 在OpenShift平台上进行应用开发和测试的开发团队
• 采用云原生架构，需要自动化测试环境管理的DevOps团队
• 使用Testcontainers进行集成测试、端到端测试的QA团队

使用方法与配置说明

前置条件

• OpenShift集群（4.x及以上版本）
• 集群管理员权限（用于部署CRD和操作器权限配置）
• Testcontainers Cloud账户（如需使用云服务特性）

部署步骤

1. 安装CRD
   首先在OpenShift集群中部署Testcontainers Cloud Operator的自定义资源定义（CRD）：

   bash
   oc apply -f https://testcontainers.cloud/operator/openshift/crd.yaml
   

2. 部署操作器
   使用以下命令部署操作器到指定命名空间（例如testcontainers-system）：

   bash
   oc apply -f https://testcontainers.cloud/operator/openshift/deployment.yaml -n testcontainers-system
   

3. 验证部署
   检查操作器Pod是否正常运行：

   bash
   oc get pods -n testcontainers-system
   

配置参数

操作器支持通过环境变量和自定义资源（TestcontainersConfig）进行配置，主要参数包括：

自定义资源示例

创建TestcontainersConfig自定义资源以配置测试环境：

yaml
apiVersion: testcontainers.cloud/v1alpha1
kind: TestcontainersConfig
metadata:
  name: default-config
  namespace: my-test-namespace
spec:
  resourceLimits:
    cpu: "1"
    memory: "1Gi"
  imagePullPolicy: Always
  cloud:
    enabled: true
    apiKey: "${TC_CLOUD_API_KEY}"

卸载方法

如需卸载操作器，执行以下命令：

bash
oc delete -f https://testcontainers.cloud/operator/openshift/deployment.yaml -n testcontainers-system
oc delete crd testcontainersconfigs.testcontainers.cloud

注意事项

• 操作器需要足够的权限来管理集群中的Pod、Service、ConfigMap等资源，部署时需确保RBAC配置正确。
• 对于生产环境，建议限制操作器的监控命名空间，避免过度权限。
• 如需使用Testcontainers Cloud的高级特性（如远程容器管理），需确保集群可访问Testcontainers Cloud服务端点。