You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AKS-Hybrid/aks-edge-howto-deploy-AIO.md
+18-5Lines changed: 18 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,12 +12,12 @@ ms.custom: template-how-to
12
12
13
13
[Azure IoT Operations (AIO)]() requires an Arc-enabled Kubernetes cluster. You can use AKS Edge Essentials to create a Microsoft managed Kubernetes cluster and deploy AIO as a workload on it. This article describes the steps to run a handy script that creates an AKS Edge Essentials Kubernetes clusters with all the required configurations applicable for AIO.
14
14
15
-
> [!INFO]
16
-
> AIO is Gnerally Available on AKS EE single machine clusters. Deploying clusters on multiple machines is an experimental feature.
15
+
> [!NOTE]
16
+
> AIO is Generally Available on AKS EE when deployed on single machine clusters. Deploying clusters on multiple machines is an experimental feature.
17
17
18
18
## Pre-requisites for running the script
19
19
20
-
- An Azure subscription. If you don't have an Azure subscription, create one for free before you begin.
20
+
- An Azure subscription with either the **Owner** role or a combination of **Contributor** and **User Access Administrator** roles. You can check your access level by navigating to your subscription, selecting **Access control (IAM)** on the left-hand side of the Azure portal, and then selecting **View my access**. Read the [Azure Resource Manager documentation](/azure/azure-resource-manager/management/manage-resource-groups-portal) for more information about managing resource groups. If you don't have an Azure subscription, [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
21
21
- 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](https://review.learn.microsoft.com/en-us/cli/azure/install-azure-cli).
22
22
- The latest version of the following extensions for Azure CLI:
23
23
```bash
@@ -29,7 +29,20 @@ ms.custom: template-how-to
29
29
30
30
31
31
## Create an AKS EE cluster for AIO
32
-
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.
32
+
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. Here is what the script does on your behalf:
33
+
- Downloads the latest AKS EE MSI from this [repo](https://github.com/Azure/aks-edge).
34
+
- Installs AKS EE and deploys to creates a single machine Kubernetes cluster on your Windows machine.
35
+
- Connects to the Azure subscription and creates a resource group if it does exists already and connects the cluster to Arc to create an Arc-enabled Kubernetes cluster.
36
+
- Enables the custom location feature on the Arc-enabled Kubernetes cluster.
37
+
- Deploys the local path provisioning.
38
+
- Configures firewall rules on the host Windows machine for the MQTT broker.
39
+
- On the Linux VM, which serves as the Kubernetes control plane node:
40
+
- Configures port proxy for the Kubernetes Service default IP range of 10.96.0.0/28.
41
+
- Configures the IP table rules.
42
+
- `sudo iptables -A INPUT -p tcp -m state --state NEW -m tcp --dport 9110 -j ACCEPT`
1. Open an elevated PowerShell window and change the directory to a working folder.
34
47
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.
35
48
```azurecli
@@ -44,7 +57,7 @@ The [AksEdgeQuickStartForAio.ps1](https://github.com/Azure/AKS-Edge/blob/main/to
44
57
|RESOURCE_GROUP_NAME | The name of an existing resource group or a name for a new resource group to be created. |
45
58
|LOCATION | An Azure region close to you. For the list of currently supported Azure regions, see [Supported regions](https://review.learn.microsoft.com/en-us/azure/iot-operations/overview-iot-operations#supported-regions). |
46
59
|CLUSTER_NAME | A name for the new cluster to be created. |
47
-
|ARC_APP_OBJECT_ID | The object ID value that you retrieved in the previous step. |
60
+
|ARC_APP_OBJECT_ID | The object ID value that you retrieved in step 2. |
0 commit comments