Istio on Rancher

This repo is designed to help you quickly "set sail" with Istio on Rancher's deployment of Kubernetes. This guide will help you stand up the BookInfo demo app from Itsio's docs site.

Deploy Rancher/Kubernetes

1. Deploy Rancher 1.6 or higher, create K8 environment.
2. Install kubectl locally. This is the CLI tool for K8 and will allow us to make API calls to the cluster.
3. Download the kubectl config for your new deployment of K8. In Rancher, navigate to Kubernetes > CLI and click "Generate Config". Place the contents contents in ~/.kube/config

Option A - Deploy Istio using Helm (recommended)

1. Install Helm locally. At the time of this writing, Rancher 1.6 supports helm/tiller 2.3, so you want to have a 2.3.x helm client. This is the helm client which will use the information we previously setup in ~/.kube/config to talk to our K8 cluster. We don't need to setup tiller because it is already included in the Rancher distribution.
2. Add the Kubernetes Incubator Helm chart repo: helm repo add incubator http://storage.googleapis.com/kubernetes-charts-incubator Special thanks to the folks who worked on this helm chart.
3. Deploy the chart helm install -n istio incubator/istio

Option B - Deploy Istio using kubectl

1. Run deploy-rancher.sh to apply the K8 services.

Deploy Istio Sample Application (BookInfo)

1. From the root of this repo directory, Run: istioctl_bin=$PWD/bin/istioctl
2. While in the same directory, run kubectl apply -f <(istioctl kube-inject -f samples/apps/bookinfo/bookinfo.yaml)

Viewing the Sample Application

1. Run kubectl get ingress -o wide to get the IP address of the Istio ingress.
2. You should then be able to view BookInfo in your browser at http://$GATEWAYURL/productpage
3. See https://istio.io/docs/samples/bookinfo.html for more information on this app

Feedback

Have you developed something cool with Istio on Rancher? We'd love to hear about it. Feel free to drop us a line on twitter (@Rancher_Labs) or our user slack https://slack.rancher.io/.