Add Azure Resources doc (#8283)

motm32 · web-flow · commit d9ec1f65e6c1 · 2025-05-06T19:30:49.000+02:00
* add resources doc

* small changes

* add toc

* requested changes

* add screenshots from misty
diff --git a/docs/azure/aksextensions.md b/docs/azure/aksextensions.md
@@ -1,5 +1,5 @@
 ---
-Order: 5
+Order: 6
 Area: azure
 TOCTitle: Azure Kubernetes Service
 ContentId: 131f9633-5446-4384-96ca-7bff2e3dc0fc
@@ -9,15 +9,15 @@ MetaDescription: Working with AKS tools and diagnostics in Visual Studio Code
 ---
 # AKS tools and diagnostics in VS Code
 
-This document will walk you through some of the ways you can interact with your AKS clusters directly from Visual Studio Code. [Azure Kubernetes Services](https://azure.microsoft.com/services/kubernetes-service/#overview) is a fully managed [Kubernetes](https://azure.microsoft.com/topic/what-is-kubernetes/#overview) service. Azure Kubernetes Service (AKS) offers serverless Kubernetes, a continuous integration and continuous delivery (CI/CD) experience, with enterprise-grade security and governance. Azure Kubernetes Service (AKS) is an open-source system for automating deployment, scaling, and management of containerized applications. 
+This document will walk you through some of the ways you can interact with your AKS clusters directly from Visual Studio Code. [Azure Kubernetes Services](https://azure.microsoft.com/services/kubernetes-service/#overview) is a fully managed [Kubernetes](https://azure.microsoft.com/topic/what-is-kubernetes/#overview) service. Azure Kubernetes Service (AKS) offers serverless Kubernetes, a continuous integration and continuous delivery (CI/CD) experience, with enterprise-grade security and governance. Azure Kubernetes Service (AKS) is an open-source system for automating deployment, scaling, and management of containerized applications.
 
 We will show you how to run [diagnostic health-checks](https://learn.microsoft.com/azure/aks/concepts-diagnostics) on your AKS cluster, launch [AKS Periscope](https://github.com/azure/aks-periscope) for more in-depth troubleshooting, deploy [Azure Service Operator](https://github.com/Azure/azure-service-operator), or generate [GitHub Actions Starter Workflows](https://github.com/actions/starter-workflows).
 
 ## Before you begin
 
-The [AKS VS Code Extension](https://marketplace.visualstudio.com/items?itemName=ms-kubernetes-tools.vscode-aks-tools) has parent dependency on [Kubernetes VS Code extension](https://marketplace.visualstudio.com/items?itemName=ms-kubernetes-tools.vscode-kubernetes-tools). 
+The [AKS VS Code Extension](https://marketplace.visualstudio.com/items?itemName=ms-kubernetes-tools.vscode-aks-tools) has parent dependency on [Kubernetes VS Code extension](https://marketplace.visualstudio.com/items?itemName=ms-kubernetes-tools.vscode-kubernetes-tools).
 
-You will need to download the [Kubernetes VS Code extension](https://code.visualstudio.com/docs/azure/kubernetes). 
+You will need to download the [Kubernetes VS Code extension](https://code.visualstudio.com/docs/azure/kubernetes).
 
 You can follow this guide on an existing AKS cluster or you can [create AKS cluster](https://learn.microsoft.com/azure/aks/learn/quick-kubernetes-deploy-portal).
 
@@ -101,11 +101,11 @@ For more information, visit [AKS Periscope](https://github.com/Azure/aks-perisco
 
 **Configuring a Storage Account**
 
-Running the AKS Periscope requires you to have a storage account associated with the Diagnostic settings of your AKS cluster. 
+Running the AKS Periscope requires you to have a storage account associated with the Diagnostic settings of your AKS cluster.
 
-If you have only one storage account associated with the Diagnostic settings of your AKS cluster, the collected logs will be stored in the associated storage account by default. 
+If you have only one storage account associated with the Diagnostic settings of your AKS cluster, the collected logs will be stored in the associated storage account by default.
 
-If you have more than one storage account associated with the Diagnostics settings of your AKS cluster, then the extension will prompt you to choose the storage account for saving collected logs. 
+If you have more than one storage account associated with the Diagnostics settings of your AKS cluster, then the extension will prompt you to choose the storage account for saving collected logs.
 
 If you don't have a storage account configured in the Diagnostic settings, you can follow these instructions to enable it:
 
diff --git a/docs/azure/deployment.md b/docs/azure/deployment.md
@@ -1,5 +1,5 @@
 ---
-Order: 3
+Order: 4
 Area: azure
 TOCTitle: Deployment
 PageTitle: Visual Studio Code Azure Tutorials
diff --git a/docs/azure/docker.md b/docs/azure/docker.md
@@ -1,5 +1,5 @@
 ---
-Order: 4
+Order: 5
 Area: azure
 TOCTitle: Docker
 ContentId: 42F8B9F8-BD03-4159-9479-17C5BDE30531
diff --git a/docs/azure/images/extensions/accountsAndTenants.png b/docs/azure/images/extensions/accountsAndTenants.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d409ec9d38a9c31c630f9da02aa2760a0cfbf7726c7dcadbe64a1a415e0fb16d
+size 48997
diff --git a/docs/azure/images/extensions/authenticateTenant.png b/docs/azure/images/extensions/authenticateTenant.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d54aa2bd843ae0736a6230ae0af04daf5ff819bac7f19c37718b99d348f6cc26
+size 92416
diff --git a/docs/azure/images/extensions/cloudOptions.png b/docs/azure/images/extensions/cloudOptions.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d838093ad6127658a939ceeb99848963355f8b42413d64747ea4f45a5eee54d8
+size 8792
diff --git a/docs/azure/images/extensions/filterSub.png b/docs/azure/images/extensions/filterSub.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:66da3cb0a61b7338ff77f62ff628214334e0633d9a8d317af9ecae53bd5df0f7
+size 48245
diff --git a/docs/azure/images/extensions/multiAccount.png b/docs/azure/images/extensions/multiAccount.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5ba024f8e43dd343d1e174e600d713404db5d0fec170c7e6d7bb152bbdd7013e
+size 103239
diff --git a/docs/azure/images/extensions/signInCommandPallete.png b/docs/azure/images/extensions/signInCommandPallete.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cc8ed31a9c89c70a1be3fdfb2604c609e3ce75b5f5b0f78a0bf21270c81f5027
+size 52382
diff --git a/docs/azure/images/extensions/signInView.png b/docs/azure/images/extensions/signInView.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a4e934110dec13e229cf721d726afcdc155310b08ed9c1918c8700c498fc903c
+size 61533
diff --git a/docs/azure/images/extensions/signOut.png b/docs/azure/images/extensions/signOut.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bb29f736dc475055f60c8a0046663ea21887c13ad3d76c266a3ad305b730f8e6
+size 21109
diff --git a/docs/azure/kubernetes.md b/docs/azure/kubernetes.md
@@ -1,5 +1,5 @@
 ---
-Order: 6
+Order: 7
 Area: azure
 TOCTitle: Kubernetes
 ContentId: d0ece2e4-8dd2-4c0d-a773-604542651c9e
diff --git a/docs/azure/mongodb.md b/docs/azure/mongodb.md
@@ -1,5 +1,5 @@
 ---
-Order: 7
+Order: 8
 Area: azure
 TOCTitle: MongoDB
 PageTitle: Working with MongoDB in Visual Studio Code
diff --git a/docs/azure/remote-debugging.md b/docs/azure/remote-debugging.md
@@ -1,5 +1,5 @@
 ---
-Order: 8
+Order: 9
 Area: azure
 TOCTitle: Remote Debugging for Node.js
 PageTitle: Azure Remote Debugging for Node.js with Visual Studio Code
diff --git a/docs/azure/resourcesextension.md b/docs/azure/resourcesextension.md
@@ -0,0 +1,75 @@
+---
+Order: 3
+Area: azure
+TOCTitle: Resource View
+PageTitle: Azure Resources for Visual Studio Code
+ContentId: fc1e60f9-86a6-47c2-beb6-5289d21f48d1
+MetaDescription: Azure Resouces for Visual Studio Code
+DateApproved: 5/5/2025
+---
+# Azure Resources for Visual Studio Code
+
+The [Azure Resources](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureresourcegroups) Extension allows you to seamlessly view and manage your Azure resources directly within VS Code. It also provides the ability to authenticate and manage your Azure accounts and tenants.
+
+## How to sign in to your Azure account
+
+The Azure Resources extension uses the built-in VS Code Microsoft authentication provider to authenticate with Azure.
+Sign in by selecting the **Sign in to Azure…** item in the Azure Resources view.
+
+![Screenshot that shows where to sign in to your Azure account](images/extensions/signInView.png)
+
+You can also sign in using the **Azure: Sign in** command contributed by the Azure Resources extension.
+
+![Screenshot that shows where to sign in to an Azure account from the command palette](images/extensions/signInCommandPallete.png)
+
+## How to sign out
+
+Sign out in the Accounts menu, located in the bottom left of your VS Code window.
+
+![Screenshot that shows where to sign out of an Azure account](images/extensions/signOut.png)
+
+## Filter subscriptions
+
+You can filter the displayed subscriptions, by selecting the filter icon on any subscription.
+
+![Screenshot that shows where to filter your subscriptions](images/extensions/filterSub.png)
+
+The filtered subscriptions are stored in the `setting(azureResourceGroups.selectedSubscriptions)` setting.
+
+## Accounts & Tenants view
+
+Within the Azure Resources extension you can use the Accounts & Tenants view to manage and authenticate accounts and tenants.
+
+![Screenshot that shows the Accounts & Tenants view](images/extensions/accountsAndTenants.png)
+
+### Filter out tenants
+
+You can also filter out tenants by checking and unchecking tenants. This causes subscriptions within the Resources view and subscription filter to be filtered out, based on which tenants are checked/unchecked within the tenant’s view.
+
+<img width = "900" alt = "Accounts & Tenants view" src = "https://github.com/user-attachments/assets/d34c1f79-fb21-46f9-af3a-cbb109ba0414">
+
+### Authenticate tenants
+
+In the Accounts & Tenants view, you can view all tenants associated with your accounts. Many tenants require multi-factor authentication (MFA) in order to access them. Tenants that require multi-factor authentication will have a sign-in button located to the right of the tenant when hovering over the tenant.
+
+![Screenshot that shows where to authenticate your tenants](images/extensions/authenticateTenant.png)
+
+You can authenticate specific tenants by navigating to the Accounts & Tenants view and either selecting the sign-in button located to the right of the tenant, or by simply checking an unauthenticated tenant.
+
+### Multi-account support
+
+With the Accounts & Tenants view, you can sign into a new account by selecting the `+` icon in the right corner of the view.
+
+![Screenshot that shows where to sign in to multiple Azure Accounts](images/extensions/multiAccount.png)
+
+### Using sovereign clouds
+
+To connect to a sovereign cloud, you can select the gear icon on the right side of the Accounts & Tenants view.
+
+<img width = "400" alt = "Sovereign Clouds" src = "https://github.com/user-attachments/assets/d07af7a8-eab9-46db-8ab5-f386c5c78b57">
+
+This brings up a list of sovereign clouds to choose from.
+
+![Screenshot that shows where to connect to a sovereign cloud](images/extensions/cloudOptions.png)
+
+Once chosen, the `setting(Microsoft-sovereign-cloud.environment)` setting is automatically set. The Resources and Accounts & Tenants view also refreshes, allowing you to sign into your sovereign cloud account.
diff --git a/docs/toc.json b/docs/toc.json
@@ -360,6 +360,7 @@
     "topics": [
       ["Overview", "/docs/azure/overview"],
       ["Getting Started", "/docs/azure/gettingstarted"],
+      ["Resources view", "/docs/azure/resourcesextension"],
       ["Deployment", "/docs/azure/deployment"],
       ["Docker", "/docs/azure/docker"],
       ["Azure Kubernetes Service", "/docs/azure/aksextensions"],
