Skip to content

Commit 016784b

Browse files
Merge pull request #313390 from dominicbetts/release-aio-2603-support-updates
AIO 2603: Tanzu support updates
2 parents 1c2252e + 3dc6b30 commit 016784b

7 files changed

Lines changed: 23 additions & 29 deletions

articles/iot-operations/deploy-iot-ops/howto-deploy-iot-operations.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -170,6 +170,9 @@ One at a time, run each Azure CLI command on the **Automation** tab in a termina
170170
> [!TIP]
171171
> The `init` command only needs to be run once per cluster. If you're reusing a cluster that already had Azure IoT Operations version 0.8.0 deployed on it, you can skip this step.
172172
173+
> [!IMPORTANT]
174+
> When you initialize your Azure IoT Operations instance on a VKS cluster with its [pod security admission controller running in restricted mode](https://techdocs.broadcom.com/us/en/vmware-cis/vcf/vsphere-supervisor-services-and-standalone-components/latest/managing-vsphere-kuberenetes-service-clusters-and-workloads/managing-security-for-tkg-service-clusters/configure-psa-for-tkr-1-25-and-later.html) you must include the `--cm-config global.telemetry.logs.enabled=false` flag when you run `az iot ops init`.
175+
173176
This command might take several minutes to complete. You can watch the progress in the deployment progress display in the terminal.
174177

175178
1. Deploy Azure IoT Operations. Copy and run the provided [az iot ops create](/cli/azure/iot/ops#az-iot-ops-create) command. This command might take several minutes to complete. You can watch the progress in the deployment progress display in the terminal.

articles/iot-operations/deploy-iot-ops/howto-deploy-iot-test-operations.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,9 @@ One at a time, run each Azure CLI command on the **Automation** tab in a termina
155155
156156
This command might take several minutes to complete. You can watch the progress in the deployment progress display in the terminal.
157157
158+
> [!IMPORTANT]
159+
> When you initialize your Azure IoT Operations instance on a VKS cluster with its [pod security admission controller running in restricted mode](https://techdocs.broadcom.com/us/en/vmware-cis/vcf/vsphere-supervisor-services-and-standalone-components/latest/managing-vsphere-kuberenetes-service-clusters-and-workloads/managing-security-for-tkg-service-clusters/configure-psa-for-tkr-1-25-and-later.html) you must include the `--cm-config global.telemetry.logs.enabled=false` flag when you run `az iot ops init`.
160+
158161
1. To deploy Azure IoT Operations, copy and run the provided [az iot ops create](/cli/azure/iot/ops#az-iot-ops-create) command. This command might take several minutes to complete. You can watch the progress in the deployment progress display in the terminal.
159162
160163
1. Once all of the Azure CLI commands complete successfully, you can close the **Install Azure IoT Operations** wizard.

articles/iot-operations/deploy-iot-ops/howto-prepare-cluster.md

Lines changed: 13 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -12,19 +12,19 @@ ms.date: 10/23/2024
1212

1313
# Prepare your Azure Arc-enabled Kubernetes cluster
1414

15-
An Azure Arc-enabled Kubernetes cluster is a prerequisite for deploying Azure IoT Operations. This article describes how to prepare a cluster before you deploy Azure IoT Operations. This article includes guidance for Ubuntu, Windows, Azure Local, and Tanzu Kubernetes Grid (TKG).
15+
An Azure Arc-enabled Kubernetes cluster is a prerequisite for deploying Azure IoT Operations. This article describes how to prepare a cluster before you deploy Azure IoT Operations. This article includes guidance for Ubuntu, Windows, Azure Local, and vSphere Kubernetes Service (VKS), formerly Tanzu Kubernetes Grid Service.
1616

1717
If you want to deploy Azure IoT Operations quickly and run a sample workload in a test environment, see the [Quickstart: Run Azure IoT Operations in GitHub Codespaces with K3s](../get-started-end-to-end-sample/quickstart-deploy.md).
1818

1919
## Prerequisites
2020

21-
Microsoft supports Azure Kubernetes Service (AKS) Edge Essentials for deployments on Windows, K3s for deployments on Ubuntu, AKS deployments on Azure Local, and Tanzu Kubernetes release (TKr) on TKG. If you want to deploy Azure IoT Operations to a multi-node solution, use K3s on Ubuntu.
21+
For multi-node deployments, K3s for deployments on Ubuntu, AKS deployments on Azure Local, and VKS. Azure Kubernetes Service (AKS) Edge Essentials for Windows only supports single-node deployments.
2222

2323
### [Ubuntu](#tab/ubuntu)
2424

2525
To prepare an Azure Arc-enabled Kubernetes cluster, you need:
2626

27-
[!INCLUDE [Cluster prerequisites for Ubuntu and Tanzu](../includes/cluster-prerequisites.md)]
27+
[!INCLUDE [Cluster prerequisites for Ubuntu and VKS](../includes/cluster-prerequisites.md)]
2828

2929
* Hardware that meets the system requirements:
3030

@@ -60,20 +60,20 @@ To prepare an Azure Arc-enabled Kubernetes cluster, you need:
6060
* [Azure IoT Operations supported environments](./overview-deploy.md#supported-environments).
6161
* [Azure Arc-enabled Kubernetes system requirements](/azure/azure-arc/kubernetes/system-requirements).
6262

63-
### [TKG with a management cluster](#tab/tkgm)
63+
### [VKS](#tab/vks)
6464

65-
To prepare a TKG workload cluster, you need:
65+
To prepare a VKS cluster, you need:
6666

67-
[!INCLUDE [Cluster prerequisites for Ubuntu and Tanzu](../includes/cluster-prerequisites.md)]
67+
[!INCLUDE [Cluster prerequisites for Ubuntu and VKS](../includes/cluster-prerequisites.md)]
6868

69-
- [TKG with a standalone management cluster.](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-kubernetes-grid/2-5/tkg/mgmt-index.html)
69+
- [vSphere Kubernetes Service](https://techdocs.broadcom.com/us/en/vmware-cis/vcf/vsphere-supervisor-services-and-standalone-components/latest/release-notes/vmware-tanzu-kubernetes-grid-service-release-notes.html)
7070

7171
- Hardware that meets the system requirements:
7272

7373
- [Azure IoT Operations supported environments](./overview-deploy.md#supported-environments).
7474
- [Azure Arc-enabled Kubernetes system requirements](/azure/azure-arc/kubernetes/system-requirements).
7575

76-
- [TKG standalone management cluster requirements.](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-kubernetes-grid/2-5/tkg/mgmt-reqs-index.html)
76+
- [Requirements for running VKS clusters](https://techdocs.broadcom.com/us/en/vmware-cis/vcf/vsphere-supervisor-services-and-standalone-components/latest/managing-vsphere-kubernetes-service/running-tkg-service-clusters.html)
7777

7878
---
7979

@@ -239,21 +239,12 @@ By default, a Kubernetes cluster is created with a node pool that can run Linux
239239

240240
Then, once you have an Azure Arc-enabled Kubernetes cluster, you can [deploy Azure IoT Operations](howto-deploy-iot-operations.md).
241241

242-
### [TKG with a management cluster](#tab/tkgm)
242+
### [VKS](#tab/vks)
243243

244-
To prepare a TKG workload cluster, you need:
244+
For guidance on setting up a VKS cluster, see [Deploying VKS Service Clusters](https://techdocs.broadcom.com/us/en/vmware-cis/vcf/vsphere-supervisor-services-and-standalone-components/latest/managing-vsphere-kubernetes-service/running-tkg-service-clusters/deploying-tkg-service-clusters.html).
245245

246-
- A single-node or multi-node TKG workload cluster. For guidance, see the [Tanzu documentation](https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-kubernetes-grid/2-5/tkg/workload-clusters-index.html).
247-
248-
### Update pod security admission settings
249-
250-
Before deploying Azure IoT Operations, you will need to update the Pod Security Admission settings on your TKG cluster. Applying this file will pre-create namespace labels and set pod security to `privileged`.
251-
252-
253-
254-
```azurecli
255-
kubectl apply -f https://raw.githubusercontent.com/Azure-Samples/explore-iot-operations/main/samples/tanzu-config/psa.yaml
256-
```
246+
> [!IMPORTANT]
247+
> When you initialize your Azure IoT Operations instance on a VKS cluster with its [pod security admission controller running in restricted mode](https://techdocs.broadcom.com/us/en/vmware-cis/vcf/vsphere-supervisor-services-and-standalone-components/latest/managing-vsphere-kuberenetes-service-clusters-and-workloads/managing-security-for-tkg-service-clusters/configure-psa-for-tkr-1-25-and-later.html) you must include the `--cm-config global.telemetry.logs.enabled=false` flag when you run `az iot ops init`.
257248
258249
### Arc-enable your cluster
259250

@@ -308,7 +299,7 @@ Connect your cluster to Azure Arc so that it can be managed remotely.
308299

309300
Save the output of this command to use in the next steps.
310301

311-
1. Connect to the TKG management cluster. Edit the custom resource for the workload cluster with the issuer URL from the previous step.
302+
1. Connect to the VKS cluster. Edit the custom resource for the workload cluster with the issuer URL from the previous step.
312303

313304
```azurecli
314305
kubectl edit cluster <CLUSTER_NAME>

articles/iot-operations/includes/cluster-prerequisites.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: include file
3-
description: include file with cluster prerequisites for Ubuntu and Tanzu
3+
description: include file with cluster prerequisites for Ubuntu and VKS
44
author: dominicbetts
55
ms.topic: include
66
ms.date: 06/16/2025

articles/iot-operations/includes/supported-environments-table.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,7 @@ Microsoft supports the following Kubernetes distributions for Azure IoT Operatio
2424
| Kubernetes distribution | Architecture | Support level | *Minimum validated version* | *Minimum validated OS* |
2525
|-----------------------------------|----------------------|----------------------|-------------------------------------|---------------------------------------|
2626
| [K3s](https://www.rancher.com/products/k3s) | x86_64 | General availability | *1.33.6* | *Ubuntu 24.04*, <br> Red Hat Enterprise Linux (RHEL) 9.x |
27-
| [Tanzu Kubernetes release (TKr)](https://www.vmware.com/products/app-platform/tanzu-kubernetes-grid) | x86_64 | General availability | *1.28.11* | *Tanzu Kubernetes Grid 2.5.2* |
27+
| [vSphere Kubernetes Service (VKS)](https://techdocs.broadcom.com/us/en/vmware-cis/vcf/vsphere-supervisor-services-and-standalone-components/latest/release-notes/vmware-tanzu-kubernetes-grid-service-release-notes.html) | x86_64 | General availability | *1.32.7* | *VKS* |
2828

2929
* The *minimum validated version* is the lowest version of the Kubernetes distribution that Microsoft uses to validate Azure IoT Operations deployments.
3030
* The *minimum validated OS* is the lowest operating system version that Microsoft uses to validate deployments.
31-
32-
>[!IMPORTANT]
33-
>Support for Azure IoT Operations deployments is only available on version 1.28.11 of TKr.

articles/iot-operations/includes/supported-environments.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,4 @@ ms.custom:
1010
---
1111

1212
> [!IMPORTANT]
13-
> Currently, K3s on Ubuntu 24.04 and Tanzu Kubernetes are the only platforms for deploying Azure IoT Operations in production. To learn more, see [Supported environments](../deploy-iot-ops/overview-deploy.md#supported-environments).
13+
> Currently, K3s on Ubuntu 24.04 and vSphere Kubernetes Service are the only platforms for deploying Azure IoT Operations in production. To learn more, see [Supported environments](../deploy-iot-ops/overview-deploy.md#supported-environments).

articles/iot-operations/includes/supported-versions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ Currently, [Azure support](https://azure.microsoft.com/support/plans) is availab
1313

1414
| Version | Type | Current patch <br/>release (YYMM) | Release notes | Current <br/>CLI version |
1515
|---------|------|---------------|---------------|-------------|
16+
| 1.3.x | GA | 1.3.38 (2603) | [Release notes](https://github.com/Azure/azure-iot-operations/releases/tag/v1.3.38) | [2.4.0](https://github.com/Azure/azure-iot-ops-cli-extension/releases/tag/v2.4.0) |
1617
| 1.2.x | GA | 1.2.189 (2602) | [Release notes](https://github.com/Azure/azure-iot-operations/releases/tag/v1.2.189) | [2.3.0](https://github.com/Azure/azure-iot-ops-cli-extension/releases/tag/v2.3.0) |
1718
| 1.1.x | GA | 1.1.59 (2506) | [Release notes](https://github.com/Azure/azure-iot-operations/releases/tag/v1.1.59) | [1.7.0](https://github.com/Azure/azure-iot-ops-cli-extension/releases/tag/v1.7.0) |
18-
| 1.0.x | GA | 1.0.34 (2503) | [Release notes](https://github.com/Azure/azure-iot-operations/releases/tag/v1.0.34) | [1.3.0](https://github.com/Azure/azure-iot-ops-cli-extension/releases/tag/v1.3.0) |
1919

2020
To learn about upgrades between versions, see [Upgrade to a new version](../deploy-iot-ops/howto-upgrade.md).
2121

0 commit comments

Comments
 (0)