관리형 DevOps 풀 이미지 구성

관리형 DevOps 풀은 풀에서 파이프라인을 실행하기 위한 가상 머신 이미지에 대한 몇 가지 옵션을 제공합니다. 선택한 Azure Marketplace VM 이미지를 사용하여 풀을 만들거나, 사용자 지정 Azure Compute 갤러리 이미지를 사용하거나, Azure Pipelines Microsoft 호스팅 에이전트와 동일한 이미지를 사용할 수 있습니다.

관리형 DevOps 풀은 단일 이미지 또는 여러 이미지로 구성할 수 있습니다. 풀에 여러 이미지가 있는 경우 파이프라인은 별칭을 사용하여 실행할 이미지를 지정합니다.

풀의 이미지 선택

Azure Portal

관리형 DevOps 풀을 만들 때 기본 이미지가 선택됩니다. 기본 선택을 유지하거나 풀을 만드는 동안 변경할 수 있습니다. 풀을 만든 후 이미지를 구성하려면 설정>풀로 이동하여 이미지 라이브러리에서 추가를 선택하고 풀에 대해 하나 이상의 이미지를 선택합니다.

ARM 템플릿

이미지는 관리되는 DevOps 풀 리소스 속성의 섹션에서 구성 fabricProfile 됩니다.

다음 예제에서는 세 개의 이미지를 지정합니다. 이미지의 스키마에 대한 자세한 내용은 이 문서의 다음 섹션을 참조하세요.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    ...
                    "images": [
                        {
                            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
                            "aliases": [
                                "ubuntu-20.04-gen2"
                            ]
                        },
                        {
                            "wellKnownImageName": "windows-2022"
                        },
                        {
                            "wellKnownImageName": "ubuntu-22.04"
                        }
                    ]
                }
            }
        }
    ]
}

각 이미지에는 다음 속성이 있을 수 있습니다.

속성	설명
aliases	별칭의 선택적 목록입니다. 그런 다음 이미지의 전체 리소스 ID 대신 별칭을 사용하여 이미지를 참조할 수 있습니다.
resourceID	사용할 이미지의 리소스 ID입니다. Azure Compute 갤러리 이미지 또는 선택한 마켓플레이스 이미지를 사용할 때 필요합니다.
wellKnownImageName	Azure Pipelines 이미지의 별칭입니다. Azure Pipelines 이미지를 사용할 때 필요합니다.
buffer	대기 에이전트를 사용하도록 설정 buffer 하면 이 이미지에 할당할 대기 에이전트의 비율을 지정합니다. 모든 이미지 buffer 값의 합계는 100과 같아야 합니다.

다음 예제에서는 세 개의 이미지를 정의합니다. 대기 에이전트는 이미지에 할당 windows-2022 된 대기 에이전트의 100%를 사용하여 사용하도록 설정됩니다.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ],
        "buffer": "0"
    },
    {
        "buffer": "100",
        "wellKnownImageName": "windows-2022"
    },
    {
        "buffer": "0",
        "wellKnownImageName": "ubuntu-22.04"
    }
]

Azure CLI

이미지는 관리되는 DevOps 풀 리소스 속성의 섹션에서 구성 fabric-profile 됩니다.

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

