Подключение к Azure Stack Hub с помощью расширения учетной записи Azure в Visual Studio CodeConnect to Azure Stack Hub using Azure Account Extension in Visual Studio Code

В этой статье описано, как подключиться к Azure Stack Hub с помощью расширения учетной записи Azure.In this article, we will walk you through how to connect to Azure Stack Hub using the Azure Account extension. Вам нужно обновить параметры Visual Studio Code (VS Code).You will need to update your Visual Studio Code (VS Code) settings.

VS Code — это упрощенный редактор для создания и отладки облачных приложений и веб-приложений.VS Code is a light-weight editor for building and debug web and cloud applications. VS Code используют разработчики ASP.NET Core, Python, NodeJS, Go и др.ASP.NET Core, Python, NodeJS, Go, and other developers use VS Code. С помощью расширения учетной записи Azure можно использовать единый вход Azure с фильтрацией подписок для дополнительных расширений Azure.With the Azure Account extension, you can use a single Azure sign-in with subscription filtering for additional Azure extensions. Эти расширения позволяют использовать Azure Cloud Shell в интегрированном терминале VS Code.The extension makes the Azure Cloud Shell available in the VS Code-integrated terminal. Используя это расширение, вы можете подключить свою подписку Azure Stack Hub с помощью Azure AD (Azure AD) и служб федерации Active Directory (AD FS) для диспетчера удостоверений.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. Вы можете войти в Azure Stack Hub, выбрать свою подписку и открыть новую командную строку в Cloud Shell.You can sign in to Azure Stack Hub, select your subscription, and open a new command line in a cloud shell.

Примечание

Приведенные здесь инструкции можно использовать в среде служб федерации Active Directory (AD FS).You can use the steps in this article for an Active Directory Federated Services (AD FS) environment. Вам нужно использовать учетные данные AD FS и конечные точки.Use your AD FS credentials and endpoints.

Предварительные требования для расширения учетной записи AzurePre-requisites for the Azure Account Extension

  1. Среда Azure Stack Hub, начиная с версии 1904.Azure Stack Hub environment 1904 build or later
  2. Visual Studio CodeVisual Studio Code
  3. Расширение учетной записи AzureAzure Account Extension
  4. Подписка Azure Stack Hub.An Azure Stack Hub subscription

