Merge pull request #303715 from dominicbetts/aio-fix-deployment

AIO: Clarify preview instance requirement

Author: prmerger-automator[bot]

articles/iot-operations/discover-manage-assets/howto-autodetect-opc-ua-assets-use-akri.md

@@ -22,7 +22,7 @@ To learn more, see [What is asset discovery (preview)?](overview-akri.md).
 
 ## Prerequisites
 
-- **Enable resource sync rules.** A deployed instance of Azure IoT Operations with resource sync rules enabled. To learn more, see [Deploy Azure IoT Operations](../deploy-iot-ops/overview-deploy.md).
+- **Enable resource sync rules.** A deployed preview instance of Azure IoT Operations with resource sync rules enabled. To learn more, see [Deploy Azure IoT Operations](../deploy-iot-ops/overview-deploy.md).
 
     > [!IMPORTANT]
     > By default, the [deployment quickstart](../get-started-end-to-end-sample/quickstart-deploy.md) instructions do not enable resource sync rules. If resource sync rules aren't enabled on your instance, see [Enable resource sync rules on an existing instance](../troubleshoot/troubleshoot.md#you-want-to-enable-resource-sync-rules-on-an-existing-instance).

articles/iot-operations/discover-manage-assets/howto-configure-opc-ua.md

@@ -27,7 +27,7 @@ These assets, tags, and events map inbound data from OPC UA servers to friendly
 
 ## Prerequisites
 
-To configure devices and assets, you need a running instance of Azure IoT Operations.
+To configure devices and assets, you need a running preview instance of Azure IoT Operations.
 
 [!INCLUDE [iot-operations-entra-id-setup](../includes/iot-operations-entra-id-setup.md)]
 

articles/iot-operations/discover-manage-assets/howto-manage-assets-devices.md

@@ -31,7 +31,7 @@ This article describes how to use the operations experience web UI:
 
 ## Prerequisites
 
-To use the operations experience, you need a running instance of Azure IoT Operations.
+To use the operations experience, you need a running preview instance of Azure IoT Operations.
 
 [!INCLUDE [iot-operations-entra-id-setup](../includes/iot-operations-entra-id-setup.md)]
 

articles/iot-operations/discover-manage-assets/howto-use-http-connector.md

@@ -25,7 +25,7 @@ This article explains how to use the connector for REST/HTTP to perform tasks su
 
 ## Prerequisites
 
-To configure devices and assets, you need a running instance of Azure IoT Operations.
+To configure devices and assets, you need a running preview instance of Azure IoT Operations.
 
 [!INCLUDE [iot-operations-entra-id-setup](../includes/iot-operations-entra-id-setup.md)]
 

articles/iot-operations/end-to-end-tutorials/tutorial-add-assets.md

@@ -23,16 +23,17 @@ In this tutorial, you use the operations experience web UI to create your assets
 
 ## Prerequisites
 
-An instance of Azure IoT Operations with secure settings enabled deployed in a Kubernetes cluster. To create an instance, use one of the following to deploy Azure IoT Operations:
+A preview instance of Azure IoT Operations with secure settings enabled deployed in a Kubernetes cluster. To create a preview instance, use one of the following to deploy Azure IoT Operations:
 
 - [Quickstart: Run Azure IoT Operations in GitHub Codespaces with K3s](../get-started-end-to-end-sample/quickstart-deploy.md) provides simple instructions to deploy an Azure IoT Operations instance that you can use for the tutorials. Then, to enable secure settings follow the steps in [Enable secure settings in Azure IoT Operations](../deploy-iot-ops/howto-enable-secure-settings.md).
-- [Deployment overview](../deploy-iot-ops/overview-deploy.md) provides detailed instructions to deploy an Azure IoT Operations instance on Windows using Azure Kubernetes Service Edge Essentials or Ubuntu using K3s. Follow the steps in the deployment article for a secure settings deployment.
+- [Deployment overview](../deploy-iot-ops/overview-deploy.md) provides detailed instructions to deploy an Azure IoT Operations instance on Windows using Azure Kubernetes Service Edge Essentials or Ubuntu using K3s. Follow the steps in the deployment article for a secure settings deployment and to install the latest preview version.
 
 After you enable secure settings, the resource group that contains your Azure IoT Operations instance also contains the following resources:
 
 - An Azure Key Vault instance to store the secrets to synchronize into your Kubernetes cluster.
 - A user-assigned managed identity that Azure IoT Operations uses to access the Azure Key Vault instance.
 - A user-assigned managed identity that Azure IoT Operations components such as data flows can use to uses to connect to cloud endpoints such as Azure Event Hubs.
+- An Azure Device Registry namespace to store your namespace assets and devices.
 
 Ensure that when you configure secure settings that you [give your user account permissions to manage secrets](/azure/key-vault/secrets/quick-create-cli#give-your-user-account-permissions-to-manage-secrets-in-key-vault) with the **Key Vault Secrets Officer** role.
 

articles/iot-operations/get-started-end-to-end-sample/quickstart-deploy.md

@@ -153,6 +153,14 @@ To connect your cluster to Azure Arc:
    az connectedk8s enable-features -n $CLUSTER_NAME -g $RESOURCE_GROUP --custom-locations-oid $OBJECT_ID --features cluster-connect custom-locations
    ```
 
+## Install the preview version of `az iot ops`
+
+This quickstart uses the latest preview version of Azure IoT Operations. To install the preview version you need the latest version of the Azure IoT Operations CLI extension:
+
+```azurecli
+az extension add --upgrade --name azure-iot-ops --allow-preview True
+```
+
 ## Create storage account and schema registry
 
 Schema registry is a synchronized repository that stores message definitions both in the cloud and at the edge. Azure IoT Operations requires a schema registry on your cluster. Schema registry requires an Azure storage account for the schema information stored in the cloud.