Ligar ao Azure Stack Hub com a Extensão de Conta do Azure no Visual Studio Code

Este artigo descreve como ligar ao Azure Stack Hub com a extensão conta do Azure, que lhe permite utilizar o Azure diretamente a partir do Visual Studio Code. Terá de atualizar as definições do Visual Studio Code (VS Code).

O VS Code é um editor simples para criar e depurar aplicações Web e na cloud. ASP.NET Core, Python, NodeJS, Go e outros programadores utilizam o VS Code. Com a extensão conta do Azure, pode utilizar um único início de sessão do Azure com filtragem de subscrição para outras extensões do Azure. A extensão disponibiliza o Cloud Shell do Azure no terminal integrado do VS Code. Com a extensão, pode ligar-se à sua subscrição do Azure Stack Hub com o Microsoft Entra ID e os Serviços Federados do Active Directory (AD FS) para o seu gestor de identidades. Pode iniciar sessão no Azure Stack Hub, selecionar a sua subscrição e abrir uma nova linha de comandos num Cloud Shell.

Visual Studio Code e Azure Stack Hub

Além da extensão da Conta do Azure para Visual Studio, são suportadas várias outras extensões do Azure para utilização com o Azure Stack Hub e o Visual Studio Code. Incluem-se:

• Extensão do Armazenamento do Azure do Visual Studio Code
• Extensão de Recursos do Azure do Visual Studio Code (requer a versão 0.4.0 ou anterior)
• Extensão de Máquinas Virtuais do Visual Studio Code

Pré-requisitos da Extensão da Conta do Azure

• Um ambiente do Azure Stack Hub.
• Visual Studio Code.
• Extensão da Conta do Azure.
• Uma subscrição e credenciais do Azure Stack Hub com acesso ao Azure Stack Hub.
• Um ambiente com o PowerShell a utilizar os módulos AZ para o Azure Stack Hub. Para obter instruções, veja Instalar o módulo do PowerShell Az para o Azure Stack Hub.

Obter as suas credenciais

Nesta secção, irá utilizar as suas credenciais para obter o seu ID de inquilino. Precisará do URL do gestor de recursos e do ID do inquilino do Azure Stack Hub.

A Resource Manager do Azure Stack Hub é uma arquitetura de gestão que lhe permite implementar, gerir e monitorizar recursos do Azure.

• O URL de Resource Manager do Azure Stack Development Kit (ASDK) é:https://management.local.azurestack.external/
• O URL de Resource Manager para um sistema integrado é: https://management.region.<fqdn>/, onde <fqdn> é o seu nome de domínio completamente qualificado.

1. Abra o PowerShell com uma linha de comandos elevada e execute os seguintes cmdlets:

   Add-AzEnvironment -Name "<username@contoso.com>" -ArmEndpoint "https://management.region.<fqdn>"
   

   Name  Resource Manager Url                            ActiveDirectory Authority
   ----  --------------------                            -------------------------
   username@contoso.com https://management.region.<fqdn> https://login.microsoftonline.com/
   

2. Execute os seguintes cmdlets na mesma sessão:

   $AuthEndpoint = (Get-AzEnvironment -Name "sethm@microsoft.com").ActiveDirectoryAuthority.TrimEnd('/')
   $AADTenantName = "masselfhost.onmicrosoft.com"
   $TenantId = (invoke-restmethod "$($AuthEndpoint)/$($AADTenantName)/.well-known/openid-configuration").issuer.TrimEnd('/').Split('/')[-1]
   Add-AzAccount -EnvironmentName "sethm@microsoft.com" -TenantId $TenantId
   

   Account               SubscriptionName  TenantId                             Environment
   -------               ----------------  --------                             -----------
   username@contoso.com   azure-stack-sub  aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb username@contoso.com
   

3. Anote o ID do inquilino. Irá precisar dele ao adicionar a secção JSON que configura a extensão da Conta do Azure.

Configurar a extensão da Conta do Azure

1. Abra o VS Code.

2. Selecione Extensões no canto esquerdo.

3. Na caixa de pesquisa, introduza Azure Account.

4. Selecione Conta do Azure e selecione Instalar.

   

5. Reinicie o VS Code para carregar a extensão.

6. Prima Ctrl+Shift+P e selecione Preferências: Abrir Definições do Utilizador (JSON).

7. No editor de código, atualize o fragmento JSON seguinte com os valores do seu ambiente e, em seguida, cole fragmentos no bloco de definições.

   • Valores:

     Parâmetro	Description
     azure.cloud	Tem de utilizar a constante literal "AzureCustomCloud" para este parâmetro.
     azure.tenant	O valor do ID de inquilino do Azure Stack Hub.
     azure.customCloud.resourceManagerEndpointUrl	Este é o URL de raiz do Azure Resource Manager para o Azure Stack Hub.
     validateAuthority	Pode deixar de fora este parâmetro se estiver a utilizar Microsoft Entra ID como gestor de identidades. Adicione o parâmetro com um valor de false se estiver a utilizar o AD FS.

   • Fragmento JSON:

       "azure.cloud": "AzureCustomCloud",
       "azure.customCloud.resourceManagerEndpointUrl": "https://management.region.<fqdn>",
       "azure.tenant": "<your-tenant-ID>",
     

8. Guarde as definições de utilizador (JSON) e utilize Ctrl+Shift+P mais uma vez. Selecione Azure: Iniciar sessão. A página de autenticação é carregada no browser. Inicie sessão no ponto final.

9. Para testar se iniciou sessão com êxito na sua subscrição do Azure Stack Hub, utilize Ctrl+Shift+ P e selecione Azure: Selecione Subscrição e veja se a subscrição que tem está disponível.

Comandos

Passos seguintes

Configurar um ambiente de desenvolvimento no Azure Stack Hub

Configurar o Armazenamento do Azure no Azure Stack Hub a partir do Visual Studio Code