Definir configurações do pool

Este artigo descreve como definir as configurações básicas do Pool de DevOps Gerenciado.

Vá para Visão geral para exibir uma visão geral das configurações do pool, mover recursos do Azure para um novo grupo de recursos ou assinatura ou configurar marcas. Os pools de DevOps gerenciados passam até 20 marcas para a VM e o restante é ignorado.

Para configurar seu pool, vá para Configurações>do Pool.

Use as configurações a seguir para definir seu Pool de DevOps Gerenciado.

• Projeto do Centro de Desenvolvimento
• Organização do Azure DevOps
• Imagens
• Máximo de agentes
• Tamanho do agente
• Tipo de disco de SO

Projeto do Centro de Desenvolvimento

Portal do Azure

Escolha o projeto do Centro de Desenvolvimento para o Pool de DevOps Gerenciado. Durante a criação do pool, você pode criar um projeto do Centro de Desenvolvimento e do Centro de Desenvolvimento se não tiver um.

Modelo de ARM

O projeto do devCenterProjectResourceId centro de desenvolvimento é especificado pela propriedade.

    "$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 para seu devCenterProjectResourceId projeto do Centro de Desenvolvimento no portal do Azure usando a Exibição JSON na página de visão geral do projeto do Centro de Desenvolvimento ou pode recuperá-lo usando a CLI do Azure para consultar o projeto para sua id propriedade. No exemplo a seguir, o devCenterProjectResourceId é recuperado de um projeto do Centro de Desenvolvimento nomeado 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"

CLI do Azure

O projeto do devcenter-project-id centro de desenvolvimento é especificado pelo parâmetro 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 para o devcenter-project-id projeto do centro de desenvolvimento no portal do Azure usando a exibição JSON na página de visão geral do projeto do centro de desenvolvimento ou recuperá-lo usando a CLI do Azure para consultar o projeto em busca de sua id propriedade. No exemplo a seguir, o devcenter-project-id é recuperado de um projeto do centro de desenvolvimento nomeado 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

Portal do Azure

Se o Pool de DevOps Gerenciado estiver configurado para uma única organização do Azure DevOps, você poderá especificar a organização nas configurações do pool.

Se o pool estiver configurado 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, acesse Configurações>Segurança e configure Usar pool em várias organizações.

Modelo de ARM

A organização do Azure DevOps é configurada usando a organizations lista na organizationProfile seção. No exemplo a seguir, um Pool de DevOps Gerenciado é configurado para todos os projetos em uma única organização, com um paralelismo de 4. Para obter um exemplo de configuração de 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": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "https://dev.azure.com/fabrikam-tailspin",
                            "projects": [],
                            "parallelism": 4
                        }
                    ]
                }
            }
        }
    ]
}

CLI do Azure

A organização do Azure DevOps é configurada usando a organizations lista no organization-profile parâmetro. No exemplo a seguir, um Pool de DevOps Gerenciado é configurado para todos os projetos em uma única organização, com um paralelismo de 4. Para obter um exemplo de configuração de 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": {...}
  }
}

Por padrão, seu Pool de DevOps Gerenciado 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 da organização.

Máximo de agentes

Especifique a contagem máxima de agentes disponíveis para uso 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 por vez executarão trabalhos enquanto os outros trabalhos aguardam.

Portal do Azure

O máximo de agentes é definido nas configurações do pool para um pool existente e na guia Básico ao criar um pool.

Modelo de ARM

O máximo de agentes é configurado usando a maximumConcurrency propriedade. No exemplo a seguir, o máximo de agentes é definido como 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": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

CLI do Azure

O máximo de agentes é configurado usando o maximum-concurrency parâmetro ao criar ou atualizar um pool. No exemplo a seguir, o máximo de agentes é definido como 4.

az mdp pool create \
   --maximum-concurrency 4
   # other parameters omitted for space

Observação

O 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

O tamanho do agente especifica o tamanho da máquina virtual do Azure a ser usado para hospedar seus agentes do Pools de DevOps Gerenciados.

Portal do Azure

Escolha Alterar tamanho para exibir e selecione um tamanho de máquina virtual do Azure que esteja disponível em sua região do Azure. Os SKUs (tamanhos de agente) com cotas de Pools de DevOps Gerenciados disponíveis são marcados como Disponíveis. Você pode solicitar mais cota para SKUs não disponíveis . Depois que uma solicitação de cota para um SKU Não Disponível for aprovada, ela será listada como Disponível. Saiba mais sobre as cotas dos Pools de DevOps Gerenciados.

Modelo de ARM

O tamanho do agente é configurado 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": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

CLI do Azure

O tamanho do agente é configurado 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 arquivo fabric-profile.json.

{
  "vmss": {
    "sku": {
      "name": "Standard_D2ads_v5"
    },
    "images": [...],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Se sua assinatura não tiver a capacidade de configurar seu pool com o SKU de VM do Azure desejado e a contagem máxima de agentes, você receberá um erro semelhante à mensagem a seguir. 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 do SKU é compatível com 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 Tipos de disco gerenciado do Azure.

Portal do Azure

O tipo de disco do sistema operacional é definido nas configurações do pool para um pool existente e na guia Noções básicas ao criar um pool.

Modelo de ARM

O tipo de disco do sistema operacional é configurado usando a osDiskStorageAccountType propriedade na storageProfile seção. No exemplo a seguir, um tipo de disco do sistema operacional padrão é especificado. Escolha Standard, StandardSSD ou Premium.

{
    "$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": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

CLI do Azure

No exemplo a seguir, um tipo de disco do sistema operacional padrão é especificado. Escolha Standard, StandardSSD ou Premium.

O tipo de disco do sistema operacional é configurado usando a osDiskStorageAccountType storageProfile propriedade na seção do fabric-profile parâmetro. No exemplo a seguir, um tipo de disco do sistema operacional padrão é especificado. Escolha Standard, StandardSSD ou Premium.

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

O exemplo a seguir mostra a storageProfile seção do arquivo fabric-profile.json.

{
  "vmss": {
    "sku": {...},
    "images": [...],
    "osProfile": {...},
    "storageProfile": {
      "osDiskStorageAccountType": "Standard",
      "dataDisks": []
    }
  }
}

Imagens

Os pools de DevOps gerenciados fornecem várias opções de imagens de máquina virtual para executar pipelines em seu pool. Você pode criar seu pool usando imagens de VM selecionadas do Azure Marketplace, usar suas próprias imagens personalizadas em uma Galeria de Computação do Azure ou usar as mesmas imagens do Windows e do Linux usadas pelos agentes hospedados pela Microsoft do Azure Pipelines.

Você pode configurar seu pool para usar uma única imagem ou várias imagens e 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.

Confira também

• Configurar imagens