#部署 Bookinfo Application

#Bookinfo Application 概述

要安装 bookinfo 示例应用程序，需要两个主要步骤：首先部署应用程序本身，其次设置一个 gateway 以便从集群外部访问它。

bookinfo application 是用于探索 service mesh 功能的工具。它可以让你轻松验证 Web 浏览器请求是否正确地通过 mesh 路由到应用程序。

bookinfo application 展示一本书的相关信息，类似于在线书店目录中的单个条目。它会显示一个包含书籍描述、详细信息（例如 ISBN 和页数）以及客户评论的页面。

当通过 mesh 暴露时，bookinfo application 的微服务行为由 mesh 配置控制。评论数据来自三个服务之一：reviews-v1、reviews-v2 或 reviews-v3。如果你在未定义 reviews virtual service 的情况下部署 bookinfo，mesh 会默认使用 round-robin 策略将请求路由到这些服务。

通过创建 reviews virtual service，你可以定义自定义路由规则。例如，你可以将 mesh 配置为在用户已登录时将请求转发到 reviews-v2 服务，这样会显示黑色星标的评论。相反，对于未登录用户，mesh 可以将请求路由到 reviews-v3，显示红色星标的评论。

更多详细信息可参考上游 Istio 文档中的 Bookinfo Application。

#部署 Bookinfo Application

#前提条件

• 已安装 Alauda Service Mesh v2 Operator。
• 已部署 Istio CNI。
• 已部署 Istio control plane。

#操作步骤

1. 使用以下命令创建一个名为 bookinfo 的新 namespace：

   kubectl create namespace bookinfo

2. 为 bookinfo namespace 启用 sidecar 注入。如果你的环境使用 InPlace 升级策略，请运行以下命令：

   kubectl label namespace bookinfo istio-injection=enabled
   NOTE

   如果你使用的是 RevisionBased 升级策略，请执行以下命令：

   1. 要获取 <revision-name>，请运行以下命令：

      kubectl get istiorevisions.sailoperator.io

      示例输出：

      NAME      NAMESPACE      PROFILE   READY   STATUS    IN USE   VERSION   AGE
      default   istio-system             True    Healthy   True     v1.28.6   47h

   2. 使用 revision 名称为 namespace 打标签，以启用 sidecar 注入：

      kubectl label namespace bookinfo istio.io/rev=default

3. 可选 ：如果你已经配置了 discoverySelectors，请使用以下命令将 Istio discovery selector 应用到 bookinfo namespace：

   示例 discovery selector 标签：istio-discovery=enabled

   kubectl label namespace bookinfo istio-discovery=enabled

4. 通过执行以下命令应用其 YAML 文件，部署 bookinfo application：

   kubectl -n bookinfo apply -f https://raw.githubusercontent.com/alauda-mesh/istio/refs/heads/istio-1.28/samples/bookinfo/platform/kube/bookinfo.yaml

#验证

1. 要确认 bookinfo service 可用，请运行以下命令：

   kubectl get services -n bookinfo

   示例输出

   NAME          TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
   details       ClusterIP   10.4.153.200   <none>        9080/TCP   4m44s
   productpage   ClusterIP   10.4.132.101   <none>        9080/TCP   4m43s
   ratings       ClusterIP   10.4.76.104    <none>        9080/TCP   4m44s
   reviews       ClusterIP   10.4.48.38     <none>        9080/TCP   4m44s

2. 要检查 bookinfo pod 是否可用，请执行以下命令：

   kubectl get pods -n bookinfo

   示例输出

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-c66556f6d-bbqjx        2/2     Running   0          5m56s
   productpage-v1-5f568ff46d-r886k   2/2     Running   0          5m56s
   ratings-v1-74bcfcb96d-7bm8s       2/2     Running   0          5m56s
   reviews-v1-549bfb5f44-xwh4z       2/2     Running   0          5m56s
   reviews-v2-6486bc9868-snch4       2/2     Running   0          5m56s
   reviews-v3-6c66dc6cdd-87jgd       2/2     Running   0          5m56s

   当 Ready 列显示 2/2 时，表示 proxy sidecar 注入成功。确保每个 pod 的 Status 列都显示 Running。

3. 通过向其 product page 发送请求，确认 bookinfo application 正在运行。执行以下命令：

   kubectl exec "$(kubectl get pod -l app=ratings -n bookinfo -o jsonpath='{.items[0].metadata.name}')" -c ratings -n bookinfo -- curl -sS productpage:9080/productpage | grep -o "<title>.*</title>"

   示例输出

   <title>Simple Bookstore App</title>

#通过 Gateway 访问 Bookinfo Application

由于 gateway 不被视为 control plane 的一部分，因此 Alauda Service Mesh v2 Operator 不会部署它们。出于安全考虑，最佳实践是将 Ingress 和 Egress gateway 部署在与 control plane 不同的 namespace 中。

部署 gateway 有两种方法：使用 Gateway API 或 gateway 注入技术。

#使用 Istio Gateway 注入访问 Bookinfo Application

gateway 注入技术利用了与 Istio sidecar 注入相同的机制。它会从与 Service 资源关联的 Deployment 资源创建一个 gateway。随后可以将该 Service 暴露到 Alauda Container Platform 集群外部。

#前提条件

• 已安装 Alauda Service Mesh v2 Operator。
• 已部署 Istio control plane。

#操作步骤

1. 执行以下命令创建 istio-ingressgateway deployment 和 service：

   kubectl -n bookinfo apply -f https://raw.githubusercontent.com/alauda-mesh/sail-operator/refs/heads/main/chart/samples/ingress-gateway.yaml

