배치 풀의 관리 ID 구성

아티클
12/23/2024

Azure 리소스에 대한 관리 ID는 Microsoft Entra ID(Azure AD ID)에서 Azure 리소스에 대한 ID를 제공하여 복잡한 ID 및 자격 증명 관리를 제거합니다. 이 ID는 Azure의 대상 리소스를 인증하기 위해 Microsoft Entra 토큰을 가져오는 데 사용됩니다.

Batch 풀에 사용자 할당 관리 ID를 추가할 때 구성에서 ID 속성을 설정하는 것이 중요합니다. 이 속성은 관리 ID를 풀에 연결하여 Azure 리소스에 안전하게 액세스할 수 있도록 합니다. ID 속성을 잘못 설정하면 액세스 문제 또는 업로드 오류와 같은 일반적인 오류가 발생할 수 있습니다.

Azure Batch에서 관리 ID를 구성하는 방법에 대한 자세한 내용은 Azure Batch 관리 ID 설명서를 참조하세요.

이 항목에서는 배치 풀에서 사용자가 할당한 관리 ID를 사용하도록 설정하는 방법과 노드 내에서 관리 ID를 사용하는 방법에 대해 설명합니다.

Important

관리 ID를 사용하여 풀을 만드는 작업은 Entra 인증을 사용하여 Batch 관리 평면 API 또는 SDK로만 수행할 수 있습니다. Batch 서비스 API 또는 SDK를 사용하여 관리 ID를 포함한 풀을 만들 수 없습니다. 자세한 내용은 Batch API 및 도구에 대한 개요 설명서를 참조하세요.

사용자 할당 관리 ID 만들기

먼저 배치 계정과 동일한 테넌트에서 사용자가 할당한 관리 ID 만들기를 수행합니다. Azure Portal, Azure CLI(Azure 명령줄 인터페이스), PowerShell, Azure Resource Manager 또는 Azure REST API를 사용하여 ID를 만들 수 있습니다. 이 관리 ID는 동일한 리소스 그룹 또는 동일한 구독에 있을 필요는 없습니다.

팁

고객 데이터 암호화를 위해 Batch 계정용으로 만들어진 시스템 할당 관리 ID는 이 문서에 설명된 대로 Batch 풀에서 사용자 지정 관리 ID로 사용할 수 없습니다. 배치 계정과 Batch 풀 모두에서 동일한 관리 ID를 사용하려고 하면 대신 일반 사용자가 할당한 관리 ID를 사용합니다.

사용자가 할당한 관리 ID를 사용하여 배치 풀 만들기

하나 이상의 사용자가 할당한 관리 ID를 만든 후에는 해당 ID로 Batch 풀을 만들 수 있습니다. 마케팅 목록의 구성원을 관리할 수 있습니다.

Azure Portal을 사용하여 Batch 풀 만들기
Batch .NET 관리 라이브러리를 사용하여 Batch 풀 만들기

Warning

풀에 활성 노드가 있는 동안에는 풀 관리 ID의 현재 위치 업데이트가 지원되지 않습니다. 기존 컴퓨팅 노드는 변경 내용으로 업데이트되지 않습니다. 모든 VM에 동일한 ID 집합이 할당되도록 ID 컬렉션을 수정하기 전에 풀을 0 컴퓨팅 노드로 스케일 다운하는 것이 좋습니다.

Azure Portal에서 Batch 풀 만들기

Azure Portal을 통해 사용자가 할당한 관리 ID를 사용하여 Batch 풀을 만들려면 다음을 수행합니다.

Azure Portal에 로그인합니다.
검색 창에 배치 계정을 입력하고 선택합니다.
배치 계정 페이지에서 Batch 풀을 만들 배치 계정을 선택합니다.
배치 계정 메뉴의 기능 아래에서 풀을 선택합니다.
풀 메뉴에서 추가를 선택하여 새 Batch 풀을 추가합니다.
풀 ID의 경우 풀의 식별자를 입력합니다.
ID의 경우 설정을 사용자 할당으로 변경합니다.
사용자 할당 관리 ID 아래에서 추가를 선택합니다.
사용하려는 사용자가 할당한 관리 ID 또는 ID를 선택합니다. 그런 후 추가를 선택합니다.
운영 체제에서 사용할 게시자, 제품 및 SKU를 선택합니다.
필요에 따라 컨테이너 레지스트리에서 관리 ID를 활성화합니다.
1. 컨테이너 구성의 경우 설정을 사용자 지정으로 변경합니다. 그런 다음, 사용자 지정 구성을 선택합니다.
2. 시작 태스크의 경우 사용을 선택합니다. 그런 다음, 리소스 파일을 선택하고 스토리지 컨테이너 정보를 추가합니다.
3. 컨테이너 설정을 활성화합니다.
4. 컨테이너 레지스트리를 사용자 지정으로 변경합니다.
5. ID 참조의 경우 스토리지 컨테이너를 선택합니다.

