Configurar imagens de Pools de DevOps Gerenciados

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 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 ARM

As imagens são configuradas na fabricProfile seção das propriedades do recurso Managed DevOps Pools.

O exemplo a seguir especifica três imagens. Para obter mais informações sobre o esquema para 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.

Property	Description
aliases	Uma lista opcional de aliases. Em seguida, você pode fazer referência à imagem usando os aliases em vez do ID de recurso completo da imagem.
resourceID	O ID do recurso da imagem a ser usada. Necessário ao usar imagens da Galeria de Computação do Azure ou imagens de mercado selecionadas.
wellKnownImageName	O alias da imagem do Azure Pipelines. Necessário ao usar imagens do Azure Pipelines.
buffer	Quando os agentes em espera estão habilitados, buffer designa qual porcentagem de agentes em espera deve ser alocada 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 estão ativados, com 100% dos agentes em espera alocados 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 do recurso Managed DevOps Pools.

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 para 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.

Property	Description
aliases	Uma lista opcional de aliases. Em seguida, você pode fazer referência à imagem usando os aliases em vez do ID de recurso completo da imagem.
resourceID	O ID do recurso da imagem a ser usada. Necessário ao usar imagens da Galeria de Computação do Azure ou imagens de mercado selecionadas.
wellKnownImageName	O alias da imagem do Azure Pipelines. Necessário ao usar imagens do Azure Pipelines.
buffer	Quando os agentes em espera estão habilitados, buffer designa qual porcentagem de agentes em espera deve ser alocada 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 estão ativados, com 100% dos agentes em espera alocados 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 selecionadas.
• Imagens da Galeria de Computação do Azure - Escolha entre as 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 de 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 ARM

Para especificar uma imagem do Azure Pipelines, forneça o alias da imagem usando a wellKnownImageName propriedade. Veja 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. Veja uma lista de aliases predefinidos de imagem do Azure Pipelines.

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

Cada imagem inclui o seguinte software instalado.

Image	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 mercado

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 de mercado selecionadas, escolha a imagem desejada e escolha a versão desejada. Escolha a mais recente para usar sempre a versão mais recente da imagem.

Modelo ARM

Para especificar uma imagem de mercado selecionada, forneça o 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 o 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 que esteja disponível em suas assinaturas. São suportadas imagens generalizadas com os seguintes sistemas operativos.

• 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 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 o 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, vá para a Galeria de Computação do Azure no portal do Azure. Para usar apenas uma imagem específica, vá para essa imagem.

2. Selecione Controlo de acesso (IAM) .

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

4. Atribua a seguinte função. Para obter os passos detalhados, veja o artigo Atribuir funções do Azure com o portal do Azure.

   Definição	Value
   Role	Leitor
   Atribuir acesso a	Principal de Serviço
   Membros	DevOpsInfrastructure

   

Use várias imagens por pool com aliases

Se você tiver várias imagens em seu pool, poderá configurar seu pipeline de DevOps do Azure para usar uma imagem específica fazendo referência a 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 de aliases e escolha Salvar.

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

Modelo 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 quaisquer 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 os 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 seguinte demanda na pool seção do seu 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 ImageOverride alias na 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 Azure Pipelines Windows Server 2022 do exemplo anterior, especifique a seguinte demanda na pool seção do seu pipeline.

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

Consulte também

• Definir configurações do pool