Klientská knihovna Azure KubernetesRuntime pro JavaScript – verze 1.0.0-beta.1

  • Článek

Tento balíček obsahuje izomorfní sadu SDK (spouští se v Node.js i v prohlížečích) pro klienta Azure KubernetesRuntime.

Referenční dokumentace k rozhraníAPI package (NPM)

Začínáme

Aktuálně podporovaná prostředí

Další podrobnosti najdete v našich zásadách podpory .

Požadavky

Instalace balíčku @azure/arm-containerorchestratorruntime

Nainstalujte klientskou knihovnu Azure KubernetesRuntime pro JavaScript s npm:

npm install @azure/arm-containerorchestratorruntime

Vytvoření a ověření KubernetesRuntimeClient

Pokud chcete vytvořit objekt klienta pro přístup k rozhraní API Azure KubernetesRuntime, budete potřebovat endpoint prostředku Azure KubernetesRuntime a credential. Klient Azure KubernetesRuntime může k ověření použít přihlašovací údaje Azure Active Directory. Koncový bod prostředku Azure KubernetesRuntime najdete na webu Azure Portal.

Pomocí Azure Active Directory se můžete ověřit pomocí přihlašovacích údajů z knihovny @azure/identity nebo existujícího tokenu AAD.

Pokud chcete použít poskytovatele DefaultAzureCredential zobrazené níže nebo jiné zprostředkovatele přihlašovacích údajů poskytnuté sadou Azure SDK, nainstalujte balíček @azure/identity:

npm install @azure/identity

Budete také muset zaregistrovat novou aplikaci AAD a udělit přístup k azure KubernetesRuntime přiřazením vhodné role k instančnímu objektu (poznámka: role, jako je "Owner", neudělí potřebná oprávnění). Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace AAD jako proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Další informace o tom, jak vytvořit aplikaci Azure AD, najdete této příručce.

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);

JavaScript Bundle

Pokud chcete tuto klientskou knihovnu použít v prohlížeči, musíte nejprve použít bundler. Podrobnosti o tom, jak to udělat, najdete v naší dokumentaci sdružování.

Klíčové koncepty

KubernetesRuntimeClient

KubernetesRuntimeClient je primárním rozhraním pro vývojáře, kteří používají klientskou knihovnu Azure KubernetesRuntime. Prozkoumejte metody tohoto objektu klienta a seznamte se s různými funkcemi služby Azure KubernetesRuntime, ke kterým máte přístup.

Řešení problémů

Protokolování

Povolení protokolování může pomoct odhalit užitečné informace o chybách. Pokud chcete zobrazit protokol požadavků a odpovědí HTTP, nastavte proměnnou prostředí AZURE_LOG_LEVEL na info. Případně můžete protokolování povolit za běhu voláním setLogLevel v @azure/logger:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

Podrobnější pokyny k povolení protokolů najdete v dokumentaci k @azure/protokolovacímu balíčku.

Přispívající

Pokud chcete přispívat do této knihovny, přečtěte si průvodce přispívání a přečtěte si další informace o vytváření a testování kódu.