Skip to content

Commit 4f01280

Browse files
AKS - update quickstart walkthrough doc
1 parent dd6fc76 commit 4f01280

File tree

1 file changed

+18
-21
lines changed

1 file changed

+18
-21
lines changed

articles/aks/kubernetes-walkthrough.md

Lines changed: 18 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,19 @@ To learn more about creating a Windows Server node pool, see [Create an AKS clus
2727

2828
- This article requires version 2.0.64 or greater of the Azure CLI. If using Azure Cloud Shell, the latest version is already installed.
2929
- The identity you are using to create your cluster has the appropriate minimum permissions. For more details on access and identity for AKS, see [Access and identity options for Azure Kubernetes Service (AKS)](concepts-identity.md).
30+
- Verify *Microsoft.OperationsManagement* and *Microsoft.OperationalInsights* are registered on your subscription. To check the registration status:
31+
32+
```azurecli
33+
az provider show -n Microsoft.OperationsManagement -o table
34+
az provider show -n Microsoft.OperationalInsights -o table
35+
```
36+
37+
If they are not registered, register *Microsoft.OperationsManagement* and *Microsoft.OperationalInsights* using:
38+
39+
```azurecli
40+
az provider register --namespace Microsoft.OperationsManagement
41+
az provider register --namespace Microsoft.OperationalInsights
42+
```
3043
3144
> [!NOTE]
3245
> Run the commands as administrator if you plan to run the commands in this quickstart locally instead of in Azure Cloud Shell.
@@ -59,27 +72,11 @@ Output for successfully created resource group:
5972
},
6073
"tags": null
6174
}
62-
```
63-
64-
## Enable cluster monitoring
65-
66-
Verify *Microsoft.OperationsManagement* and *Microsoft.OperationalInsights* are registered on your subscription. To check the registration status:
67-
68-
```azurecli
69-
az provider show -n Microsoft.OperationsManagement -o table
70-
az provider show -n Microsoft.OperationalInsights -o table
71-
```
72-
73-
If they are not registered, register *Microsoft.OperationsManagement* and *Microsoft.OperationalInsights* using:
74-
75-
```azurecli
76-
az provider register --namespace Microsoft.OperationsManagement
77-
az provider register --namespace Microsoft.OperationalInsights
78-
```
75+
```
7976

8077
## Create AKS cluster
8178

82-
Create an AKS cluster using the [az aks create][az-aks-create] command with the *--enable-addons monitoring* parameter to enable [Azure Monitor for containers][azure-monitor-containers]. The following example creates a cluster named *myAKSCluster* with one node:
79+
Create an AKS cluster using the [az aks create][az-aks-create] command with the *--enable-addons monitoring* parameter to enable [Azure Monitor container insights][azure-monitor-containers]. The following example creates a cluster named *myAKSCluster* with one node:
8380

8481
```azurecli-interactive
8582
az aks create --resource-group myResourceGroup --name myAKSCluster --node-count 1 --enable-addons monitoring --generate-ssh-keys
@@ -268,7 +265,7 @@ To see the Azure Vote app in action, open a web browser to the external IP addre
268265

269266
![Voting app deployed in Azure Kubernetes Service](./media/container-service-kubernetes-walkthrough/voting-app-deployed-in-azure-kubernetes-service.png)
270267

271-
View the cluster nodes' and pods' health metrics captured by [Azure Monitor for containers][azure-monitor-containers] in the Azure portal.
268+
View the cluster nodes' and pods' health metrics captured by [Azure Monitor container insights][azure-monitor-containers] in the Azure portal.
272269

273270
## Delete the cluster
274271

@@ -279,9 +276,9 @@ az group delete --name myResourceGroup --yes --no-wait
279276
```
280277

281278
> [!NOTE]
282-
> When you delete the cluster, the Azure Active Directory service principal used by the AKS cluster is not removed. For steps on how to remove the service principal, see [AKS service principal considerations and deletion][sp-delete].
279+
> If the AKS cluster was created with system-assigned managed identity (default identity option used in this quickstart), the identity is managed by the platform and does not require removal.
283280
>
284-
> If you used a managed identity, the identity is managed by the platform and does not require removal.
281+
> If the AKS cluster was created with service principal as the identity option instead, then when you delete the cluster, the service principal used by the AKS cluster is not removed. For steps on how to remove the service principal, see [AKS service principal considerations and deletion][sp-delete].
285282
286283
## Get the code
287284

0 commit comments

Comments
 (0)