Skip to content

Commit f71f0f4

Browse files
Istio addon GA
1 parent c4b9a7c commit f71f0f4

File tree

6 files changed

+38
-112
lines changed

6 files changed

+38
-112
lines changed

articles/aks/istio-about.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
11
---
2-
title: Istio-based service mesh add-on for Azure Kubernetes Service (preview)
2+
title: Istio-based service mesh add-on for Azure Kubernetes Service
33
description: Istio-based service mesh add-on for Azure Kubernetes Service.
44
ms.topic: article
55
ms.date: 04/09/2023
66
ms.author: shasb
7+
author: shashankbarsin
78
---
89

9-
# Istio-based service mesh add-on for Azure Kubernetes Service (preview)
10+
# Istio-based service mesh add-on for Azure Kubernetes Service
1011

1112
[Istio][istio-overview] addresses the challenges developers and operators face with a distributed or microservices architecture. The Istio-based service mesh add-on provides an officially supported and tested integration for Azure Kubernetes Service (AKS).
1213

13-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
14-
1514
## What is a Service Mesh?
1615

1716
Modern applications are typically architected as distributed collections of microservices, with each collection of microservices performing some discrete business function. A service mesh is a dedicated infrastructure layer that you can add to your applications. It allows you to transparently add capabilities like observability, traffic management, and security, without adding them to your own code. The term **service mesh** describes both the type of software you use to implement this pattern, and the security or network domain that is created when you use that software.
@@ -50,6 +49,7 @@ Istio-based service mesh add-on for AKS has the following limitations:
5049
* Managed lifecycle of mesh on how Istio versions are installed and later made available for upgrades.
5150
* Istio doesn't support Windows Server containers.
5251
* Customization of mesh based on the following custom resources is blocked for now - `EnvoyFilter, ProxyConfig, WorkloadEntry, WorkloadGroup, Telemetry, IstioOperator, WasmPlugin`
52+
* Gateway API for Istio ingress gateway or managing mesh traffic (GAMMA) are currently not yet supported with Istio addon.
5353

5454
## Next steps
5555

articles/aks/istio-deploy-addon.md

Lines changed: 12 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,19 @@
11
---
2-
title: Deploy Istio-based service mesh add-on for Azure Kubernetes Service (preview)
3-
description: Deploy Istio-based service mesh add-on for Azure Kubernetes Service (preview)
2+
title: Deploy Istio-based service mesh add-on for Azure Kubernetes Service
3+
description: Deploy Istio-based service mesh add-on for Azure Kubernetes Service
44
ms.topic: article
55
ms.custom: devx-track-azurecli
66
ms.date: 04/09/2023
77
ms.author: shasb
8+
author: shashankbarsin
89
---
910

10-
# Deploy Istio-based service mesh add-on for Azure Kubernetes Service (preview)
11+
# Deploy Istio-based service mesh add-on for Azure Kubernetes Service
1112

1213
This article shows you how to install the Istio-based service mesh add-on for Azure Kubernetes Service (AKS) cluster.
1314

1415
For more information on Istio and the service mesh add-on, see [Istio-based service mesh add-on for Azure Kubernetes Service][istio-about].
1516

16-
[!INCLUDE [preview features callout](includes/preview/preview-callout.md)]
17-
1817
## Before you begin
1918

