istio/examples-bookinfo-ratings-v-unavailable

Istio 示例镜像文档

一、镜像概述和主要用途

该镜像为 Istio 官方提供的示例应用镜像，用于支持 Istio 服务网格的功能演示和文档教程。其核心用途是帮助用户快速部署和验证 Istio 的核心特性，降低学习和测试门槛，配合 Istio 官方文档（[***]

二、核心功能和特性

• 预配置示例环境：内置简化的应用服务，支持 Istio 关键功能（流量管理、安全、可观测性等）的即开即用演示。
• 控制平面兼容性：与 Istio 控制平面组件（Pilot、Citadel 等）无缝集成，可直接用于服务网格功能验证。
• 轻量级设计：镜像体积精简，适合本地测试、CI/CD 演示及文档教程场景。

三、使用场景和适用范围

• Istio 初学者入门：通过示例应用快速理解服务网格的工作原理。
• 部署环境验证：检验 Istio 控制平面和数据平面的部署正确性。
• 特性演示：直观展示 Istio 核心能力（如流量路由、熔断、mTLS 加密等）的实际效果。
• 文档配套工具：作为 Istio 官方教程的标准化运行环境，确保步骤一致性。

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

4.1 前置条件

• 已安装 Istio 控制平面（参考 Istio 官方安装指南）。
• 环境支持：推荐 Kubernetes 集群（生产/测试环境）或 Docker 单机环境（简化演示）。

4.2 Kubernetes 环境使用（推荐）

4.2.1 部署官方示例应用

以 Istio 经典 Bookinfo 示例为例，通过 Kubernetes 资源清单部署：

bash
# 部署 Bookinfo 应用（包含该示例镜像的多个服务）
kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.20/samples/bookinfo/platform/kube/bookinfo.yaml

# 验证部署状态（确保所有 Pod 均为 Running 状态）
kubectl get pods -n default

4.2.2 功能验证

部署完成后，通过 Istio Ingress Gateway 访问示例服务，验证流量路由等功能：

bash
# 获取 Ingress Gateway 入口地址
export INGRESS_HOST=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
export INGRESS_PORT=$(kubectl -n istio-system get service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="http2")].port}')
export GATEWAY_URL=$INGRESS_HOST:$INGRESS_PORT

# 访问 productpage 服务
curl "http://$GATEWAY_URL/productpage"

4.3 Docker 单机环境使用（简化演示）

4.3.1 运行示例容器

通过 docker run 启动单个示例服务（仅用于基础功能演示，不含 Istio 代理注入）：

bash
# 拉取并运行示例镜像（替换 <tag> 为具体版本，如 1.20.0）
docker run --name istio-sample -d -p 8080:8080 istio/samples:<tag>

4.3.2 验证容器状态

bash
# 查看容器日志
docker logs istio-sample

# 访问服务（若镜像包含 HTTP 服务）
curl http://localhost:8080

4.4 配置参数

示例镜像主要用于演示，配置项较少，支持通过环境变量调整基础服务参数：

五、部署方案示例

5.1 Docker Compose 配置（简化版）

适用于本地快速启动多服务示例（模拟服务网格环境）：

yaml
version: '3'
services:
  sample-service-a:
    image: istio/samples:<tag>
    container_name: sample-a
    ports:
      - "8080:8080"
    environment:
      - SERVICE_NAME=service-a
      - PORT=8080
      - LOG_LEVEL=debug

  sample-service-b:
    image: istio/samples:<tag>
    container_name: sample-b
    ports:
      - "8081:8080"
    environment:
      - SERVICE_NAME=service-b
      - PORT=8080
    depends_on:
      - sample-service-a

networks:
  default:
    driver: bridge

启动命令：

bash
docker-compose up -d

5.2 Kubernetes 资源清单示例

以下为单个示例服务的 Deployment 配置（需配合 Istio Sidecar 注入）：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: sample-service
spec:
  replicas: 1
  selector:
    matchLabels:
      app: sample-service
  template:
    metadata:
      labels:
        app: sample-service  # 用于 Istio 服务发现
    spec:
      containers:
      - name: sample-app
        image: istio/samples:<tag>
        ports:
        - containerPort: 8080
        env:
        - name: SERVICE_NAME
          value: "sample-service"
        - name: PORT
          value: "8080"

应用配置：

bash
# 启用命名空间的 Sidecar 自动注入
kubectl label namespace default istio-injection=enabled

# 部署服务
kubectl apply -f sample-deployment.yaml

六、注意事项

• 生产环境禁用：该镜像仅用于演示和学习，未经过生产级安全加固，禁止用于生产环境。
• 版本匹配：需使用与 Istio 控制平面版本一致的镜像标签（如 Istio 1.20.0 对应镜像标签 1.20.0）。
• 高级功能依赖：部分特性（如流量拆分、熔断）需额外配置 Istio 资源（VirtualService、DestinationRule 等）。