Azure Batch client library for JavaScript - version 13.0.0

Tento balíček obsahuje izomorfní SDK (běží jak v Node.js, tak v prohlížečích) pro Azure Batch klienta.

Azure Batch poskytuje plánování úloh v cloudovém měřítku a správu výpočetních prostředků.

Začínáme

Aktuálně podporovaná prostředí

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

Prerequisites

  • Předplatné služby Azure.

Nainstalujte balíček @azure/batch.

Nainstalovat klientskou knihovnu Azure Batch pro JavaScript s npm:

npm install @azure/batch

Vytvořte a ověřte BatchClient

Pro vytvoření klientského objektu pro přístup k Azure Batch API budete potřebovat .endpointcredential Klient Azure Batch může použít přihlašovací údaje Azure Active Directory k autentizaci. Endpoint pro váš Azure Batch zdroj najdete v Azure Portalu.

Azure Batch podporuje ověřování prostřednictvím ID Microsoft Entra nebo sdíleného klíče.

Microsoft Entra ID

Můžete se autentizovat pomocí Azure Entra ID pomocí přihlašovacích údajů z knihovny @azure/identity nebo existujícího AAD tokenu.

Pro použití poskytovatele DefaultAzureCredential uvedeného níže nebo jiných poskytovatelů přihlašovacích údajů přiložených k Azure SDK, prosím nainstalujte balíček @azure/identity:

npm install @azure/identity

Budete také muset zaregistrovat novou AAD aplikaci a udělit přístup do Azure Batch přiřazením vhodné role vašemu principálovi služby (poznámka: role jako například neudělí "Owner" potřebná oprávnění).

Pro více informací o tom, jak vytvořit Azure AD aplikaci, navštivte tento průvodce.

Pomocí Node.js a prostředí podobných uzlům můžete k ověření klienta použít třídu DefaultAzureCredential.

import { BatchClient } from "@azure/batch";
import { DefaultAzureCredential } from "@azure/identity";

const client = new BatchClient("<endpoint>", new DefaultAzureCredential());

Pro prohlížečová prostředí použijte InteractiveBrowserCredential z balíčku @azure/identity k ověření.

import { InteractiveBrowserCredential } from "@azure/identity";
import { BatchClient } from "@azure/batch";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new BatchClient("<endpoint>", credential);

Sdílený klíč

Pro použití sdíleného klíče k autentizaci musíte nejprve npm nainstalovat @azure/core-auth, poté zadat jméno účtu a klíč k účtu, abyste vytvořili AzureNamedKeyCredential přihlašovací údaje z @azure/core-auth.

Všiml jsem si, že autentizace sdíleným klíčem je podporována pouze v prostředích podobných Node.js a uzlům.

import { AzureNamedKeyCredential } from "@azure/core-auth";
import { BatchClient } from "@azure/batch";

const credential = new AzureNamedKeyCredential("<account name>", "<account key>");
const client = new BatchClient("<endpoint>", credential);

JavaScriptový balíček

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

BatchClient

BatchClient je primární rozhraní pro vývojáře využívající klientskou knihovnu Azure Batch. Prozkoumejte metody na tomto klientském objektu, abyste pochopili různé funkce Azure Batch služby, ke kterým máte přístup.

Troubleshooting

Logging

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:

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

setLogLevel("info");

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

Contributing

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.