mercari/pilot

Istio Pilot（修改版）镜像文档

镜像概述

该镜像为Istio Pilot的修改版本，核心变更为覆盖了默认的重试策略。Istio Pilot作为服务网格的控制平面组件，负责服务发现、流量管理规则分发等功能，本修改版专注于提供自定义的流量重试行为配置能力。

核心功能与特性

• 自定义重试策略：覆盖Istio默认的服务间调用重试策略，支持调整重试次数、重试超时、重试条件等参数
• 保持核心功能：保留Istio Pilot原有的服务发现、配置分发、流量路由等核心能力
• 兼容性：与标准Istio控制平面组件（如Istiod）兼容，可无缝集成到现有Istio服务网格环境

使用场景

适用于需要调整服务网格中服务间调用重试行为的场景，例如：

• 减少特定服务的重试次数以避免级联故障
• 增加关键服务的重试次数以提高系统可用性
• 自定义重试条件（如基于响应码、错误类型）以满足业务需求
• 调整重试超时时间以适配不同服务的响应特性

使用方法

拉取镜像

bash
docker pull [镜像仓库地址]/modified-istio-pilot:[版本标签]

运行容器

bash
docker run -d \
  --name modified-istio-pilot \
  -p 8080:8080 \
  -v /path/to/custom-retry-config:/etc/istio/pilot/custom-config \
  [镜像仓库地址]/modified-istio-pilot:[版本标签]

配置说明

自定义重试策略配置

通过挂载配置文件自定义重试策略，配置文件示例（custom-retry-config.yaml）：

yaml
retryPolicy:
  attempts: 3  # 重试次数
  perTryTimeout: 2s  # 每次重试超时时间
  retryOn: "5xx,gateway-error,connect-failure,refused-stream"  # 触发重试的条件

环境变量

Docker Compose 示例

yaml
version: '3'
services:
  pilot:
    image: [镜像仓库地址]/modified-istio-pilot:[版本标签]
    container_name: modified-istio-pilot
    ports:
      - "8080:8080"
    volumes:
      - ./custom-retry-config:/etc/istio/pilot/custom-config
    environment:
      - PILOT_CUSTOM_RETRY_CONFIG_PATH=/etc/istio/pilot/custom-config/retry-policy.yaml
      - PILOT_LOG_LEVEL=debug
    restart: unless-stopped

注意事项

• 确保自定义重试策略配置与Istio版本兼容
• 修改重试策略可能影响服务网格的整体稳定性，建议在测试环境充分验证后再应用到生产环境
• 需配合Istio数据平面组件（如Envoy）使用，确保数据平面能正确接收并应用自定义重试策略