Conectar-se ao Hub de Azure Stack usando a extensão de conta do Azure no Visual Studio CodeConnect to Azure Stack Hub using Azure Account Extension in Visual Studio Code

Neste artigo, vamos orientá-lo sobre como se conectar ao Hub de Azure Stack usando a extensão de conta do Azure.In this article, we will walk you through how to connect to Azure Stack Hub using the Azure Account extension. Você precisará atualizar suas configurações de Visual Studio Code (VS Code).You will need to update your Visual Studio Code (VS Code) settings.

VS Code é um editor leve para criar e depurar aplicativos Web e na nuvem.VS Code is a light-weight editor for building and debug web and cloud applications. ASP.NET Core, Python, NodeJS, Go e outros desenvolvedores usam VS Code.ASP.NET Core, Python, NodeJS, Go, and other developers use VS Code. Com a extensão de conta do Azure, você pode usar uma única entrada do Azure com a filtragem de assinatura para extensões adicionais do Azure.With the Azure Account extension, you can use a single Azure sign-in with subscription filtering for additional Azure extensions. A extensão torna o Azure Cloud Shell disponível no terminal integrado ao VS Code.The extension makes the Azure Cloud Shell available in the VS Code-integrated terminal. Usando a extensão, você pode se conectar à sua assinatura do hub de Azure Stack usando o AD do Azure (Azure AD) e Active Directory serviços federados (AD FS) para seu Gerenciador de identidade.Using the extension, you can connect to your Azure Stack Hub subscription using both Azure AD (Azure AD) and Active Directory Federated Services (AD FS) for your identity manager. Você pode entrar no Hub Azure Stack, selecionar sua assinatura e abrir uma nova linha de comando em um Cloud Shell.You can sign in to Azure Stack Hub, select your subscription, and open a new command line in a cloud shell.

Observação

Você pode usar as etapas neste artigo para um ambiente de AD FS (Serviços Federados) Active Directory.You can use the steps in this article for an Active Directory Federated Services (AD FS) environment. Use suas credenciais de AD FS e pontos de extremidade.Use your AD FS credentials and endpoints.

Pré-requisitos para a extensão de conta do AzurePre-requisites for the Azure Account Extension

  1. Ambiente de Hub de Azure Stack 1904 Build ou posteriorAzure Stack Hub environment 1904 build or later
  2. Visual Studio CodeVisual Studio Code
  3. Extensão de conta do AzureAzure Account Extension
  4. Uma assinatura de Hub de Azure StackAn Azure Stack Hub subscription