2. 通过运行以下命令，将 bookinfo application 配置为使用新创建的 gateway：

   kubectl -n bookinfo apply -f https://raw.githubusercontent.com/alauda-mesh/istio/refs/heads/istio-1.28/samples/bookinfo/networking/bookinfo-gateway.yaml
   NOTE

   此示例使用一个示例 gateway 配置文件为 bookinfo application 设置 gateway 注入。该文件必须应用到安装应用程序的同一 namespace 中。

3. 可选 ：修改 YAML 文件，以根据 ingress 流量实现自动 pod 扩缩容。

   示例配置

   apiVersion: autoscaling/v2
   kind: HorizontalPodAutoscaler
   metadata:
     labels:
       istio: ingressgateway
       release: istio
     name: ingressgatewayhpa
     namespace: bookinfo
   spec:
     minReplicas: 2
     maxReplicas: 5
     metrics:
       - resource:
           name: cpu
           target:
             averageUtilization: 80
             type: Utilization
         type: Resource
     scaleTargetRef:
       apiVersion: apps/v1
       kind: Deployment
       name: istio-ingressgateway
   1. 在此示例中，最大副本数设置为 5，最小副本数设置为 2。当 CPU 利用率达到 80% 时，会创建一个新副本。

4. 可选 ：定义节点上应运行的最小 pod 数量。

   示例配置

   apiVersion: policy/v1
   kind: PodDisruptionBudget
   metadata:
     labels:
       istio: ingressgateway
       release: istio
     name: ingressgatewaypdb
     namespace: bookinfo
   spec:
     minAvailable: 1
     selector:
       matchLabels:
         istio: ingressgateway
   1. 此示例配置可确保当某个 pod 在不同节点上重启时，至少有一个副本处于运行状态。

#验证

你将通过刚刚部署的 gateway 连接到 Bookinfo productpage service。要访问该 gateway，需要使用 kubectl port-forward 命令：

kubectl -n bookinfo port-forward svc/istio-ingressgateway 9080:80

• 如果你在本地工作站上运行该命令，请在浏览器中打开 http://localhost:9080/productpage。
• 如果你在远程 IPv4 主机上运行该命令，并使用了 --address "0.0.0.0"，请将 localhost 替换为远程主机的 IP 或主机名（例如 http://<REMOTE_HOST_IP>:9080/productpage）
• 如果你在远程 IPv6 主机上运行该命令，并使用了 --address "::"，请将 localhost 替换为远程主机的 IP 或主机名（例如 http://[<REMOTE_HOST_IP>]:9080/productpage）

当你多次刷新页面时，应会看到 productpage 中显示不同版本的 reviews，呈现 round robin 方式（红色星标、黑色星标、无星标），因为我们尚未使用 Istio 来控制版本路由。

#使用 Gateway API 访问 Bookinfo Application

使用 Kubernetes Gateway API 时，gateway 通过创建 Gateway 资源进行部署。

#前提条件

• 已安装 Alauda Service Mesh v2 Operator。
• 已部署 Istio control plane。
• 你的 Kubernetes 集群支持外部负载均衡器（即 LoadBalancer 类型的 Service）

#操作步骤

1. 通过执行以下命令，使用 Gateway 和 HTTPRoute 资源创建并配置 gateway：

   kubectl -n bookinfo apply -f https://raw.githubusercontent.com/alauda-mesh/istio/refs/heads/istio-1.28/samples/bookinfo/gateway-api/bookinfo-gateway.yaml 
   NOTE

   此示例使用一个示例 gateway 配置文件，通过 Gateway API 为 bookinfo application 配置 gateway。该文件必须应用到应用程序的 namespace 中。

2. 通过运行以下命令，确保 Gateway API service 已就绪并具有地址：

   kubectl wait --for=condition=programmed gtw bookinfo-gateway -n bookinfo

3. 使用以下命令获取 host：

   export INGRESS_HOST=$(kubectl get gtw bookinfo-gateway -n bookinfo -o jsonpath='{.status.addresses[0].value}')
   echo "INGRESS_HOST=$INGRESS_HOST"

4. 使用以下命令获取 port：

   export INGRESS_PORT=$(kubectl get gtw bookinfo-gateway -n bookinfo -o jsonpath='{.spec.listeners[?(@.name=="http")].port}')
   echo "INGRESS_PORT=$INGRESS_PORT"

5. 使用以下命令获取 gateway URL：

   INFO

   如果 $INGRESS_HOST 是 IPv6 地址，在构造 URL 时请将其括在方括号中。例如：

   export GATEWAY_URL=[$INGRESS_HOST]:$INGRESS_PORT

   export GATEWAY_URL=$INGRESS_HOST:$INGRESS_PORT

6. 通过运行以下命令获取 product page 的完整 URL：

   echo "http://${GATEWAY_URL}/productpage"

#验证

• 通过 curl 命令确认 productpage 可访问：

  curl -sS -g "http://${GATEWAY_URL}/productpage" | grep -o "<title>.*</title>"

  示例输出

  <title>Simple Bookstore App</title>

• 确认可以在 Web 浏览器中访问 productpage。

  在浏览器中访问 http://${GATEWAY_URL}/productpage，查看 Bookinfo Web 页面。

  当你多次刷新页面时，应会看到 productpage 中显示不同版本的 reviews，呈现 round robin 方式（红色星标、黑色星标、无星标），因为我们尚未使用 Istio 来控制版本路由。

#删除 Bookinfo Application

在完成对 Bookinfo application 的探索后，请通过删除 bookinfo namespace 来移除应用程序及其所有关联的 gateway 资源：

kubectl delete namespace bookinfo