이 문서에서는 관리형 DevOps 풀 인스턴스의 기본 설정을 구성하는 방법을 설명합니다.
개요
풀 설정의 개요를 보려면 개요로 이동합니다.
개요에서 다음을 수행할 수 있습니다.
풀 설정
풀을 구성하려면 설정이동합니다.
풀을 구성하려면 다음 설정을 사용합니다.
개발자 센터 프로젝트
풀에 대한 개발자 센터 프로젝트 인스턴스를 선택합니다. (없는 경우 풀을 만들 때 개발자 센터 인스턴스 및 개발자 센터 프로젝트 인스턴스를 만들 수 있습니다.)
이 속성은 devCenterProjectResourceId개발자 센터 프로젝트 인스턴스를 지정합니다.
{
"$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",
"location": "eastus",
"tags": {},
"properties": {
...
"devCenterProjectResourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
}
}
]
}
devCenterProjectResourceId 인스턴스의 개요 페이지에서 JSON 보기를 사용하여 Azure Portal에서 개발자 센터 프로젝트 인스턴스의 값을 검색할 수 있습니다. Azure CLI를 사용하여 해당 속성에 대한 id 프로젝트를 쿼리하여 검색할 수도 있습니다.
다음 예제에서는 라는 fabrikam-dev-center-project 인스턴스에서 fabrikam-managed-devops-pools 그룹의 devCenterProjectResourceId 값을 검색합니다.
az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"
이 매개 변수는 devcenter-project-id 풀을 만들거나 업데이트할 때 개발자 센터 프로젝트 인스턴스를 지정합니다.
az mdp pool create \
--devcenter-project-id /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resourceGroupName/providers/Microsoft.DevCenter/projects/devCenterProjectName
# other parameters omitted for space
devcenter-project-id 인스턴스의 개요 페이지에서 JSON 보기를 사용하여 Azure Portal에서 개발자 센터 프로젝트 인스턴스를 검색할 수 있습니다. Azure CLI를 사용하여 해당 속성에 대한 id 프로젝트를 쿼리하여 검색할 수도 있습니다.
다음 예제에서 devcenter-project-id는 리소스 그룹 내에 있는 이름의 fabrikam-dev-center-project 인스턴스에서 fabrikam-managed-devops-pools 가져옵니다.
az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"
이 속성은 devCenterProjectResourceId개발자 센터 프로젝트 인스턴스를 지정합니다.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
...
devCenterProjectResourceId: '/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project'
}
}
devCenterProjectResourceId 인스턴스의 개요 페이지에서 JSON 보기를 사용하여 Azure Portal에서 개발자 센터 프로젝트 인스턴스를 검색할 수 있습니다. Azure CLI를 사용하여 해당 속성에 대한 id 프로젝트를 쿼리하여 검색할 수도 있습니다.
다음 예제에서는 리소스 그룹 내의 개발자 센터 프로젝트 인스턴스인 fabrikam-dev-center-project에서 devCenterProjectResourceId이 검색됩니다.
az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"
Azure DevOps 조직
단일 Azure DevOps 조직에 대해 풀을 구성한 경우 풀 설정에서 조직을 지정할 수 있습니다.
여러 조직에 대해 풀을 구성한 경우 Azure DevOps 조직 설정이 풀 설정에 없습니다. 여러 조직에서 사용할 풀을 구성하려면 Settings>로 이동하여 여러 조직에서 풀 사용을 구성합니다.
organizationProfile 섹션의 organizations 목록을 사용하여 Azure DevOps 조직 값을 구성할 수 있습니다.
다음 예제에서는 단일 조직의 모든 프로젝트에 대해 풀이 구성되며 병렬 처리는 4입니다. 여러 조직을 구성하는 방법을 보여 주는 예제는 여러 조직에서 풀 사용을 참조하세요.
{
"$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": "2025-09-20",
"location": "eastus",
"properties": {
...
"organizationProfile": {
"organizations": [
{
"url": "https://dev.azure.com/fabrikam-tailspin",
"projects": [],
"parallelism": 4
}
]
}
}
}
]
}
Azure DevOps 조직 값은 organizationsorganization-profile 매개 변수의 목록을 사용하여 구성할 수 있습니다.
다음 예제에서는 단일 조직의 모든 프로젝트에 대해 풀이 구성되며 병렬 처리는 4입니다. 여러 조직을 구성하는 방법을 보여 주는 예제는 여러 조직에서 풀 사용을 참조하세요.
az mdp pool create \
--organization-profile organization-profile.json
# other parameters omitted for space
다음 예제에서는 organization-profile.jsonorganizations목록을 보여줍니다.
{
"AzureDevOps": {
"organizations": [
{
"url": "https://dev.azure.com/fabrikam-tailspin",
"projects": [],
"parallelism": 4
}
],
"permissionProfile": {...}
}
}
organizationProfile
organizations
Azure DevOps 조직 값을 구성할 수 있습니다.
다음 예제에서는 단일 조직의 모든 프로젝트에 대해 풀이 구성되며 병렬 처리는 4입니다.
여러 조직을 구성하는 방법을 보여 주는 예제는 여러 조직에서 풀 사용을 참조하세요.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
...
organizationProfile: {
organizations: [
{
url: 'https://dev.azure.com/fabrikam-tailspin'
projects: []
parallelism: 4
}
]
}
}
}
기본적으로 풀은 지정된 조직의 모든 프로젝트에서 사용할 수 있습니다. 풀을 특정 프로젝트로 제한하려면 보안 설정: 조직 액세스 구성을 참조하세요.
최대 에이전트
풀에서 동시에 프로비전할 수 있는 최대 에이전트 수를 지정합니다. 예를 들어 최대 에이전트 값을 2로 지정하는 경우 동시에 최대 2개의 에이전트를 실행할 수 있습니다. 두 개 이상의 작업이 큐에 대기 중인 경우 두 개의 에이전트만 작업을 실행하고 다른 작업은 대기합니다.
에이전트 창을 사용하여 풀에서 프로비전된 에이전트의 현재 상태 및 수를 볼 수 있습니다 . 에이전트 보기의 모든 에이전트 ( 반환 된 상태의 에이전트 제외)는 가상 머신 리소스에서 실행되며 최대 에이전트 수로 계산됩니다.
기존 풀에 대한 풀 설정 및 풀을 만들 때 기본 사항 탭에서 최대 에이전트 값을 구성할 수 있습니다.
속성을 사용하여 maximumConcurrency 값을 구성할 수 있습니다.
다음 예제에서 최대 에이전트 값은 .입니다 4.
{
"$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": "2025-09-20",
"location": "eastus",
"properties": {
...
"maximumConcurrency": 4
}
}
]
}
풀을 만들거나 maximum-concurrency할 때 매개 변수를 사용하여 최대 에이전트 값을 구성할 수 있습니다.
다음 예제에서 최대 에이전트 값은 .입니다 4.
az mdp pool create \
--maximum-concurrency 4
# other parameters omitted for space
속성을 사용하여 maximumConcurrency 값을 구성할 수 있습니다.
다음 예제에서 최대 에이전트 값은 .입니다 4.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
...
maximumConcurrency: 4
}
}
참고 항목
최대 에이전트 값은 동시에 프로비전할 수 있는 최대 에이전트 수를 구성하지만 조직의 자체 호스팅 병렬 작업 수는 동시에 실행할 수 있는 작업 수를 지정합니다. 에이전트가 작업을 실행할 수 있도록 조직에서 사용할 수 있는 자체 호스팅 병렬 작업이 충분한지 확인합니다. 자세한 내용은 Azure DevOps Services 병렬 작업 가격 책정을 참조 하세요.
에이전트 크기
에이전트 크기 설정은 관리형 DevOps 풀 에이전트를 호스트하는 데 사용할 Azure 가상 머신 크기를 지정합니다.
Azure 지역에서 사용할 수 있는 Azure 가상 머신 크기를 보고 선택하려면 크기 변경을 선택합니다. 사용 가능한 관리형 DevOps 풀 할당량이 있는 SKU(에이전트 크기)는 사용 가능한 것으로 표시됩니다. 사용할 수 없음으로 표시된 SKU에 대해 더 많은 할당량을 요청할 수 있습니다.
사용할 수 없는 SKU에 대한 할당량 요청이 승인되면 사용 가능으로 표시됩니다.
관리형 DevOps 풀 할당량에 대해 자세히 알아봅니다.
fabricProfile 섹션에서 sku 속성을 사용하여 에이전트 크기를 구성할 수 있습니다. 다음 예제 Standard_D2ads_v5 에서는 VM 크기가 지정됩니다.
{
"$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": "2025-09-20",
"location": "eastus",
"properties": {
...
"fabricProfile": {
"sku": {
"name": "Standard_D2ads_v5"
}
}
}
}
]
}
풀을 sku거나 fabricProfile할 때 섹션의 속성을 사용하여 에이전트 크기를 구성할 수 있습니다. 다음 예제 Standard_D2ads_v5 에서는 VM 크기가 지정됩니다.
az mdp pool create \
--fabric-profile fabric-profile.json
# other parameters omitted for space
다음 예제에서는 sku 부분이 있는 fabric-profile.json 파일을 보여 줍니다.
{
"vmss": {
"sku": {
"name": "Standard_D2ads_v5"
},
"images": [...],
"osProfile": {...},
"storageProfile": {...}
}
}
sku 속성을 fabricProfile 섹션에서 사용하여 에이전트 크기를 구성할 수 있습니다. 다음 예제 Standard_D2ads_v5 에서는 VM 크기가 지정됩니다.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
fabricProfile: {
...
sku: {
name: 'Standard_D2ads_v5'
}
}
}
}
구독에 Azure VM SKU를 사용하여 풀을 구성할 수 있는 용량이 없고 사용자가 지정한 최대 에이전트 수가 없는 경우 다음과 같은 오류 메시지가 표시됩니다.
Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97
이 문제를 해결하려면 관리 DevOps 풀 할당량 검토를 참조하세요.
모든 Azure 지역에 대해 모든 SKU가 지원되는 것은 아닙니다. 다음과 같은 SKU family <sku-family> is not available in location <region>오류가 표시되면 해당 지역에 대해 SKU 크기가 지원되는지 확인합니다. 자세한 내용은 Azure의 가상 머신 크기 및 지역별 사용 가능한 제품을 참조하세요.
OS 디스크 유형
관리형 DevOps 풀은 OS 디스크에 대해 다음과 같은 디스크 유형을 제공합니다.
기본 OS 디스크 유형은 Standard입니다. 워크로드의 처리량이 표준 계층 수준을 초과하는 경우 더 성능이 뛰어난 디스크 유형으로 업그레이드하여 워크로드의 성능 향상을 얻을 수 있습니다. 디스크 유형 및 성능에 대한 자세한 내용은 Azure 관리 디스크 유형을 참조하세요.
기존 풀에 대한 풀 설정에서 OS 디스크 유형을 구성할 수 있습니다. 풀을 만들 때 기본 탭에서 OS 디스크 유형을 구성할 수 있습니다.
섹션의 속성을 osDiskStorageAccountType 사용하여 storageProfile 구성할 수 있습니다.
표준, StandardSSD 또는 프리미엄을 선택합니다.
다음 예제에서는 표준 OS 디스크 유형이 지정됩니다.
{
"$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": "2025-09-20",
"location": "eastus",
"properties": {
...
"storageProfile": {
"osDiskStorageAccountType": "Standard"
}
}
}
]
}
매개 변수의 섹션 에 osDiskStorageAccountType 있는 storageProfile 속성을 사용하여 fabric-profile 구성할 수 있습니다.
표준, StandardSSD 또는 프리미엄을 선택합니다. 다음 예제 에서는 표준 OS 디스크 유형이 지정됩니다.
az mdp pool create \
--fabric-profile fabric-profile.json
# other parameters omitted for space
다음 예제는 storageProfile 파일의 fabric-profile.json 섹션을 보여줍니다.
{
"vmss": {
"sku": {...},
"images": [...],
"osProfile": {...},
"storageProfile": {
"osDiskStorageAccountType": "Standard",
"dataDisks": []
}
}
}
섹션의 속성을 osDiskStorageAccountType 사용하여 storageProfile 구성할 수 있습니다.
표준, StandardSSD 또는 프리미엄을 선택합니다. 다음 예제 에서는 표준 OS 디스크 유형이 지정됩니다.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
fabricProfile: {
...
storageProfile: {
osDiskStorageAccountType: 'Standard'
}
}
}
}
이미지
관리형 DevOps 풀은 풀에서 파이프라인을 실행하는 데 사용할 수 있는 몇 가지 VM 이미지 옵션을 제공합니다. 선택한 마켓플레이스 VM 이미지, Azure Compute 갤러리 인스턴스의 사용자 지정 이미지 또는 Azure Pipelines Microsoft 호스팅 에이전트에서 사용하는 것과 동일한 Windows 및 Linux 이미지를 사용하여 풀을 만들 수 있습니다.
단일 이미지 또는 여러 이미지를 사용하도록 풀을 구성할 수 있습니다. 별칭을 사용하여 특정 이미지를 사용하도록 파이프라인을 구성할 수도 있습니다. 자세한 내용은 관리형 DevOps 풀 이미지 구성을 참조 하세요.
중요하다
풀에 여러 이미지가 있고 파이프라인의 요구를 사용하여 이미지를 지정하지 않는 경우 파이프라인은 풀에 나열된 첫 번째 이미지를 사용하여 실행됩니다. 다음과 같은 방법으로 풀의 이미지 순서를 변경할 수 있습니다.
-
템플릿 사용:
fabricProfile 내 images에서 이미지의 순서를 변경합니다.
- 끌기 사용: Azure Portal의 이미지 목록에서 이미지 순서를 지정합니다.
관련 콘텐츠