Conectar-se ao Azure Stack Hub usando a Extensão de Conta do Azure no Visual Studio Code

Este artigo descreve como se conectar ao Azure Stack Hub usando a extensão de Conta do Azure, que permite que você use o Azure diretamente do Visual Studio Code. Você precisará atualizar suas configurações do Visual Studio Code (VS Code).

O VS Code é um editor leve para criar e depurar aplicações web e na nuvem. ASP.NET Core, Python, NodeJS, Go e outros desenvolvedores usam o VS Code. Com a extensão da Conta do Azure, você pode usar um único logon do Azure com filtragem de assinatura para outras extensões do Azure. A extensão disponibiliza o Azure Cloud Shell no terminal integrado ao VS Code. Usando a extensão, pode conectar-se à sua subscrição do Azure Stack Hub usando tanto o Microsoft Entra ID como os Active Directory Federated Services (AD FS) para o seu gestor de identidades. Você pode entrar no Azure Stack Hub, selecionar sua assinatura e abrir uma nova linha de comando em um Cloud Shell.

Visual Studio Code e Azure Stack Hub

Além da extensão da Conta do Azure para Visual Studio, várias outras extensões do Azure têm suporte para uso com o Azure Stack Hub e o Visual Studio Code. Estes são, entre outros:

• Extensão de 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 Azure do Visual Studio Code

Pré-requisitos para a Extensão de Conta do Azure

• Um ambiente do Azure Stack Hub.
• Código do Visual Studio.
• Extensão de Conta do Azure.
• Uma assinatura e credenciais do Azure Stack Hub com acesso ao Azure Stack Hub.
• Um ambiente com o PowerShell usando os módulos AZ para o Azure Stack Hub. Para obter instruções, consulte Instalar o módulo Az do PowerShell para o Azure Stack Hub.

Obtenha as suas credenciais

Nesta seção, você usará suas credenciais para obter sua ID de locatário. Você precisará da URL e do ID de inquilino do gestor de recursos do Azure Stack Hub.

O Azure Stack Hub Resource Manager é uma estrutura de gerenciamento que permite implantar, gerenciar e monitorar recursos do Azure.

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

1. Abra o PowerShell com um prompt elevado 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 locatário. Você precisará dele ao adicionar a seçã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, digite Azure Account.

4. Selecione Conta do Azure e selecione Instalar.

   

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

6. Pressione Ctrl+Shift+P e selecione Preferências: Abrir configurações do usuário (JSON).

7. No editor de códigos, atualize o seguinte trecho JSON com os valores para seu ambiente e cole o trecho no bloco de configurações.

   • Values:

     Parâmetro	Description
     azure.cloud	Você deve usar a constante literal "AzureCustomCloud" para esse parâmetro.
     azure.tenant	O valor da sua ID de locatário do Azure Stack Hub.
     azure.customCloud.resourceManagerEndpointUrl	Esta é a URL raiz do Azure Resource Manager para Azure Stack Hub.
     validateAuthority	Você pode excluir esse parâmetro se estiver usando o Microsoft Entra ID como seu gerenciador de identidades. Adicione o parâmetro com um valor de false se você estiver usando o AD FS.

   • Trecho JSON:

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

8. Salve as configurações do usuário (JSON) e use Ctrl+Shift+P mais uma vez. Selecione Azure: Entrar. A página de autenticação é carregada no navegador. Inicie sessão no seu endpoint.

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.

Commands

Próximos passos

Configurar um ambiente de desenvolvimento no Azure Stack Hub

Configurar o Armazenamento do Azure no seu Azure Stack Hub no Visual Studio Code