容器与云原生 / 系统课时
搭建 Istio 1.30 实验环境
搭建 Istio 1.30 实验环境
本节搭建一套可重复验证的 Istio 1.30.3 实验环境:先安装支持 Ambient 的控制面、CNI 与 ztunnel,再部署 Bookinfo 验证 HBONE 纳管,最后把同一命名空间切换到 Sidecar 模式并检查 Envoy 与 Istiod 的 xDS 同步状态。
学习目标
- 使用固定版本的
istioctl安装 Istio 1.30.3 Ambient 组件并检查就绪状态 - 部署 Bookinfo,并通过 Pod 状态与 ztunnel 工作负载视图确认 Ambient 纳管
- 切换到 Sidecar 注入,验证 Envoy 容器和 CDS、LDS、EDS、RDS 同步状态
检查实验前提
Istio 1.30 支持 Kubernetes 1.32~1.36。开始前确认 kubectl 已指向可操作的实验集群,并准备 Linux、macOS 或兼容 Bash 环境。实验使用独立命名空间 mesh-lab,避免影响现有业务命名空间。
固定下载 1.30.3,避免以后执行脚本时自动取得更高版本。下面以 x86_64 为例;其他 CPU 架构应把 TARGET_ARCH 改为下载脚本支持的实际架构。
curl -fsSL https://istio.io/downloadIstio | ISTIO_VERSION=1.30.3 TARGET_ARCH=x86_64 sh - >/dev/null
cd istio-1.30.3
export PATH="$PWD/bin:$PATH"
istioctl version --remote=false预期输出
client version: 1.30.3如果版本不是 1.30.3,先修正 PATH,不要继续用其他版本的 istioctl 操作本实验。
安装 Ambient 组件
ambient profile 会安装 Istiod、Istio CNI 与 ztunnel。Istiod 负责控制面配置,CNI 负责把已纳管工作负载接入数据路径,ztunnel 以 DaemonSet 形式提供 Ambient 的节点级 L4 安全隧道。
istioctl install --set profile=ambient --skip-confirmation >/dev/null
kubectl rollout status deployment/istiod -n istio-system --timeout=180s
kubectl rollout status daemonset/istio-cni-node -n istio-system --timeout=180s
kubectl rollout status daemonset/ztunnel -n istio-system --timeout=180s预期输出
deployment "istiod" successfully rolled out
daemon set "istio-cni-node" successfully rolled out
daemon set "ztunnel" successfully rolled outztunnel 正常情况下会在每个符合调度条件的节点上运行实例。若某个节点长期缺少 ztunnel,应先排查节点污点、CNI 或 Pod 调度问题,再进行应用纳管。

