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 conta do Azure, que permite que você use o Azure diretamente do Visual Studio Code. Você precisará atualizar as configurações do VS Code (Visual Studio Code).

O VS Code é um editor leve para criar e depurar aplicativos Web e de nuvem. ASP.NET Core, Python, NodeJS, Go e outros desenvolvedores usam o VS Code. Com a extensão Conta do Azure, você pode usar uma única entrada no Azure usando 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, você pode se conectar à sua assinatura do Azure Stack Hub usando a ID do Microsoft Entra e o AD FS (Active Directory Federated Services) para seu gerenciador 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, há suporte para várias outras extensões do Azure para uso com o Azure Stack Hub e o Visual Studio Code. Elas 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 a Extensão de Conta do Azure

• Um ambiente do Azure Stack Hub.
• Visual Studio Code.
• 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, você usará suas credenciais para obter sua ID de locatário. Você precisará da URL do gerenciador de recursos do Azure Stack Hub e da ID do locatário.

O Azure Stack Hub Resource Manager é uma estrutura de gerenciamento que permite implantar, gerenciar e monitorar recursos do 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ê precisará dela 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, 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	Você deve usar 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 Azure Resource Manager para o Azure Stack Hub.
     validateAuthority	Você pode deixar de fora esse parâmetro se estiver usando a ID do Microsoft Entra 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ê efetuou login com sucesso em sua assinatura do Azure Stack Hub, use Ctrl+Shift+ P e Azure: Selecionar 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