Skip to content

Install

Follow these steps to install Iter8 for Knative.

Prerequisites

  1. Kubernetes cluster with Knative Serving
  2. kubectl
  3. Kustomize v3, and
  4. Go 1.13+

Step 1: Export TAG

export TAG=v0.2.5

Step 2: Install iter8-monitoring

kustomize build github.com/iter8-tools/iter8/install/monitoring/prometheus-operator/?ref=${TAG} | kubectl apply -f -
kubectl wait crd -l creator=iter8 --for condition=established --timeout=120s
kustomize build github.com/iter8-tools/iter8/install/monitoring/prometheus/?ref=${TAG} | kubectl apply -f - 

Step 3: Install Iter8

kustomize build github.com/iter8-tools/iter8/install/?ref=${TAG} | kubectl apply -f -
kubectl wait crd -l creator=iter8 --for condition=established --timeout=120s
kustomize build github.com/iter8-tools/iter8/install/iter8-metrics/?ref=${TAG} | kubectl apply -f -

Step 4: Install iter8ctl

GO111MODULE=on GOBIN=/usr/local/bin go get github.com/iter8-tools/iter8ctl@v0.1.0

Optional: Customizing Iter8 install

Prometheus URL

The URL of the Prometheus metrics backend is supplied as part of this configmap during the install process. This URL is intended to match the location of the iter8-monitoring install above. To use your own Prometheus backend, replace the value of the metrics backend URL in the configmap during the install process with the URL of your Prometheus backend. You can use Kustomize or sed or any tool of your choice for this customization.

An initial version of Iter8 for KFServing is available here along with installation instructions. An updated version is coming soon and will be documented here.

An earlier version of Iter8 for Istio is available here along with installation instructions. An updated version is coming soon and will be documented here.