PowerShell cmdlet을 사용한 Batch 리소스 관리
Azure Batch PowerShell cmdlet을 사용하면 여러 일반적인 Batch 작업을 수행하고 스크립팅할 수 있습니다. Batch 계정을 관리하고 풀, 작업, 태스크 등의 Batch 리소스 작업에 사용할 수 있는 cmdlet에 대해 간략히 소개합니다.
Batch cmdlet의 전체 목록과 상세 cmdlet 구문은 Azure Batch cmdlet 참조에서 확인하세요.
서비스 업데이트 및 향상을 최대한 활용하기 위해서 Azure PowerShell 모듈을 자주 업데이트하는 것이 좋습니다.
필수 조건
Azure PowerShell 모듈을 설치하고 구성합니다. 시험판 모듈처럼 특정 Azure Batch 모듈을 설치하려면 PowerShell 갤러리를 참조하세요.
Connect-AzAccount cmdlet을 실행하여 구독에 연결(Azure Batch cmdlet은 Azure Resource Manager 모듈에 탑재됨):
Connect-AzAccountBatch 공급자 네임 스페이스를 등록합니다. 이 작업은 구독당 한 번만 수행하면 됩니다.
Register-AzResourceProvider -ProviderNamespace Microsoft.Batch
Batch 계정 및 키 관리
Batch 계정 만들기
New-AzBatchAccount는 지정된 리소스 그룹에서 Batch 계정을 만듭니다. 아직 리소스 그룹이 없는 경우 New-AzResourceGroup cmdlet을 실행하여 만듭니다. 위치 매개 변수에서 "미국 중부"와 같이 Azure 지역 중 하나를 지정합니다. 예시:
New-AzResourceGroup –Name MyBatchResourceGroup –Location "Central US"
그런 다음, 새 리소스 그룹에 Batch 계정을 만듭니다. <account_name>의 계정 이름과 리소스 그룹의 위치 및 이름을 지정합니다. Batch 계정을 만드는 데 다소 시간이 걸릴 수 있습니다. 예시:
New-AzBatchAccount –AccountName <account_name> –Location "Central US" –ResourceGroupName <res_group_name>
참고 항목
Batch 계정 이름은 리소스 그룹에 대해 Azure 지역에 고유해야 하며, 3자에서 24자 사이의 문자를 포함하고, 소문자와 숫자만 사용해야 합니다.
계정 액세스 키 가져오기
Get-AzBatchAccountKeys 는 Azure Batch 계정과 연결된 액세스 키를 표시합니다. 예를 들어, 사용자가 만든 계정의 기본 및 보조 키를 가져오려면 다음을 실행합니다.
$Account = Get-AzBatchAccountKeys –AccountName <account_name>
$Account.PrimaryAccountKey
$Account.SecondaryAccountKey
새 액세스 키 생성
New-AzBatchAccountKey 는 Azure Batch 계정에 대해 기본 또는 보조 계정 키를 새로 생성합니다. 예를 들어, Batch 계정의 새 기본 키를 생성하려면 다음과 같이 입력합니다.
New-AzBatchAccountKey -AccountName <account_name> -KeyType Primary
참고 항목
새 보조 키를 생성하려면 KeyType 매개 변수에 "Secondary"를 지정합니다. 기본 및 보조 키를 개별적으로 다시 생성해야 합니다.
Batch 계정 삭제
Remove-AzBatchAccount는 배치 계정을 삭제합니다. 예시:
Remove-AzBatchAccount -AccountName <account_name>
메시지가 나타나면 계정을 제거할 것인지 확인합니다. 계정을 제거하는 데는 시간이 걸릴 수 있습니다.
BatchAccountContext 개체 만들기
공유 키 인증 또는 Microsoft Entra 인증을 사용하여 Batch 리소스 관리를 인증할 수 있습니다. Batch PowerShell cmdlet를 사용하여 인증하려면 먼저 계정 자격 증명이나 ID를 저장하는 BatchAccountContext 계정을 만듭니다. BatchAccountContext 개체를 BatchContext 매개 변수를 사용하는 cmdlet에 전달합니다.
공유 키 인증
$context = Get-AzBatchAccountKeys -AccountName <account_name>
참고 항목
기본적으로 계정의 기본 키는 인증에 사용되지만 BatchAccountContext 개체의 KeyInUse 속성을 변경하면 사용할 키를 명시적으로 선택할 수 있습니다. $context.KeyInUse = "Secondary"
Microsoft Entra 인증
$context = Get-AzBatchAccount -AccountName <account_name>
Batch 리소스 만들기 및 수정
New-AzBatchPool, New-AzBatchJob, New-AzBatchTask 등의 cmdlet을 사용하여 Batch 계정 아래 리소스를 만듭니다. 기존 리소스 속성을 업데이트하는 해당 Get- 및 Set- cmdlet과, Batch 계정에서 리소스를 제거하는 Remove- cmdlet이 있습니다.
이러한 많은 cmdlet을 사용하는 경우 BatchContext 개체를 전달 하는 것 외에도, 다음 예제와 같이 상세한 리소스 설정을 포함하는 개체를 만들거나 전달해야 합니다. 추가 예제를 보려면 각 cmdlet에 대한 자세한 도움말을 참조하세요.
Batch 풀 만들기
Batch 풀을 만들거나 업데이트할 때 구성을 지정합니다. 풀은 일반적으로 Azure Virtual Machines Marketplace에 나열된 지원되는 Linux 또는 Windows VM 이미지 중 하나를 지정하거나 준비한 사용자 지정 이미지를 제공할 수 있는 가상 머신 구성으로 구성해야 합니다. Cloud Services 구성 풀은 Windows 컴퓨팅 노드만 제공하며 일부 Batch 기능을 지원하지 않습니다.
New-AzBatchPool을 실행할 때 PSVirtualMachineConfiguration 또는 PSCloudServiceConfiguration 개체로 운영 체제 설정을 전달합니다. 예를 들어 다음 코드 조각은 가상 머신 구성에서 크기가 Standard_A1 컴퓨팅 노드이고 Ubuntu Server 20.04-LTS 이미지로 작성된 Batch 풀을 만듭니다. 여기서 VirtualMachineConfiguration 매개 변수는 $configuration 변수를 PSCloudServiceConfiguration 개체로 지정합니다. BatchContext 매개 변수는 이전에 정의한 $context 변수를 BatchAccountContext 개체로 지정합니다.
$imageRef = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("UbuntuServer","Canonical","20.04-LTS")
$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageRef, "batch.node.ubuntu 20.04")
New-AzBatchPool -Id "mypspool" -VirtualMachineSize "Standard_a1" -VirtualMachineConfiguration $configuration -AutoScaleFormula '$TargetDedicated=4;' -BatchContext $context
새 풀에 있는 컴퓨팅 노드의 목표 수치는 자동 크기 조정 수식에 의해 계산됩니다. 이 경우 공식은 단순히 $TargetDedicated=4이며 풀의 컴퓨팅 노드 수는 최대 4개입니다.
풀, 작업, 태스크 및 기타 상세 정보 쿼리
Get-AzBatchPool, Get-AzBatchJob, Get-AzBatchTask 등의 cmdlet을 사용하여 Batch 계정 아래에 만들어진 엔터티를 쿼리합니다.
데이터에 대한 쿼리
예제와 같이 Get-AzBatchPools를 사용하여 풀을 찾습니다. 이 작업은 기본적으로 사용자 계정 아래의 모든 풀을 쿼리합니다. 이때 $context에는 이미 BatchAccountContext 개체가 저장되어 있다고 가정합니다.
Get-AzBatchPool -BatchContext $context
OData 필터 사용
Filter 매개 변수를 사용하여 OData 필터를 제공하면 사용자와 관계가 있는 개체만 찾을 수 있습니다. 예를 들어 ID가 "myPool"로 시작하는 모든 풀을 찾을 수 있습니다.
$filter = "startswith(id,'myPool')"
Get-AzBatchPool -Filter $filter -BatchContext $context
이 방법은 로컬 파이프라인에서 "Where-Object"를 사용하는 것만큼 유연하지는 않습니다. 그러나 쿼리가 Batch 서비스에 직접 전송되므로 서버에서 모든 필터링이 수행되어 인터넷 대역폭이 절약됩니다.
ID 매개 변수 사용
OData 필터의 대안은 ID 매개 변수를 사용하는 것입니다. ID가 "myPool"인 특정 풀을 쿼리하려면
Get-AzBatchPool -Id "myPool" -BatchContext $context
Id 매개 변수는 전체 ID 검색만 지원하며 와일드카드 또는 OData 스타일 필터를 지원하지 않습니다.
MaxCount 매개 변수 사용
기본적으로 각 cmdlet은 최대 1000개의 개체를 반환합니다. 이 제한에 도달하면 더 적은 수의 개체를 반환하도록 필터를 조정하거나 MaxCount 매개 변수를 사용하여 최대값을 명시적으로 설정합니다. 예시:
Get-AzBatchTask -MaxCount 2500 -BatchContext $context
상한값을 제거하려면 MaxCount 를 0 이하로 설정합니다.
PowerShell 파이프라인 사용
Batch cmdlet은 PowerShell 파이프라인을 사용하여 cmdlet 간에 데이터를 전송합니다. 이 방식은 매개 변수를 지정하는 것과 같은 효과가 있지만 보다 쉽게 여러 엔터티로 작업할 수 있습니다.
예를 들어, 다음과 같이 사용자 계정 아래의 모든 작업을 찾아서 표시할 수 있습니다.
Get-AzBatchJob -BatchContext $context | Get-AzBatchTask -BatchContext $context
풀의 모든 컴퓨팅 노드 다시 시작(다시 부팅):
Get-AzBatchComputeNode -PoolId "myPool" -BatchContext $context | Restart-AzBatchComputeNode -BatchContext $context
애플리케이션 패키지 관리
애플리케이션 패키지는 풀에서 컴퓨팅 노드에 애플리케이션을 배포하는 간단한 방법을 제공합니다. Batch PowerShell cmdlet으로 Batch 계정에 애플리케이션 패키지를 업로드하여 관리하고 노드를 계산하는 패키지 버전을 배포할 수 있습니다.
Important
애플리케이션 패키지를 사용하려면 Azure Storage 계정을 Batch 계정에 연결해야 합니다.
만듭니다 .
New-AzBatchApplication -AccountName <account_name> -ResourceGroupName <res_group_name> -ApplicationId "MyBatchApplication"
추가합니다 .
New-AzBatchApplicationPackage -AccountName <account_name> -ResourceGroupName <res_group_name> -ApplicationId "MyBatchApplication" -ApplicationVersion "1.0" -Format zip -FilePath package001.zip
애플리케이션의 기본 버전 설정:
Set-AzBatchApplication -AccountName <account_name> -ResourceGroupName <res_group_name> -ApplicationId "MyBatchApplication" -DefaultVersion "1.0"
애플리케이션의 패키지 열거
$application = Get-AzBatchApplication -AccountName <account_name> -ResourceGroupName <res_group_name> -ApplicationId "MyBatchApplication"
$application.ApplicationPackages
애플리케이션 패키지 삭제
Remove-AzBatchApplicationPackage -AccountName <account_name> -ResourceGroupName <res_group_name> -ApplicationId "MyBatchApplication" -ApplicationVersion "1.0"
애플리케이션 삭제
Remove-AzBatchApplication -AccountName <account_name> -ResourceGroupName <res_group_name> -ApplicationId "MyBatchApplication"
참고 항목
애플리케이션을 삭제하기 전에 모든 애플리케이션의 애플리케이션 패키지 버전을 삭제해야 합니다. 현재 애플리케이션 패키지를 보유하는 애플리케이션을 삭제하려고 하면 '충돌' 오류 메시지를 받게 됩니다.
애플리케이션 패키지 배포
새 풀을 만들 때 배포에 하나 이상의 애플리케이션 패키지를 지정할 수 있습니다. 풀을 만들 때 패키지를 지정하는 경우 노드가 풀에 조인하면 각 노드에 배포됩니다. 패키지는 노드를 다시 부팅하거나 이미지로 다시 설치하는 경우에 배포됩니다.
풀에 참가하면서 풀의 노드에 애플리케이션 패키지를 배포하도록 풀을 만들 때 -ApplicationPackageReference 옵션을 지정합니다. 먼저 PSApplicationPackageReference 개체를 만들고, 풀의 컴퓨팅 노드에 배포하려는 애플리케이션 ID 및 패키지 버전을 사용하여 개체를 구성합니다.
$appPackageReference = New-Object Microsoft.Azure.Commands.Batch.Models.PSApplicationPackageReference
$appPackageReference.ApplicationId = "MyBatchApplication"
$appPackageReference.Version = "1.0"
이제 풀을 만들고 패키지 참조 개체를 ApplicationPackageReferences 옵션에 대한 인수로 지정:
New-AzBatchPool -Id "PoolWithAppPackage" -VirtualMachineSize "Small" -VirtualMachineConfiguration $configuration -BatchContext $context -ApplicationPackageReferences $appPackageReference
Batch 애플리케이션 패키지를 사용하여 컴퓨팅 노드에 애플리케이션 배포에서 애플리케이션 패키지에 대한 자세한 정보를 찾을 수 있습니다.
풀의 애플리케이션 패키지 업데이트
기존 풀에 할당된 애플리케이션을 업데이트하려면 먼저 원하는 속성(애플리케이션 ID 및 패키지 버전)의 PSApplicationPackageReference 개체를 만듭니다.
$appPackageReference = New-Object Microsoft.Azure.Commands.Batch.Models.PSApplicationPackageReference
$appPackageReference.ApplicationId = "MyBatchApplication"
$appPackageReference.Version = "2.0"
다음으로, Batch에서 풀을 가져오고, 기존 패키지를 지우고, 새 패키지 참조를 추가하고, 새 풀 설정을 사용하여 Batch 서비스를 업데이트합니다.
$pool = Get-AzBatchPool -BatchContext $context -Id "PoolWithAppPackage"
$pool.ApplicationPackageReferences.Clear()
$pool.ApplicationPackageReferences.Add($appPackageReference)
Set-AzBatchPool -BatchContext $context -Pool $pool
이제 Batch 서비스에서 풀의 속성을 업데이트했습니다. 실제로 풀의 컴퓨팅 노드에 새로운 애플리케이션 패키지를 배포하려면, 해당 노드를 다시 시작하거나 이미지로 다시 설치해야 합니다. 이 명령을 사용하여 풀의 모든 노드를 다시 시작할 수 있습니다.
Get-AzBatchComputeNode -PoolId "PoolWithAppPackage" -BatchContext $context | Restart-AzBatchComputeNode -BatchContext $context
팁
여러 애플리케이션 패키지를 풀의 컴퓨팅 노드에 배포할 수 있습니다. 현재 배포된 패키지를 교체하는 대신 애플리케이션 패키지를 추가하고자 하는 경우 위의 $pool.ApplicationPackageReferences.Clear() 줄을 생략합니다.
다음 단계
- 자세한 cmdlet 구문과 예제에 대한 Azure Batch cmdlet 참조를 검토합니다.
- Batch 애플리케이션 패키지를 사용하여 컴퓨팅 노드에 애플리케이션을 배포하는 방법을 알아봅니다.