Поделиться через


Клиентская библиотека REST Azure DevCenter для JavaScript версии 1.0.1

Библиотека Azure DevCenter предоставляет доступ к управлению ресурсами для сред развертывания Microsoft Dev Box и Azure. Этот пакет позволяет управлять компьютерами и средами разработчиков в Azure.

Используйте пакет для Azure DevCenter, чтобы:

Создание, доступ, управление и удаление ресурсов Dev Box, создание, развертывание, управление и удаление ресурсов среды

Служба DevCenter

Для использования этой библиотеки используется документация клиента REST

Ключевые ссылки:

Начало работы

Поддерживаемые в настоящее время среды

  • Версии LTS Node.js

Необходимые условия

  • Для использования этого пакета необходимо подписку Azure.
  • Необходимо настроить DevCenter, Project, Network Connection, Dev Box Definition и Pool, прежде чем создавать поля разработки
  • Прежде чем создавать среды, необходимо настроить DevCenter, Project, Catalog и Environment Type

Установка пакета @azure-rest/developer-devcenter

Установите клиентскую клиентскую библиотеку REST клиента Azure DevCenter REST для JavaScript с npm:

npm install @azure-rest/developer-devcenter

Создание и проверка подлинности AzureDeveloperDevCenterClient

Чтобы использовать учетных данных маркера Azure Active Directory (AAD), укажите экземпляр требуемого типа учетных данных, полученного из библиотеки @azure/identity.

Чтобы выполнить проверку подлинности с помощью AAD, необходимо сначала npm установить @azure/identity

После установки можно выбрать тип учетных данных из @azure/identity использования. Например, DefaultAzureCredential можно использовать для проверки подлинности клиента.

Задайте значение конечной точки центра разработки в качестве переменной среды: DEVCENTER_ENDPOINT

import AzureDeveloperDevCenter from "@azure-rest/developer-devcenter";
import { DefaultAzureCredential } from "@azure/identity";

const endpoint = process.env["DEVCENTER_ENDPOINT"] || "<endpoint>";
const client = AzureDeveloperDevCenter(endpoint, new DefaultAzureCredential());

Основные понятия

КЛИЕНТ REST

Этот клиент является одним из наших клиентов REST. Мы настоятельно рекомендуем ознакомиться с тем, как использовать клиент REST здесь.

Основные понятия DevCenter

Dev Boxes относятся к управляемым компьютерам разработчиков, работающим в Azure. Поля разработки подготавливаются в пулах, определяющих сеть и образ, используемые для Dev Box.

Среды относятся к шаблонным средам разработчика, которые объединяют шаблон (элемент каталога) и параметры, а также тип среды, определяющий разрешения и место развертывания ресурсов.

Устранение неполадок

Лесозаготовка

Включение ведения журнала может помочь выявить полезные сведения о сбоях. Чтобы просмотреть журнал HTTP-запросов и ответов, задайте для переменной среды AZURE_LOG_LEVEL значение info. Кроме того, ведение журнала можно включить во время выполнения путем вызова setLogLevel в @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Дополнительные инструкции по включению журналов см. в документации по пакету @azure/loger.