From 0d4d5106b1ef84b8e545087602efdec254b0ca68 Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Fri, 14 Jun 2019 12:55:49 -0700 Subject: [PATCH 1/3] Change 'service mesh' to Istio in docs --- .../tools/service-mesh/_index.md | 28 +++++++++---------- .../tools/service-mesh/istio/_index.md | 4 +-- .../en/project-admin/service-mesh/_index.md | 4 +-- 3 files changed, 18 insertions(+), 18 deletions(-) diff --git a/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/_index.md b/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/_index.md index d080d5d5f77..d02b6a44023 100644 --- a/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/_index.md +++ b/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/_index.md @@ -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. 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/service-mesh/istio/). Enter in your desired configuration options. Ensure you have enough resources for the service mesh and on your worker nodes to enable the service mesh. 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 the 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. -## Using Service Mesh +## Using Istio -Once the service mesh is `active`, you can: +Once Istio is `active`, you can see visualizations for your 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. 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/service-mesh/). -## 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. 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. diff --git a/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/istio/_index.md b/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/istio/_index.md index 5f84f6eb7fd..c2fa0f7bbee 100644 --- a/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/istio/_index.md +++ b/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/istio/_index.md @@ -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 diff --git a/content/rancher/v2.x/en/project-admin/service-mesh/_index.md b/content/rancher/v2.x/en/project-admin/service-mesh/_index.md index 12885629f8a..1c99c4ec7b3 100644 --- a/content/rancher/v2.x/en/project-admin/service-mesh/_index.md +++ b/content/rancher/v2.x/en/project-admin/service-mesh/_index.md @@ -1,5 +1,5 @@ --- -title: Service Mesh +title: Istio weight: 3528 --- @@ -12,7 +12,7 @@ Using Rancher, you can connect, secure, control, and observe services through in >- [Service Mesh]({{< baseurl >}}/rancher/v2.x/en/cluster-admin/tools/service-mesh/) 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. From 3380c5b912de2c813eaf8a7c0368cba4fbf8d825 Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Fri, 14 Jun 2019 14:01:50 -0700 Subject: [PATCH 2/3] Change folder names from serv0ce-mesh to istio --- .../en/cluster-admin/tools/{service-mesh => istio}/_index.md | 4 ++-- .../tools/{service-mesh/istio => istio/config}/_index.md | 0 .../v2.x/en/project-admin/{service-mesh => istio}/_index.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) rename content/rancher/v2.x/en/cluster-admin/tools/{service-mesh => istio}/_index.md (88%) rename content/rancher/v2.x/en/cluster-admin/tools/{service-mesh/istio => istio/config}/_index.md (100%) rename content/rancher/v2.x/en/project-admin/{service-mesh => istio}/_index.md (95%) diff --git a/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/_index.md b/content/rancher/v2.x/en/cluster-admin/tools/istio/_index.md similarity index 88% rename from content/rancher/v2.x/en/cluster-admin/tools/service-mesh/_index.md rename to content/rancher/v2.x/en/cluster-admin/tools/istio/_index.md index d02b6a44023..1b556986945 100644 --- a/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/_index.md +++ b/content/rancher/v2.x/en/cluster-admin/tools/istio/_index.md @@ -15,7 +15,7 @@ As an [administrator]({{< baseurl >}}/rancher/v2.x/en/admin-settings/rbac/global 1. Select **Tools > Istio** in the navigation bar. -1. Select **Enable** to show the [Istio 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 the service mesh and on your worker nodes to enable the 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 for the service mesh and on your worker nodes to enable the service mesh. 1. Click **Save**. @@ -31,7 +31,7 @@ Once Istio is `active`, you can see visualizations for your service mesh across 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/service-mesh/). +1. Go to a project to [view traffic graph, traffic metrics and manage traffic]({{< baseurl >}}/rancher/v2.x/en/project-admin/istio/). ## Disabling Istio diff --git a/content/rancher/v2.x/en/cluster-admin/tools/service-mesh/istio/_index.md b/content/rancher/v2.x/en/cluster-admin/tools/istio/config/_index.md similarity index 100% rename from content/rancher/v2.x/en/cluster-admin/tools/service-mesh/istio/_index.md rename to content/rancher/v2.x/en/cluster-admin/tools/istio/config/_index.md diff --git a/content/rancher/v2.x/en/project-admin/service-mesh/_index.md b/content/rancher/v2.x/en/project-admin/istio/_index.md similarity index 95% rename from content/rancher/v2.x/en/project-admin/service-mesh/_index.md rename to content/rancher/v2.x/en/project-admin/istio/_index.md index 1c99c4ec7b3..5bd15a488d1 100644 --- a/content/rancher/v2.x/en/project-admin/service-mesh/_index.md +++ b/content/rancher/v2.x/en/project-admin/istio/_index.md @@ -9,7 +9,7 @@ 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 From 9c8940d244f57c2ca9efa6f8b94cd693582a4a83 Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Fri, 14 Jun 2019 14:20:32 -0700 Subject: [PATCH 3/3] Change 'service mesh' to Istio in more places --- .../v2.x/en/cluster-admin/tools/istio/_index.md | 10 +++++----- content/rancher/v2.x/en/project-admin/istio/_index.md | 6 +++--- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/content/rancher/v2.x/en/cluster-admin/tools/istio/_index.md b/content/rancher/v2.x/en/cluster-admin/tools/istio/_index.md index 1b556986945..50ccf14efe1 100644 --- a/content/rancher/v2.x/en/cluster-admin/tools/istio/_index.md +++ b/content/rancher/v2.x/en/cluster-admin/tools/istio/_index.md @@ -11,21 +11,21 @@ Using Rancher, you can connect, secure, control, and observe services through in 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 > Istio** in the navigation bar. -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 for the service mesh and on your worker nodes to enable the 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 the 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 Istio -Once Istio is `active`, you can see visualizations for your service mesh across several services: +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 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. @@ -37,7 +37,7 @@ Once Istio is `active`, you can see visualizations for your service mesh across 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 > Istio** in the navigation bar. diff --git a/content/rancher/v2.x/en/project-admin/istio/_index.md b/content/rancher/v2.x/en/project-admin/istio/_index.md index 5bd15a488d1..2c7c26bc6ce 100644 --- a/content/rancher/v2.x/en/project-admin/istio/_index.md +++ b/content/rancher/v2.x/en/project-admin/istio/_index.md @@ -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.