Configurar imagens de Pools de DevOps Gerenciados

Artigo
08/22/2024

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.

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.

Captura de tela da imagem de configuração.

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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    ...
                    "images": [
                        {
                            "resourceId": "/subscriptions/subscrition_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/subscrition_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"
    }
]

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

Captura de tela de imagens do Azure Pipelines.

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.

Captura de tela de imagens selecionadas do marketplace.

Portal do Azure
Modelo de ARM

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.

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

"images": [
    {
        "resourceId": "/subscriptions/subscrition_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 com os seguintes sistemas operacionais são suportadas

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

Portal do Azure
Modelo de ARM

Captura de tela das imagens da Galeria de Computação do Azure.

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

"images": [
    {
        "resourceId": "/subscriptions/subscrition_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.

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.
Selecione Controle de acesso (IAM) .
Selecione Adicionar>Adicionar atribuição de função para abrir a página Adicionar atribuição de função.
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

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

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.

Captura de tela do painel de alias.

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.

Captura de tela de um pool com várias imagens com aliases.

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/subscrition_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

Compartilhar via