Merge pull request #1510 from catherineluse/istio

Change 'service mesh' to Istio in docs
This commit is contained in:
Denise
2019-06-18 11:07:10 -07:00
committed by GitHub
3 changed files with 25 additions and 25 deletions
@@ -1,5 +1,5 @@
---
title: Service Mesh
title: Istio
weight: 5
---
@@ -7,39 +7,39 @@ _Available as of v2.3.0-alpha_
Using Rancher, you can connect, secure, control, and observe services through integration with [Istio](https://istio.io/), a leading open-source service mesh solution. Istio provides behavioral insights and operational control over the service mesh as a whole, offering a complete solution to satisfy the diverse requirements of microservice applications.
## Enabling Service Mesh
## Enabling Istio
As an [administrator]({{< baseurl >}}/rancher/v2.x/en/admin-settings/rbac/global-permissions/) or [cluster owner]({{< baseurl >}}/rancher/v2.x/en/admin-settings/rbac/cluster-project-roles/#cluster-roles), you can configure Rancher to deploy Istio to your Kubernetes cluster.
1. From the **Global** view, navigate to the cluster that you want to configure the service mesh for.
1. From the **Global** view, navigate to the cluster that you want to configure Istio for.
1. Select **Tools > Service Mesh** in the navigation bar.
1. Select **Tools > Istio** in the navigation bar.
1. Select **Enable** to show the [Service mesh configuration options]({{< baseurl >}}/rancher/v2.x/en/cluster-admin/tools/service-mesh/istio/). Enter in your desired configuration options. Ensure you have enough resources for service mesh and on your worker nodes to enable service mesh.
1. Select **Enable** to show the [Istio configuration options]({{< baseurl >}}/rancher/v2.x/en/cluster-admin/tools/istio/config/). Enter in your desired configuration options. Ensure you have enough resources on your worker nodes to enable Istio.
1. Click **Save**.
**Result:** The Istio application, `cluster-istio`, is added as an [application]({{< baseurl >}}/rancher/v2.x/en/catalog/apps/) to the cluster's `system` project. After the application is `active`, you can start using Istio.
> **Note:** When enabling service mesh, you need to ensure your worker nodes and Istio pod have enough resources. In larger deployments, it is strongly advised that the service mesh infrastructure be placed on dedicated nodes in the cluster.
> **Note:** When enabling Istio, you need to ensure your worker nodes and Istio pod have enough resources. In larger deployments, it is strongly advised that the infrastructure be placed on dedicated nodes in the cluster.
## Using Service Mesh
## Using Istio
Once the service mesh is `active`, you can:
Once Istio is `active`, you can see visualizations of your Istio service mesh across several services:
1. Access [Kiali UI](https://www.kiali.io/) by clicking Kiali UI icon in service mesh page.
1. Access [Jaeger UI](https://www.jaegertracing.io/) by clicking Jaeger UI icon in service mesh page.
1. Access [Grafana UI](https://grafana.com/) by clicking Grafana UI icon in service mesh page.
1. Access [Prometheus UI](https://prometheus.io/) by clicking Prometheus UI icon in service mesh page.
1. Go to a project to [view traffic graph, traffic metrics and manage traffic]({{< baseurl >}}/rancher/v2.x/en/project-admin/service-mesh/).
1. Access [Kiali UI](https://www.kiali.io/) by clicking the Kiali UI icon in the Istio page.
1. Access [Jaeger UI](https://www.jaegertracing.io/) by clicking the Jaeger UI icon in the Istio page.
1. Access [Grafana UI](https://grafana.com/) by clicking the Grafana UI icon in the Istio page.
1. Access [Prometheus UI](https://prometheus.io/) by clicking the Prometheus UI icon in the Istio page.
1. Go to a project to [view traffic graph, traffic metrics and manage traffic]({{< baseurl >}}/rancher/v2.x/en/project-admin/istio/).
## Disabling Service Mesh
## Disabling Istio
To disable the service mesh:
To disable Istio:
1. From the **Global** view, navigate to the cluster that you want to disable the service mesh for.
1. From the **Global** view, navigate to the cluster that you want to disable Istio for.
1. Select **Tools > Service Mesh** in the navigation bar.
1. Select **Tools > Istio** in the navigation bar.
1. Click **Disable Istio**, then click the red button again to confirm the disable action.
@@ -1,11 +1,11 @@
---
title: Service Mesh Configuration
title: Istio Configuration
weight: 1
---
_Available as of v2.3.0-alpha_
There are several configuration options for the service mesh.
There are several configuration options for Istio.
## PILOT
@@ -1,5 +1,5 @@
---
title: Service Mesh
title: Istio
weight: 3528
---
@@ -9,10 +9,10 @@ Using Rancher, you can connect, secure, control, and observe services through in
>**Prerequisites:**
>
>- [Service Mesh]({{< baseurl >}}/rancher/v2.x/en/cluster-admin/tools/service-mesh/) must be enabled in the cluster.
>- [Istio]({{< baseurl >}}/rancher/v2.x/en/cluster-admin/tools/istio/) must be enabled in the cluster.
>- To be a part of an Istio service mesh, pods and services in a Kubernetes cluster must satisfy the [Istio Pods and Services Requirements](https://istio.io/docs/setup/kubernetes/prepare/requirements/)
## Istio sidecar auto injection
## Istio Sidecar Auto Injection
In the create and edit namespace page, you can enable or disable [Istio sidecar auto injection](https://istio.io/blog/2019/data-plane-setup/#automatic-injection). When you enable it, Rancher will add `istio-injection=enabled` label to the namespace automatically.
@@ -20,13 +20,13 @@ In the create and edit namespace page, you can enable or disable [Istio sidecar
## View Traffic Graph
Rancher integrates Kiali Graph into the Rancher UI. The Kiali graph provides a powerful way to visualize the topology of your service mesh. It shows you which services communicate with each other.
Rancher integrates Kiali Graph into the Rancher UI. The Kiali graph provides a powerful way to visualize the topology of your Istio service mesh. It shows you which services communicate with each other.
To see the traffic graph for a particular namespace:
1. From the **Global** view, navigate to the project that you want to view traffic graph for.
1. Select **Service Mesh** in the navigation bar.
1. Select **Istio** in the navigation bar.
1. Select **Traffic Graph** in the navigation bar.
@@ -40,7 +40,7 @@ To see the Success Rate, Request Volume, 4xx Request Count, Project 5xx Request
1. From the **Global** view, navigate to the project that you want to view traffic metrics for.
1. Select **Service Mesh** in the navigation bar.
1. Select **Istio** in the navigation bar.
1. Select **Traffic Metrics** in the navigation bar.