Setup For Istio Tutorials¶

Clone iter8 repository¶

git clone https://github.com/iter8-tools/iter8.git
cd iter8
export ITER8=$(pwd)

Install Istio¶

For production installation of Istio, refer to the official Istio instructions. For exercising Iter8 tutorials, install Istio as follows.

If not already cloned, clone the iter8 repositiory.

$ITER8/samples/istio/quickstart/istio-setup.sh

Install Optional Prometheus Add-On¶

The Iter8 Prometheus add-on is suitable only for tutorials. To install Prometheus for production, see the official Prometheus documentation.

To install the add-on:

export TAG=v0.7.21
kustomize build https://github.com/iter8-tools/iter8/install/prometheus-add-on/prometheus-operator/?ref=${TAG} | kubectl apply -f -
kubectl wait crd -l creator=iter8 --for condition=established --timeout=120s
kustomize build https://github.com/iter8-tools/iter8/install/prometheus-add-on/prometheus/?ref=${TAG} | kubectl apply -f -
kubectl apply -f ${ITER8}/samples/istio/quickstart/service-monitor.yaml

Install Argo CD¶

If not already cloned, clone the iter8 repositiory.

$ITER8/samples/istio/gitops/argocd-setup.sh

The output from the install script will provide instructions on how to access the Argo CD UI to setup your Argo CD app. Take those steps now. After logging in, you should see Argo CD showing no application is currently installed.

Create GitHub Token¶

Login to GitHub. From the upper right corner of the page, go to Settings > Developer settings > Personal access token > Generate new token. Make sure the token is granted access for repo and workflow.

Save the generated token to a Kubernetes secret as follows:

kubectl create secret generic iter8-token --from-literal=token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Finally, give Iter8 permission to read the secret:

kubectl apply -f https://raw.githubusercontent.com/iter8-tools/iter8/master/samples/tasks/rbac/read-secrets.yaml