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

Este artigo descreve como se conectar a Azure Stack Hub usando a extensão Azure Conta, que permite que você use Azure diretamente do VS Code. Você precisa atualizar as configurações do VS Code.

O VS Code é um editor leve para criar e depurar aplicativos Web e na nuvem. ASP.NET Core, Python, Node.js, Go e outros desenvolvedores usam o VS Code. Usando a extensão Azure Conta, você pode usar uma única Azure entrada com filtragem de assinatura para outras extensões de Azure. A extensão disponibiliza o Azure Cloud Shell no terminal integrado ao VS Code. Usando a extensão, você pode se conectar à sua assinatura Azure Stack Hub usando Microsoft Entra ID e Serviços de Federação do Active Directory (AD FS) (AD FS) para seu Identity Manager. 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 conta Azure para Visual Studio, há suporte para várias outras extensões de Azure para uso com Azure Stack Hub e VS Code. Essas extensões incluem:

• 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 Azure extensão de conta

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

Obter suas credenciais

Nesta seção, use suas credenciais para obter sua ID de locatário. Você precisa da URL do Azure Stack Hub Azure Resource Manager e da ID do locatário.

O Azure Stack Hub Resource Manager é uma estrutura de gerenciamento que você pode usar para implantar, gerenciar e monitorar recursos Azure.

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

1. Abra o PowerShell com um prompt com privilégios elevados 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 a ID do locatário. Você precisa dela ao adicionar a seção JSON que configura a extensão Azure Conta.

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, insira Azure Account.

4. Selecione a 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ódigo, atualize o snippet JSON a seguir com os valores do seu ambiente e cole o snippet no bloco de configurações.

   • Valores:

     Parâmetro	Description
     azure.cloud	Use a constante literal "AzureCustomCloud" para esse parâmetro.
     azure.tenant	O valor do ID do tenant do Azure Stack Hub.
     azure.customCloud.resourceManagerEndpointUrl	Essa é a URL raiz do Resource Manager para Azure Stack Hub.
     validateAuthority	Você pode deixar de fora esse parâmetro se estiver usando 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. Faça login no endpoint.

9. Para testar se você fez logon com êxito em sua assinatura Azure Stack Hub, use Ctrl+Shift+P e selecione Azure: Selecione Assinatura e veja se a assinatura que você tem está disponível.

Commands

Próximas etapas

Configurar um ambiente de desenvolvimento no Azure Stack Hub

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