#在 ambient 模式下部署 Bookinfo 原生应用

您可以依赖 ZTunnel proxy，在无需 sidecar 注入的情况下，以 ambient 模式部署 Bookinfo 示例原生应用。有关 Bookinfo 原生应用的背景信息，请参阅 Deploying the Bookinfo Application。

#前提条件

• 具有 cluster-admin 角色的集群管理员已建立一个处于活动状态的 ACP CLI (kubectl) 会话。
• 已在本地安装 istioctl，以便可以使用它来执行这些操作步骤。
• 已安装 Alauda Service Mesh Operator 2.1.1 或更高版本，已创建 Istio resource，并且 Operator 已部署 Istio。
• 已创建 IstioCNI resource，并且 Operator 已部署所需的 IstioCNI pods。
• 已创建 ZTunnel resource，并且 Operator 已部署所需的 ZTunnel pods。

#操作步骤

1. 创建 bookinfo namespace：

   kubectl create namespace bookinfo

2. 将 istio-discovery=enabled label 添加到 bookinfo namespace：

   kubectl label namespace bookinfo istio-discovery=enabled

3. 部署 Bookinfo 原生应用：

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

   应用 bookinfo-versions YAML 文件以创建 Bookinfo 服务的多个版本：

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

4. 验证 Bookinfo pods 是否正在运行：

   kubectl get pods -n bookinfo

   示例输出

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-569946bc86-f5xks       1/1     Running   0          2m30s
   productpage-v1-6c76dd65f7-tk5mr   1/1     Running   0          2m29s
   ratings-v1-5fd569d7c8-5x778       1/1     Running   0          2m30s
   reviews-v1-7668bf774d-qvpjh       1/1     Running   0          2m30s
   reviews-v2-55dd985686-bxv5v       1/1     Running   0          2m29s
   reviews-v3-5d7d6bddd8-2wr5w       1/1     Running   0          2m29s

5. 确认 Bookinfo 原生应用正在响应：

   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>

6. 通过为整个 namespace 或单个 pod 添加 label，将 Bookinfo 原生应用纳入 ambient mesh：

   • 要包含 bookinfo namespace 中的所有 workload：

     kubectl label namespace bookinfo istio.io/dataplane-mode=ambient

   • 要仅包含特定 workload，请直接为单个 pod 应用 istio.io/dataplane-mode=ambient label。有关用于将 workload 添加到 mesh 或从 mesh 中排除的 label 的详细信息，请参阅 Additional resources 部分。

     NOTE

     将 workload 纳入 ambient mesh 不需要重启或重新部署应用 pods。与 sidecar 模式不同，每个 pod 中的容器数量保持不变。

7. 确认 ZTunnel proxy 已在 pod network namespaces 中成功建立监听套接字：

   istioctl -n ztunnel ztunnel-config workloads

   将 bookinfo namespace 添加到 Ambient mesh 后，您会看到 HBONE protocol。

   示例输出

   NAMESPACE    POD NAME                        ADDRESS    NODE           WAYPOINT PROTOCOL
   bookinfo     details-v1-569946bc86-f5xks     10.3.0.143 192.168.131.32 None     HBONE
   bookinfo     productpage-v1-6c76dd65f7-tk5mr 10.3.0.148 192.168.131.32 None     HBONE
   bookinfo     ratings-v1-5fd569d7c8-5x778     10.3.0.144 192.168.131.32 None     HBONE
   bookinfo     reviews-v1-7668bf774d-qvpjh     10.3.0.145 192.168.131.32 None     HBONE
   bookinfo     reviews-v2-55dd985686-bxv5v     10.3.0.146 192.168.131.32 None     HBONE
   bookinfo     reviews-v3-5d7d6bddd8-2wr5w     10.3.0.147 192.168.131.32 None     HBONE
   istio-cni    istio-cni-node-vfrbr            10.3.0.140 192.168.131.32 None     TCP
   istio-system istiod-57f9449cdd-56gl8         10.3.0.141 192.168.131.32 None     TCP
   ztunnel      ztunnel-lf7c9                   10.3.0.142 192.168.131.32 None     TCP

#清理

# Remove the namespace from the ambient data plane
kubectl label namespace bookinfo istio.io/dataplane-mode-
# Remove the Bookinfo namespace
kubectl delete namespace bookinfo

#其他资源

• 在 ambient 模式下将 workload 添加到 mesh（Istio documentation）