Dela via


Azure DevCenter REST-klientbibliotek för JavaScript – version 1.0.1

Azure DevCenter-biblioteket ger åtkomst till att hantera resurser för Microsoft Dev Box och Azure Deployment Environments. Det här paketet gör det möjligt att hantera utvecklardatorer och miljöer i Azure.

Använd paketet för Azure DevCenter för att:

Skapa, komma åt, hantera och ta bort Dev Box-resurser Skapa, distribuera, hantera och ta bort miljöresurser

DevCenter-tjänsten

Vi förlitar dig mycket på våra REST-klientdokument för att kunna använda det här biblioteket

Nyckellänkar:

Komma igång

Miljöer som stöds för närvarande

  • LTS-versioner av Node.js

Förutsättningar

  • Du måste ha en Azure-prenumeration för att kunna använda det här paketet.
  • Du måste ha konfigurerad devcenter, projekt, nätverksanslutning, Dev Box-definition och pool innan du kan skapa dev-rutor
  • Du måste ha konfigurerad en DevCenter-, projekt-, katalog- och miljötyp innan du kan skapa miljöer

Installera @azure-rest/developer-devcenter-paketet

Installera REST-klientbiblioteket för Azure DevCenter för JavaScript med npm:

npm install @azure-rest/developer-devcenter

Skapa och autentisera en AzureDeveloperDevCenterClient

Om du vill använda en AAD-tokenautentiseringsuppgifter (Azure Active Directory)anger du en instans av önskad typ av autentiseringsuppgifter som hämtats från @azure/identitetsbiblioteket.

Om du vill autentisera med AAD måste du först npm installera @azure/identity

Efter installationen kan du välja vilken typ av autentiseringsuppgifter från @azure/identity att använda. Till exempel kan StandardAzureCredential användas för att autentisera klienten.

Ange värdet för dev center-slutpunkten som miljövariabel: 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());

Viktiga begrepp

REST-klient

Den här klienten är en av våra REST-klienter. Vi rekommenderar starkt att du läser hur du använder en REST-klient här.

DevCenter-begrepp

Dev Boxes refererar till hanterade utvecklardatorer som körs i Azure. Dev Boxes etableras i Pooler, som definierar nätverket och avbildningen som används för en Dev Box.

Miljöer refererar till mallade utvecklarmiljöer, som kombinerar en mall (katalogobjekt) och parametrar, samt en miljötyp som definierar behörigheter och var resurserna distribueras.

Felsökning

Skogsavverkning

Aktivering av loggning kan hjälpa dig att hitta användbar information om fel. Om du vill se en logg med HTTP-begäranden och svar anger du AZURE_LOG_LEVEL miljövariabeln till info. Du kan också aktivera loggning vid körning genom att anropa setLogLevel i @azure/logger:

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

setLogLevel("info");

Mer detaljerade anvisningar om hur du aktiverar loggar finns i @azure/logger-paketdokumenten.