Install with Helm
This guide shows you how to install Istio in ambient mode with Helm. Aside from following the demo in Getting Started with Ambient Mode5, we encourage the use of Helm to install Istio for use in ambient mode. Helm helps you manage components separately, and you can easily upgrade the components to the latest version.
Prerequisites
Check the Platform-Specific Prerequisites6.
Install the Helm client7, version 3.6 or above.
Configure the Helm repository:
See helm repo8 for command documentation.
Install the components
Install the base component
The base
chart contains the basic CRDs and cluster roles required to set up Istio.
This should be installed prior to any other Istio component.
Install the CNI component
The cni
chart installs the Istio CNI plugin. It is responsible for detecting the pods that belong to the ambient mesh, and configuring the traffic redirection between pods and the ztunnel node proxy (which will be installed later).
Install the Istiod component
The istiod
chart installs a revision of Istiod. Istiod is the control plane component that manages and
configures the proxies to route traffic within the mesh.
Install the ztunnel component
The ztunnel
chart installs the ztunnel DaemonSet, which is the node proxy component of Istio’s ambient mode.
Install an ingress gateway (optional)
To install an ingress gateway, run the command below:
If your Kubernetes cluster doesn’t support the LoadBalancer
service type (type: LoadBalancer
) with a proper external IP assigned, run the above command without the --wait
parameter to avoid the infinite wait. See Installing Gateways9 for in-depth documentation on gateway installation.
Configuration
To view supported configuration options and documentation, run:
Verify the installation
Verify the workload status
After installing all the components, you can check the Helm deployment status with:
You can check the status of the deployed pods with:
Verify with the sample application
After installing ambient mode with Helm, you can follow the Deploy the sample application10 guide to deploy the sample application and ingress gateways, and then you can add your application to the ambient mesh.
Uninstall
You can uninstall Istio and its components by uninstalling the charts installed above.
List all the Istio charts installed in
istio-system
namespace:(Optional) Delete any Istio gateway chart installations:
Delete the Istio CNI chart:
Delete the Istio ztunnel chart:
Delete the Istio discovery chart:
Delete the Istio base chart:
Delete CRDs installed by Istio (optional)
Delete the
istio-system
namespace: