Implement consistent term for installation related flows (#3577)

* Implement consitent term for installation related flows

Replaced "paths", "instructions", and other similar terms
with the term "flow" to ensure readers from different
Geos are not confused by multiple meanings or idiomatic use.

Signed-off-by: Rigs Caballero <grca@google.com>

* Implement consistent term for installation related flows

Replaced "paths", "instructions", and other similar terms
with the term "flow" to ensure readers from different
Geos are not confused by multiple meanings or idiomatic use.

Signed-off-by: Rigs Caballero <grca@google.com>

* Fix typos and lint issue.

Signed-off-by: Rigs Caballero <grca@google.com>
This commit is contained in:
Rigs Caballero 2019-03-08 11:02:33 -08:00 committed by istio-bot
parent 50fecb615f
commit ee1b180bf7
16 changed files with 38 additions and 33 deletions

View File

@ -17,7 +17,7 @@ Istio {{< istio_version >}} has been tested with these Kubernetes releases: {{<
## Getting started
Istio offers multiple installation paths depending on your Kubernetes platform.
Istio offers multiple installation flows depending on your Kubernetes platform.
However, the basic flow is the same regardless of platform:
@ -28,8 +28,8 @@ However, the basic flow is the same regardless of platform:
Some platforms additionally require you [download the latest Istio release](/docs/setup/kubernetes/download-release/)
manually.
Whether or not you intend to use Istio on production, is critical when deciding
which installation to perform.
Whether or not you intend to use Istio on production, it is critical when
deciding which installation to perform.
## Evaluating Istio

View File

@ -1,13 +1,13 @@
---
title: Install Istio with the Istio CNI plugin
description: Instructions to install and use Istio with the Istio CNI plugin, allowing operators to deploy services with lower privilege.
description: Install and use Istio with the Istio CNI plugin, allowing operators to deploy services with lower privilege.
weight: 70
aliases:
- /docs/setup/kubernetes/install/cni
keywords: [kubernetes,cni,sidecar,proxy,network,helm]
---
Follow this path to install, configure, and use an Istio mesh using the Istio Container Network Interface
Follow this flow to install, configure, and use an Istio mesh using the Istio Container Network Interface
([CNI](https://github.com/containernetworking/cni#cni---the-container-network-interface))
plugin.

View File

@ -1,12 +1,12 @@
---
title: Advanced Install Options
description: Instructions for customizing the Istio installation.
description: Customize the Istio installation.
weight: 35
keywords: [kubernetes]
draft: true
---
This section provides options for piecemeal installation of Istio
This page provides options for piecemeal installation of Istio
components.
## Ingress controller only

View File

@ -1,13 +1,13 @@
---
title: Mesh Expansion
description: Instructions for integrating VMs and bare metal hosts into an Istio mesh deployed on Kubernetes.
description: Integrate VMs and bare metal hosts into an Istio mesh deployed on Kubernetes.
weight: 95
keywords: [kubernetes,vms]
aliases:
- /docs/setup/kubernetes/additional-setup/mesh-expansion/
---
This guide provides instructions for integrating VMs and bare metal hosts into
This flow provides instructions to integrate VMs and bare metal hosts into
an Istio mesh deployed on Kubernetes.
## Prerequisites

View File

@ -1,6 +1,6 @@
---
title: Installing the Sidecar
description: Instructions for installing the Istio sidecar in application pods automatically using the sidecar injector webhook or manually using istioctl CLI.
description: Install the Istio sidecar in application pods automatically using the sidecar injector webhook or manually using istioctl CLI.
weight: 45
keywords: [kubernetes,sidecar,sidecar-injection]
aliases:

View File

@ -1,6 +1,6 @@
---
title: Downloading the Release
description: Instructions to download the Istio release.
description: Download the Istio release and prepare for installation.
weight: 1
aliases:
- /docs/setup/kubernetes/download-release/

View File

@ -1,6 +1,6 @@
---
title: Installation Paths
description: Choose the path that best suits your needs and platform.
title: Installation Flows
description: Choose the flows that best suit your needs and platform.
weight: 3
icon: setup
---

View File

@ -10,9 +10,9 @@ aliases:
icon: helm
---
Follow this path to install and configure an Istio mesh for in-depth evaluation or production use.
Follow this flow to install and configure an Istio mesh for in-depth evaluation or production use.
These instructions use [Helm](https://github.com/helm/helm) charts that provide rich
This installation flow uses [Helm](https://github.com/helm/helm) charts that provide rich
customization of the Istio control plane and of the sidecars for the Istio data plane.
You can start with one of Istio's built-in configuration profiles and then further customize
the configuration for your specific needs.

View File

@ -7,8 +7,8 @@ aliases:
- /docs/setup/kubernetes/quick-start/
---
Follow this path to quickly evaluate Istio in a Kubernetes cluster on any platform.
This path installs a preconfigured Istio **demo profile** using basic Kubernetes commands
Follow this flow to quickly evaluate Istio in a Kubernetes cluster on any platform.
This flow installs a preconfigured Istio **demo profile** using basic Kubernetes commands
without needing to download or install [Helm](https://github.com/helm/helm).
{{< tip >}}

View File

@ -7,8 +7,9 @@ aliases:
keywords: [kubernetes,multicluster,federation,gateway]
---
Instructions for installing an Istio [multicluster service mesh](/docs/concepts/multicluster-deployments/)
where Kubernetes cluster services and applications in each cluster are limited to remote communication using gateway IPs.
Follow this flow to install an Istio [multicluster service mesh](/docs/concepts/multicluster-deployments/)
where the Kubernetes cluster services and the applications in each cluster
are limited to remote communication using gateway IPs.
Instead of using a central Istio control plane to manage the mesh,
in this configuration each cluster has an **identical** Istio control plane

View File

@ -7,9 +7,10 @@ aliases:
- /docs/setup/kubernetes/multicluster-install/vpn/
---
Instructions for installing an Istio [multicluster service mesh](/docs/concepts/multicluster-deployments/)
where Kubernetes cluster services and applications in each cluster have the capability to expose
their internal Kubernetes network to other clusters.
Follow this flow to install an Istio [multicluster service mesh](/docs/concepts/multicluster-deployments/)
where the Kubernetes cluster services and the applications in each cluster
have the capability to expose their internal Kubernetes network to other
clusters.
In this configuration, multiple Kubernetes control planes running
a remote configuration connect to a **single** Istio control plane.

View File

@ -1,6 +1,6 @@
---
title: Platform-specific Instructions
description: Additional installation instructions for supported Kubernetes platforms.
description: Additional installation flows for the supported Kubernetes platforms.
weight: 40
icon: setup
---

View File

@ -7,11 +7,11 @@ aliases:
- /docs/setup/kubernetes/quick-start-alicloud-ack/
---
Follow this path to install and configure an Istio mesh in the
Follow this flow to install and configure an Istio mesh in the
[Alibaba Cloud Kubernetes Container Service](https://www.alibabacloud.com/product/kubernetes)
using the `Application Catalog` module.
This guide installs the current release version of Istio and deploys the
This flow installs the current release version of Istio and deploys the
[Bookinfo](/docs/examples/bookinfo/) sample application.
## Prerequisites

View File

@ -8,7 +8,7 @@ aliases:
- /docs/setup/kubernetes/quick-start/
---
Follow this path to install and configure an Istio mesh Istio in the
Follow this flow to install and configure an Istio mesh Istio in the
[Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine/) (GKE)
using [Istio on GKE](https://cloud.google.com/istio/docs/istio-on-gke/overview).

View File

@ -7,7 +7,7 @@ aliases:
- /docs/setup/kubernetes/quick-start-ibm/
---
Follow this path to install and configure an Istio mesh in IBM Cloud.
Follow this flow to install and configure an Istio mesh in IBM Cloud.
You can use the [managed Istio add-on for IBM Cloud Kubernetes Service](#managed-istio-add-on)
in IBM Cloud Public, use Helm to install Istio in [IBM Cloud Public](#ibm-cloud-public),

View File

@ -1,18 +1,21 @@
---
title: Upgrading
description: Demonstrates how to upgrade the Istio control plane and data plane independently.
description: Upgrade the Istio control plane and data plane independently.
weight: 5
aliases:
- /docs/setup/kubernetes/upgrading-istio/
keywords: [kubernetes,upgrading]
---
This page describes how to upgrade an existing Istio deployment (including both control plane and sidecar proxy) to a new release of Istio.
The upgrade process may install new binaries and may change configuration and API schemas. The upgrade process
may result in service downtime. To minimize downtime, please ensure your Istio control plane components and your applications
are highly available with multiple replicas.
Follow this flow to upgrade an existing Istio deployment, including both the
control plane and the sidecar proxies, to a new release of Istio. The upgrade
process may install new binaries and may change configuration and API schemas.
The upgrade process may result in service downtime. To minimize downtime,
please ensure your Istio control plane components and your applications are
highly available with multiple replicas.
In the following steps, we assume that the Istio components are installed and upgraded in the `istio-system` namespace.
This flow assumes that the Istio components are installed and upgraded in the
`istio-system` namespace.
## Upgrade steps