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: articles/iot-operations/deploy-iot-ops/overview-deploy.md
+16-10Lines changed: 16 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ ms.date: 11/06/2024
12
12
13
13
# Deployment details
14
14
15
-
When you deploy Azure IoT Operations, you install a suite of services on an [Azure Arc-enabled Kubernetes cluster](/azure/azure-arc/kubernetes/overview). This article provides an overview of the different deployment options to consider for your scenario.
15
+
When you deploy Azure IoT Operations, you install a suite of services on an Azure Arc-enabled Kubernetes cluster. This article provides an overview of the different deployment options to consider for your scenario.
16
16
17
17
## Supported environments
18
18
@@ -21,10 +21,8 @@ Microsoft supports the following environments for Azure IoT Operations deploymen
21
21
| Environment | Minimum version | Availability |
22
22
| ----------- | --------------- | ------------ |
23
23
| K3s on Ubuntu 24.04 | K3s version 1.31.1 | General availability |
24
-
| Azure Kubernetes Service (AKS) Edge Essentials on Windows 11 IoT Enterprise <sup>1</sup> | AksEdge-K3s-1.29.6-1.8.202.0 | Public preview |
25
-
| Azure Kubernetes Service (AKS) on Azure Local <sup>1</sup> | Azure Stack HCI OS, version 23H2, build 2411 | Public preview |
26
-
27
-
<sup>1</sup> Regardless of the host system environment, Azure IoT Operations only supports deployment to Kubernetes clusters running on Linux nodes.
24
+
| Azure Kubernetes Service (AKS) Edge Essentials on Windows 11 IoT Enterprise | AksEdge-K3s-1.29.6-1.8.202.0 | Public preview |
25
+
| Azure Kubernetes Service (AKS) on Azure Local | Azure Stack HCI OS, version 23H2, build 2411 | Public preview |
28
26
29
27
>[!NOTE]
30
28
>Billing usage records are collected on any environment where Azure IoT Operations is installed, regardless of support or availability levels.
@@ -46,22 +44,31 @@ A deployment with only test settings:
46
44
47
45
* Doesn't configure secrets or user-assigned managed identity capabilities.
48
46
* Is meant to enable the end-to-end quickstart sample for evaluation purposes, so supports the OPC PLC simulator and connects to cloud resources using system-assigned managed identity.
49
-
* Can be upgraded to use secure settings by following the steps in [Enable secure settings](howto-enable-secure-settings.md).
47
+
* Can be upgraded to use secure settings.
48
+
49
+
The quickstart scenario, [Quickstart: Run Azure IoT Operations in GitHub Codespaces](../get-started-end-to-end-sample/quickstart-deploy.md), uses test settings.
50
+
51
+
At any point, you can upgrade an Azure IoT Operations instance to use secure settings by following the steps in [Enable secure settings](howto-enable-secure-settings.md).
50
52
51
53
### Secure settings deployment
52
54
53
55
A deployment with secure settings:
54
56
55
57
* Enables secrets and user-assignment managed identity, both of which are important capabilities for developing a production-ready scenario. Secrets are used whenever Azure IoT Operations components connect to a resource outside of the cluster; for example, an OPC UA server or a dataflow endpoint.
56
58
59
+
To deploy Azure IoT Operations with secure settings, follow these articles:
60
+
61
+
1. Start with [Prepare your Azure Arc-enabled Kubernetes cluster](./howto-prepare-cluster.md) to configure and Arc-enable your cluster.
The following table describes Azure IoT Operations deployment and management tasks that require elevated permissions. For information about assigning roles to users, see [Steps to assign an Azure role](../../role-based-access-control/role-assignments-steps.md).
60
67
61
68
| Task | Required permission | Comments |
62
69
| ---- | ------------------- | -------- |
63
-
| Deploy Azure IoT Operations |**Contributor** role at the subscription level. ||
64
-
| Register resource providers |**Contributor** role at the subscription level. | Only required to do once per subscription. |
70
+
| Deploy Azure IoT Operations |**Contributor** role at the resource group level. ||
71
+
| Register resource providers |Microsoft.ExtendedLocation/register/action Microsoft.SecretSyncController/register/action Microsoft.Kubernetes/register/action Microsoft.KubernetesConfiguration/register/action Microsoft.IoTOperations/register/action Microsoft.DeviceRegistry/register/action| Only required to do once per subscription. |
65
72
| Create a schema registry. |**Microsoft.Authorization/roleAssignments/write** permissions at the resource group level. ||
66
73
| Create secrets in Key Vault |**Key Vault Secrets Officer** role at the resource level. | Only required for secure settings deployment. |
67
74
| Enable resource sync rules on an Azure IoT Operations instance |**Microsoft.Authorization/roleAssignments/write** permissions at the resource group level. | Resource sync rules are disabled by default, but can be enabled as part of the [az iot ops create](/cli/azure/iot/ops#az-iot-ops-create) command. |
@@ -89,7 +96,7 @@ If you use enterprise firewalls or proxies to manage outbound traffic, configure
89
96
90
97
* Endpoints in [Azure CLI endpoints](/cli/azure/azure-cli-endpoints?tabs=azure-cloud#endpoints).
91
98
92
-
Azure IoT Operations uses`graph.windows.net`, `*.azurecr.io`, `*.blob.core.windows.net`, `*.vault.azure.net` from this endpoint list.
99
+
You need`graph.windows.net`, `*.azurecr.io`, `*.blob.core.windows.net`, `*.vault.azure.net` from this endpoint list.
93
100
94
101
* The following endpoints are required specifically for Azure IoT Operations:
95
102
@@ -104,7 +111,6 @@ If you use enterprise firewalls or proxies to manage outbound traffic, configure
0 commit comments