Etapas para se conectar ao Hub de Azure StackSteps to connect to Azure Stack Hub

  1. Execute o script de identidade de ferramentas de Hub de Azure Stack no github.Run the Identity script from Azure Stack Hub Tools in GitHub.

    Update-AzsHomeDirectoryTenant -AdminResourceManagerEndpoint $adminResourceManagerEndpoint `
    -DirectoryTenantName $homeDirectoryTenantName -Verbose
    Register-AzsWithMyDirectoryTenant -TenantResourceManagerEndpoint $tenantARMEndpoint `
    -DirectoryTenantName $guestDirectoryTenantName
    
  2. Abra o VS Code.Open VS Code.

  3. Selecione extensões no canto esquerdo.Select Extensions on the left-side corner.

  4. Na caixa de pesquisa, insira Azure Account.In the search box, enter Azure Account.

  5. Selecione conta do Azure e selecione instalar.Select Azure Account and select Install.

    Visual Studio Code do Azure Stack Hub

  6. Reinicie VS Code para carregar a extensão.Restart VS Code to load the extension.

  7. Recupere os metadados para se conectar ao Azure Resource Manager no Hub de Azure Stack.Retrieve the metadata to connect to the Azure Resource Manager in your Azure Stack Hub.

    O Microsoft Azure Resource Manager é uma estrutura de gerenciamento que permite implantar, gerenciar e monitorar recursos do Azure.The Microsoft Azure Resource Manager is a management framework that allows you to deploy, manage, and monitor Azure resources.

    • A URL do Gerenciador de recursos para o Kit de Desenvolvimento do Azure Stack (ASDK) é: https://management.local.azurestack.external/The Resource Manager URL for the Azure Stack Development Kit (ASDK) is: https://management.local.azurestack.external/
    • A URL do Gerenciador de recursos para um sistema integrado é: https://management.region.<fqdn>/ , onde <fqdn> é seu nome de domínio totalmente qualificado.The Resource Manager URL for an integrated system is: https://management.region.<fqdn>/, where <fqdn> is your fully qualified domain name.
    • Adicione o seguinte texto à sua URL para acessar os metadados: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0Add the following text to your URL to access the metadata: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

    Por exemplo, a URL para recuperar os metadados para seu ponto de extremidade de Azure Resource Manager pode ser semelhante a: https://management.local.azurestack.external/metadata/endpoints?api-version=1.0For example, the URL to retrieve the metadata for your Azure Resource Manager endpoint may look something like: https://management.local.azurestack.external/metadata/endpoints?api-version=1.0

    Anote o JSON de retorno.Make a note of the return JSON. Você precisará dos valores para a loginEndpoint audiences propriedade e.You will need the values for the loginEndpoint and audiences property.

  8. Pressione Ctrl + Shift + P e selecione preferências: abrir configurações de usuário (JSON).Press Ctrl+Shift+P, and select Preferences: Open User Settings (JSON).

  9. No editor de código, atualize o seguinte trecho JSON com os valores para seu ambiente e cole o trecho no bloco Settings.In the code editor, update the following JSON snippet with the values for your environment, and then paste snippet into the settings block.

    • Valores:Values:

      ParâmetroParameter DescriçãoDescription
      tenant-ID O valor de sua ID de locatáriodo Hub de Azure Stack.The value of your Azure Stack Hub tenant ID.
      activeDirectoryEndpointUrl Essa é a URL da propriedade loginEndpoint.This is the URL from loginEndpoint property.
      activeDirectoryResourceId Esta é a URL da propriedade audiências.This is the URL from the audiences property.
      resourceManagerEndpointUrl Esta é a URL raiz para o Azure Resource Manager para Azure Stack Hub.This is the root URL for the Azure Resource Manager for Azure Stack Hub.
      validateAuthority Você pode sair desse parâmetro se estiver usando o Azure AD como seu Gerenciador de identidade.You can leave out this parameter if you are using Azure AD as your identity manager. Adicione o parâmetro com um valor de false se você estiver usando AD FS.Add the parameter with a value of false if you are using AD FS.
    • Trecho de JSON:JSON snippet:

      "azure.tenant": "tenant-ID",
      "azure.ppe": {
          "activeDirectoryEndpointUrl": "Login endpoint",
          "activeDirectoryResourceId": "This is the URL from the audiences property.",
          "resourceManagerEndpointUrl": "Aure Resource Management Endpoint",
          "validateAuthority" : false, 
      },
      "azure.cloud": "AzurePPE"
      
  10. Salve as configurações do usuário e use Ctrl + Shift + P novamente.Save the User Settings and use Ctrl+Shift+P once again. Selecione Azure: entrar na nuvem do Azure.Select Azure: Sign in to Azure Cloud. A nova opção, AzurePPE , aparece na lista de destinos.The new option, AzurePPE , appears in the list of targets.

  11. Selecione AzurePPE.Select AzurePPE. A página de autenticação é carregada no navegador.The authentication page loads in your browser. Entre no ponto de extremidade.Sign in to your endpoint.

  12. Para testar se você fez logon com êxito em sua assinatura do hub de Azure Stack, use Ctrl + Shift + P e selecione Azure: selecione assinatura e veja se a assinatura que você tem está disponível.To test that you have successfully logged into your Azure Stack Hub subscription, use Ctrl+Shift+ P and select Azure: Select Subscription and see if the subscription you have is available.

ComandosCommands

Azure: entrarAzure: Sign In Entre em sua assinatura do AzureSign in to your Azure subscription
Azure: entrar com código de dispositivoAzure: Sign In with Device Code Entre em sua assinatura do Azure com um código de dispositivo.Sign in to your Azure subscription with a device code. Use um código de dispositivo em configurações em que o comando de entrada não funciona.Use a device code in setups where the Sign In command doesn't work.
Azure: entrar na nuvem do AzureAzure: Sign In to Azure Cloud Entre em sua assinatura do Azure em uma das nuvens soberanas.Sign in to your Azure subscription in one of the sovereign clouds.
Azure: sairAzure: Sign Out Saia da sua assinatura do Azure.Sign out of your Azure subscription.
Azure: selecionar assinaturasAzure: Select Subscriptions Escolha o conjunto de assinaturas com o qual você deseja trabalhar.Pick the set of subscriptions you want to work with. A extensão mostra apenas os recursos dentro das assinaturas filtradas.The extension only shows resources within the filtered subscriptions.
Azure: criar uma contaAzure: Create an Account Se você não tiver uma conta do Azure, você pode se inscrever para uma hoje e receber $ 200 em créditos gratuitos.If you don't have an Azure Account, you can sign up for one today and receive $200 in free credits.
Azure: abrir bash no Cloud ShellAzure: Open Bash in Cloud Shell Abra um novo terminal executando o bash no Cloud Shell.Open a new terminal running Bash in Cloud Shell.
Azure: abrir o PowerShell no Cloud ShellAzure: Open PowerShell in Cloud Shell Abra um novo terminal executando o PowerShell no Cloud Shell.Open a new terminal running PowerShell in Cloud Shell.
Azure: carregar para Cloud ShellAzure: Upload to Cloud Shell Carregue um arquivo em sua conta de armazenamento de Cloud Shell.Upload a file to your Cloud Shell storage account.

Próximas etapasNext steps

Configurar um ambiente de desenvolvimento no Hub de Azure Stack Set up a development environment in Azure Stack Hub