Este artigo descreve como configurar as configurações básicas da instância de Pools de DevOps Gerenciados.
Visão geral
Para exibir uma visão geral das configurações do pool, acesse Visão geral.
Na visão geral, você pode:
Configurações do pool
Para configurar seu pool, vá para Configurações>do Pool.
Para configurar o pool, use as seguintes configurações:
Projeto do Centro de Desenvolvimento
Selecione a instância do projeto do Centro de Desenvolvimento para o pool. (Se você não tiver uma, poderá criar uma instância do Centro de Desenvolvimento e uma instância de projeto do Centro de Desenvolvimento ao criar seu pool.)
A devCenterProjectResourceId propriedade especifica a instância de projeto do 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 devCenterProjectResourceId valor de uma instância do projeto do Dev Center no portal do Azure usando a Visão JSON na página de visão geral da sua instância do projeto Dev Center. 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 de projeto do Centro de Desenvolvimento ao criar ou atualizar 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 sua instância de projeto do Centro de Desenvolvimento no portal do Azure usando a Visualização em JSON na página de Visão Geral da 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, 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 de projeto do 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 a devCenterProjectResourceId da sua instância do projeto Dev Center no portal do Azure, usando o Modo de Exibição JSON na página de Visão Geral da sua instância do projeto Dev Center. Você também pode recuperá-lo usando a CLI do Azure para consultar o projeto quanto à sua id propriedade.
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 o pool para uma única organização do Azure DevOps, poderá especificar a organização nas configurações do pool.
Se você configurou o pool para várias organizações, a configuração da organização do Azure DevOps não está presente nas configurações do pool. Para configurar seu pool para uso em várias organizações, acesse Configurações>Segurança e configure Usar pool em várias organizações.
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.
{
"$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 organizations lista no organization-profile parâmetro.
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 As 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 forem enfileirados, apenas dois agentes executarão trabalhos, enquanto os outros trabalhos esperarão.
Você pode exibir o status atual e a contagem dos agentes provisionados em seu pool usando o painel Agentes . Todos os agentes na exibição Agentes (exceto agentes com um status Retornado ) são executados em um 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 máximo de agentes usando a maximumConcurrency propriedade.
No exemplo a seguir, o valor máximo dos agentes é 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 máximo dos agentes é 4.
az mdp pool create \
--maximum-concurrency 4
# other parameters omitted for space
Você pode configurar o valor máximo de agentes usando a maximumConcurrency propriedade.
No exemplo a seguir, o valor máximo dos agentes é 4.
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'fabrikam-managed-pool'
location: 'eastus'
properties: {
...
maximumConcurrency: 4
}
}
Observação
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 Azure DevOps Services preços de trabalho paralelo.
Tamanho do agente
A configuração de 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 SKUs (tamanhos do agente) com cotas de Pools de DevOps Gerenciados disponíveis estã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 um SKU Não Disponível for aprovada, ela será marcada como Disponível. Saiba mais sobre 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 tamanho de Standard_D2ads_v5 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. Neste exemplo a seguir, um tamanho de VM Standard_D2ads_v5 é 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 tamanho de VM Standard_D2ads_v5 é 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 que você especificar, 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 Revisar cotas de Pools de DevOps Gerenciados.
Nem todos os SKUs são aceitos em 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 tem suporte para sua região. Para obter informações, confira Tamanhos para máquinas virtuais no Azure e Produtos disponíveis por região.
Tipo de disco de 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 do sistema operacional padrão é Standard. Se a taxa de transferência da carga de trabalho exceder o nível da camada padrão, você poderá obter uma melhoria de desempenho na carga de trabalho atualizando para um tipo de disco com melhor desempenho. Para obter mais informações sobre tipos de disco e desempenho, consulte os 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 do sistema operacional Standard é 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 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 do 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 do 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 a serem usadas 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 por agentes hospedados pela Microsoft no Azure Pipelines.
Você pode configurar o pool para usar uma única imagem ou várias imagens. Você também pode usar aliases para configurar seus pipelines para usar uma imagem específica. Para obter mais informações, consulte Configurar imagens de Pools de DevOps Gerenciados.
Importante
Se você tiver várias imagens no pool e não usar demandas em seus pipelines para designar uma imagem, os pipelines serão executados usando a primeira imagem listada no pool. Você pode alterar a ordem das imagens em seu pool das seguintes maneiras:
- Use modelos: altere a ordem das imagens na lista
images na seção fabricProfile.
- Use a função de arrastar: Organize as imagens na lista de imagens no portal do Azure.
Conteúdo relacionado