이 패키지에는 Azure Batch 클라이언트용 동형형(Node.js 및 브라우저 모두에서 실행됨)이 포함되어 있습니다.
Azure Batch는 클라우드 규모 작업 예약 및 컴퓨팅 관리를 제공합니다.
시작하기
현재 지원되는 환경
- Node.js의 LTS 버전
- Safari, Chrome, Edge 및 Firefox의 최신 버전입니다.
자세한 내용은 저희 support 정책을 참조하세요.
필수 조건
@azure/batch 패키지 설치
JavaScript용 Azure Batch 클라이언트 라이브러리를 설치하세요 npm:
npm install @azure/batch
BatchClient를 만들고 인증하기
Azure 배치 API에 접근하기 위해 클라이언트 객체를 생성하려면 Azure 배치 리소스의 endpoint와 credential . Azure Batch 클라이언트는 Azure Active Directory 자격 증명을 사용해 인증할 수 있습니다.
Azure Batch 리소스의 엔드포인트는 Azure 포털에서 찾을 수 있습니다.
Azure 일괄 처리는 Microsoft Entra ID 또는 공유 키를 통한 인증을 지원합니다.
Microsoft Entra ID (마이크로소프트 엔트라 ID)
Azure Entra ID로 인증하려면 @azure/신원 라이브러리의 자격 증명이나 기존 AAD 토큰을 사용해 인증할 수 있습니다.
아래에 표시된 DefaultAzureCredential 제공자 또는 Azure SDK에 포함된 다른 자격 증명 제공자를 사용하려면 @azure/identity 패키지를 설치해 주세요:
npm install @azure/identity
또한 새로운 AAD 애플리케이션을 등록하고 서비스 주체에게 적절한 역할을 할당하여 Azure 배치 접근 권한을 부여해야 합니다(참고: 역할은 "Owner" 필요한 권한을 부여하지 않습니다).
Azure AD 애플리케이션 만드는 방법에 대한 자세한 내용은 this guide를 참고하세요.
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 배치 클라이언트 라이브러리를 사용하는 개발자들의 주요 인터페이스입니다. 이 클라이언트 객체의 메서드를 탐색하여 접근 가능한 Azure 배치 서비스의 다양한 기능을 이해하세요.
Troubleshooting
로깅
로깅을 사용하도록 설정하면 오류에 대한 유용한 정보를 파악하는 데 도움이 될 수 있습니다. HTTP 요청 및 응답 로그를 보려면 환경 변수AZURE_LOG_LEVEL를 info .로 설정합니다. 또는 setLogLevel@azure/logger 호출하여 런타임에 로깅을 사용하도록 설정할 수 있습니다.
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
로그를 사용하도록 설정하는 방법에 대한 자세한 지침은 @azure/로거 패키지 문서를 참조하세요.
Contributing
이 라이브러리에 기여하려면 기여 가이드 를 참조하여 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.
관련 프로젝트
- JavaScript용 Microsoft Azure SDK
Azure SDK for JavaScript