istio/app_sidecar_ubuntu_bionic

Istio 测试镜像文档

一、镜像概述和主要用途

该镜像为 Istio 官方提供的专用测试镜像，仅用于 Istio 服务网格的测试场景，非生产环境使用。其设计目的是支持开发者和测试人员在本地或测试环境中验证 Istio 的功能、兼容性及集成效果。

官方文档参考：https://istio.io/latest/docs/setup/getting-started/

二、核心功能和特性

• 专用测试环境：包含 Istio 组件的测试版本，适用于非生产环境的功能验证
• 轻量级设计：镜像体积优化，专注于测试必需的工具和依赖
• 兼容性支持：适配 Istio 最新版本的测试用例，便于验证组件间交互

三、使用场景和适用范围

适用场景

• Istio 功能测试：验证 Istio 服务发现、流量管理、安全策略等核心功能
• 集成测试：测试应用程序与 Istio 代理（Envoy）的集成效果
• 版本兼容性验证：验证 Istio 新版本与现有应用的兼容性

适用范围

• 开发者本地测试环境
• CI/CD 流水线中的自动化测试环节
• 非生产环境的 Istio 功能验证

⚠️ 注意：该镜像不具备生产环境所需的稳定性和安全性，严禁用于生产部署。

四、使用方法和配置说明

1. 前提条件

• 已安装 Docker 环境（推荐 Docker 20.10+）
• 网络可访问 Istio 官方镜像仓库（docker.io/istio）

2. 获取镜像

从 Docker Hub 拉取最新测试镜像（需指定具体版本标签，如 1.20.0-test，标签格式以官方发布为准）：

bash
docker pull docker.xuanyuan.run/istio/testing:<version-tag>

3. 基本使用示例

3.1 启动测试容器

通过 docker run 命令启动测试容器，可挂载本地测试配置文件或指定测试命令：

bash
# 示例：启动测试容器并执行基本功能测试
docker run --rm -it \
  -v /path/to/local/test/config:/test/config \  # 挂载测试配置文件
  istio/testing:<version-tag> \
  /test/scripts/run_basic_tests.sh  # 执行测试脚本

3.2 自定义测试参数

若需调整测试行为，可通过环境变量或命令行参数传递（具体参数需参考 Istio 官方测试文档）：

bash
# 示例：设置测试超时时间并启用调试模式
docker run --rm -it \
  -e TEST_TIMEOUT=300s \  # 测试超时时间（默认 180s）
  -e DEBUG_MODE=true \    # 启用调试模式（输出详细日志）
  istio/testing:<version-tag> \
  /test/scripts/run_custom_tests.sh --feature=traffic-management  # 指定测试特性

4. 注意事项

• 测试镜像版本需与目标 Istio 版本匹配，避免兼容性问题
• 容器生命周期：建议使用 --rm 参数，测试完成后自动清理容器
• 资源限制：测试过程可能消耗较多 CPU/内存，建议通过 --cpus、--memory 限制资源使用

五、参考文档

• https://istio.io/latest/docs/setup/getting-started/
• https://github.com/istio/istio/tree/master/tests