다음 예제에서는 fabric-profile.json 파일의 섹션을 보여 images 줍니다 및 세 개의 이미지를 지정합니다. 이미지의 스키마에 대한 자세한 내용은 이 문서의 다음 섹션을 참조하세요.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
            "aliases": [
                "ubuntu-20.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

각 이미지에는 다음 속성이 있을 수 있습니다.

속성	설명
aliases	별칭의 선택적 목록입니다. 그런 다음 이미지의 전체 리소스 ID 대신 별칭을 사용하여 이미지를 참조할 수 있습니다.
resourceID	사용할 이미지의 리소스 ID입니다. Azure Compute 갤러리 이미지 또는 선택한 마켓플레이스 이미지를 사용할 때 필요합니다.
wellKnownImageName	Azure Pipelines 이미지의 별칭입니다. Azure Pipelines 이미지를 사용할 때 필요합니다.
buffer	대기 에이전트를 사용하도록 설정 buffer 하면 이 이미지에 할당할 대기 에이전트의 비율을 지정합니다. 모든 이미지 buffer 값의 합계는 100과 같아야 합니다.

다음 예제에서는 세 개의 이미지를 정의합니다. 대기 에이전트는 이미지에 할당 windows-2022 된 대기 에이전트의 100%를 사용하여 사용하도록 설정됩니다.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
            "aliases": [
                "ubuntu-20.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

단일 이미지를 선택하는 경우 풀에서 실행되는 모든 파이프라인은 해당 이미지를 사용합니다. 여러 이미지를 선택하는 경우 파이프라인별로 사용할 이미지를 지정할 수 있습니다. 자세한 내용은 풀당 여러 이미지 사용을 참조 하세요.

다음 유형의 이미지 중에서 선택할 수 있습니다.

• Azure Pipelines 이미지 - Microsoft 호스팅 에이전트에서 사용하는 것과 동일한 이미지 중에서 선택합니다.
• 선택한 마켓플레이스 이미지 - 큐레이팅된 Microsoft 게시된 Azure Marketplace VM 이미지 집합 중에서 선택합니다.
• Azure Compute 갤러리 이미지 - 사용자 고유의 Azure Compute Gallery 이미지 중에서 선택합니다. 사용하려는 Azure Compute 갤러리 이미지의 DevOpsInfrastructure 서비스 주체에 읽기 권한자 역할을 할당해야 합니다. 자세한 내용은 DevOpsInfrastructure 서비스 주체에 대한 읽기 권한자 역할 액세스 권한 부여를 참조 하세요.

Azure Pipelines 이미지

관리형 DevOps 풀은 Azure Pipelines에 대해 선택한 Microsoft 호스팅 에이전트와 동일한 소프트웨어가 있는 미리 구성된 여러 이미지를 제공합니다.

Azure Portal

ARM 템플릿

Azure Pipelines 이미지를 지정하려면 속성을 사용하여 이미지의 별칭을 wellKnownImageName 제공합니다. Azure Pipelines 이미지 미리 정의된 별칭 목록을 참조하세요.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

Azure CLI

Azure Pipelines 이미지를 지정하려면 속성을 사용하여 이미지의 별칭을 wellKnownImageName 제공합니다. Azure Pipelines 이미지 미리 정의된 별칭 목록을 참조하세요.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

각 이미지에는 다음과 같은 설치된 소프트웨어가 포함되어 있습니다.

이미지	포함된 소프트웨어
Azure Pipelines - Windows Server 2022	포함된 소프트웨어
Azure Pipelines - Windows Server 2019	포함된 소프트웨어
Azure Pipelines - Ubuntu 22.04	포함된 소프트웨어
Azure Pipelines - Ubuntu 20.04	포함된 소프트웨어

선택한 마켓플레이스 이미지

관리형 DevOps 풀은 풀에서 사용할 수 있는 큐레이팅된 Microsoft 게시된 Azure Marketplace VM 이미지 집합을 제공합니다.

Azure Portal

선택한 마켓플레이스 이미지를 선택하고, 원하는 이미지를 선택하고, 원하는 버전을 선택합니다. 항상 최신 버전의 이미지를 사용하려면 최신 버전을 선택합니다.

ARM 템플릿

선택한 마켓플레이스 이미지를 지정하려면 속성을 사용하여 이미지의 리소스 ID를 resourceId 제공합니다.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Azure CLI

선택한 마켓플레이스 이미지를 지정하려면 속성을 사용하여 이미지의 리소스 ID를 resourceId 제공합니다.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Azure Compute 갤러리 이미지

Azure Compute 갤러리 이미지를 선택하여 구독에서 사용할 수 있는 모든 Azure Compute Gallery에서 이미지를 지정합니다. 다음 운영 체제가 있는 일반화된 이미지가 지원됩니다.

• Windows Server 2019
• Windows Server 2022
• Windows 11
• Ubuntu 20.04
• Ubuntu 22.04
• Ubuntu 24.04
• Debian 9
• RHEL 8
• RHEL 9
• SUSE 12
• SUSE 15

Important

관리형 DevOps 풀은 일반화된 Azure Compute 갤러리 이미지만 지원합니다.

Azure Portal

ARM 템플릿

Azure Compute 갤러리 이미지를 지정하려면 속성을 사용하여 이미지의 리소스 ID를 resourceId 제공합니다.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Azure CLI

선택한 마켓플레이스 이미지를 지정하려면 속성을 사용하여 이미지의 리소스 ID를 resourceId 제공합니다.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

DevOpsInfrastructure 서비스 주체에 대한 읽기 권한자 역할 액세스 권한 부여

Important

사용하려는 Azure Compute 갤러리 이미지에 대한 DevOpsInfrastructure 서비스 주체에 읽기 권한자 역할을 할당합니다. 이 액세스 권한이 구성되지 않은 Azure Compute 갤러리 이미지를 선택하면 풀 만들기가 실패합니다. 이미지 수준에서 개별적으로 또는 갤러리의 모든 이미지에 대해 이미지 갤러리 수준에서 읽기 권한자 역할을 할당할 수 있습니다.

1. Azure Portal에서 원하는 리소스로 이동합니다. 갤러리의 모든 이미지를 사용하려면 Azure Portal의 Azure Compute 갤러리로 이동합니다. 특정 이미지만 사용하려면 해당 이미지로 이동합니다.

2. 액세스 제어(IAM) 를 선택합니다.

3. 추가>역할 할당 추가를 선택하여 역할 할당 추가 페이지를 엽니다.

4. 다음 역할을 할당합니다. 세부 단계에 대해서는 Azure Portal을 사용하여 Azure 역할 할당을 참조하세요.

   설정	값
   역할	판독기
   액세스 할당 대상:	서비스 주체
   멤버	DevOpsInfrastructure

   

별칭이 있는 풀당 여러 이미지 사용

풀에 이미지가 여러 개 있는 경우 해당 이미지의 별칭을 참조하여 특정 이미지를 사용하도록 Azure DevOps 파이프라인을 구성할 수 있습니다.

이미지 별칭 구성

Azure Portal

이미지 별칭을 추가하고 관리하려면 풀 설정의 이미지 섹션으로 이동하여 ..., 별칭 추가를 선택합니다.

별칭 목록에 원하는 별칭을 추가하고 저장을 선택합니다.

다음 예제에서는 두 개의 Azure Pipelines 이미지와 선택한 마켓플레이스 이미지가 있는 풀을 보여 줍니다. Azure Pipeline 이미지에는 기본 별칭이 표시되고 선택한 마켓플레이스 이미지에는 ubuntu-20.04-gen2라는 단일 구성된 별칭이 있습니다.

ARM 템플릿

별칭을 구성하려면 목록에서 별칭을 aliases 지정합니다. 다음 예제에서는 이름이 ubuntu-20.04-gen2단일 별칭으로 한 이미지를 정의합니다.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ]
    }
]

