Skip to content

Commit 988c3d1

Browse files
authored
Introduce an interstitial for selecting install mode (#16426)
* Introduce an interstitial for selecting install mode * remove leftover span * fix libt * update the order * Better CSS
1 parent a5522a0 commit 988c3d1

File tree

3 files changed

+35
-2
lines changed

3 files changed

+35
-2
lines changed

content/en/_index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ <h1 id="title">
3939
<div class="panels">
4040
{{< content_panel type="dark" title="latest_news" text="Fast, secure and simple: Istio's ambient mode is now Generally Available." button="read_more" url="/blog/2024/ambient-reaches-ga/" >}}
4141
{{< content_panel type="dark" title="join_the_community" text="Connect with over 10,000+ of your peers using, testing and innovating with Istio." button="connect_with_us" url="/get-involved" >}}
42-
{{< content_panel type="dark" title="get_started" text="Try Istio today. Quickly evaluate the project in four steps." button="learn_more" url="/docs/setup/getting-started" >}}
42+
{{< content_panel type="dark" title="get_started" text="Try Istio today. Quickly evaluate the project in four steps." button="learn_more" url="/docs/overview/quickstart" >}}
4343
</div>
4444
</section>
4545

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: "Quickstart"
3+
description: Learn how to get started with a simple example installation.
4+
weight: 50
5+
keywords: [introduction]
6+
owner: istio/wg-docs-maintainers-english
7+
skip_seealso: true
8+
test: n/a
9+
---
10+
11+
Thanks for your interest in Istio!
12+
13+
Istio has two primary modes: **ambient mode** and **sidecar mode**.
14+
15+
* [Ambient mode](/docs/overview/dataplane-modes/#ambient-mode) is the new and improved model, created to address the shortcomings of sidecar mode. In ambient mode, a secure tunnel is installed on each node, and you can opt in to the full feature set with proxies you install, (generally) per-namespace.
16+
* [Sidecar mode](/docs/overview/dataplane-modes/#sidecar-mode) is the traditional model of service mesh pioneered by Istio in 2017. In sidecar mode, a proxy is deployed along with every Kubernetes pod or other workload.
17+
18+
Most of the energy in the Istio community is going towards improvement of ambient mode, although sidecar mode remains fully supported. Any major new feature contributed to the project is expected to work in both modes.
19+
20+
In general, **we recommend that new users start with ambient mode**. It is faster, cheaper, and easier to manage. There are [advanced use cases](/docs/overview/dataplane-modes/#unsupported-features) that still require the use of sidecar mode, but closing these gaps is on our 2025 roadmap.
21+
22+
<div style="text-align: center;">
23+
<div style="display: inline-block;">
24+
<a href="/docs/ambient/getting-started"
25+
style="display: inline-block; min-width: 18em; margin: 0.5em;"
26+
class="btn btn--secondary"
27+
id="get-started-ambient">Get started with ambient mode</a>
28+
<a href="/docs/setup/getting-started"
29+
style="display: inline-block; min-width: 18em; margin: 0.5em;"
30+
class="btn btn--secondary"
31+
id="get-started-sidecar">Get started with sidecar mode</a>
32+
</div>
33+
</div>

layouts/partials/header.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@
5050

5151
<div class="main-navigation-footer">
5252
<button id="search-show" class="search-show" title='{{ i18n "search" }}' aria-label='{{ i18n "search_label" }}'>{{ partial "icon.html" "magnifier" }}</button>
53-
<a href='{{ "/docs/setup/getting-started" | relLangURL }}' class="btn btn--primary" id="try-istio">{{ i18n "try_istio" }}</a>
53+
<a href='{{ "/docs/overview/quickstart" | relLangURL }}' class="btn btn--primary" id="try-istio">{{ i18n "try_istio" }}</a>
5454
</div>
5555

5656
</div>

0 commit comments

Comments
 (0)