Istio is an open platform for providing a uniform way to integrate microservices, manage traffic flow across microservices, enforce policies and aggregate telemetry data.
The documentation here is for developers only, please follow the installation instructions from istio.io for all other uses.
This chart bootstraps all Istio components deployment on a Kubernetes cluster using the Helm package manager.
This chart can install multiple Istio components as subcharts:
- ingressgateway
- egressgateway
- sidecarInjectorWebhook
- galley
- mixer
- pilot
- security(citadel)
- grafana
- prometheus
- tracing(jaeger)
- kiali
To enable or disable each component, change the corresponding enabled flag.
- Kubernetes 1.9 or newer cluster with RBAC (Role-Based Access Control) enabled is required
- Helm 2.7.2 or newer or alternately the ability to modify RBAC rules is also required
- If you want to enable automatic sidecar injection, Kubernetes 1.9+ with
admissionregistrationAPI is required, andkube-apiserverprocess must have theadmission-controlflag set with theMutatingAdmissionWebhookandValidatingAdmissionWebhookadmission controllers added and listed in the correct order. - The
istio-initchart must be run to completion prior to install theistiochart.
The chart deploys pods that consume minimum resources as specified in the resources configuration parameter.
-
If a service account has not already been installed for Tiller, install one:
$ kubectl apply -f install/kubernetes/helm/helm-service-account.yaml
-
Install Tiller on your cluster with the service account:
$ helm init --service-account tiller
-
Set and create the namespace where Istio was installed:
$ NAMESPACE=istio-system $ kubectl create ns $NAMESPACE -
If you are enabling
kiali, you need to create the secret that contains the username and passphrase forkialidashboard:$ echo -n 'admin' | base64 YWRtaW4= $ echo -n '1f2d1e2e67df' | base64 MWYyZDFlMmU2N2Rm $ cat <<EOF | kubectl apply -f - apiVersion: v1 kind: Secret metadata: name: kiali namespace: $NAMESPACE labels: app: kiali type: Opaque data: username: YWRtaW4= passphrase: MWYyZDFlMmU2N2Rm EOF
-
If you are using security mode for Grafana, create the secret first as follows:
-
Encode username, you can change the username to the name as you want:
$ echo -n 'admin' | base64 YWRtaW4=
-
Encode passphrase, you can change the passphrase to the passphrase as you want:
$ echo -n '1f2d1e2e67df' | base64 MWYyZDFlMmU2N2Rm
-
Create secret for Grafana:
$ cat <<EOF | kubectl apply -f - apiVersion: v1 kind: Secret metadata: name: grafana namespace: $NAMESPACE labels: app: grafana type: Opaque data: username: YWRtaW4= passphrase: MWYyZDFlMmU2N2Rm EOF
-
-
To install the chart with the release name
istioin namespace $NAMESPACE you defined above:-
With automatic sidecar injection (requires Kubernetes >=1.9.0):
$ helm install istio --name istio --namespace $NAMESPACE -
Without the sidecar injection webhook:
$ helm install istio --name istio --namespace $NAMESPACE --set sidecarInjectorWebhook.enabled=false
-
The Helm chart ships with reasonable defaults. There may be circumstances in which defaults require overrides.
To override Helm values, use --set key=value argument during the helm install command. Multiple --set operations may be used in the same Helm operation.
Helm charts expose configuration options which are currently in alpha. The currently exposed options can be found here.
To uninstall/delete the istio release but continue to track the release:
$ helm delete istioTo uninstall/delete the istio release completely and make its name free for later use:
$ helm delete --purge istio