.NET을 사용하여 Batch 풀 만들기

Batch .NET 관리 라이브러리를 사용하여 사용자가 할당한 관리 ID로 Batch 풀을 만들려면 다음 예제 코드를 사용합니다.

var credential = new DefaultAzureCredential();
ArmClient _armClient = new ArmClient(credential);
        
var batchAccountIdentifier = ResourceIdentifier.Parse("your-batch-account-resource-id");   
BatchAccountResource batchAccount = _armClient.GetBatchAccountResource(batchAccountIdentifier);

var poolName = "HelloWorldPool";
var imageReference = new BatchImageReference()
{
    Publisher = "canonical",
    Offer = "0001-com-ubuntu-server-jammy",
    Sku = "22_04-lts",
    Version = "latest"
};
string nodeAgentSku = "batch.node.ubuntu 22.04";

var batchAccountPoolData = new BatchAccountPoolData()
{
    VmSize = "Standard_DS1_v2",
    DeploymentConfiguration = new BatchDeploymentConfiguration()
    {
        VmConfiguration = new BatchVmConfiguration(imageReference, nodeAgentSku)
    },
    ScaleSettings = new BatchAccountPoolScaleSettings()
    {
        FixedScale = new BatchAccountFixedScaleSettings()
        {
            TargetDedicatedNodes = 1
        }
    }
};

ArmOperation<BatchAccountPoolResource> armOperation = batchAccount.GetBatchAccountPools().CreateOrUpdate(
    WaitUntil.Completed, poolName, batchAccountPoolData);
BatchAccountPoolResource pool = armOperation.Value;

참고 항목

Identity 속성을 포함하려면 다음 예제 코드를 사용합니다.

   var pool = batchClient.PoolOperations.CreatePool(
       poolId: "myPool",
       virtualMachineSize: "STANDARD_D2_V2",
       cloudServiceConfiguration: new CloudServiceConfiguration(osFamily: "4"),
       targetDedicatedNodes: 1,
       identity: new PoolIdentity(
           type: PoolIdentityType.UserAssigned,
           userAssignedIdentities: new Dictionary<string, UserAssignedIdentity>
           {
               { "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}", new UserAssignedIdentity() }
           }
       ));

배치 노드에서 사용자가 할당한 관리 ID 사용

Azure Storage 또는 Azure Container Registry와 같은 컴퓨팅 노드에서 직접 다른 Azure 리소스에 액세스하는 많은 Azure Batch 함수는 관리 ID를 지원합니다. Azure Batch에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 다음 링크를 참조하세요.

관리 ID가 관리 ID를 지원하는 Azure 리소스에 직접 액세스할 수 있도록 작업을 수동으로 구성할 수도 있습니다.

Batch 노드 내에서 관리 ID 토큰을 가져오고 이를 사용하여 Azure Instance Metadata Service를 통해 Microsoft Entra 인증을 통해 인증할 수 있습니다.

Windows의 경우 인증할 액세스 토큰을 가져오는 PowerShell 스크립트는 다음과 같습니다.

$Response = Invoke-RestMethod -Uri 'http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource={Resource App Id Url}' -Method GET -Headers @{Metadata="true"}

Linux의 경우 Bash 스크립트는 다음과 같습니다.

curl 'http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource={Resource App Id Url}' -H Metadata:true

자세한 내용은 Azure VM에서 Azure 리소스에 대한 관리 ID를 사용하여 액세스 토큰을 획득하는 방법을 참조하세요.

다음 단계

Azure 리소스에 대한 관리 ID에 대해 자세히 알아봅니다.
사용자 관리 ID에서 고객 관리형 키를 사용하는 방법에 대해 알아봅니다.
배치 풀에서 자동 인증서 순환을 사용하도록 설정하는 방법에 대해 알아봅니다.

다음을 통해 공유