2019
### Set environment variables
@@ -25,44 +24,9 @@ export RESOURCE_GROUP=<resource-group-name>
2524
export LOCATION=<location>
2625
```
2726

28-
### Verify Azure CLI and aks-preview extension versions
29-
The add-on requires:
30-
* Azure CLI version 2.49.0 or later installed. To install or upgrade, see [Install Azure CLI][azure-cli-install].
31-
* `aks-preview` Azure CLI extension of version 0.5.163 or later installed
32-
33-
You can run `az --version` to verify above versions.
34-
35-
To install the aks-preview extension, run the following command:
36-
37-
```azurecli-interactive
38-
az extension add --name aks-preview
39-
```
40-
41-
Run the following command to update to the latest version of the extension released:
42-
43-
```azurecli-interactive
44-
az extension update --name aks-preview
45-
```
46-
47-
### Register the _AzureServiceMeshPreview_ feature flag
27+
### Verify Azure CLI version
4828

49-
Register the `AzureServiceMeshPreview` feature flag by using the [az feature register][az-feature-register] command:
50-
51-
```azurecli-interactive
52-
az feature register --namespace "Microsoft.ContainerService" --name "AzureServiceMeshPreview"
53-
```
54-
55-
It takes a few minutes for the feature to register. Verify the registration status by using the [az feature show][az-feature-show] command:
56-
57-
```azurecli-interactive
58-
az feature show --namespace "Microsoft.ContainerService" --name "AzureServiceMeshPreview"
59-
```
60-
61-
When the status reflects *Registered*, refresh the registration of the *Microsoft.ContainerService* resource provider by using the [az provider register][az-provider-register] command:
62-
63-
```azurecli-interactive
64-
az provider register --namespace Microsoft.ContainerService
65-
```
29+
The add-on requires Azure CLI version 2.57.0 or later installed. You can run `az --version` to verify version. To install or upgrade, see [Install Azure CLI][azure-cli-install].
6630

6731
## Install Istio add-on at the time of cluster creation
6832

@@ -116,33 +80,33 @@ Confirm the `istiod` pod has a status of `Running`. For example:
11680

11781
```
11882
NAME READY STATUS RESTARTS AGE
119-
istiod-asm-1-17-74f7f7c46c-xfdtl 1/1 Running 0 2m
83+
istiod-asm-1-18-74f7f7c46c-xfdtl 1/1 Running 0 2m
12084
```
12185

12286
## Enable sidecar injection
12387

12488
To automatically install sidecar to any new pods, annotate your namespaces:
12589

12690
```bash
127-
kubectl label namespace default istio.io/rev=asm-1-17
91+
kubectl label namespace default istio.io/rev=asm-1-18
12892
```
12993

13094
> [!IMPORTANT]
131-
> The default `istio-injection=enabled` labeling doesn't work. Explicit versioning (`istio.io/rev=asm-1-17`) is required.
95+
> The default `istio-injection=enabled` labeling doesn't work. Explicit versioning (`istio.io/rev=asm-1-18`) is required.
13296
13397

13498
For manual injection of sidecar using `istioctl kube-inject`, you need to specify extra parameters for `istioNamespace` (`-i`) and `revision` (`-r`). Example:
13599

136100
```bash
137-
kubectl apply -f <(istioctl kube-inject -f sample.yaml -i aks-istio-system -r asm-1-17) -n foo
101+
kubectl apply -f <(istioctl kube-inject -f sample.yaml -i aks-istio-system -r asm-1-18) -n foo
138102
```
139103

140104
## Deploy sample application
141105

142106
Use `kubectl apply` to deploy the sample application on the cluster:
143107

144108
```bash
145-
kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.17/samples/bookinfo/platform/kube/bookinfo.yaml
109+
kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.18/samples/bookinfo/platform/kube/bookinfo.yaml
146110
```
147111

148112
Confirm several deployments and services are created on your cluster. For example:
@@ -207,7 +171,7 @@ To test this sample application against ingress, check out [next-steps](#next-st
207171
Use `kubectl delete` to delete the sample application:
208172

209173
```bash
210-
kubectl delete -f https://raw.githubusercontent.com/istio/istio/release-1.17/samples/bookinfo/platform/kube/bookinfo.yaml
174+
kubectl delete -f https://raw.githubusercontent.com/istio/istio/release-1.18/samples/bookinfo/platform/kube/bookinfo.yaml
211175
```
212176

213177
If you don't intend to enable Istio ingress on your cluster and want to disable the Istio add-on, run the following command:

articles/aks/istio-deploy-ingress.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,18 @@
11
---
2-
title: Azure Kubernetes Service (AKS) external or internal ingresses for Istio service mesh add-on (preview)
3-
description: Deploy external or internal ingresses for Istio service mesh add-on for Azure Kubernetes Service (preview)
2+
title: Azure Kubernetes Service (AKS) external or internal ingresses for Istio service mesh add-on
3+
description: Deploy external or internal ingresses for Istio service mesh add-on for Azure Kubernetes Service
44
ms.topic: how-to
55
ms.service: azure-kubernetes-service
66
ms.subservice: aks-networking
7-
author: asudbring
7+
author: shashankbarsin
88
ms.date: 08/07/2023
9-
ms.author: allensu
9+
ms.author: shasb
1010
---
1111

12-
# Azure Kubernetes Service (AKS) external or internal ingresses for Istio service mesh add-on deployment (preview)
12+
# Azure Kubernetes Service (AKS) external or internal ingresses for Istio service mesh add-on deployment
1313

1414
This article shows you how to deploy external or internal ingresses for Istio service mesh add-on for Azure Kubernetes Service (AKS) cluster.
1515

16-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
17-
1816
## Prerequisites
1917

2018
This guide assumes you followed the [documentation][istio-deploy-addon] to enable the Istio add-on on an AKS cluster, deploy a sample application and set environment variables.

articles/aks/istio-meshconfig.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,19 @@
11
---
2-
title: Configure Istio-based service mesh add-on for Azure Kubernetes Service (preview)
3-
description: Configure Istio-based service mesh add-on for Azure Kubernetes Service (preview)
2+
title: Configure Istio-based service mesh add-on for Azure Kubernetes Service
3+
description: Configure Istio-based service mesh add-on for Azure Kubernetes Service
44
ms.topic: article
55
ms.custom: devx-track-azurecli
66
ms.date: 02/14/2024
77
ms.author: shasb
8+
author: shashankbarsin
89
---
910

10-
# Configure Istio-based service mesh add-on for Azure Kubernetes Service (preview)
11+
# Configure Istio-based service mesh add-on for Azure Kubernetes Service
1112

1213
Open-source Istio uses [MeshConfig][istio-meshconfig] to define mesh-wide settings for the Istio service mesh. Istio-based service mesh add-on for AKS builds on top of MeshConfig and classifies different properties as supported, allowed, and blocked.
1314

1415
This article walks through how to configure Istio-based service mesh add-on for Azure Kubernetes Service and the support policy applicable for such configuration.
1516

16-
[!INCLUDE [preview features callout](includes/preview/preview-callout.md)]
17-
1817
## Prerequisites
1918

2019
This guide assumes you followed the [documentation][istio-deploy-addon] to enable the Istio add-on on an AKS cluster.

articles/aks/istio-plugin-ca.md

Lines changed: 8 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,62 +1,26 @@
11
---
2-
title: Plug in CA certificates for Istio-based service mesh add-on on Azure Kubernetes Service (preview)
3-
description: Plug in CA certificates for Istio-based service mesh add-on on Azure Kubernetes Service (preview)
2+
title: Plug in CA certificates for Istio-based service mesh add-on on Azure Kubernetes Service
3+
description: Plug in CA certificates for Istio-based service mesh add-on on Azure Kubernetes Service
44
ms.topic: conceptual
55
ms.custom: devx-track-azurecli
66
ms.date: 12/04/2023
7+
ms.author: shasb
8+
author: shashankbarsin
79
---
810

9-
# Plug in CA certificates for Istio-based service mesh add-on on Azure Kubernetes Service (preview)
11+
# Plug in CA certificates for Istio-based service mesh add-on on Azure Kubernetes Service
1012

11-
In the Istio-based service mesh addon for Azure Kubernetes Service (preview), by default the Istio certificate authority (CA) generates a self-signed root certificate and key and uses them to sign the workload certificates. To protect the root CA key, you should use a root CA, which runs on a secure machine offline. You can use the root CA to issue intermediate certificates to the Istio CAs that run in each cluster. An Istio CA can sign workload certificates using the administrator-specified certificate and key, and distribute an administrator-specified root certificate to the workloads as the root of trust. This article addresses how to bring your own certificates and keys for Istio CA in the Istio-based service mesh add-on for Azure Kubernetes Service.
13+
In the Istio-based service mesh addon for Azure Kubernetes Service, by default the Istio certificate authority (CA) generates a self-signed root certificate and key and uses them to sign the workload certificates. To protect the root CA key, you should use a root CA, which runs on a secure machine offline. You can use the root CA to issue intermediate certificates to the Istio CAs that run in each cluster. An Istio CA can sign workload certificates using the administrator-specified certificate and key, and distribute an administrator-specified root certificate to the workloads as the root of trust. This article addresses how to bring your own certificates and keys for Istio CA in the Istio-based service mesh add-on for Azure Kubernetes Service.
1214

1315
[ ![Diagram that shows root and intermediate CA with Istio.](./media/istio/istio-byo-ca.png) ](./media/istio/istio-byo-ca.png#lightbox)
1416

1517
This article addresses how you can configure the Istio certificate authority with a root certificate, signing certificate and key provided as inputs using Azure Key Vault to the Istio-based service mesh add-on.
1618

17-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
18-
1919
## Before you begin
2020

21-
### Verify Azure CLI and aks-preview extension versions
22-
23-
The add-on requires:
24-
* Azure CLI version 2.49.0 or later installed. To install or upgrade, see [Install Azure CLI][install-azure-cli].
25-
* `aks-preview` Azure CLI extension of version 0.5.163 or later installed
26-
27-
You can run `az --version` to verify above versions.
28-
29-
To install the aks-preview extension, run the following command:
30-
31-
```azurecli-interactive
32-
az extension add --name aks-preview
33-
```
34-
35-
Run the following command to update to the latest version of the extension released:
36-
37-
```azurecli-interactive
38-
az extension update --name aks-preview
39-
```
40-
41-
### Register the _AzureServiceMeshPreview_ feature flag
42-
43-
Register the `AzureServiceMeshPreview` feature flag by using the [az feature register][az-feature-register] command:
44-
45-
```azurecli-interactive
46-
az feature register --namespace "Microsoft.ContainerService" --name "AzureServiceMeshPreview"
47-
```
48-
49-
It takes a few minutes for the feature to register. Verify the registration status by using the [az feature show][az-feature-show] command:
50-
51-
```azurecli-interactive
52-
az feature show --namespace "Microsoft.ContainerService" --name "AzureServiceMeshPreview"
53-
```
54-
55-
When the status reflects *Registered*, refresh the registration of the *Microsoft.ContainerService* resource provider by using the [az provider register][az-provider-register] command:
21+
### Verify Azure CLI version
5622

57-
```azurecli-interactive
58-
az provider register --namespace Microsoft.ContainerService
59-
```
23+
The add-on requires Azure CLI version 2.57.0 or later installed. You can run `az --version` to verify version. To install or upgrade, see [Install Azure CLI][azure-cli-install].
6024

6125
### Set up Azure Key Vault
6226

articles/aks/istio-upgrade.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,13 @@
11
---
2-
title: Upgrade Istio-based service mesh add-on for Azure Kubernetes Service (preview)
3-
description: Upgrade Istio-based service mesh add-on for Azure Kubernetes Service (preview).
2+
title: Upgrade Istio-based service mesh add-on for Azure Kubernetes Service
3+
description: Upgrade Istio-based service mesh add-on for Azure Kubernetes Service
44
ms.topic: conceptual
55
ms.date: 05/04/2023
6-
6+
ms.author: shasb
7+
author: shashankbarsin
78
---
89

9-
# Upgrade Istio-based service mesh add-on for Azure Kubernetes Service (preview)
10+
# Upgrade Istio-based service mesh add-on for Azure Kubernetes Service
1011

1112
This article addresses upgrade experiences for Istio-based service mesh add-on for Azure Kubernetes Service (AKS).
1213

0 commit comments

Comments
 (0)