Skip to content

Commit 4d02a33

Browse files
committed
add role/permission info
1 parent 4cacc46 commit 4d02a33

File tree

1 file changed

+21
-8
lines changed

1 file changed

+21
-8
lines changed

articles/azure-arc/kubernetes/kubernetes-resource-view.md

Lines changed: 21 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Access Kubernetes resources from Azure portal
3-
ms.date: 07/22/2022
3+
ms.date: 08/04/2023
44
ms.topic: how-to
55
description: Learn how to interact with Kubernetes resources to manage an Azure Arc-enabled Kubernetes cluster from the Azure portal.
66
---
@@ -13,7 +13,19 @@ The Azure portal includes a Kubernetes resource view for easy access to the Kube
1313

1414
- An existing Kubernetes cluster [connected](quickstart-connect-cluster.md) to Azure as an Azure Arc-enabled Kubernetes resource.
1515

16-
- [Service account token](cluster-connect.md#service-account-token-authentication-option) for authentication to the cluster.
16+
- An account that can authenticate to the cluster and access the resources in the portal:
17+
18+
- If using [cluster connect with service account token authentication](cluster-connect.md#service-account-token-authentication-option), ensure that the service account has a role that can authenticate to the cluster, such as `cluster-admin`:
19+
20+
```console
21+
kubectl create clusterrolebinding demo-user-binding --clusterrole cluster-admin --serviceaccount default:demo-user`
22+
```
23+
24+
- If using [Azure RBAC](azure-rbac.md), assign a role to your Azure Active Directory (Azure AD) entity that lets it authenticate to the cluster, such as [Azure Arc Kubernetes Viewer](/azure/role-based-access-control/built-in-roles):
25+
26+
```azurecli
27+
az role assignment create --role "Azure Arc Kubernetes Viewer" --assignee $AAD_ENTITY_OBJECT_ID --scope $ARM_ID_CLUSTER
28+
```
1729

1830
## View Kubernetes resources
1931

@@ -25,19 +37,20 @@ To see the Kubernetes resources, navigate to your cluster in the Azure portal. T
2537
- **Storage** shows your Azure storage classes and persistent volume information.
2638
- **Configuration** shows your cluster's config maps and secrets.
2739

28-
[ ![Kubernetes workloads information displayed in the Azure portal](media/kubernetes-resource-view/workloads.png) ](media/kubernetes-resource-view/workloads.png#lightbox)
40+
:::image type="content" source="media/kubernetes-resource-view/workloads.png" alt-text="Screenshot of Kubernetes workloads information in the Azure portal." lightbox="media/kubernetes-resource-view/workloads.png":::
2941

3042
## Edit YAML
3143

3244
The Kubernetes resource view also includes a YAML editor. A built-in YAML editor means you can update Kubernetes objects from within the portal and apply changes immediately.
3345

34-
After you edit the YAML, select **Review + save**, confirm the changes, and then save again.
46+
>[!WARNING]
47+
> The Azure portal Kubernetes management capabilities and the YAML editor are built for learning and flighting new deployments in a development and test setting. Performing direct production changes by editing the YAML is not recommended. For production environments, consider using [GitOps to apply configurations](tutorial-use-gitops-flux2.md).
3548
36-
[ ![YAML editor for Kubernetes objects displayed in the Azure portal](media/kubernetes-resource-view/yaml-editor.png) ](media/kubernetes-resource-view/yaml-editor.png#lightbox)
49+
After you edit the YAML, select **Review + save**, confirm the changes, and then save again.
3750

38-
>[!WARNING]
39-
> The Azure portal Kubernetes management capabilities and the YAML editor are built for learning and flighting new deployments in a development and testing setting. Performing direct production changes via UI or CLI is not recommended. For production environments, consider using [Configurations (GitOps)](tutorial-use-gitops-flux2.md).
51+
:::image type="content" source="media/kubernetes-resource-view/yaml-editor.png" alt-text="Screenshot showing the YAML editor for Kubernetes objects displayed in the Azure portal." lightbox="media/kubernetes-resource-view/yaml-editor.png":::
4052

4153
## Next steps
4254

43-
Azure Monitor for containers provides more in-depth information about nodes and containers of the cluster when compared to the Kubernetes resource view described in this article. Learn how to [deploy Azure Monitor for containers](../../azure-monitor/containers/container-insights-enable-arc-enabled-clusters.md?toc=/azure/azure-arc/kubernetes/toc.json) on your cluster.
55+
- Learn how to [deploy Azure Monitor for containers](../../azure-monitor/containers/container-insights-enable-arc-enabled-clusters.md?toc=/azure/azure-arc/kubernetes/toc.json) for more in-depth information about nodes and containers on your clusters.
56+
- Learn about [identity and access options for Azure Arc-enabled Kubernetes](identity-access-overview.md).

0 commit comments

Comments
 (0)