Exercise 2 - Installing Istio on IBM Cloud Kubernetes Service¶
In this module, you will use the istioctl
CLI to install Istio on your cluster.
-
Check if
istioctl
is installed in the client terminal,$ istioctl version 2021-03-13T23:02:25.382086Z warn will use `--remote=false` to retrieve version info due to `no Istio pods in name 1.5.4
-
If
istioctl
is not installed, download theistioctl
CLI and add it to your PATH:
curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.5.6 sh -
export PATH=$PWD/istio-1.5.6/bin:$PATH
-
List the available profiles,
istioctl profile list
Sample output:
$ istioctl profile list Istio configuration profiles: minimal remote separate default demo empty
-
Install Istio with the
demo
Istio profile into your IKS cluster:istioctl manifest apply --set profile=demo
Sample output:
$ istioctl manifest apply --set profile=demo - Applying manifest for component Base... ✔ Finished applying manifest for component Base. - Applying manifest for component Pilot... ✔ Finished applying manifest for component Pilot. Waiting for resources to become ready... Waiting for resources to become ready... Waiting for resources to become ready... - Applying manifest for component IngressGateways... - Applying manifest for component EgressGateways... - Applying manifest for component AddonComponents... ✔ Finished applying manifest for component IngressGateways. ✔ Finished applying manifest for component EgressGateways. ✔ Finished applying manifest for component AddonComponents. ✔ Installation complete
-
The install can take up to 10 minutes. Ensure the corresponding pods are all in
Running
state before you continue.kubectl get pods -n istio-system
Sample output:
$ kubectl get pods -n istio-system NAME READY STATUS RESTARTS AGE grafana-57cb8b8d44-zld4p 1/1 Running 0 49s istio-egressgateway-794f9f9d64-7hxw5 1/1 Running 0 52s istio-ingressgateway-945588978-gxtqq 1/1 Running 0 52s istio-tracing-7fcc6f5848-8fx8j 1/1 Running 0 49s istiod-7b7d59548-bs9x7 1/1 Running 0 65s kiali-6875bdf78-ppgn7 1/1 Running 0 49s prometheus-5d4c44597d-w49b5 2/2 Running 0 4m33s
NOTE Before you continue, make sure all the pods are deployed and either in the
Running
orCompleted
state. If they're inpending
state, wait a few minutes to let the installation and deployment finish.
-
Check the version of your Istio:
istioctl version
Sample output:
client version: 1.5.4 control plane version: 1.5.4 data plane version: 1.5.4 (3 proxies)
Congratulations! You successfully installed Istio into your cluster.