Definir configurações do pool

Artigo
10/18/2024

Importante

Os pools de DevOps gerenciados estão atualmente em versão prévia. Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

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

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.

Captura de tela das configurações do Centro de Desenvolvimento.

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"

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

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.

Captura de tela da configuração de uma única organização.

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.

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
                        }
                    ]
                }
            }
        }
    ]
}

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.

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

Captura de tela da configuração Máximo de agentes.

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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

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.

Captura de tela da configuração do tamanho do agente.

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.

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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

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.

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.

Captura de tela da configuração do tipo de disco do sistema operacional.

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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

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.

Captura de tela da imagem de configuração.

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

Compartilhar via