link to aks-ee docs; slim down supported environment statements

kgremban · kgremban · commit f647c7be3790 · 2024-10-28T16:46:32.000-07:00
diff --git a/articles/iot-operations/deploy-iot-ops/howto-deploy-iot-operations.md b/articles/iot-operations/deploy-iot-ops/howto-deploy-iot-operations.md
@@ -1,6 +1,6 @@
 ---
 title: Deploy Azure IoT Operations to a cluster
-description: Use the Azure CLI or Azure portal to deploy Azure IoT Operations to an Arc-enabled Kubernetes cluster.
+description: Use the Azure portal to deploy Azure IoT Operations to an Arc-enabled Kubernetes cluster.
 author: kgremban
 ms.author: kgremban
 ms.topic: how-to
@@ -14,7 +14,7 @@ ms.date: 10/23/2024
 
 [!INCLUDE [public-preview-note](../includes/public-preview-note.md)]
 
-Learn how to deploy Azure IoT Operations Preview to a Kubernetes cluster using the Azure CLI or Azure portal.
+Learn how to deploy Azure IoT Operations Preview to a Kubernetes cluster using the Azure portal.
 
 In this article, we discuss Azure IoT Operations *deployments* and *instances*, which are two different concepts:
 
diff --git a/articles/iot-operations/deploy-iot-ops/howto-prepare-cluster.md b/articles/iot-operations/deploy-iot-ops/howto-prepare-cluster.md
@@ -24,20 +24,11 @@ Microsoft supports Azure Kubernetes Service (AKS) Edge Essentials for deployment
 
 If you want to deploy Azure IoT Operations to a multi-node solution, use K3s on Ubuntu.
 
-To prepare your Azure Arc-enabled Kubernetes cluster, you need:
-
 ### [AKS Edge Essentials](#tab/aks-edge-essentials)
 
-* An Azure subscription. If you don't have an Azure subscription, [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
-
-* Azure CLI version 2.64.0 or newer installed on your development machine. Use `az --version` to check your version and `az upgrade` to update if necessary. For more information, see [How to install the Azure CLI](/cli/azure/install-azure-cli).
-
-* The latest version of the following extensions for Azure CLI:
+To prepare an Azure Arc-enabled Kubernetes cluster, you need:
 
-  ```bash
-  az extension add --upgrade --name azure-iot-ops
-  az extension add --upgrade --name connectedk8s
-  ```
+* An Azure subscription. If you don't have an Azure subscription, [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
 * Hardware that meets the system requirements:
 
@@ -48,6 +39,8 @@ To prepare your Azure Arc-enabled Kubernetes cluster, you need:
 
 ### [Ubuntu](#tab/ubuntu)
 
+To prepare an Azure Arc-enabled Kubernetes cluster, you need:
+
 * An Azure subscription. If you don't have an Azure subscription, [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
 * Azure CLI version 2.64.0 or newer installed on your development machine. Use `az --version` to check your version and `az upgrade` to update if necessary. For more information, see [How to install the Azure CLI](/cli/azure/install-azure-cli).
@@ -69,7 +62,7 @@ To prepare your Azure Arc-enabled Kubernetes cluster, you need:
 
 ---
 
-## Create a cluster
+## Create and Arc-enable a cluster
 
 This section provides steps to create clusters in validated environments on Linux and Windows.
 
