Udostępnij za pomocą


Azure ContainerService client library for JavaScript - version 24.0.0

Ten pakiet zawiera izomorficzny zestaw SDK (uruchamiany zarówno w Node.js, jak i w przeglądarkach) dla klienta usługi Azure ContainerService.

Klient usługi kontenera.

Dokumentacja referencyjna interfejsu APIkodu źródłowego (NPM)Przykłady

Wprowadzenie

Obecnie obsługiwane środowiska

  • Wersje LTS systemu Node.js
  • Najnowsze wersje przeglądarek Safari, Chrome, Edge i Firefox.

Aby uzyskać więcej informacji, zobacz nasze zasady pomocy technicznej .

Warunki wstępne

Instalowanie pakietu @azure/arm-containerservice

Zainstaluj bibliotekę klienta usługi Azure ContainerService dla języka JavaScript przy użyciu npm:

npm install @azure/arm-containerservice

Tworzenie i uwierzytelnianie ContainerServiceClient

Aby utworzyć obiekt klienta w celu uzyskania dostępu do interfejsu API usługi Azure ContainerService, potrzebny będzie endpoint zasobu azure ContainerService i credential. Klient usługi Azure ContainerService może używać poświadczeń usługi Azure Active Directory do uwierzytelniania. Punkt końcowy zasobu usługi Azure ContainerService można znaleźć w witrynie Azure Portal.

Możesz uwierzytelnić się w usłudze Azure Active Directory przy użyciu poświadczeń z biblioteki @azure/tożsamości lub istniejącego tokenu usługi AAD.

Aby użyć domyślnego dostawcyAzureCredential pokazanego poniżej lub innych dostawców poświadczeń dostarczonych z zestawem Azure SDK, zainstaluj @azure/identity pakiet:

npm install @azure/identity

Należy również zarejestrować nową aplikację usługi AAD i udzielić dostępu do usługi Azure ContainerService , przypisując odpowiednią rolę do jednostki usługi (uwaga: role, takie jak "Owner" nie będą udzielać niezbędnych uprawnień).

Aby uzyskać więcej informacji na temat tworzenia aplikacji usługi Azure AD, zapoznaj się z tym przewodnikiem.

Korzystając ze środowisk Node.js i środowisk podobnych do węzłów, możesz użyć klasy DefaultAzureCredential do uwierzytelniania klienta.

import { ContainerServiceClient } from "@azure/arm-containerservice";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ContainerServiceClient(new DefaultAzureCredential(), subscriptionId);

W przypadku środowisk przeglądarki użyj InteractiveBrowserCredential z pakietu @azure/identity do uwierzytelniania.

import { InteractiveBrowserCredential } from "@azure/identity";
import { ContainerServiceClient } from "@azure/arm-containerservice";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new ContainerServiceClient(credential, subscriptionId);

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw należy użyć pakietu. Aby uzyskać szczegółowe informacje o tym, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów .

Kluczowe pojęcia

ContainerServiceClient

ContainerServiceClient jest podstawowym interfejsem dla deweloperów korzystających z biblioteki klienta usługi Azure ContainerService. Zapoznaj się z metodami tego obiektu klienta, aby zrozumieć różne funkcje usługi Azure ContainerService, do której można uzyskać dostęp.

Rozwiązywanie problemów

Wyrąb

Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań i odpowiedzi HTTP, ustaw zmienną środowiskową AZURE_LOG_LEVEL na info. Alternatywnie rejestrowanie można włączyć w czasie wykonywania, wywołując setLogLevel w @azure/logger:

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

setLogLevel("info");

Aby uzyskać bardziej szczegółowe instrukcje dotyczące włączania dzienników, zapoznaj się z dokumentami dotyczącymi pakietów @azure/rejestratora.

Następne kroki

Zapoznaj się z przykładami katalogu, aby zapoznać się ze szczegółowymi przykładami dotyczącymi korzystania z tej biblioteki.

Przyczyniając się

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik dotyczący współtworzenia , aby dowiedzieć się więcej na temat tworzenia i testowania kodu.