Definir configurações do pool

Importante

Os Pools de DevOps Gerenciados estão atualmente em visualização. Veja Termos de Utilização Complementares da Pré-visualizações do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão na versão beta, na pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

Este artigo descreve como definir as configurações básicas do seu 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 tags. Os Pools de DevOps Gerenciados passam até 20 tags para a VM e o restante é ignorado.

Para configurar seu pool, vá para Pool de configurações>.

Use as configurações a seguir para configurar 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 do SO

Projeto do Centro de Desenvolvimento

Portal do Azure

Escolha o projeto do Centro de Desenvolvimento para seu 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 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 devCenterProjectResourceId para seu projeto do Centro de Desenvolvimento no portal do Azure usando o Modo de Exibição JSON da página de visão geral do seu 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 centro de desenvolvimento é especificado pelo parâmetro ao devcenter-project-id 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 seu projeto de centro de desenvolvimento no portal do Azure usando o Modo de Exibição JSON na página de visão geral do seu projeto de 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 devcenter-project-id é recuperado de um projeto de 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 seu Pool de DevOps Gerenciado estiver configurado para uma única organização de DevOps do Azure, 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, vá para Configurações>de Segurança e configure Usar pool em várias organizações.

Modelo 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-04-04-preview",
            "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 à organização.

Máximo de agentes

Especifique a contagem máxima de agentes que estão 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 de cada 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 Noções básicas ao criar um pool.

Modelo ARM

O máximo de agentes é configurado usando a maximumConcurrency propriedade. No exemplo a seguir, Maximum agents é 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-04-04-preview",
            "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, Maximum agents é definido como 4.

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

Nota

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

Tamanho do agente especifica o tamanho da máquina virtual do Azure a ser usado para hospedar seus agentes de 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 tamanhos dos agentes (SKUs) 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 . Assim que uma solicitação de cota para uma SKU Não Disponível for aprovada, ela será listada como Disponível. Saiba mais sobre as cotas de Pools de DevOps gerenciados.

Modelo ARM

O tamanho do agente é configurado usando a sku propriedade na fabricProfile seção . No exemplo a seguir, um tamanho de VM Standard_D2ads_v5 é 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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

CLI do Azure

O tamanho do agente é configurado usando a sku propriedade na seção ao fabricProfile criar ou atualizar um pool. No 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 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 a SKU de VM do Azure desejada e a contagem máxima de agentes, você receberá um erro semelhante à seguinte mensagem. 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 receber um erro como SKU family <sku-family> is not available in location <region>, verifique se o tamanho da sua SKU é suportado para a 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

Managed DevOps Pools fornece 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.

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 ARM

O tipo de disco do SO é configurado usando a osDiskStorageAccountType propriedade na storageProfile seção . No exemplo a seguir, um tipo de disco de sistema operacional padrão é especificado. Escolha Standard, StandardSSDou 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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

CLI do Azure

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

O tipo de disco do sistema operacional é configurado usando a osDiskStorageAccountType storageProfile propriedade na seção no fabric-profile parâmetro. No exemplo a seguir, um tipo de disco de sistema operacional padrão é especificado. Escolha Standard, StandardSSDou 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áquinas virtuais para executar pipelines em seu pool. Você pode criar seu pool usando imagens selecionadas de VM 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 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.

Consulte também

• Configurar imagens