Azure CLI를 사용하여 Batch 리소스 관리
Azure CLI(Azure 명령줄 인터페이스)를 사용하여 Azure Batch 계정 및 리소스를 관리할 수 있습니다. 풀, 작업 및 태스크와 같은 Batch 리소스를 만들고 업데이트하는 명령이 있습니다. Batch API, PowerShell cmdlet 및 Azure Portal을 통해 수행하는 여러 동일한 작업에 대한 스크립트를 만들 수도 있습니다.
Azure Cloud Shell에서 Azure CLI를 실행하거나 Azure CLI를 로컬로 설치할 수 있습니다. 버전은 Windows, Mac 및 Linux OS(운영 체제)에 사용할 수 있습니다.
이 문서에서는 Batch 계정 및 리소스와 함께 Azure CLI를 사용하는 방법을 설명합니다.
Azure CLI 설정
Azure CLI를 설정하는 방법을 선택합니다.
- Cloud Shell에서 Azure CLI 실행
- 로컬로 Azure CLI 설치
- Windows에 Azure CLI 설치
- macOS에 Azure CLI 설치
- 여러 Linux 배포판용으로 Linux에 Azure CLI 설치
Azure CLI를 사용하는 경우 계속하기 전에 Azure CLI 시작을 참조하세요.
이전에 Azure CLI를 로컬로 설치한 경우 설치를 최신 버전으로 업데이트해야 합니다.
Azure CLI를 사용하여 인증
Batch에서 Azure CLI를 사용하려면 먼저 Azure 계정에 로그인한 다음, Batch 계정에 로그인합니다.
Azure 계정에 로그인
Azure CLI를 사용하려면 먼저 Azure 계정에 로그인합니다. 이 단계에서는 Batch Management 서비스 명령이 포함된 Azure Resource Manager 명령에 액세스할 수 있습니다. 그런 다음, 명령을 실행하여 Batch 계정, 키, 애플리케이션 패키지 및 할당량을 관리할 수 있습니다.
두 가지 방법으로 Azure CLI에서 Azure 계정을 인증할 수 있습니다. 직접 명령을 실행하려면 Azure CLI에 대화식으로 로그인합니다. Azure CLI는 자격 증명을 캐시하고 동일한 자격 증명을 사용하여 나중에 Batch 계정에 로그인할 수 있습니다. 스크립트 또는 애플리케이션에서 명령을 실행하려면 서비스 주체를 사용하여 Azure CLI에 로그인합니다.
Azure CLI에 대화식으로 로그인하려면 az login을 실행합니다.
az login
Batch 계정에 로그인
다음으로, az batch account login 명령을 사용하여 Azure CLI에서 Batch 계정에 로그인합니다. 이 단계에서는 Batch 서비스 명령에 액세스할 수 있습니다. 그런 다음, 풀, 작업 및 태스크와 같은 Batch 리소스를 관리할 수 있습니다.
두 가지 방법으로 Azure CLI에서 Batch 계정을 인증할 수 있습니다. 기본 방법은 Microsoft Entra ID를 사용하여 인증하는 것입니다. 대부분의 시나리오에서 이 방법을 사용하는 것이 좋습니다. 또 다른 옵션은 공유 키 인증을 사용하는 것입니다.
Batch 명령을 자동화하기 위해 Azure CLI 스크립트를 만드는 경우 두 인증 방법 중 하나를 사용할 수 있습니다. 일부 시나리오에서는 공유 키 인증이 서비스 주체를 만드는 것보다 더 간단할 수 있습니다.
Microsoft Entra ID로 인증
배치 계정으로 인증하는 기본 방법은 Microsoft Entra ID를 통하는 것입니다. 대화식으로 또는 서비스 주체를 사용하여 Azure CLI에 로그인하는 경우 캐시된 동일한 자격 증명으로 Microsoft Entra ID를 사용하여 배치 계정에 로그인할 수 있습니다. 또한 이 인증 방법은 Azure RBAC(Azure 역할 기반 액세스 제어)를 제공합니다. Azure RBAC에서 사용자 액세스는 계정 키가 아니라 할당된 역할에 따라 달라집니다. 계정 키가 아닌 Azure 역할만 관리하면 됩니다. 그러면 Microsoft Entra ID가 액세스 및 인증을 처리합니다.
Microsoft Entra ID를 사용하여 배치 계정에 로그인하려면 az batch login을 실행합니다. Batch 계정 이름(-n) 및 리소스 그룹 이름(-g)에 대한 필수 매개변수를 포함해야 합니다.
az batch account login -g <your-resource-group> -n <your-batch-account>
공유 키를 사용하여 인증
공유 키 인증을 사용하여 Batch 계정에 로그인할 수도 있습니다. 이 방법은 계정 액세스 키를 사용하여 Batch 서비스에 대한 Azure CLI 명령을 인증합니다.
공유 키 인증을 사용하여 Batch 계정에 로그인하려면 az batch login을 --shared-key-auth 매개 변수와 함께 실행합니다. Batch 계정 이름(-n) 및 리소스 그룹 이름(-g)에 대한 필수 매개변수를 포함해야 합니다.
az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth
Batch 명령 알아보기
Azure CLI 참조 설명서에는 Batch용 Azure CLI 명령이 모두 나열되어 있습니다.
Azure CLI에서 모든 Batch 명령을 나열하려면 az batch -h를 실행합니다.
일반적인 Batch 작업에 대한 예제 CLI 스크립트가 여러 가지 있습니다. 다음 예제에서는 Azure CLI에서 Batch에 사용할 수 있는 많은 명령을 사용하는 방법을 보여줍니다. Batch 계정, 풀, 작업 및 태스크를 만들고 관리하는 방법을 알아볼 수 있습니다.
Batch CLI 확장 명령 사용
Batch CLI 확장을 사용하여 코드를 작성하지 않고 Batch 작업을 실행할 수 있습니다. 확장은 Azure CLI를 사용하여 풀, 작업 및 태스크를 만들기 위해 JSON 템플릿을 사용하는 명령을 제공합니다. 또한 확장은 Batch 계정에 연결된 Azure Storage 계정에 연결하는 명령을 제공합니다. 그러면 작업 입력 파일을 업로드하고 작업 입력 파일을 다운로드할 수 있습니다.
JSON을 사용하여 리소스 만들기
명령줄 매개 변수만 사용하여 대부분의 Batch 리소스를 만들 수 있습니다. 일부 기능은 대신 JSON 구성 파일을 지정해야 합니다. JSON 파일에는 새 리소스에 대한 구성 세부 정보가 포함되어 있습니다. 예를 들어 시작 태스크에 대한 리소스 파일을 지정하려면 JSON 파일을 사용해야 합니다.
예를 들어 JSON 파일을 사용하여 새 Batch 풀 리소스를 구성하려면 다음을 수행합니다.
az batch pool <your-batch-pool-configuration>.json
새 리소스에 대한 JSON 파일을 지정할 때 명령에 다른 매개 변수를 사용하지 마세요. 서비스는 JSON 파일만 사용하여 리소스를 구성합니다.
Batch REST API 참조 설명서에는 리소스를 만드는 데 필요한 모든 JSON 구문이 나열되어 있습니다.
리소스를 만드는 데 필요한 JSON 구문을 보려면 Batch REST API 참조 설명서를 참조하세요. 리소스 작업의 참조 페이지에서 예제 섹션으로 이동합니다. 그런 다음, <리소스 종류> 추가라는 하위 섹션을 찾습니다. 예: 기본 작업 추가. 예제 JSON 코드를 구성 파일의 템플릿으로 사용합니다.
JSON 파일을 지정하는 샘플 스크립트는 Batch로 작업 및 태스크 실행을 참조하세요.
Batch 리소스를 효율적으로 쿼리
list 명령을 사용하여 Batch 계정을 쿼리하고 모든 리소스를 나열할 수 있습니다. 예를 들어 계정의 풀과 작업의 태스크를 나열하려면 다음을 수행합니다.
az batch pool list
az batch task list --job-id <your-job-id>
Batch 쿼리에서 반환하는 데이터의 양을 제한하려면 OData 절을 지정합니다. 모든 필터링은 서버 쪽에서 이루어지므로 요청한 데이터만 받습니다. 이러한 OData 절을 사용하여 list 작업으로 대역폭과 시간을 절약합니다. 자세한 내용은 Batch 리소스에 대한 효율적인 목록 쿼리 디자인을 참조하세요.
| 절 | 설명 |
|---|---|
--select-clause [select-clause] |
각 엔터티에 대한 속성의 하위 집합을 반환합니다. |
--filter-clause [filter-clause] |
지정된 OData 식과 일치하는 엔터티만 반환합니다. |
--expand-clause [expand-clause] |
단일 기본 REST 호출에서 엔터티 정보를 가져옵니다. expand 절은 현재 stats 속성만 지원합니다. |
이러한 절을 사용하는 방법을 보여주는 예제 스크립트는 Batch로 작업 및 태스크 실행을 참조하세요.
문제 해결
Batch 명령에 대한 도움말을 보려면 명령 끝에 -h를 추가합니다. 다른 옵션은 추가하지 마세요. 예를 들어 Batch 계정을 만드는 데 도움말을 보려면 az batch account create -h를 실행합니다.
자세한 명령 출력을 반환하려면 명령 끝에 -v 또는 -vv를 추가합니다. 이러한 스위치를 사용하여 전체 오류 출력을 표시합니다. -vv 플래그는 실제 REST 요청 및 응답을 반환합니다.
명령 출력을 JSON 형식으로 보려면 명령 끝에 --json을 추가합니다. 예를 들어, 이름이 pool001인 풀의 속성을 표시하려면 az batch pool show pool001 --json을 실행합니다. 그런 다음, 출력을 복사하고 수정하여 JSON 구성 파일을 사용하여 Batch 리소스를 생성합니다.
일반적인 Azure CLI 문제 해결
Azure CLI는 여러 셸 환경에서 실행할 수 있지만 약간의 형식 변형이 있습니다. Azure CLI 명령으로 예기치 않은 결과가 발생하는 경우 Azure CLI를 성공적으로 사용하는 방법을 참조하세요.