istio/app_sidecar_base_centos_8

Istio 测试镜像文档

一、镜像概述和主要用途

本镜像专为 Istio 服务网格的测试工作设计，旨在提供轻量级、可集成的测试环境，支持 Istio 组件功能验证、配置有效性检测及兼容性测试。通过封装 Istio 测试所需的基础工具和运行时环境，简化 Istio 服务网格在开发、测试及部署阶段的验证流程。
主要用途包括：

• Istio 控制平面（如 Pilot、Galley、Citadel 等）组件功能测试
• 数据平面代理（Envoy）的转发规则、流量控制及安全策略验证
• 服务间通信（如 mTLS 加密、流量拆分、故障注入）的场景化测试
• Istio 配置（如 VirtualService、DestinationRule、Gateway）的有效性检测
• Istio 版本升级或配置变更前的兼容性验证

二、核心功能和特性

核心功能

1. 多维度测试支持：覆盖 Istio 控制平面、数据平面及策略/遥测功能的测试需求
2. 轻量级设计：基于精简基础镜像构建，资源占用低，适合集成到自动化流程
3. 工具集成：内置 Istio 测试常用工具（如 istioctl、kubectl、Envoy 调试工具等）
4. 灵活适配：支持自定义测试用例注入，兼容主流测试框架（如 Go Test、JUnit）

特性

• 预配置 Istio 测试环境依赖，无需手动安装组件
• 支持与 Kubernetes 集群（含 Istio 部署）网络互通，便于端到端测试
• 提供标准化测试输出格式，易于集成到 CI/CD 报告系统

三、使用场景和适用范围

典型使用场景

1. 开发环境验证：开发人员本地验证 Istio 功能（如流量路由、故障注入）
2. CI/CD 自动化测试：在流水线中集成，实现 Istio 配置变更的自动验证（如 GitLab CI、Jenkins）
3. 版本兼容性测试：Istio 版本升级前，验证目标集群与新版本的兼容性
4. 自定义配置测试：验证用户自定义 Istio 资源（如 WASM 插件、自定义遥测规则）的有效性

适用范围

• 开发人员、测试工程师、DevOps 工程师
• 基于 Kubernetes 的 Istio 部署环境
• 需自动化验证 Istio 功能的场景

四、详细使用方法和配置说明

4.1 前置条件

• 已安装 Docker 19.03+
• 目标环境已部署 Istio（参考 Istio 官方文档）
• （可选）Kubernetes 集群访问权限（通过 kubeconfig 文件）

4.2 基本使用流程

1. 拉取镜像

   bash
   docker pull [镜像仓库地址]/istio-test:latest  # 替换为实际镜像仓库地址  
   

2. 运行测试容器
   基础命令格式：

   bash
   docker run -it --rm \  
     -v /path/to/local/testcases:/testcases \  # 挂载本地测试用例目录  
     -v ~/.kube/config:/root/.kube/config \    # 挂载 Kubernetes 配置（如需集群内测试）  
     --network=host \                          # 共享主机网络（便于访问本地 Istio 环境）  
     [镜像仓库地址]/istio-test:latest \  
     /testcases/run_tests.sh                   # 执行测试脚本  
   

3. 查看测试结果
   测试输出默认打印至控制台，或通过 -v /path/to/output:/results 挂载目录保存报告。

4.3 集成到 CI/CD 流程（示例：GitLab CI）

在 .gitlab-ci.yml 中添加测试阶段配置：

yaml
stages:  
  - test  

istio-test:  
  stage: test  
  image: [镜像仓库地址]/istio-test:latest  
  script:  
    - cd /testcases  
    - ./run_tests.sh --type=integration  # 执行集成测试  
  artifacts:  
    paths:  
      - /testcases/report/  # 保存测试报告  
  only:  
    - main  
    - /^release-.*$/  

五、Docker 部署方案示例

5.1 基础测试（本地 Istio 环境）

bash
docker run -it --rm \  
  -v $(pwd)/testcases:/testcases \          # 本地测试用例目录（含测试脚本和配置）  
  -v ~/.kube/config:/root/.kube/config \    # 访问 Kubernetes 集群  
  --name istio-test-local \  
  [镜像仓库地址]/istio-test:latest \  
  sh -c "cd /testcases && ./validate-istio-config.sh"  # 验证 Istio 配置有效性  

5.2 端到端测试（集成 Envoy 代理）

bash
docker run -d --name istio-e2e-test \  
  -v $(pwd)/e2e-tests:/e2e \  
  -e ISTIO_VERSION=1.19.0 \                # 指定测试的 Istio 版本  
  -e TEST_TYPE=e2e \                       # 测试类型：端到端  
  --network=container:istio-proxy \        # 与 Envoy 容器共享网络命名空间  
  [镜像仓库地址]/istio-test:latest \  
  /e2e/run_e2e.sh  

5.3 docker-compose 配置示例（多测试场景并行）

yaml
# docker-compose.yml  
version: '3'  
services:  
  unit-test:  
    image: [镜像仓库地址]/istio-test:latest  
    volumes:  
      - ./unit-tests:/testcases  
    command: /testcases/run_unit.sh  
    environment:  
      - TEST_TYPE=unit  

  integration-test:  
    image: [镜像仓库地址]/istio-test:latest  
    volumes:  
      - ./integration-tests:/testcases  
      - ~/.kube/config:/root/.kube/config  
    command: /testcases/run_integration.sh  
    environment:  
      - TEST_TYPE=integration  
      - TARGET_NAMESPACE=istio-system  

六、配置参数和环境变量

七、参考链接

• Istio 官方文档：[***]
• Istio 测试框架：[***]