mirror of https://github.com/istio/istio.io.git
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:
parent
50fecb615f
commit
ee1b180bf7
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
|
|
@ -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/
|
||||
|
|
|
|||
|
|
@ -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
|
||||
---
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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 >}}
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
---
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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).
|
||||
|
||||
|
|
|
|||
|
|
@ -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),
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue