Configurar imagens de Pools de DevOps Gerenciados

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 da Galeria de Computação do Azure ou usar as mesmas imagens que os agentes hospedados pela Microsoft do Azure Pipelines.

Os pools de DevOps gerenciados podem ser configurados com uma única imagem ou várias imagens. Quando o pool tem várias imagens, os pipelines especificam a imagem na qual desejam ser executados usando aliases.

Escolha a imagem da sua piscina

Portal do Azure

Uma imagem padrão é selecionada quando você cria um Pool de DevOps Gerenciado. Você pode manter a opção padrão ou alterá-la durante a criação do pool. Para configurar a imagem após a criação do pool, vá para Pool de Configurações>, escolha Adicionar da Biblioteca de Imagens e selecione uma ou mais imagens para o pool.

Modelo de ARM

As imagens são configuradas na fabricProfile seção das propriedades de recursos dos Pools de DevOps Gerenciados.

O exemplo a seguir especifica três imagens. Para obter mais informações sobre o esquema de imagens, consulte as seções a seguir neste artigo.

{
    "$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": {
                    ...
                    "images": [
                        {
                            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
                            "aliases": [
                                "ubuntu-20.04-gen2"
                            ]
                        },
                        {
                            "wellKnownImageName": "windows-2022"
                        },
                        {
                            "wellKnownImageName": "ubuntu-22.04"
                        }
                    ]
                }
            }
        }
    ]
}

Cada imagem pode ter as seguintes propriedades.

Propriedade	Descrição
aliases	Uma lista opcional de aliases. Em seguida, você pode se referir à imagem usando os aliases em vez da ID de recurso completa da imagem.
resourceID	A ID do recurso da imagem a ser usada. Necessário ao usar imagens da Galeria de Computação do Azure ou imagens selecionadas do marketplace.
wellKnownImageName	O alias da imagem do Azure Pipelines. Necessário ao usar imagens do Azure Pipelines.
buffer	Quando os agentes em espera estão ativados, buffer designa a porcentagem de agentes em espera a serem alocados para essa imagem. O total de todos os valores de imagem buffer deve ser igual a 100.

O exemplo a seguir define três imagens. Os agentes em espera são ativados, com 100% dos agentes em espera alocados para a windows-2022 imagem.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ],
        "buffer": "0"
    },
    {
        "buffer": "100",
        "wellKnownImageName": "windows-2022"
    },
    {
        "buffer": "0",
        "wellKnownImageName": "ubuntu-22.04"
    }
]

CLI do Azure

As imagens são configuradas na fabric-profile seção das propriedades de recursos dos Pools de DevOps Gerenciados.

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

O exemplo a seguir mostra a images seção do arquivo fabric-profile.json e especifica três imagens. Para obter mais informações sobre o esquema de imagens, consulte as seções a seguir neste artigo.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
            "aliases": [
                "ubuntu-20.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Cada imagem pode ter as seguintes propriedades.

Propriedade	Descrição
aliases	Uma lista opcional de aliases. Em seguida, você pode se referir à imagem usando os aliases em vez da ID de recurso completa da imagem.
resourceID	A ID do recurso da imagem a ser usada. Necessário ao usar imagens da Galeria de Computação do Azure ou imagens selecionadas do marketplace.
wellKnownImageName	O alias da imagem do Azure Pipelines. Necessário ao usar imagens do Azure Pipelines.
buffer	Quando os agentes em espera estão ativados, buffer designa a porcentagem de agentes em espera a serem alocados para essa imagem. O total de todos os valores de imagem buffer deve ser igual a 100.

O exemplo a seguir define três imagens. Os agentes em espera são ativados, com 100% dos agentes em espera alocados para a windows-2022 imagem.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
            "aliases": [
                "ubuntu-20.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Se você escolher uma única imagem, todos os pipelines executados em seu pool usarão essa imagem. Se você escolher várias imagens, poderá especificar a imagem a ser usada por pipeline. Para obter mais informações, consulte Usar várias imagens por pool.

Você pode escolher entre os seguintes tipos de imagens.

• Imagens do Azure Pipelines – escolha entre as mesmas imagens que os agentes hospedados pela Microsoft usam.
• Imagens selecionadas do marketplace – escolha entre um conjunto de imagens de VM do Azure Marketplace publicadas pela Microsoft.
• Imagens da Galeria de Computação do Azure – escolha entre suas próprias imagens das Galerias de Computação do Azure. Você deve atribuir a função Leitor à entidade de serviço DevOpsInfrastructure para as imagens da Galeria de Computação do Azure que deseja usar. Para obter mais informações, consulte Conceder acesso à função Leitor à entidade de serviço DevOpsInfrastructure.

Imagens do Azure Pipelines

Os Pools de DevOps Gerenciados fornecem várias imagens pré-configuradas que têm o mesmo software que os agentes hospedados pela Microsoft selecionados para o Azure Pipelines.

Portal do Azure

Modelo de ARM

Para especificar uma imagem do Azure Pipelines, forneça o alias da imagem usando a wellKnownImageName propriedade. Confira uma lista de aliases predefinidos de imagem do Azure Pipelines.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

CLI do Azure

Para especificar uma imagem do Azure Pipelines, forneça o alias da imagem usando a wellKnownImageName propriedade. Confira uma lista de aliases predefinidos de imagem do Azure Pipelines.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

Cada imagem inclui o seguinte software instalado.

Imagem	Software incluído
Azure Pipelines – Windows Server 2022	Software incluído
Azure Pipelines – Windows Server 2019	Software incluído
Azure Pipelines – Ubuntu 22.04	Software incluído
Azure Pipelines – Ubuntu 20.04	Software incluído

Imagens selecionadas do marketplace

Os Pools de DevOps Gerenciados fornecem um conjunto de imagens de VM do Azure Marketplace publicadas pela Microsoft para uso em seus pools.

Portal do Azure

Escolha Imagens selecionadas do marketplace, escolha a imagem desejada e escolha a versão desejada. Escolha latest (mais recente ) para sempre usar a versão mais recente da imagem.

Modelo de ARM

Para especificar uma imagem do marketplace selecionada, forneça a ID do recurso da imagem usando a resourceId propriedade.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

CLI do Azure

Para especificar a imagem do marketplace selecionada, forneça a ID do recurso da imagem usando a resourceId propriedade.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Imagens da Galeria de Computação do Azure

Escolha imagens da Galeria de Computação do Azure para especificar uma imagem de qualquer Galeria de Computação do Azure disponível em suas assinaturas. Imagens generalizadas com os seguintes sistemas operacionais são suportadas.

• Windows Server 2019
• Windows Server 2022
• Windows 11
• Ubuntu 20.04
• Ubuntu 22.04
• Ubuntu 24.04
• Debian 9
• RHEL 8
• RHEL 9
• SUSE 12
• SUSE 15

Importante

Os Pools de DevOps Gerenciados dão suporte apenas a imagens generalizadas da Galeria de Computação do Azure.

Portal do Azure

Modelo de ARM

Para especificar uma imagem da Galeria de Computação do Azure, forneça a ID do recurso da imagem usando a resourceId propriedade.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

CLI do Azure

Para especificar a imagem do marketplace selecionada, forneça a ID do recurso da imagem usando a resourceId propriedade.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest"
    }
]

