通过 Helm 安装
我们鼓励使用 Helm 在 Ambient 模式下安装 Istio 以供生产使用。 为了允许受控的升级,控制平面和数据平面组件是分开打包和安装的。 (由于 Ambient 数据平面分为 ztunnel 和 waypoint 两个组件, 所以需要单独升级这些组件。)
前提条件
检查平台特定的前提条件。
安装 Helm 客户端,版本要求 3.6 或更高。
配置 Helm 仓库:
$ helm repo add istio https://istio-release.storage.googleapis.com/charts $ helm repo update
安装或升级 Kubernetes Gateway API CRD
请注意,Kubernetes Gateway API CRD 不会默认安装在大多数 Kubernetes 集群上, 因此请确保在使用 Gateway API 之前已安装好这些 CRD:
$ kubectl get crd gateways.gateway.networking.k8s.io &> /dev/null || \
{ kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.2.0/standard-install.yaml; }
安装控制平面
可以使用一个或多个 --set <parameter>=<value>
参数更改默认配置值。
或者,您可以使用 --values <file>
参数在自定义值文件中指定多个参数。
有关如何使用和自定义 Helm 安装的完整详细信息, 请参阅 Sidecar 安装文档。
与 istioctl 配置文件(它会将要安装或移除的组件放在一组)不同, 而 Helm 配置文件只是对配置值做了分组。
基本组件
base
Chart 包含设置 Istio 所需的基本 CRD 和集群角色。
需要先安装此 Chart,才能安装任何其他 Istio 组件。
$ helm install istio-base istio/base -n istio-system --create-namespace --wait
istiod 控制平面
istiod
Chart 安装了修订版的 Istiod。Istiod 是管理和配置代理以在网格内路由流量的控制平面组件。
$ helm install istiod istio/istiod --namespace istio-system --set profile=ambient --wait
CNI 节点代理
cni
Chart 安装 Istio CNI 节点代理。此代理负责检测属于 Ambient 网格的 Pod,
并配置 Pod 和 ztunnel 节点代理(稍后安装)之间的流量重定向。
$ helm install istio-cni istio/cni -n istio-system --set profile=ambient --wait
安装数据平面
ztunnel DaemonSet
ztunnel
Chart 会安装 ztunnel DaemonSet,它是 Istio Ambient 模式的节点代理组件。
$ helm install ztunnel istio/ztunnel -n istio-system --wait
入口网关(可选)
要安装入口网关,请运行以下命令:
$ helm install istio-ingress istio/gateway -n istio-ingress --create-namespace --wait
如果您的 Kubernetes 集群不支持分配了正确外部 IP 的
LoadBalancer
服务类型(type: LoadBalancer
),
请在不带 --wait
参数的情况下运行上述命令,以避免无限等待。
有关网关安装的详细文档,
请参阅安装 Gateway。
配置
要查看受支持的配置选项和文档,请运行:
$ helm show values istio/istiod
验证安装
验证工作负载状态
安装所有组件后,您可以使用以下命令检查 Helm 部署状态:
$ helm ls -n istio-system
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
istio-base istio-system 1 2024-04-17 22:14:45.964722028 +0000 UTC deployed base-1.24.1 1.24.1
istio-cni istio-system 1 2024-04-17 22:14:45.964722028 +0000 UTC deployed cni-1.24.1 1.24.1
istiod istio-system 1 2024-04-17 22:14:45.964722028 +0000 UTC deployed istiod-1.24.1 1.24.1
ztunnel istio-system 1 2024-04-17 22:14:45.964722028 +0000 UTC deployed ztunnel-1.24.1 1.24.1
您可以使用以下命令检查已部署的 Pod 状态:
$ kubectl get pods -n istio-system
NAME READY STATUS RESTARTS AGE
istio-cni-node-g97z5 1/1 Running 0 10m
istiod-5f4c75464f-gskxf 1/1 Running 0 10m
ztunnel-c2z4s 1/1 Running 0 10m
使用示例应用进行验证
使用 Helm 安装 Ambient 模式后, 您可以按照部署示例应用指南部署示例应用和入口网关, 然后您可以添加您的应用到 Ambient 网格中。
卸载
您可以通过卸载上面安装的 Chart 来卸载 Istio 及其组件。
列出安装在
istio-system
命名空间中的所有 Istio Chart:$ helm ls -n istio-system NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION istio-base istio-system 1 2024-04-17 22:14:45.964722028 +0000 UTC deployed base-1.24.1 1.24.1 istio-cni istio-system 1 2024-04-17 22:14:45.964722028 +0000 UTC deployed cni-1.24.1 1.24.1 istiod istio-system 1 2024-04-17 22:14:45.964722028 +0000 UTC deployed istiod-1.24.1 1.24.1 ztunnel istio-system 1 2024-04-17 22:14:45.964722028 +0000 UTC deployed ztunnel-1.24.1 1.24.1
1.(可选)删除所有 Istio 网关 Chart 安装文件:
$ helm delete istio-ingress -n istio-ingress
$ kubectl delete namespace istio-ingress
删除 ztunnel Chart:
$ helm delete ztunnel -n istio-system
删除 Istio CNI Chart:
$ helm delete istio-cni -n istio-system
删除 istiod 控制平面 Chart:
$ helm delete istiod -n istio-system
删除 Istio base Chart:
$ helm delete istio-base -n istio-system
删除通过 Istio 安装的 CRD(可选)
$ kubectl get crd -oname | grep --color=never 'istio.io' | xargs kubectl delete
删除
istio-system
命名空间:$ kubectl delete namespace istio-system