Getting Started

This section requires basic understanding of Kubernetes - make sure you do the tutorial in sequence.
Kubernetes
Install Istio
First, make sure you already have a Kubernetes cluster up and running.
Install istioctl
You need to get the istioctl CLI to install Istio into the cluster.
1
cd $HOME
2
​
3
# Specify an Istio version to install
4
curl -L https://istio.io/downloadIstio | \
5
  ISTIO_VERSION=1.7.4 sh -
Copied!
Add Istio's bin path to shell's PATH.
1
echo 'export PATH="$PATH:$HOME/istio-1.7.4/bin"' >> ~/.bash_profile
2
​
3
source $HOME/.bash_profile
Copied!
Verify istioctl is installed properly and with the correct version:
1
istioctl version
Copied!
Install Istio
Install the demo profile of Istio, which comes with the basic settings for most of the things you'll want to learn about. In addition, because the cluster in this guide enabled Network Policy, so we can use Istio with Container Network Interface (CNI).
1
istioctl install \
2
  --set profile=demo \
3
  --set values.cni.cniBinDir=/home/kubernetes/bin \
4
  --set components.cni.enabled=true \
5
  --set components.cni.namespace=kube-system
Copied!
Validate that Istio is installed. istioctl version should show you the control plane version.
1
istioctl version
Copied!
In addition, Istio is installed into the istio-system namespace.
1
kubectl get ns
2
​
3
kubectl -n=istio-system get pods
Copied!
Install Addons
In addition to core-Istio, you can install addons for observability, for example to see distributed traces and out-of-the-box metrics/dashboard.
1
# Zipkin
2
kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.7/samples/addons/extras/zipkin.yaml
3
​
4
# Prometheus
5
kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.7/samples/addons/prometheus.yaml
6
​
7
# Grafana
8
kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.7/samples/addons/grafana.yaml
9
​
10
# Wait for Grafana a bit before Kiali
11
sleep 20
12
​
13
# Kiali
14
kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.7/samples/addons/kiali.yaml
Copied!

Deployment - Previous

Istio

Sidecar Proxy

Last modified 1yr ago

Copy link

Contents