このパッケージにはAzure Batchクライアント用の同型SDKが含まれており(Node.js とブラウザの両方で動作します)。
Azure Batch では、クラウド規模のジョブ のスケジュール設定とコンピューティング管理が提供されます。
作業の開始
現在サポートされている環境
- Node.js の LTS バージョン
- Safari、Chrome、Edge、Firefox の最新バージョン。
詳細はsupportポリシーをご覧ください。
前提条件
@azure/batch パッケージをインストールする
JavaScript用のAzure Batchクライアントライブラリを npmでインストールしてください:
npm install @azure/batch
BatchClient を作成して認証する
Azure Batch APIにアクセスするクライアントオブジェクトを作成するには、Azure Batchリソースの endpoint と credentialが必要です。 Azure BatchクライアントはAzure Active Directoryの認証情報を使って認証できます。
Azure Batchリソースのエンドポイントは Azure portalで見つけることができます。
Azure Batch では、Microsoft Entra ID または共有キーを使用した認証がサポートされています。
Microsoft Entra ID
Azure Entra IDでは 、@azure/アイデンティティ ライブラリの認証情報や 既存のAADトークンを使って認証できます。
以下に示すDefaultAzureCredentialプロバイダー、またはAzure SDKに付属する他の認証情報提供者を使用するには、@azure/identityパッケージをインストールしてください:
npm install @azure/identity
また、 新しいAADアプリケーションを登録し、 サービスプリンシパルに適切な役割を割り当ててAzure Batchへのアクセスを許可する必要があります(注: "Owner" のようなロールは必要な権限を付与しません)。
Azure ADアプリケーションの作成方法についての詳細は、このガイドをご覧ください。
Node.js とノードに似た環境を使用すると、DefaultAzureCredential クラスを使用してクライアントを認証できます。
import { BatchClient } from "@azure/batch";
import { DefaultAzureCredential } from "@azure/identity";
const client = new BatchClient("<endpoint>", new DefaultAzureCredential());
ブラウザ環境では、InteractiveBrowserCredentialパッケージの @azure/identity を使って認証します。
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);
共有キー
共有キーを使って認証するには、まずnpmをインストールし@azure/core-auth、その後アカウント名とアカウントキーを入力してAzureNamedKeyCredentialから@azure/core-auth認証情報を作成します。
共有鍵認証は Node.js およびノード系環境でのみサポートされていることに注意してください。
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);
JavaScript バンドル
ブラウザーでこのクライアント ライブラリを使用するには、まず、バンドルを使用する必要があります。 これを行う方法の詳細については、
主な概念
バッチクライアント
BatchClient はAzure Batchクライアントライブラリを使用する開発者の主要なインターフェースです。 このクライアントオブジェクトのメソッドを探索し、アクセス可能なAzure Batchサービスのさまざまな機能を理解してください。
トラブルシューティング
ログ
ログ記録を有効にすると、エラーに関する有用な情報を明らかにするのに役立つ場合があります。 HTTP 要求と応答のログを表示するには、AZURE_LOG_LEVEL 環境変数を infoに設定します。 または、setLogLevelで @azure/logger を呼び出すことによって、実行時にログを有効にすることもできます。
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
ログを有効にする方法の詳細な手順については、 @azure/logger パッケージのドキュメントを参照してください。
Contributing
このライブラリに投稿する場合は、コードをビルドしてテストする方法の詳細については、投稿ガイド を参照してください。
関連プロジェクト
- Microsoft Azure SDK for JavaScript の
Azure SDK for JavaScript