Conceder acesso à função de Leitor à entidade de serviço DevOpsInfrastructure

Importante

Atribua a função Leitor à Entidade de Serviço DevOpsInfrastructure para as imagens da Galeria de Computação do Azure que você deseja usar. Se você selecionar uma imagem da Galeria de Computação do Azure que não tenha esse acesso configurado, a criação do pool falhará. Você pode atribuir a função Leitor individualmente no nível da imagem ou no nível da galeria de imagens para todas as imagens na galeria.

1. Vá para o recurso desejado no portal do Azure. Para poder usar todas as imagens em uma galeria, acesse a Galeria de Computação do Azure no portal do Azure. Para usar apenas uma imagem específica, vá para essa imagem.

2. Selecione Controle de acesso (IAM) .

3. Selecione Adicionar>Adicionar atribuição de função para abrir a página Adicionar atribuição de função.

4. Atribua a função a seguir. Para ver as etapas detalhadas, confira Atribuir funções do Azure usando o portal do Azure.

   Configuração	Valor
   Função	Leitor
   Atribuir acesso a	Entidade de Serviço
   Membros	DevOpsInfrastructure

   

Usar várias imagens por pool com aliases

Se você tiver várias imagens em seu pool, poderá configurar seu pipeline do Azure DevOps para usar uma imagem específica referenciando um alias para essa imagem.

Configurar aliases de imagem

Portal do Azure

Para adicionar e gerenciar aliases de imagem, vá para a seção Imagens das configurações do pool e escolha ..., Adicionar alias.

Adicione os aliases desejados à lista Alias e escolha Salvar.

O exemplo a seguir mostra um pool com duas imagens do Azure Pipelines e uma imagem do marketplace selecionada. As imagens do Azure Pipeline têm seus aliases padrão exibidos e a imagem do marketplace selecionada tem um único alias configurado chamado ubuntu-20.04-gen2.

Modelo de ARM

Para configurar aliases, especifique-os aliases na lista. O exemplo a seguir define uma imagem com um único alias chamado ubuntu-20.04-gen2.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ]
    }
]

CLI do Azure

Para configurar aliases, especifique-os aliases na lista. O exemplo a seguir define uma imagem com um único alias chamado ubuntu-20.04-gen2.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/0001-com-ubuntu-server-focal/skus/20_04-lts-gen2/versions/latest",
        "aliases": [
            "ubuntu-20.04-gen2"
        ]
    }
]

Aliases predefinidos de imagem do Azure Pipelines

Além de todos os aliases que você configurar, as imagens do Azure Pipelines têm os seguintes aliases predefinidos.

Imagem do Azure Pipelines	Alias predefinido
Azure Pipelines – Windows Server 2022	windows-2022
Azure Pipelines – Windows Server 2019	windows-2019
Azure Pipelines – Ubuntu 22.04	ubuntu-22.04
Azure Pipelines – Ubuntu 20.04	ubuntu-20.04

Usar demandas para especificar uma imagem

Se você tiver várias imagens em seu pool, poderá configurar um pipeline para ser executado em uma imagem específica usando uma demanda chamada ImageOverride. Quando você especifica a ImageOverride demanda em seu pipeline, os Pools de DevOps Gerenciados enviam o trabalho somente para agentes que usam essa imagem.

Para executar um pipeline na imagem do Ubuntu 20.04 do exemplo anterior que tinha um ubuntu-20.04-gen2 alias, especifique a demanda a seguir na pool seção do pipeline.

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals ubuntu-20.04-gen2

Importante

Não coloque aspas ao redor do nome do alias na ImageOverride demanda, mesmo que ele tenha espaços no nome.

Para executar um pipeline usando uma imagem do Azure Pipelines em seu pool, use o alias na tabela anterior. Para executar um pipeline na imagem do Windows Server 2022 do Azure Pipelines do exemplo anterior, especifique a demanda a seguir na pool seção do pipeline.

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals windows-2022

Confira também

• Definir configurações do pool