部署并验证 Ambient
先创建命名空间并添加 istio.io/dataplane-mode=ambient 标签,再部署 Bookinfo。Ambient 不向业务 Pod 注入 Envoy Sidecar,因此应用 Pod 仍应只有自己的业务容器。
kubectl create namespace mesh-lab --dry-run=client -o yaml | kubectl apply -f - >/dev/null
kubectl label namespace mesh-lab istio.io/dataplane-mode=ambient --overwrite >/dev/null
kubectl apply -n mesh-lab -f samples/bookinfo/platform/kube/bookinfo.yaml >/dev/null
kubectl wait --for=condition=available deployment --all -n mesh-lab --timeout=180s
kubectl get pods -n mesh-lab预期输出
deployment.apps/details-v1 condition met
deployment.apps/productpage-v1 condition met
deployment.apps/ratings-v1 condition met
deployment.apps/reviews-v1 condition met
deployment.apps/reviews-v2 condition met
deployment.apps/reviews-v3 condition met
NAME READY STATUS RESTARTS AGE
details-v1-<ID> 1/1 Running 0 <TIME>
productpage-v1-<ID> 1/1 Running 0 <TIME>
ratings-v1-<ID> 1/1 Running 0 <TIME>
reviews-v1-<ID> 1/1 Running 0 <TIME>
reviews-v2-<ID> 1/1 Running 0 <TIME>
reviews-v3-<ID> 1/1 Running 0 <TIME>Pod 名称、年龄和输出顺序会不同;这里要检查的是应用均为 Running,READY 为 1/1,说明没有注入 istio-proxy 容器。
仅看到 1/1 还不能证明 Ambient 数据路径已经生效。继续查看 ztunnel 接收到的工作负载配置,PROTOCOL 为 HBONE 表示该工作负载按 Ambient 方式进入安全覆盖网络。
istioctl ztunnel-config workloads -n istio-system | grep -E '(^NAMESPACE|^mesh-lab[[:space:]])'预期输出
NAMESPACE POD NAME IP NODE WAYPOINT PROTOCOL
mesh-lab details-v1-<ID> <IP> <NODE> None HBONE
mesh-lab productpage-v1-<ID> <IP> <NODE> None HBONE
mesh-lab ratings-v1-<ID> <IP> <NODE> None HBONE
mesh-lab reviews-v1-<ID> <IP> <NODE> None HBONE
mesh-lab reviews-v2-<ID> <IP> <NODE> None HBONE
mesh-lab reviews-v3-<ID> <IP> <NODE> None HBONE这里没有部署 Waypoint,因此 WAYPOINT 通常为 None;这不妨碍 ztunnel 为 Ambient 工作负载提供 L4 mTLS 与身份能力。
切换到 Sidecar 并验证
Sidecar 注入发生在 Pod 创建阶段。先移除 Ambient 标签,再启用自动注入并重建 Deployment,避免同一实验命名空间同时依赖两种纳管标签。重建后,Bookinfo Pod 通常应从 1/1 变为 2/2。
kubectl label namespace mesh-lab istio.io/dataplane-mode- >/dev/null
kubectl label namespace mesh-lab istio-injection=enabled --overwrite >/dev/null
kubectl rollout restart deployment -n mesh-lab >/dev/null
kubectl rollout status deployment --all -n mesh-lab --timeout=180s
kubectl get pods -n mesh-lab
istioctl proxy-status | grep -E '(^NAME|\.mesh-lab[[:space:]])'预期输出
deployment "details-v1" successfully rolled out
deployment "productpage-v1" successfully rolled out
deployment "ratings-v1" successfully rolled out
deployment "reviews-v1" successfully rolled out
deployment "reviews-v2" successfully rolled out
deployment "reviews-v3" successfully rolled out
NAME READY STATUS RESTARTS AGE
details-v1-<ID> 2/2 Running 0 <TIME>
productpage-v1-<ID> 2/2 Running 0 <TIME>
ratings-v1-<ID> 2/2 Running 0 <TIME>
reviews-v1-<ID> 2/2 Running 0 <TIME>
reviews-v2-<ID> 2/2 Running 0 <TIME>
reviews-v3-<ID> 2/2 Running 0 <TIME>
NAME CLUSTER CDS LDS EDS RDS ECDS ISTIOD VERSION
details-v1-<ID>.mesh-lab Kubernetes SYNCED SYNCED SYNCED SYNCED NOT SENT istiod-<ID> 1.30.3
productpage-v1-<ID>.mesh-lab Kubernetes SYNCED SYNCED SYNCED SYNCED NOT SENT istiod-<ID> 1.30.3
ratings-v1-<ID>.mesh-lab Kubernetes SYNCED SYNCED SYNCED SYNCED NOT SENT istiod-<ID> 1.30.3
reviews-v1-<ID>.mesh-lab Kubernetes SYNCED SYNCED SYNCED SYNCED NOT SENT istiod-<ID> 1.30.3
reviews-v2-<ID>.mesh-lab Kubernetes SYNCED SYNCED SYNCED SYNCED NOT SENT istiod-<ID> 1.30.3
reviews-v3-<ID>.mesh-lab Kubernetes SYNCED SYNCED SYNCED SYNCED NOT SENT istiod-<ID> 1.30.3Istio 1.30 的 proxy-status 表格包含 CLUSTER 与 ECDS,因此这里保留完整原始列,不再用固定列号重组表格。对本实验的 Bookinfo Sidecar,重点检查 CDS、LDS、EDS、RDS 均为 SYNCED;未使用扩展配置时 ECDS 显示 NOT SENT 属于正常现象。Pod ID、Istiod Pod 名称和时间等动态值会不同。
实验环境是否可用,不以安装命令返回成功为准,而要同时满足系统组件就绪、Ambient 工作负载显示 HBONE,以及切换 Sidecar 后 Envoy 出现并完成关键 xDS 同步。