이 문서에서는 Bicep 템플릿을 사용하여 관리형 DevOps 풀을 만들고 새 풀에서 파이프라인을 실행하는 방법을 보여 줍니다.
필수 조건
이 문서의 단계를 완료하기 전에 필수 구성 요소 문서에 설명된 대로 관리형 DevOps 풀에서 사용할 Azure 구독 및 Azure DevOps 조직을 구성했습니다. 이러한 단계는 Azure 구독 및 Azure DevOps 조직당 한 번만 완료해야 합니다.
Azure CLI에 로그인
명령 프롬프트를 열고(Windows에서 Windows 명령 프롬프트 또는 PowerShell 사용) 다음 명령을 실행합니다.
Azure CLI에 로그인합니다.
az login둘 이상의 Azure 구독이 있는 경우 기본 Azure 구독을 설정합니다.
az account set --subscription "My subscription name"구독 목록을 얻으려면 다음 명령을 실행하면 됩니다.
az account list -o table테넌트가 여러 개 있거나 Azure CLI를 사용하여 Azure 구독을 사용하는 방법에 대한 자세한 내용은 Azure CLI를 사용하여 Azure 구독을 관리하는 방법을 참조하세요.
리소스 그룹 만들기
관리되는 DevOps 풀 및 기타 리소스를 포함할 리소스 그룹을 만듭니다. 리소스 그룹에 사용할 이름과 리소스 그룹을
<location>만들려는 Azure 지역으로 바꿉<resourceGroupName>니다.az group create --name <resourceGroupName> --location <location>
템플릿 검토 및 저장
다음 내용을 사용하여 로컬 파일 이름 mdp-azure-deploy.bicep 을 만듭니다. 이 파일은 종속성
Microsoft.DevCenter/devcenters리소스 및Microsoft.DevCenter/projects리소스를 포함하여 리소스를 만드는 매개 변수가 있는Microsoft.DevOpsInfrastructure/poolsBicep 템플릿입니다.@minLength(3) @maxLength(44) param poolName string @maxLength(26) param devCenterName string param devCenterProjectName string param adoOrg string param imageName string param poolSize int param location string = 'eastus' resource devCenter 'Microsoft.DevCenter/devcenters@2025-02-01' = { name: devCenterName location: location } resource devCenterProject 'Microsoft.DevCenter/projects@2025-02-01' = { name: devCenterProjectName location: location properties: { devCenterId: devCenter.id } } resource pool 'microsoft.devopsinfrastructure/pools@2025-09-20' = { name: poolName location: location properties: { organizationProfile: { organizations: [ { url: adoOrg parallelism: 1 } ] permissionProfile: { kind: 'CreatorOnly' } kind: 'AzureDevOps' } devCenterProjectResourceId: devCenterProject.id maximumConcurrency: poolSize agentProfile: { kind: 'Stateless' } fabricProfile: { sku: { name: 'Standard_D2ads_v5' } images: [ { wellKnownImageName: imageName buffer: '*' } ] kind: 'Vmss' } } }mdp-azure-deploy-parameters.bicepparam이라는 다른 로컬 파일을 만들고 첫 번째 파일과 동일한 폴더에 저장합니다. 환경의 세부 정보와 일치하도록 다음 속성을 업데이트합니다.
매개 변수 가치 poolName원하는 풀 이름으로 업데이트 value합니다. 이름은 영숫자 또는 영숫자 문자.-_로 구성되어야 하며 길이는 3~44자 사이여야 합니다. 이름은 Azure에서 전역적으로 고유해야 합니다.devCenterName개발자 센터의 원하는 이름으로 업데이트 value합니다.devCenterProjectName개발자 센터 프로젝트의 원하는 이름으로 업데이트 value합니다.adoOrgvalue를 Azure DevOps 조직의 이름으로 업데이트하고your-organization를 바꾸십시오.imageName이 예제는 Azure Pipelines 이미지를 사용하도록 구성되고 Windows Server 2022 이미지를 사용합니다. 변경하려면 Azure Pipelines 이미지 미리 정의된 별칭 중에서 선택합니다. 관리형 DevOps 풀은 Azure Compute 갤러리 이미지 및 선택한 마켓플레이스 이미지도 지원합니다. 이러한 이미지 유형에 대한 관리형 DevOps 풀 리소스를 구성하는 방법에 대한 자세한 내용은 관리형 DevOps 풀 이미지 구성을 참조 하세요. poolSize동시 작업을 실행할 수 있는 최대 에이전트 수로 업데이트 value합니다. 이 예제에서는 다음과 같습니다poolSize1.location풀의 Azure 지역입니다. 이 예제에서 지역은 eastus입니다.using './mdp-azure-deploy.bicep' param poolName = '<pool-name>' param devCenterName = '<dev-center-name>' param devCenterProjectName = '<dev-center-project-name>' param adoOrg = 'https://dev.azure.com/fabrikam' param location = 'eastus' param imageName = 'windows-2022' param poolSize = 1
관리형 DevOps 풀 만들기
명령 프롬프트를 열고(Windows에서 Windows 명령 프롬프트 또는 PowerShell 사용) 다음 명령을 실행합니다. 첫 번째 절차의 Azure CLI 세션이 여전히 활성 상태인 경우 처음 두 명령을 건너뛸 수 있습니다.
Azure CLI에 로그인합니다.
az login둘 이상의 Azure 구독이 있는 경우 기본 Azure 구독을 설정합니다.
az account set --subscription "My subscription name"구독 목록을 얻으려면 다음 명령을 실행하면 됩니다.
az account list -o table테넌트가 여러 개 있거나 Azure CLI를 사용하여 Azure 구독을 사용하는 방법에 대한 자세한 내용은 Azure CLI를 사용하여 Azure 구독을 관리하는 방법을 참조하세요.
이전 단계에서 mdp-azure-deploy.bicep 및 mdp-azure-deploy-parameters.bicepparam 파일을 저장한 경우 폴더로 이동합니다. 이 예제에서는 파일이 .에
C:\examples저장됩니다.cd c:\examples관리되는 DevOps 풀을 만듭니다. 첫 번째 단계에서 만든 리소스 그룹으로
<resourceGroupName>을(를) 바꿉니다.az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.bicep --parameters mdp-azure-deploy-parameters.bicepparam구독에 원하는 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 Portal에서 만든 풀 보기
- Azure Portal에 로그인합니다.
- 관리형 DevOps 풀을 검색하고 사용 가능한 옵션에서 선택합니다.
- 목록에서 새 관리형 DevOps 풀을 선택합니다.
Azure DevOps에서 에이전트 풀 보기
Azure DevOps 포털로 이동하여 Azure DevOps 조직(
https://dev.azure.com/{your-organization})에 로그인합니다.Azure DevOps의 >으로 이동합니다.
Pipelines>에이전트 풀로 이동하여 새 풀이 나열되었는지 확인합니다. 관리되는 DevOps 풀을 방금 만든 경우 새 풀이 에이전트 목록에 표시되는 데 몇 분 정도 걸릴 수 있습니다.
새 풀에서 파이프라인 실행
이 단계에서는 Azure DevOps 프로젝트의 기본 리포지토리에 간단한 파이프라인을 만들고 새 관리형 DevOps 풀에서 실행합니다.
Azure DevOps 포털로 이동하여 Azure DevOps 조직(
https://dev.azure.com/{your-organization})에 로그인합니다.파이프라인을 실행하려는 프로젝트로 이동하고 파이프라인을 선택합니다.
새 파이프라인(또는 첫 번째 파이프라인인 경우 파이프라인 만들기)을 선택합니다.
Azure Repos Git을 선택합니다.
프로젝트와 이름이 같은 리포지토리를 선택합니다. 이 예제에서는 프로젝트 이름이 FabrikamFiber이므로 이름이 같은 리포지토리를 선택합니다.
시작 파이프라인을 선택합니다.
기본적으로 시작 템플릿은 Microsoft 호스팅 Linux 에이전트를 사용합니다. 파이프라인 템플릿을 편집하고
pool섹션을 이전 단계에서 만든 풀을 참조하도록 변경합니다.# Change these two lines as shown in the following example. pool: vmImage: ubuntu-latest이 예제에서는 Managed DevOps 풀의 이름이
fabrikam-managed-pool로 지정되어 있습니다. 따라서vmImage: ubuntu-latest을name: fabrikam-managed-pools로 교체하고, 본인의 Managed DevOps 풀 이름을 지정하십시오.# Replace fabrikam-managed-pools with the name # of your Managed DevOps Pool. pool: name: fabrikam-managed-pool저장 및 실행을 선택하고, 확인을 위해 저장 및 실행을 두 번째로 선택합니다.
이 풀에서 첫 번째 파이프라인 실행인 경우 파이프라인이 실행되기 전에 권한을 부여하라는 메시지가 표시될 수 있습니다. 자세한 내용은 이 파이프라인을 계속 실행하려면 리소스에 액세스할 수 있는 권한이 필요합니다.
Azure DevOps에서 파이프라인 실행을 확인하고 Azure Portal로 전환하고 에이전트 보기에서 실행 중인 에이전트를 볼 수 있습니다.
자원을 정리하세요
빠른 시작을 완료한 경우 계속 사용하지 않으려면 만든 리소스를 삭제합니다.
Managed DevOps 풀, 개발자 센터 및 개발자 센터 프로젝트를 삭제하려면 그것들이 포함된 리소스 그룹을 삭제하여 삭제할 수 있습니다.