Использование версий профилей API с комплектом SDK для разработки Node.js в Azure Stack Hub

профили версий Node.js и API

Пакет SDK Node.js можно использовать для создания инфраструктуры для приложений и управления ею. Профили API в пакете SDK Node.js помогают с гибридными облачными решениями, позволяя переключаться между глобальными ресурсами Azure и ресурсами Azure Stack Hub. Вы можете написать код один раз и нацеливать его на глобальную платформу Azure и Azure Stack Hub.

В этой статье вы можете использовать Visual Studio Code в качестве средства разработки. Visual Studio Code может отлаживать пакет SDK Node.js и позволяет запускать приложение и отправлять приложение в экземпляр Azure Stack Hub. Вы можете выполнить отладку из Visual Studio Code или через окно терминала, выполнив команду node <nodefile.js>.

Пакет SDK Node.js

Пакет SDK Node.js предоставляет средства Azure Stack Hub Resource Manager. Поставщики ресурсов в пакете SDK включают вычислительные ресурсы, сети, хранилище, службы приложений и KeyVault. В приложении node.js можно установить 10 клиентских библиотек поставщика ресурсов. Вы также можете указать, какой поставщик ресурсов будет использоваться для профиля 2020-09-01, чтобы оптимизировать память для вашего приложения. Каждый модуль состоит из поставщика ресурсов, соответствующей версии API и профиля API.

Профиль API — это сочетание поставщиков ресурсов и версий API. Профиль API можно использовать для получения последней, самой стабильной версии каждого типа ресурса в пакете поставщика ресурсов.

Чтобы использовать последние версии всех служб, используйте последний профиль пакетов.
Чтобы использовать службы, совместимые с Azure Stack Hub, используйте @azure/arm-resources-profile-hybrid-2020-09-01 или @azure/arm-storage-profile-2020-09-01-hybrid

Пакеты NPM

У каждого поставщика ресурсов есть собственный пакет. Пакет можно получить из реестра npm.

Вы можете найти следующие пакеты:

Поставщик ресурсов	Пакет
Служба приложений	@azure/arm-resources-profile-2020-09-01-hybrid
Подписки Azure Resource Manager	@azure/arm-subscriptions-profile-hybrid-2020-09-01
Политика Azure Resource Manager	@azure/arm-policy-profile-hybrid-2020-09-01
Azure Resource Manager DNS	@azure/arm-dns-profile-2020-09-01-hybrid
Авторизация	@azure/arm-authorization-profile-2020-09-01-hybrid
Вычисление	@azure/arm-compute-profile-2020-09-01-hybrid
Хранение	@azure/arm-storage-profile-2020-09-01-hybrid
Сеть	@azure/arm-network-profile-2020-09-01-hybrid
Ресурсы	@azure/arm-resources-profile-hybrid-2020-09-01
Key Vault	@azure/arm-keyvault-profile-2020-09-01-hybrid

Чтобы использовать последнюю версию API службы, используйте последний профиль конкретной клиентской библиотеки. Например, если вы хотите использовать только последнюю версию API службы управления ресурсами, воспользуйтесь azure-arm-resource профилем пакета клиентской библиотеки управления ресурсами.

Используйте определенные версии API, определенные внутри пакета для определенных версий API поставщика ресурсов.

@azure/arm-resourceprovider-profile-2020-09-01-hybrid

Последний профиль, созданный для Azure Stack Hub. Используйте этот профиль, чтобы службы были наиболее совместимыми с Azure Stack Hub, начиная с версии 1808 или более поздней.
@azure-arm-resource

Профиль состоит из последних версий всех служб. Используйте последние версии всех служб в Azure.

Профили

Для профилей, содержащих даты, для использования другого профиля пакета SDK или версии можно заменить дату в @azure/arm-keyvault-profile-<date>-hybrid. Например, для версии 2008 профиль имеет 2019-03-01значение, а строка становится @azure/arm-keyvault-profile-2019-03-01-hybrid. Обратите внимание, что иногда команда SDK изменяет имя пакетов, поэтому просто замена даты строки другой датой может не работать. См. следующую таблицу для сопоставления профилей и версий Azure Stack.

Версия Azure Stack	Профиль
2311	2020_09_01
2301	2020_09_01
2206	2020_09_01
2108	2020-09-01
2102	2020-09-01
2008	2019-03-01

Дополнительные сведения о профилях Azure Stack Hub и API см. в сводке профилей API.

Установка пакета SDK для Node.js

Установите Git. Инструкции см. в статье "Начало работы— установка Git".
Установите или обновите текущую версию Node.js. Node.js также включает диспетчер пакетов JavaScript npm .
Установите или обновите Visual Studio Code и установите расширениеNode.js для Visual Studio Code.
Установите клиентские пакеты для azure Stack Hub Resource Manger. Дополнительные сведения см. в статье об установке клиентских библиотек.
Пакеты, которые необходимо установить, зависят от используемой версии профиля. Список поставщиков ресурсов можно найти в разделе "Пакеты" в разделе npm .

Если у вас еще нет подписки, создайте подписку и сохраните идентификатор подписки, который будет использоваться позже. Сведения о создании подписки см. в этом документе.

Принципал службы

Учётная запись службы и связанные с ней сведения о среде должны быть созданы и сохранены в определённом месте. Рекомендуется использовать субъект-службу с ролью owner, но в зависимости от примера может быть достаточно роли contributor. Смотрите README в образцовом репозитории для определения необходимых значений. Эти значения можно прочитать в любом формате, поддерживаемом языком SDK, например из JSON-файла (которые используются в наших примерах). В зависимости от выполняемого примера могут использоваться не все эти значения. См. пример репозитория для обновленного примера кода или дополнительных сведений.

Идентификатор арендатора

Чтобы найти каталог или идентификатор клиента для Azure Stack Hub, следуйте инструкциям в этой статье.

Регистрация поставщиков ресурсов

Зарегистрируйте необходимых поставщиков ресурсов, следуя этому документу. Эти поставщики ресурсов потребуются в зависимости от примеров, которые требуется запустить. Например, если вы хотите запустить виртуальную машину, требуется регистрация поставщика ресурсов Microsoft.Compute.

Конечная точка диспетчера ресурсов Azure Stack

Azure Resource Manager (ARM) — это платформа управления, которая позволяет администраторам развертывать, управлять и отслеживать ресурсы Azure. Azure Resource Manager может обрабатывать эти задачи как группу, а не отдельно в одной операции. Сведения о метаданных можно получить из узла Resource Manager. Конечная точка возвращает JSON-файл с информацией, необходимой для выполнения кода.

Рассмотрим следующее:

ResourceManagerEndpointUrl в пакете средств разработки Azure Stack (ASDK): https://management.local.azurestack.external/
ResourceManagerEndpointUrl в интегрированных системах: https://management.region.<fqdn>/, где <fqdn> — это ваше полностью квалифицированное доменное имя.
Чтобы получить необходимые метаданные, выполните следующие действия. <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

Пример JSON:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Образцы

Просмотрите образец репозитория, чтобы получить доступ к самому актуальному примерному коду. Корневой каталог README.md описывает общие требования, а каждый вложенный каталог содержит конкретный пример с собственным README.md способом запуска этого примера.

Ознакомьтесь здесь с примером, применимым к версии Azure Stack 2008 или профилю 2019-03-01, и ниже.

Дальнейшие шаги

Дополнительные сведения о профилях API:

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-02-25