部署 Bookinfo 示例

部署官方 Bookinfo 示例应用。

该示例部署了一个用于演示多种 Istio 特性的应用，该应用由四个单独的微服务构成。 这个应用模仿在线书店的一个分类，显示一本书的信息。 页面上会显示一本书的描述，书籍的细节（ISBN、页数等），以及关于这本书的一些评论。

Bookinfo 应用分为四个单独的微服务：

• productpage：这个微服务会调用 details 和 reviews 两个微服务，用来生成页面。
• details：这个微服务中包含了书籍的信息。
• reviews：这个微服务中包含了书籍相关的评论。它还会调用 ratings 微服务。
• ratings：这个微服务中包含了由书籍评价组成的评级信息。

reviews 微服务有 3 个版本：

• v1 版本不会调用 ratings 服务。
• v2 版本会调用 ratings 服务，并使用 1 到 5 个黑色星形图标来显示评分信息。
• v3 版本会调用 ratings 服务，并使用 1 到 5 个红色星形图标来显示评分信息。

下图展示了这个应用的端到端架构。

1、部署服务

1. 进入 Istio 安装目录。

2. Istio 默认 自动注入 sidecar。请为 default 命名空间打上标签 istio-injection=enabled：

   $ kubectl label namespace default istio-injection=enabled
   namespace/default labeled
   

3. 使用 kubectl apply -f 命令部署应用：

   kubectl apply -f samples/bookinfo/platform/kube/bookinfo.yaml
   

4. 确认所有的服务和 Pod 都已经正确的定义和启动：

   kubectl get service
   
   kubectl get pod
   

5. 要确认 Bookinfo 应用是否正在运行，请在某个 Pod 中用 curl 命令对应用发送请求，例如 ratings：

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

2、确定 Ingress 的 IP 和端口

现在 Bookinfo 中的所有服务都启动并运行中，您需要使应用程序可以从外部访问，例如使用浏览器。可以通过 Istio Gateway 和 istio-ingress 来实现。

1. 为应用程序定义 Ingress 网关

   kubectl apply -f samples/bookinfo/networking/bookinfo-gateway.yaml
   

2. 确认网关创建完成

   $ kubectl get gateway
   NAME               AGE
   bookinfo-gateway   32s
   

3. 确认 Ingress 的 IP 和端口

   执行如下命令，明确自身 Kubernetes 集群环境支持外部负载均衡：

   $ kubectl get svc istio-ingressgateway -n istio-system
   NAME                   TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)                                                                      AGE
   istio-ingressgateway   LoadBalancer   10.108.112.232   localhost     15021:32133/TCP,80:31412/TCP,443:31507/TCP,31400:32717/TCP,15443:32369/TCP   22h
   

   默认端口为 80。

3、确认可以从集群外部访问应用

用浏览器打开网址 http://<EXTERNAL-IP>/productpage，来浏览应用的 Web 页面。如果刷新几次应用的页面，就会看到 productpage 页面中会随机展示 reviews 服务的不同版本的效果（红色、黑色的星形或者没有显示）。reviews 服务出现这种情况是因为我们还没有使用 Istio 来控制版本的路由。

接下来的 Istio 学习中，可以使用此示例来验证 Istio 的流量路由、故障注入等功能。

4、卸载示例应用

当完成 Bookinfo 示例的实验后，如有需要可按照以下说明进行卸载和清理：

1. 删除路由规则，并终止应用程序容器

   samples/bookinfo/platform/kube/cleanup.sh
   

2. 确认卸载

   kubectl get virtualservices   #-- there should be no virtual services
   kubectl get destinationrules  #-- there should be no destination rules
   kubectl get gateway           #-- there should be no gateway
   kubectl get pods              #-- the Bookinfo pods should be deleted