Подключение к Azure Stack HubSteps to connect to Azure Stack Hub

  1. Запустите скрипт Identity с помощью средств Azure Stack Hub в GitHub.Run the Identity script from Azure Stack Hub Tools in GitHub.

    • Прежде чем выполнить скрипт, нужно установить и настроить PowerShell для вашей среды.Before you run the script, you will need to have PowerShell installed and configured for your environment. Инструкции приведены в статье Установка PowerShell для Azure Stack Hub.For instructions see Install PowerShell for Azure Stack Hub.

    • Сам скрипт Identity и инструкции по нему см. в репозитории AzureStack-Tools/Identity.For the Identity script instructions and script, see AzureStack-Tools/Identity.

    • В том же сеансе выполните следующее:In the same session, run:

    Update-AzsHomeDirectoryTenant -AdminResourceManagerEndpoint $adminResourceManagerEndpoint `
    -DirectoryTenantName $homeDirectoryTenantName -Verbose
    Register-AzsWithMyDirectoryTenant -TenantResourceManagerEndpoint $tenantARMEndpoint `
    -DirectoryTenantName $guestDirectoryTenantName
    
  2. Откройте VS Code.Open VS Code.

  3. Выберите Расширения в области слева.Select Extensions on the left-side corner.

  4. В поле поиска введите Azure Account.In the search box, enter Azure Account.

  5. Выберите Учетная запись Azure и щелкните Установить.Select Azure Account and select Install.

    Использование Visual Studio Code в Azure Stack Hub

  6. Перезапустите VS Code, чтобы загрузить расширение.Restart VS Code to load the extension.

  7. Получите метаданные для подключения к Azure Resource Manager в Azure Stack Hub.Retrieve the metadata to connect to the Azure Resource Manager in your Azure Stack Hub.

    Microsoft Azure Resource Manager — это платформа управления, которая позволяет развертывать, администрировать и отслеживать ресурсы Azure.The Microsoft Azure Resource Manager is a management framework that allows you to deploy, manage, and monitor Azure resources.

    • URL-адрес Resource Manager для Пакета средств разработки 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/
    • URL-адрес Resource Manager для интегрированной системы: https://management.region.<fqdn>/, где <fqdn> — полное доменное имя.The Resource Manager URL for an integrated system is: https://management.region.<fqdn>/, where <fqdn> is your fully qualified domain name.
    • Добавьте к URL-адресу следующий текст для доступа к метаданным: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0.Add the following text to your URL to access the metadata: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

    Например, URL-адрес для получения метаданных для конечной точки Azure Resource Manager может выглядеть так: https://management.local.azurestack.external/metadata/endpoints?api-version=1.0.For 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

    Сохраните полученные данные JSON.Make a note of the return JSON. Эти значения потребуются для свойств loginEndpoint и audiences.You will need the values for the loginEndpoint and audiences property.

  8. Нажмите клавиши CTRL+SHIFT+P и выберите Предпочтения: открыть параметры пользователя (JSON) .Press Ctrl+Shift+P, and select Preferences: Open User Settings (JSON).

  9. В редакторе кода замените приведенный ниже фрагмент JSON значениями для своей среды и вставьте его в блок параметров.In the code editor, update the following JSON snippet with the values for your environment, and then paste snippet into the settings block.

    • Значения:Values:

      ПараметрParameter ОписаниеDescription
      tenant-ID Значение идентификатора клиента Azure Stack Hub.The value of your Azure Stack Hub tenant ID.
      activeDirectoryEndpointUrl Это URL-адрес из свойства loginEndpoint.This is the URL from loginEndpoint property.
      activeDirectoryResourceId Это URL-адрес из свойства audiences.This is the URL from the audiences property.
      resourceManagerEndpointUrl Это корневой URL-адрес Azure Resource Manager для Azure Stack Hub.This is the root URL for the Azure Resource Manager for Azure Stack Hub.
      validateAuthority Вы можете оставить этот параметр, если вы используете Azure AD в качестве диспетчера удостоверений.You can leave out this parameter if you are using Azure AD as your identity manager. Добавьте параметр со значением, false Если используется AD FS.Add the parameter with a value of false if you are using AD FS.
    • Во фрагменте кода 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. Сохраните параметры пользователя и еще раз нажмите клавиши CTRL+SHIFT+P.Save the User Settings and use Ctrl+Shift+P once again. Выберите Azure: Войдите в облако Azure.Select Azure: Sign in to Azure Cloud. Новый параметр AzurePPE отобразится в списке целевых объектов.The new option, AzurePPE, appears in the list of targets.

  11. Выберите AzurePPE.Select AzurePPE. В браузере загрузится страница аутентификации.The authentication page loads in your browser. Войдите в конечную точку.Sign in to your endpoint.

  12. Чтобы убедиться, что вы успешно выполнили вход в подписку на центр Azure Stack, используйте сочетание клавиш CTRL + SHIFT + P и выберите Azure: выберите подписку и проверьте, доступна ли подписка.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.

КомандыCommands

Azure: входAzure: Sign In Войдите в свою подписку Azure.Sign in to your Azure subscription
Azure: вход с помощью кода устройстваAzure: Sign In with Device Code Войдите в подписку Azure с помощью кода устройства.Sign in to your Azure subscription with a device code. Используйте его в ситуациях, когда команда "Войти" не работает.Use a device code in setups where the Sign In command doesn't work.
Azure: вход в облако AzureAzure: Sign In to Azure Cloud Войдите в подписку Azure в одном из национальных облаков.Sign in to your Azure subscription in one of the sovereign clouds.
Azure: выходAzure: Sign Out Выйдите из подписки Azure.Sign out of your Azure subscription.
Azure: выбор подписокAzure: Select Subscriptions Выберите подписки, с которыми вы будете работать.Pick the set of subscriptions you want to work with. Расширение отображает только ресурсы в отфильтрованных подписках.The extension only shows resources within the filtered subscriptions.
Azure: создание учетной записиAzure: Create an Account Если у вас нет учетной записи Azure, вы можете зарегистрировать ее$ и получить 200 долл. США в виде бесплатного кредита.If you don't have an Azure Account, you can sign up for one today and receive $200 in free credits.
Azure: Откройте Bash в Cloud ShellAzure: Open Bash in Cloud Shell Откройте новый терминал с Bash в Cloud Shell.Open a new terminal running Bash in Cloud Shell.
Azure: Откройте PowerShell в Cloud ShellAzure: Open PowerShell in Cloud Shell Откройте новый терминал с PowerShell в Cloud Shell.Open a new terminal running PowerShell in Cloud Shell.
Azure: Отправка в Cloud ShellAzure: Upload to Cloud Shell Загрузите файл в учетную запись хранения Cloud Shell.Upload a file to your Cloud Shell storage account.

Дальнейшие действияNext steps

Настройка среды разработки в Azure Stack HubSet up a development environment in Azure Stack Hub