Monitoring & Tracing

The istio-operator relies on a custom resource to set up Istio. This configuration gets passed to an ansible playbook which will then set up your environment.

Minimal Example

At a minimum, the following arguments are required.

apiVersion: "istio.openshift.com/v1alpha1"
kind: "Installation"
metadata:
  name: "istio-installation"

Complete Example

Below, you can an example with all supported arguments populated.

apiVersion: "istio.openshift.com/v1alpha1"
kind: "Installation"
metadata:
  name: "istio-installation"
spec:
  deployment_type: openshift
  istio:
    authentication: false
    community: false
    prefix: openshift-istio-tech-preview/
    version: 0.3.0
  jaeger:
    prefix: distributed-tracing-tech-preview/
    version: 1.7.0
    elasticsearch_memory: 1Gi
  kiali:
    username: username
    password: password
    prefix: openshift-istio-tech-preview/
    version: 0.8.1
  launcher:
    openshift:
      user: user
      password: password
    github:
      username: username
      token: token
    catalog:
      filter: booster.mission.metadata.istio
      branch: v62
      repo: https://github.com/fabric8-launcher/launcher-booster-catalog.git

General

Parameter Description Values Default

deployment_type

Selects whether to use OpenShift or Origin default values for unset fields

origin, openshift

origin

Istio

Parameter Description Values Default

authentication

Whether to enable mutual authentication

true/false

false

community

Whether to modify image names to match community images.

true/false

false

prefix

a prefix to apply to Istio image names used in docker pull.

valid image repo

maistra/ if deployment_type is origin and openshift-istio-tech-preview/ if deployment_type is openshift

version

docker tag to use with Istio images

valid docker tag

0.3.0

Jaeger

Parameter Description Values Default

prefix

a prefix to apply to Jaeger image names used in docker pull.

valid image repo

jaegertracing/ if deployment_type is origin and distributed-tracing-tech-preview/ if deployment_type is openshift

version

docker tag to use with Jaeger images

valid docker tag

1.7 if deployment_type is origin and 1.7.0 if deployment_type is openshift

elasticsearch_memory

The amount of memory to allocate to the elastic search install

amount of memory to use (example: 1Gi, 512M)

1Gi

Kiali

Parameter Description Values Default

username

username used to access the Kiali console. Note that this is not related to any account on OpenShift

password

password used to access the Kiali console. Note that this is not related to any account on OpenShift.

prefix

a prefix to apply to Kiali image names used in docker pull.

valid image repo

kiali/ if deployment_type is origin and openshift-istio-tech-preview/ if deployment_type is openshift

version

docker tag to use with Kiali images

valid Kiali tag

v0.8.1 if deployment_type is origin and 0.8.1 if deployment_type is openshift

Launcher

Openshift

Parameter Description Default

user

OpenShift user to use in Fabric8

developer

password

OpenShift user password to use in Fabric8

developer

Github

Parameter Description Default

username

GitHub user to use in Fabric8

token

GitHub token to use in Fabric8

Catalog

Parameter Description Default

filter

Red Hat booster catalog filter

booster.mission.metadata.istio

branch

Red Hat Booster catalog to use for Fabric8

v62

repo

Repo to use for Fabric8

https://github.com/fabric8-launcher/launcher-booster-catalog.git