rancher-charts/charts/rancher-istio-1.8/rancher-istio/1.8.600/app-readme.md

3.0 KiB
Executable File

Rancher Istio

Our Istio installer wraps the istioctl binary commands in a handy helm chart, including an overlay file option to allow complex customization. It also includes:

  • Kiali: Used for graphing traffic flow throughout the mesh
  • Jaeger: A quick start, all-in-one installation used for tracing distributed systemm. This is not production qualified, please refer to jaeger documentation to determine which installation you may need instead.

Dependencies

Rancher Monitoring or other Prometheus installation

The Prometheus CRDs are required for installing Kiali which is enabled by default. If you do not have Prometheus installed your Istio installation will fail. If you do not plan on using Kiali, set kiali.enabled=false to bypass this requirement.

Customization

Rancher Monitoring

The Rancher Monitoring app sets prometheus.prometheusSpec.ignoreNamespaceSelectors=false which means all namespaces will be scraped by Prometheus by default. This ensures you can view traffic, metrics and graphs for resources deployed in other namespaces.

To limit scraping to specific namespaces, set prometheus.prometheusSpec.ignoreNamespaceSelectors=true and add one of the following configurations to ensure you can continue to view traffic, metrics and graphs for your deployed resources.

  1. Add a Service Monitor or Pod Monitor in the namespace with the targets you want to scrape.
  2. Add an additionalScrapeConfig to your rancher-monitoring instance to scrape all targets in all namespaces.

Custom Prometheus Installation with Kiali

To use a custom Monitoring installation, set the kiali.external_services.prometheus url in the values.yaml. This url depends on the values for nameOverride, namespaceOverride, and prometheus.service.port in your rancher-monitoring or other monitoring instance:

http://{{ .Values.nameOverride }}-prometheus.{{ .Values.namespaceOverride }}.svc:{{ prometheus.service.port }}

Custom Grafana Installation with Kiali

To use a custom Grafana installation, set the kiali.external_services.grafana url in the values.yaml. This url depends on the values for nameOverride, namespaceOverride, and granfa.service.port in your rancher-monitoring or other grafana instance:

http://{{ .Values.nameOverride }}-grafana.{{ .Values.namespaceOverride }}.svc:{{ grafana.service.port }}

Custom Tracing Installation with Kiali

To use a custom Tracing installation, set the kiali.external_services.tracing url and update the .Values.tracing.contextPath in the rancher-istio values.yaml.

This url depends on the values for namespaceOverride, and .Values.service.externalPort in your rancher-tracing or other tracing instance.:

http://tracing.{{ .Values.namespaceOverride }}.svc:{{ .Values.service.externalPort }}/{{ .Values.tracing.contextPath }}

For more information on how to use the feature, refer to our docs.