Azure CLI

별칭을 구성하려면 목록에서 별칭을 aliases 지정합니다. 다음 예제에서는 이름이 ubuntu-20.04-gen2단일 별칭으로 한 이미지를 정의합니다.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ]
    }
]

Azure Pipelines 이미지 미리 정의된 별칭

구성하는 별칭 외에도 Azure Pipelines 이미지에는 다음과 같은 미리 정의된 별칭이 있습니다.

Azure Pipelines 이미지	미리 정의된 별칭
Azure Pipelines - Windows Server 2022	windows-2022
Azure Pipelines - Windows Server 2019	windows-2019
Azure Pipelines - Ubuntu 22.04	ubuntu-22.04
Azure Pipelines - Ubuntu 20.04	ubuntu-20.04

요구 사항을 사용하여 이미지 지정

풀에 이미지가 여러 개 있는 경우 명명ImageOverride된 수요를 사용하여 특정 이미지에서 실행되도록 파이프라인을 구성할 수 있습니다. 파이프라인에서 ImageOverride 수요를 지정하면 관리형 DevOps 풀은 해당 이미지를 사용하는 에이전트에게만 작업을 보냅니다.

별칭이 있는 ubuntu-20.04-gen2 이전 예제의 Ubuntu 20.04 이미지에서 파이프라인을 실행하려면 파이프라인 섹션에서 다음 요구를 pool 지정합니다.

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals ubuntu-20.04-gen2

Important

이름에 공백이 있더라도 별칭 이름 ImageOverride 주위에 따옴표를 지정하지 마세요.

풀에서 Azure Pipelines 이미지를 사용하여 파이프라인을 실행하려면 이전 테이블의 별칭을 사용합니다. 이전 예제의 Azure Pipelines Windows Server 2022 이미지에서 파이프라인을 실행하려면 파이프라인 섹션에서 다음 요구를 pool 지정합니다.

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals windows-2022

참고 항목

• 풀 설정 구성