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

  • Artigo

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 suas configurações de Visual Studio Code (VS 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 do Azure com filtragem de assinatura para outras extensões do Azure. A extensão disponibiliza o Cloud Shell do Azure no terminal integrado ao VS Code. Usando a extensão, você pode se conectar à sua assinatura do Azure Stack Hub usando Microsoft Entra ID e a 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.

Observação

Você pode usar as etapas neste artigo para um ambiente do AD FS (Serviços Federados do Active Directory). Use suas credenciais e pontos de extremidade do AD FS.

Visual Studio Code e Azure Stack Hub

Além da extensão de Conta do Azure para Visual Studio, há suporte para várias outras extensões do Azure para uso com o Azure Stack Hub e Visual Studio Code. Estão incluídos:

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

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.

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

  • A URL Resource Manager para o ASDK (Azure Stack Development Kit) é:https://management.local.azurestack.external/
  • A URL de Resource Manager para um sistema integrado é: https://management.region.<fqdn>/, em que <fqdn> é o 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  6d5ff183-b37f-4a5b-9a2f-19959cb4224a 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 Conta do Azure e selecione Instalar.

    Captura de tela da tela de instalação da extensão

  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 ambiente e cole o snippet no bloco de configurações.

    • Valores:

      Parâmetro Descrição
      azure.cloud Você deve usar a constante literal "AzureCustomCloud" para esse parâmetro.
      azure.tenant O valor da ID do locatário do Azure Stack Hub.
      azure.customCloud.resourceManagerEndpointUrl Essa é a URL raiz do Resource Manager do Azure para o Azure Stack Hub.
      validateAuthority Você poderá 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.

    • Snippet 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. Entre no ponto de extremidade.

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

Comandos

Azure: Entrar Entre em sua assinatura do Azure
Azure: Entrar com o código do dispositivo Entre em sua assinatura do Azure com um código de dispositivo. Use um código de dispositivo em configurações em que o comando Entrar não funciona.
Azure: Entrar no Azure Cloud Entre em sua assinatura do Azure em uma das nuvens soberanas.
Azure: Sair Saia da assinatura do Azure.
Azure: Selecionar Assinaturas Escolha o conjunto de assinaturas com as quais você deseja trabalhar. A extensão mostra apenas os recursos dentro das assinaturas filtradas.
Azure: Criar uma conta Se você não tiver uma Conta do Azure, poderá se inscrever para uma hoje e receber US$ 200 em créditos gratuitos.
Azure: Abrir Bash no Cloud Shell Abra um novo terminal executando o Bash em Cloud Shell.
Azure: Abrir o PowerShell no Cloud Shell Abra um novo terminal executando o PowerShell em Cloud Shell.
Azure: Carregar no Cloud Shell Carregue um arquivo em sua conta de armazenamento Cloud Shell.

Próximas etapas

Configurar um ambiente de desenvolvimento no Azure Stack Hub

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