@@ -79,43 +72,7 @@ This section provides steps to create clusters in validated environments on Linu
 
 The [AksEdgeQuickStartForAio.ps1](https://github.com/Azure/AKS-Edge/blob/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStartForAio.ps1) script automates the process of creating and connecting a cluster, and is the recommended path for deploying Azure IoT Operations on AKS Edge Essentials.
 
-1. Open an elevated PowerShell window and change the directory to a working folder.
-
-1. Get the `objectId` of the Microsoft Entra ID application that the Azure Arc service uses in your tenant. Run the following command exactly as written, without changing the GUID value.
-
-   ```azurecli
-   az ad sp show --id bc313c14-388c-4e7d-a58e-70017303ee3b --query id -o tsv
-   ```
-
-1. Run the following commands, replacing the placeholder values with your information:
-
-   | Placeholder | Value |
-   | ----------- | ----- |
-   | SUBSCRIPTION_ID | The ID of your Azure subscription. If you don't know your subscription ID, see [Find your Azure subscription](/azure/azure-portal/get-subscription-tenant-id#find-your-azure-subscription). |
-   | TENANT_ID | The ID of your Microsoft Entra tenant. If you don't know your tenant ID, see [Find your Microsoft Entra tenant](/azure/azure-portal/get-subscription-tenant-id#find-your-microsoft-entra-tenant). |
-   | RESOURCE_GROUP_NAME | The name of an existing resource group or a name for a new resource group to be created. |
-   | LOCATION | An Azure region close to you. For the list of currently supported Azure regions, see [Supported regions](../overview-iot-operations.md#supported-regions). |
-   | CLUSTER_NAME | A name for the new cluster to be created. |
-   | ARC_APP_OBJECT_ID | The object ID value that you retrieved in the previous step. |
-
-   ```powershell
-   $url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStartForAio.ps1"
-   Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStartForAio.ps1
-   Unblock-File .\AksEdgeQuickStartForAio.ps1
-   Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
-   .\AksEdgeQuickStartForAio.ps1 -SubscriptionId "<SUBSCRIPTION_ID>" -TenantId "<TENANT_ID>" -ResourceGroupName "<RESOURCE_GROUP_NAME>"  -Location "<LOCATION>"  -ClusterName "<CLUSTER_NAME>" -CustomLocationOid "<ARC_APP_OBJECT_ID>"
-   ```
-
-   If there are any issues during deployment, including if your machine reboots as part of this process, run the whole set of commands again.
-
-1. Run the following commands to check that the deployment was successful:
-
-   ```powershell
-   Import-Module AksEdge
-   Get-AksEdgeDeploymentInfo
-   ```
-
-   In the output of the `Get-AksEdgeDeploymentInfo` command, you should see that the cluster's Arc status is `Connected`.
+For instructions on running the script, see [Configure an AKS Edge Essentials cluster for Azure IoT Operations](/azure/aks/hybrid/aks-edge-howto-deploy-azure-iot).
 
 ### [Ubuntu](#tab/ubuntu)
 
@@ -167,20 +124,10 @@ On multi-node clusters with at least three nodes, you have the option of enablin
 
 If you want to enable fault tolerance during deployment, configure your clusters by following the steps in [Prepare Linux for Edge Volumes using a multi-node Ubuntu cluster](/azure/azure-arc/container-storage/multi-node-cluster-edge-volumes?pivots=ubuntu).
 
----
-
-## Arc-enable your cluster
+### Arc-enable your cluster
 
 Connect your cluster to Azure Arc so that it can be managed remotely.
 
-### [AKS Edge Essentials](#tab/aks-edge-essentials)
-
-The **AksEdgeQuickStartForAio.ps1** script that you ran in the previous section handled the steps to connect your cluster. You don't need to take any extra steps to Arc-enable.
-
-### [Ubuntu](#tab/ubuntu)
-
-To connect your cluster to Azure Arc:
-
 1. On the machine where you deployed the Kubernetes cluster, sign in with Azure CLI:
 
    ```azurecli
diff --git a/articles/iot-operations/deploy-iot-ops/overview-deploy.md b/articles/iot-operations/deploy-iot-ops/overview-deploy.md
@@ -16,8 +16,6 @@ ms.date: 10/23/2024
 
 ## Supported environments
 
-Azure IoT Operations should work on any Arc-enabled Kubernetes cluster except for those on Arm64 architectures. For more information, review the [Azure Arc-enabled Kubernetes system requirements](/azure/azure-arc/kubernetes/system-requirements).
-
 Microsoft supports Azure Kubernetes Service (AKS) Edge Essentials for deployments on Windows and K3s for deployments on Ubuntu. For a list of specific hardware and software combinations that are tested and validated, see [Validated environments](../overview-iot-operations.md#validated-environments).
 
 ## Choose your features
diff --git a/articles/iot-operations/get-started-end-to-end-sample/quickstart-deploy.md b/articles/iot-operations/get-started-end-to-end-sample/quickstart-deploy.md
@@ -52,10 +52,9 @@ Azure IoT Operations is a suite of data services that run on Kubernetes clusters
 
 ## Connect a Kubernetes cluster to Azure Arc
 
-Azure IoT Operations should work on any Kubernetes cluster that conforms to the Cloud Native Computing Foundation (CNCF) standards. For speed and convenience, this quickstart uses GitHub Codespaces to host your cluster.
+Azure IoT Operations supports Azure Kubernetes Service (AKS) Edge Essentials and K3s on Ubuntu clusters. However, for speed and convenience, this quickstart uses GitHub Codespaces to host your cluster.
 
-> [!IMPORTANT]
-> Codespaces are easy to set up quickly and tear down later, but they're not suitable for performance evaluation or scale testing. Use GitHub Codespaces for exploration only. To learn how to deploy Azure IoT Operations to a production cluster such as AKS Edge Essentials, see [Prepare your Azure Arc-enabled Kubernetes cluster](../deploy-iot-ops/howto-prepare-cluster.md?tabs=aks-edge-essentials).
+Codespaces are easy to set up quickly and tear down later, but they're not suitable for performance evaluation or scale testing. Use GitHub Codespaces for exploration only. To learn how to deploy Azure IoT Operations to a cluster on Windows or Ubuntu, see [Prepare your Azure Arc-enabled Kubernetes cluster](../deploy-iot-ops/howto-prepare-cluster.md).
 
 In this section, you create a new cluster and connect it to Azure Arc. If you want to reuse a cluster that you deployed Azure IoT Operations to previously, refer to the steps in [Clean up resources](#clean-up-resources) to uninstall Azure IoT Operations before continuing.
 
diff --git a/articles/iot-operations/includes/validated-environments.md b/articles/iot-operations/includes/validated-environments.md
@@ -10,12 +10,11 @@ ms.custom:
   - ignite-2023
 ---
 
-Azure IoT Operations ships as a set of Azure Arc-enabled Kubernetes services and is intended for use with [CNCF](https://www.cncf.io/) conformant [Arc validated partner products](/azure/azure-arc/kubernetes/validation-program). Currently, Microsoft has validated Azure IoT Operations against the following fixed-set of infrastructures and environments:
+Currently, Microsoft has validated Azure IoT Operations against the following fixed-set of infrastructures and environments:
 
 | Environment | Version |
 | ----------- | ------- |
 | AKS-EE on Windows 11 IoT Enterprise <br> on a Lenovo ThinkStation P3 Tiny machine (16 core, 32 GB RAM) with single-node cluster | AksEdge-K3s-1.29.6-1.8.202.0 |
 | K3S on Ubuntu 24.04 <br> on a Lenovo ThinkStation P3 Tiny machine (16 core, 32 GB RAM) with a 3-node cluster | K3s version 1.31.1 |
 
-> [!IMPORTANT]
-> The environments listed previously are production-like environments that Microsoft has validated. They're not the only environments that Azure IoT Operations can run on. Azure IoT Operations can run on any Arc-enabled Kubernetes cluster that meets the [Azure Arc-enabled Kubernetes system requirements](/azure/azure-arc/kubernetes/system-requirements). Currently Azure IoT Operations doesn't support ARM64 architectures.
+Currently Azure IoT Operations doesn't support ARM64 architectures.
