Udostępnij za pośrednictwem

Biblioteka klienta usługi Azure KubernetesRuntime dla języka JavaScript — wersja 1.0.0-beta.1

  • Artykuł

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

Dokumentacja interfejsu APIpakietu Package (NPM)

Wprowadzenie

Obecnie obsługiwane środowiska

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

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

Warunki wstępne

  • Subskrypcja platformy Azure .

Instalowanie pakietu @azure/arm-containerorchestratorruntime

Zainstaluj bibliotekę klienta azure KubernetesRuntime dla języka JavaScript przy użyciu npm:

npm install @azure/arm-containerorchestratorruntime

Tworzenie i uwierzytelnianie KubernetesRuntimeClient

Aby utworzyć obiekt klienta w celu uzyskania dostępu do interfejsu API Azure KubernetesRuntime, potrzebny będzie endpoint zasobu Azure KubernetesRuntime oraz credential. Klient usługi Azure KubernetesRuntime może uwierzytelniać się przy użyciu poświadczeń usługi Azure Active Directory. Punkt końcowy zasobu Azure KubernetesRuntime 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ć dostawcy DefaultAzureCredential pokazanego poniżej lub innych dostawców poświadczeń dostarczonych z zestawem Azure SDK, zainstaluj pakiet @azure/identity:

npm install @azure/identity

Należy również zarejestrować nową aplikację usługi AAD i udzielić dostępu do usługi Azure KubernetesRuntime, przypisując odpowiednią rolę do jednostki usługi (uwaga: role, takie jak "Owner", nie będą udzielać niezbędnych uprawnień). Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i wpisu tajnego klienta aplikacji usługi AAD jako zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Aby uzyskać więcej informacji na temat tworzenia aplikacji usługi Azure AD, zobacz tym przewodniku.

const { KubernetesRuntimeClient } = require("@azure/arm-containerorchestratorruntime");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

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

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new KubernetesRuntimeClient(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

KubernetesRuntimeClient

KubernetesRuntimeClient to podstawowy interfejs dla deweloperów korzystających z biblioteki klienta Azure KubernetesRuntime. Zapoznaj się z metodami tego obiektu klienta, aby zrozumieć różne funkcje usługi Azure KubernetesRuntime, 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:

const { setLogLevel } = require("@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.

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.