Switch branches/tags
Nothing to show
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Istio

This chart has been deprecated as of version 0.2.12-chart4 and will not be updated. Please use the upstream charts found here instead.

Istio, Istio is an open platform that provides a uniform way to connect, manage, and secure microservices. Istio supports managing traffic flows between microservices, enforcing access policies, and aggregating telemetry data, all without requiring changes to the microservice code.

TL;DR;

$ helm repo add incubator https://kubernetes-charts-incubator.storage.googleapis.com
$ helm install incubator/istio

Introduction

This chart bootstraps a Istio deployment on a Kubernetes cluster using the Helm package manager.

Prerequisites

  • Kubernetes 1.6+
  • Kubernetes 1.7+ if you would like to use the Initializer (auto-inject)
  • istioctl

istioctl installation steps

Run

curl -L https://git.io/getIstio | sh -

to download and extract the latest release automatically (on MacOS and Ubuntu), the istioctl client will be added to your PATH by the above shell command.

RBAC

By default the chart is installed without associated RBAC roles and rolebindings. If you would like to install the provided roles and rolebindings please do the following:

$ helm install incubator/istio --set rbac.install=true

This will install the associated RBAC roles and rolebindings using beta annotations.

To determine if your cluster supports this running the following:

$ kubectl api-versions | grep rbac

You also need to have the following parameter on the api server. See the following document for how to enable RBAC

--authorization-mode=RBAC

If the output contains "beta" or both "alpha" and "beta" you can proceed with normal installation.

Changing RBAC manifest apiVersion

By default the RBAC resources are generated with the "v1beta1" apiVersion. To use "v1alpha1" do the following:

$ helm install --name my-release incubator/istio --set rbac.install=true,rbac.apiVersion=v1alpha1

If it does not. Follow the steps below to disable.

Disable RBAC role/rolebinding creation

If you don't want the RBAC roles and bindings to be created by the installation of this chart simply install the default chart.

$ helm install --name my-release incubator/istio

Installing the Chart

It is recommended that you install Istio into the istio-system namespace.

Full installation requires two steps.

The first step will install the prerequisite CRDs.

To install the chart with the release name istio into the namespace istio-system:

$ helm install --name istio incubator/istio --namespace istio-system

The second step will install the Istio components

helm upgrade istio incubator/istio --reuse-values --set istio.install=true

The command deploys Istio on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.

Tip: List all releases using helm list

Uninstalling the Chart

To uninstall/delete the istio deployment:

$ helm delete istio

The command removes all the Kubernetes components associated with the chart and deletes the release.

Configuration

The following table lists the configurable parameters of the Istio chart and their default values.

Tip: You can use the default values.yaml

Parameter Description Default

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

$ helm install incubator/istio --name my-release \
    --set auth.enabled=false

Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. For example,

$ helm install incubator/istio --name my-release -f values.yaml

Custom ConfigMaps

When creating a new chart with this chart as a dependency, customConfigMap can be used to override the default config map provided. To use, set the value to true and provide the file templates/configmap.yaml for your use case. If you start by copying configmap.yaml from this chart and want to access values from this chart you must change all references from .Values to .Values.istio.

pilot:
  customConfigMap: true

Addons

Istio ships with several preconfigured addons

  • Grafana
  • Prometheus
  • ServiceGraph
  • Zipkin

These addons can be selectively installed by setting addons.<addon-name>.enabled=false in values.yaml or by using the --set command

Auto-inject

If you are running a Kubernetes 1.7+ and have the Initializers api enabled you may choose to enable the Initializer to be installed. See the docs on how to enable.

helm install --name my-release --devel incubator/istio --namespace istio-system --set istio.install=true,initializer.enabled=true