mirror of https://github.com/istio/istio.io.git
Improve the flow and language of the Getting started doc. (#4425)
* Fix the flow and language of the Getting started doc. Signed-off-by: rcaballeromx <grca@google.com> * Add cross-reference on the k8s install guide. Signed-off-by: rcaballeromx <grca@google.com> * Rework concluding paragraph to clarify timeline. Signed-off-by: rcaballeromx <grca@google.com> * Move cross-reference to landing page. Signed-off-by: rcaballeromx <grca@google.com>
This commit is contained in:
parent
86a203c8de
commit
f4d247cc30
|
@ -18,6 +18,9 @@ content_above: true
|
|||
Istio {{< istio_version >}} has been tested with these Kubernetes releases: {{< supported_kubernetes_versions >}}.
|
||||
{{< /tip >}}
|
||||
|
||||
Visit our [getting started guide](/docs/setup/kubernetes/getting-started/) to
|
||||
learn how to evaluate and try Istio's basic features quickly.
|
||||
|
||||
Istio offers [multiple installation flows](/docs/setup/kubernetes/getting-started/)
|
||||
depending on your platform and whether or not you intend to use Istio in production.
|
||||
At a high level, the basic flow is the same regardless of platform:
|
||||
|
|
|
@ -1,41 +1,42 @@
|
|||
---
|
||||
title: Getting Started
|
||||
description: Download and install Istio.
|
||||
description: Download, install, and try out Istio.
|
||||
weight: 5
|
||||
skip_toc: true
|
||||
keywords: [kubernetes]
|
||||
keywords: [getting-started, install, bookinfo, quick-start, kubernetes]
|
||||
---
|
||||
|
||||
If you’re new to Istio and just want to try it out, the quickest way to get started is
|
||||
by downloading and installing Istio's built-in **demo** configuration.
|
||||
Istio can also be installed and customized in many other ways, depending on your platform and intended use.
|
||||
Check out our [general installation instructions](/docs/setup/) for details.
|
||||
|
||||
To get started, proceed as follows:
|
||||
This guide lets you try out Istio quickly and it's the ideal starting
|
||||
point if you are new to the project. To get started, download and install
|
||||
Istio's built-in **demo** configuration:
|
||||
|
||||
1. [Setup your platform](/docs/setup/kubernetes/platform-setup/)
|
||||
1. [Download the Istio release](/docs/setup/kubernetes/#downloading-the-release)
|
||||
1. [Follow the quick-start installation instructions](/docs/setup/kubernetes/install/kubernetes)
|
||||
|
||||
Once you've installed Istio, a good way to start evaluating Istio's features is using our
|
||||
[Bookinfo sample application](/docs/examples/bookinfo/).
|
||||
You can use this sample to experiment with Istio’s features for traffic routing,
|
||||
fault injection, rate limiting, etc..
|
||||
With Istio installed, you can [deploy the Bookinfo sample](/docs/examples/bookinfo/#if-you-are-running-on-kubernetes)
|
||||
and evaluate Istio's features for traffic routing, fault injection, rate
|
||||
limiting, etc. Explore the various [Istio tasks](/docs/tasks/), and try out the
|
||||
tasks that interest you. If you are not sure where to begin, the following
|
||||
tasks are a good place to start:
|
||||
|
||||
1. [Deploy the Bookinfo sample](/docs/examples/bookinfo/#if-you-are-running-on-kubernetes)
|
||||
1. Explore various [Istio tasks](/docs/tasks/), depending on your interest.
|
||||
The following tasks are a good start for beginners:
|
||||
* [Request routing](/docs/tasks/traffic-management/request-routing/)
|
||||
* [Fault injection](/docs/tasks/traffic-management/fault-injection/)
|
||||
* [Traffic shifting](/docs/tasks/traffic-management/traffic-shifting/)
|
||||
* [Querying metrics](/docs/tasks/telemetry/metrics/querying-metrics/)
|
||||
* [Visualizing metrics](/docs/tasks/telemetry/metrics/using-istio-dashboard/)
|
||||
* [Collecting logs](/docs/tasks/telemetry/logs/collecting-logs/)
|
||||
* [Rate limiting](/docs/tasks/policy-enforcement/rate-limiting/)
|
||||
* [Ingress gateways](/docs/tasks/traffic-management/ingress/ingress-control/)
|
||||
* [Accessing external services](/docs/tasks/traffic-management/egress/egress-control/)
|
||||
* [Visualizing your mesh](/docs/tasks/telemetry/kiali/)
|
||||
- [Request routing](/docs/tasks/traffic-management/request-routing/)
|
||||
- [Fault injection](/docs/tasks/traffic-management/fault-injection/)
|
||||
- [Traffic shifting](/docs/tasks/traffic-management/traffic-shifting/)
|
||||
- [Querying metrics](/docs/tasks/telemetry/metrics/querying-metrics/)
|
||||
- [Visualizing metrics](/docs/tasks/telemetry/metrics/using-istio-dashboard/)
|
||||
- [Collecting logs](/docs/tasks/telemetry/logs/collecting-logs/)
|
||||
- [Rate limiting](/docs/tasks/policy-enforcement/rate-limiting/)
|
||||
- [Ingress gateways](/docs/tasks/traffic-management/ingress/ingress-control/)
|
||||
- [Accessing external services](/docs/tasks/traffic-management/egress/egress-control/)
|
||||
- [Visualizing your mesh](/docs/tasks/telemetry/kiali/)
|
||||
|
||||
After that, you will have a pretty good understanding of Istio's basic functionality and can then
|
||||
proceed to explore Istio's many other tasks or, even better, start to deploy your own applications.
|
||||
If you do continue to use Istio, we look forward to hearing from you.
|
||||
The tasks above provide a good basic understanding of Istio's features but,
|
||||
explore more [tasks](/docs/tasks/) depending on what interests you. Before you
|
||||
install and customize Istio to fit your platform and intended use, check out
|
||||
our [general installation instructions](/docs/setup/) for details.
|
||||
|
||||
The next step is to deploy your own applications.
|
||||
|
||||
As you continue to use Istio, we look forward to hearing from you and welcoming
|
||||
you to our [community](/about/community/join/).
|
||||
|
|
|
@ -7,20 +7,22 @@ aliases:
|
|||
- /docs/setup/kubernetes/quick-start/
|
||||
---
|
||||
|
||||
Follow this guide to quickly evaluate Istio in a Kubernetes cluster on any platform.
|
||||
This guide installs Istio's built-in **demo**
|
||||
[configuration profile](/docs/setup/kubernetes/additional-setup/config-profiles/)
|
||||
using basic Kubernetes commands without needing to download or install [Helm](https://github.com/helm/helm).
|
||||
This guide installs Istio's built-in **demo** [configuration profile](/docs/setup/kubernetes/additional-setup/config-profiles/)
|
||||
using basic Kubernetes commands without needing to download or install
|
||||
[Helm](https://github.com/helm/helm). This installation lets you quickly
|
||||
evaluate Istio in a Kubernetes cluster on any platform.
|
||||
|
||||
{{< warning >}}
|
||||
The demo configuration profile is not suitable for performance evaluation.
|
||||
It is designed to showcase Istio functionality with high levels of tracing and access logging.
|
||||
The demo configuration profile is not suitable for performance evaluation. It
|
||||
is designed to showcase Istio functionality with high levels of tracing and
|
||||
access logging.
|
||||
{{< /warning >}}
|
||||
|
||||
To install Istio for production use, we recommend using the
|
||||
[Helm Installation guide](/docs/setup/kubernetes/install/helm/) instead,
|
||||
which provides many more options for selecting and managing the Istio configuration.
|
||||
This permits customization of Istio to operator specific requirements.
|
||||
[Helm Installation guide](/docs/setup/kubernetes/install/helm/)
|
||||
instead, which provides many more options for selecting and managing the Istio
|
||||
configuration. This permits customization of Istio to operator specific
|
||||
requirements.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
|
|
Loading…
Reference in New Issue