Skip to content

Commit 0f7fb8d

Browse files
committed
update docs from PR feedback
Signed-off-by: Troy Connor <[email protected]>
1 parent 6fb4894 commit 0f7fb8d

File tree

1 file changed

+43
-15
lines changed

1 file changed

+43
-15
lines changed

articles/operator-nexus/howto-create-cluster-with-user-assigned-managed-identity.md

Lines changed: 43 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Azure Operator Nexus: Create Cluster Resource with User Assigned Managed Identity"
2+
title: "Azure Operator Nexus: Create Cluster Resource with a Managed Identity"
33
description: Create Clusters using the User Assigned Managed Identity to access the Log Analytics Workspace
44
author: troy0820
55
ms.author: troyconnor
@@ -10,9 +10,9 @@ ms.custom: template-how-to
1010
---
1111

1212

13-
# Create a Cluster Resource with a User Assigned Managed Identity
13+
# Create a Cluster Resource with a Managed Identity
1414

15-
To create a cluster without a service principal user name and password, you can now create a cluster with a user-assigned managed identity that has permissions over the Log Analytics Workspace. This will be used when installing the extensions that utilize the Log Analytics Workspace.
15+
To create a cluster without a service principal user name and password, you can now create a cluster with a user-assigned managed identity or a system-assigned managed identity that has permissions over the Log Analytics Workspace. This will be used when validating the hardware during hardware validation and when installing the extensions that utilize the Log Analytics Workspace.
1616

1717
## Prerequisites
1818

@@ -42,10 +42,11 @@ az networkcloud cluster create --name "<cluster-name>" \
4242
--mi-user-assigned "<user-assigned-identity-resource-id>" \
4343
--analytics-output-settings identity-type="UserAssignedIdentity" \
4444
identity-resource-id="<user-assigned-identity-resource-id>" \
45+
...
4546
--subscription "<subscription>"
4647
```
4748

48-
### View the principal ID for the managed identity
49+
### View the principal ID for the user-assigned managed identity
4950

5051
The identity resource ID can be found by selecting "JSON view" on the identity resource; the ID is at the top of the panel that appears. The container URL can be found on the Settings -> Properties tab of the container resource.
5152

@@ -57,19 +58,9 @@ Example:
5758
az networkcloud cluster show --ids /subscriptions/<Subscription ID>/resourceGroups/<Cluster Resource Group Name>/providers/Microsoft.NetworkCloud/clusters/<Cluster Name>
5859
```
5960

60-
System-assigned identity example:
61-
62-
```
63-
"identity": {
64-
"principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
65-
"tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
66-
"type": "SystemAssigned"
67-
},
68-
```
69-
7061
User-assigned identity example:
7162

72-
```
63+
```json
7364
"identity": {
7465
"type": "UserAssigned",
7566
"userAssignedIdentities": {
@@ -81,4 +72,41 @@ User-assigned identity example:
8172
},
8273
```
8374

75+
### Create and configure Log Analytics Workspace and System Assigned Managed Identity
76+
77+
> [!NOTE]
78+
> The system-assigned managed identity that is created during cluster creation does not exist until the cluster is created. This system-assigned managed identity will need to have persmissions over the scope of the Log Analytics Workspace with the role of Log Analytics Contributor before we can update the cluster to utilize this identity.
79+
80+
```azurecli-interactive
81+
az networkcloud cluster update --name "<cluster-name>" \
82+
--resource-group "<cluster-resource-group>" \
83+
--mi-system-assigned "<system-assigned-identity-resource-id>" \
84+
--analytics-output-settings identity-type="SystemAssignedIdentity" \
85+
identity-resource-id="<user-assigned-identity-resource-id>" \
86+
...
87+
--subscription "<subscription>"
88+
```
89+
90+
### View the principal ID for the system-assigned managed identity
91+
92+
The identity resource ID can be found by selecting "JSON view" on the identity resource; the ID is at the top of the panel that appears. The container URL can be found on the Settings -> Properties tab of the container resource.
93+
94+
The CLI can also be used to view the identity and the associated principal ID data within the cluster.
95+
96+
Example:
97+
98+
```console
99+
az networkcloud cluster show --ids /subscriptions/<Subscription ID>/resourceGroups/<Cluster Resource Group Name>/providers/Microsoft.NetworkCloud/clusters/<Cluster Name>
100+
```
101+
102+
System-assigned identity example:
103+
104+
```json
105+
"identity": {
106+
"principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
107+
"tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
108+
"type": "SystemAssigned"
109+
},
110+
```
111+
84112

0 commit comments

Comments
 (0)