Este artigo descreve como definir as configurações básicas da sua instância de Managed DevOps Pools.
Visão geral
Para ver uma visão geral das configurações do pool, vá para Visão geral.
Na visão geral, você pode:
Configurações do pool
Para configurar seu pool, vá para Pool de configurações>.
Para configurar o seu pool, utilize as seguintes definições:
Projeto do Centro de Desenvolvimento
Selecione a instância do projeto do Centro de Desenvolvimento para seu pool. (Se você não tiver uma, poderá criar uma instância do Centro de Desenvolvimento e uma instância do projeto do Centro de Desenvolvimento ao criar seu pool.)
A devCenterProjectResourceId propriedade especifica a instância do projeto Centro de Desenvolvimento .
{
"$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"
}
}
]
}
Você pode recuperar o valor de uma instância de projeto do Centro de Desenvolvimento no portal do Azure, usando a Visualização JSON a partir da página de visão geral da sua instância de projeto do Centro de Desenvolvimento. Você também pode recuperá-lo usando a CLI do Azure para consultar a propriedade id do projeto.
No exemplo a seguir, o devCenterProjectResourceId valor é recuperado de uma instância de projeto do Centro de Desenvolvimento nomeada fabrikam-dev-center-project no fabrikam-managed-devops-pools grupo de recursos.
az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"
O devcenter-project-id parâmetro especifica a instância do projeto do Centro de Desenvolvimento quando você cria ou atualiza um pool.
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
Você pode recuperar o devcenter-project-id para a sua instância do Centro de Dev no portal do Azure usando o Modo de Exibição JSON da página Visão Geral da sua instância do Centro de Dev. Você também pode recuperá-lo usando a CLI do Azure para consultar a propriedade id do projeto.
No exemplo a seguir, o devcenter-project-id é recuperado de uma instância de projeto do Centro de Desenvolvimento nomeada fabrikam-dev-center-project no fabrikam-managed-devops-pools grupo de recursos.
az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"
A devCenterProjectResourceId propriedade especifica a instância do projeto Centro de Desenvolvimento .
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'
}
}
Você pode recuperar o devCenterProjectResourceId da sua instância do projeto do Centro de Desenvolvimento no portal do Azure usando o Modo de Exibição JSON na página Visão Geral da sua instância do projeto do Centro de Desenvolvimento. Você também pode recuperá-lo usando a CLI do Azure para consultar a propriedade id do projeto.
No exemplo a seguir, o devCenterProjectResourceId é recuperado de uma instância de projeto do Centro de Desenvolvimento nomeada fabrikam-dev-center-project no fabrikam-managed-devops-pools grupo de recursos.
az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"
Organização do Azure DevOps
Se você configurou seu pool para uma única organização do Azure DevOps, poderá especificar a organização nas configurações do pool.
Se você configurou seu pool para várias organizações, a configuração da organização do Azure DevOps não estará presente nas configurações do pool. Para configurar seu pool para uso em várias organizações, vá para Configurações>de Segurança e configure Usar pool em várias organizações.
Você pode configurar o valor da organização do Azure DevOps usando a lista organizations na seção organizationProfile.
No exemplo a seguir, um pool é configurado para todos os projetos em uma única organização, com um paralelismo de 4. Para obter um exemplo que mostra como configurar várias organizações, consulte Usar pool em várias organizações.
{
"$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
}
]
}
}
}
]
}
Você pode configurar o valor da organização do Azure DevOps usando a lista organizations no parâmetro organization-profile.
No exemplo a seguir, um pool é configurado para todos os projetos em uma única organização, com um paralelismo de 4. Para obter um exemplo que mostra como configurar várias organizações, consulte Usar pool em várias organizações.
az mdp pool create \
--organization-profile organization-profile.json
# other parameters omitted for space
O exemplo a seguir mostra a organizations lista no arquivo organization-profile.json.
{
"AzureDevOps": {
"organizations": [
{
"url": "https://dev.azure.com/fabrikam-tailspin",
"projects": [],
"parallelism": 4
}
],
"permissionProfile": {...}
}
}
Você pode configurar o valor da organização do Azure DevOps usando a organizations lista na organizationProfile seção .
No exemplo a seguir, um pool é configurado para todos os projetos em uma única organização, com um paralelismo de 4.
Para obter um exemplo que mostra como configurar várias organizações, consulte Usar pool em várias organizações.
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
}
]
}
}
}
Por padrão, seu pool está disponível para todos os projetos em suas organizações especificadas. Para limitar seu pool a projetos específicos, consulte Configurações de segurança: Configurar o acesso à organização.
Máximo de agentes
Especifique o número máximo de agentes que podem ser provisionados ao mesmo tempo em seu pool. Por exemplo, se você especificar um valor máximo de agentes de 2, poderá executar no máximo dois agentes ao mesmo tempo. Se mais de dois trabalhos estiverem na fila, apenas dois agentes executarão trabalhos, enquanto os outros trabalhos aguardam.
Você pode exibir o status atual e a contagem dos agentes provisionados em seu pool usando o painel Agentes . Todos os agentes na vista Agentes (exceto agentes com o estado Retornado) são executados num recurso de máquina virtual e contam para a contagem máxima de agentes.
Você pode definir o valor Máximo de agentes nas configurações do Pool para um pool existente e na guia Noções básicas ao criar um pool.
Você pode configurar o valor Maximum agents usando a maximumConcurrency propriedade.
No exemplo a seguir, o valor Maximum agents é 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
}
}
]
}
Você pode configurar o valor Máximo de agentes usando o maximum-concurrency parâmetro ao criar ou atualizar um pool.
No exemplo a seguir, o valor Maximum agents é 4.
az mdp pool create \
--maximum-concurrency 4
# other parameters omitted for space
Você pode configurar o valor Maximum agents usando a maximumConcurrency propriedade.
No exemplo a seguir, o valor Maximum agents é 4.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
...
maximumConcurrency: 4
}
}
Nota
O valor Máximo de agentes configura o número máximo de agentes que podem ser provisionados ao mesmo tempo, mas a contagem de trabalhos paralelos auto-hospedados da sua organização especifica o número de trabalhos que podem ser executados simultaneamente. Certifique-se de ter trabalhos paralelos auto-hospedados suficientes disponíveis em sua organização para permitir que seus agentes executem trabalhos. Para obter mais informações, consulte Preços de trabalho paralelo dos Serviços de DevOps do Azure.
Tamanho do agente
A configuração Tamanho do agente especifica o tamanho da máquina virtual do Azure a ser usada para hospedar seus agentes de Pools de DevOps gerenciados.
Para exibir e selecionar um tamanho de máquina virtual do Azure disponível em sua região do Azure, selecione Alterar tamanho. Os tamanhos dos agentes (SKUs) com cotas disponíveis em Grupos de DevOps Geridos são marcados como Disponíveis. Você pode solicitar mais cota para SKUs marcadas como Não disponíveis. Depois que uma solicitação de cota para uma SKU Não Disponível for aprovada, ela será marcada como Disponível. Saiba mais sobre as cotas de Pools de DevOps gerenciados.
Você pode configurar o tamanho do agente usando a sku propriedade na fabricProfile seção . No exemplo a seguir, um Standard_D2ads_v5 tamanho de VM é especificado.
{
"$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"
}
}
}
}
]
}
Você pode configurar o tamanho do agente usando a sku propriedade na fabricProfile seção ao criar ou atualizar um pool. No exemplo a seguir, um Standard_D2ads_v5 tamanho de VM é especificado.
az mdp pool create \
--fabric-profile fabric-profile.json
# other parameters omitted for space
O exemplo a seguir mostra a sku seção do fabric-profile.json arquivo.
{
"vmss": {
"sku": {
"name": "Standard_D2ads_v5"
},
"images": [...],
"osProfile": {...},
"storageProfile": {...}
}
}
Você pode configurar o tamanho do agente usando a sku propriedade na fabricProfile seção . No exemplo a seguir, um Standard_D2ads_v5 tamanho de VM é especificado.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
fabricProfile: {
...
sku: {
name: 'Standard_D2ads_v5'
}
}
}
}
Se sua assinatura não tiver a capacidade de configurar seu pool com a SKU da VM do Azure e a contagem máxima de agentes especificada, você receberá uma mensagem de erro como esta:
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
Para resolver o problema, consulte Rever quotas de pools de DevOps geridos.
Nem todas as SKUs são suportadas para todas as regiões do Azure. Se você receber um erro como SKU family <sku-family> is not available in location <region>, verifique se o tamanho da SKU é suportado para sua região. Para obter mais informações, consulte Tamanhos para máquinas virtuais no Azure e Produtos disponíveis por região.
Tipo de disco do SO
Os Pools de DevOps Gerenciados fornecem os seguintes tipos de disco para o disco do sistema operacional:
- Standard
- SSD Standard
- SSD Premium
O tipo de disco padrão do sistema operacional é Standard. Se a taxa de transferência da sua carga de trabalho exceder o nível da camada padrão, você poderá obter uma melhoria de desempenho na sua carga de trabalho atualizando para um tipo de disco com melhor desempenho. Para obter mais informações sobre tipos de disco e desempenho, consulte Tipos de disco gerenciado do Azure.
Você pode definir o tipo de disco do sistema operacional nas configurações do pool para um pool existente. Você pode configurar o tipo de disco do sistema operacional na guia Noções básicas ao criar um pool.
Você pode configurar o tipo de disco do sistema operacional usando a osDiskStorageAccountType propriedade na storageProfile seção . Selecione Standard, StandardSSD ou Premium.
No exemplo a seguir, um tipo de disco de sistema operacional padrão é especificado:
{
"$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"
}
}
}
]
}
Você pode configurar o tipo de disco do sistema operacional usando a osDiskStorageAccountType propriedade na storageProfile seção no fabric-profile parâmetro.
Selecione Standard, StandardSSD ou Premium. No exemplo a seguir, um tipo de disco de sistema operacional padrão é especificado.
az mdp pool create \
--fabric-profile fabric-profile.json
# other parameters omitted for space
O exemplo a seguir mostra a storageProfile seção do fabric-profile.json arquivo.
{
"vmss": {
"sku": {...},
"images": [...],
"osProfile": {...},
"storageProfile": {
"osDiskStorageAccountType": "Standard",
"dataDisks": []
}
}
}
Você pode configurar o tipo de disco do sistema operacional usando a osDiskStorageAccountType propriedade na storageProfile seção .
Selecione Standard, StandardSSD ou Premium. No exemplo a seguir, um tipo de disco de sistema operacional padrão é especificado.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
fabricProfile: {
...
storageProfile: {
osDiskStorageAccountType: 'Standard'
}
}
}
}
Imagens
Os Pools de DevOps Gerenciados fornecem várias opções de imagem de VM para usar para executar pipelines em seu pool. Você pode criar seu pool usando imagens de VM do marketplace selecionadas, suas próprias imagens personalizadas em uma instância da Galeria de Computação do Azure ou as mesmas imagens do Windows e Linux usadas pelos agentes hospedados pela Microsoft do Azure Pipelines.
Você pode configurar seu pool para usar uma única imagem ou várias imagens. Você também poderá usar pseudónimos para configurar os seus pipelines para utilizar uma imagem específica. Para obter mais informações, consulte Configurar imagens de pools de DevOps gerenciados.
Importante
Se você tiver várias imagens em seu pool e não usar demandas em seus pipelines para designar uma imagem, os pipelines serão executados usando a primeira imagem listada em seu pool. Pode alterar a ordem das imagens na sua piscina das seguintes formas:
- Usar modelos: altere a ordem das imagens na
images lista na fabricProfile seção.
- Usar arrastar: ordene as imagens na lista de imagens no portal do Azure.
Conteúdo relacionado