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

Este artigo descreve como se ligar ao Azure Stack Hub usando a extensão Azure Account, que permite usar o Azure diretamente a partir do VS Code. Precisas de atualizar as definições do teu VS Code.

O VS Code é um editor leve para construir e depurar aplicações web e cloud. ASP.NET Core, Python, Node.js, Go e outros programadores usam o VS Code. Ao usar a extensão Azure Account, pode usar um único login no Azure com filtragem de subscrição para outras extensões do Azure. A extensão disponibiliza o Azure Cloud Shell no terminal integrado ao VS Code. Ao usar a extensão, pode ligar-se à sua subscrição do Azure Stack Hub utilizando tanto o Microsoft Entra ID como o Serviços de Federação do Active Directory (AD FS) (AD FS) para o seu Gestor de Identidade. 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 de Serviços Federados do Ative Directory (AD FS). Utilize as suas credenciais e endpoints do AD FS.

Visual Studio Code e Azure Stack Hub

Para além da extensão Azure Account para Visual Studio, são suportadas várias outras extensões do Azure para uso com o Azure Stack Hub e o VS Code. Essas extensões incluem:

Pré-requisitos para Azure Account Extension

Obtenha as suas credenciais

Nesta secção, use as suas credenciais para obter o seu ID de inquilino. Precisas do teu URL Azure Stack Hub Azure Resource Manager e do ID do inquilino.

O Azure Stack Hub Resource Manager é uma estrutura de gestão que pode usar para implementar, gerir e monitorizar Azure recursos.

  • 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. Precisas disso ao adicionar a secção JSON que configura a extensão da conta 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.

    Captura de ecrã do ecrã 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ó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 Use a constante literal "AzureCustomCloud" para este parâmetro.
      azure.tenant O valor da sua ID de locatário do Azure Stack Hub.
      azure.customCloud.resourceManagerEndpointUrl Esta é a URL raiz do Resource Manager para Azure Stack Hub.
      validateAuthority Podes omitir este parâmetro se estiveres a usar o Microsoft Entra ID como gestor de identidade. Adiciona o parâmetro com um valor de false se estiveres a usar AD FS.

    • Trecho JSON:

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

  8. Guarda as definições do utilizador (JSON) e usa 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 conseguiu iniciar sessão na sua subscrição do Azure Stack Hub, use Ctrl+Shift+P e selecione Azure: Selecione Subscrição e veja se a subscrição que tem está disponível.

Commands

Azure: Entrar Inicie sessão na sua subscrição do Azure
Azure: Entrar com código de dispositivo Inicie sessão na sua subscrição do Azure usando um código de dispositivo. Use um código de dispositivo em configurações onde o comando Entrar não funciona.
Azure: Entrar na Nuvem do Azure Entre em sua assinatura do Azure em uma das nuvens soberanas.
Azure: Terminar sessão Saia da sua assinatura do Azure.
Azure: Selecione Assinaturas Escolha o conjunto de subscrições com o qual pretende trabalhar. A extensão mostra apenas recursos dentro das assinaturas filtradas.
Azure: Criar uma conta Se não tiver uma conta Azure, pode inscrever-se numa hoje.
Azure: Open Bash no Cloud Shell Abra um novo terminal executando o Bash no Cloud Shell.
Azure: Abra o PowerShell no Cloud Shell Abra um novo terminal executando o PowerShell no Cloud Shell.
Azure: Carregar no Cloud Shell Carregue um arquivo para sua conta de armazenamento do Cloud Shell.

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

  • Última atualização a