Konfigurera avbildningar av hanterade DevOps-pooler

Hanterade DevOps-pooler ger dig flera alternativ för avbildningar av virtuella datorer för att köra pipelines i din pool. Du kan skapa din pool med hjälp av valda avbildningar av virtuella Azure Marketplace-datorer, använda dina egna anpassade Azure Compute Gallery-avbildningar eller använda samma avbildningar som Azure Pipelines Microsoft-värdbaserade agenter.

Hanterade DevOps-pooler kan konfigureras med en enda avbildning eller flera bilder. När din pool har flera bilder bör dina pipelines ange den bild som de vill använda genom att använda alias.

Välj poolens avbildning

Azure-portalen

En standardavbildning väljs när du skapar en hanterad DevOps-pool. Du kan behålla standardalternativet eller ändra det när poolen skapas. Om du vill konfigurera avbildningen när poolen har skapats går du till Inställningspool>, väljer Lägg till från bildbibliotek och väljer en eller flera bilder för poolen.

ARM-mall

Avbildningar konfigureras i fabricProfile avsnittet med resursegenskaperna för hanterade DevOps-pooler.

I följande exempel anges tre bilder. Mer information om schemat för bilder finns i följande avsnitt i den här artikeln.

JSON

{
    "$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"
                        }
                    ]
                }
            }
        }
    ]
}

Varje bild kan ha följande egenskaper.

Property	beskrivning
aliases	En valfri lista med alias. Du kan sedan referera till bilden med hjälp av aliasen i stället för avbildningens fullständiga resurs-ID.
resourceID	Resurs-ID för avbildningen som ska användas. Krävs när du använder Azure Compute Gallery-avbildningar eller valda marketplace-avbildningar.
wellKnownImageName	Aliaset för Azure Pipelines-avbildningen. Krävs när du använder Azure Pipelines-avbildningar.
buffer	När väntelägesagenter är aktiverade anger buffer vilken procentandel av väntelägesagenterna som ska allokeras till den här avbildningen. Summan av alla bildvärden buffer måste vara lika med 100.

I följande exempel definieras tre bilder. Standby-agenter är aktiverade med 100 % av väntelägesagenterna allokerade till avbildningen windows-2022 .

JSON

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

Azure CLI

Avbildningar konfigureras i fabric-profile avsnittet med resursegenskaperna för hanterade DevOps-pooler.

Azure CLI

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

I följande exempel visas avsnittet images i filen fabric-profile.json och anger tre bilder. Mer information om schemat för bilder finns i följande avsnitt i den här artikeln.

JSON

{
  "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": {...}
  }
}

Varje bild kan ha följande egenskaper.

Property	beskrivning
aliases	En valfri lista med alias. Du kan sedan referera till bilden med hjälp av aliasen i stället för avbildningens fullständiga resurs-ID.
resourceID	Resurs-ID för avbildningen som ska användas. Krävs när du använder Azure Compute Gallery-avbildningar eller valda marketplace-avbildningar.
wellKnownImageName	Aliaset för Azure Pipelines-avbildningen. Krävs när du använder Azure Pipelines-avbildningar.
buffer	När väntelägesagenter är aktiverade anger buffer vilken procentandel av väntelägesagenterna som ska allokeras till den här avbildningen. Summan av alla bildvärden buffer måste vara lika med 100.

I följande exempel definieras tre bilder. Standby-agenter är aktiverade med 100 % av väntelägesagenterna allokerade till avbildningen windows-2022 .

JSON

{
  "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": {...}
  }
}

Om du väljer en enda avbildning körs alla pipelines i poolen med den avbildningen. Om du väljer flera bilder kan du ange vilken avbildning som ska användas per pipeline. Mer information finns i Använda flera bilder per pool.

Viktigt

Om du har flera avbildningar i din pool och inte använder krav i dina pipelines för att specificera en avbildning, körs dina pipelines med den första avbildningen som anges i poolen. Du kan ändra ordningen på bilderna i poolen genom att ändra ordningen på bilderna i listan images i avsnittet fabricProfile (om du använder mallar), eller genom att beställa bilder i avbildningslistan i Azure-portalen med dra och släpp.

Du kan välja mellan följande typer av bilder.

• Azure Pipelines-avbildningar – Välj bland samma avbildningar som Microsoft-värdbaserade agenter använder.
• Valda marketplace-avbildningar – Välj bland en uppsättning utvalda Microsoft-publicerade vm-avbildningar på Azure Marketplace.
• Azure Compute Gallery-avbildningar – Välj från dina egna Azure Compute Galleries-avbildningar. Du måste tilldela rollen Läsare till DevOpsInfrastructure Service Principal för de Azure Compute Gallery-avbildningar som du vill använda. Mer information finns i Bevilja läsare rollåtkomst till DevOpsInfrastructure-tjänstens huvudnamn.

Azure Pipelines-avbildningar

Hanterade DevOps-pooler innehåller flera förkonfigurerade avbildningar som har samma programvara som valda Microsoft-värdbaserade agenter för Azure Pipelines.

Azure-portalen

ARM-mall

Om du vill ange en Azure Pipelines-avbildning anger du aliaset för avbildningen wellKnownImageName med hjälp av egenskapen . Se en lista över fördefinierade alias för Azure Pipelines-avbildningar.

JSON

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

Azure CLI

Om du vill ange en Azure Pipelines-avbildning anger du aliaset för avbildningen wellKnownImageName med hjälp av egenskapen . Se en lista över fördefinierade alias för Azure Pipelines-avbildningar.

JSON

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

Varje avbildning innehåller följande installerade programvara.

Bild	Programvara som ingår
Azure Pipelines – Windows Server 2022	Programvara som ingår
Azure Pipelines – Windows Server 2019	Programvara som ingår
Azure Pipelines – Ubuntu 22.04	Programvara som ingår
Azure Pipelines – Ubuntu 20.04	Programvara som ingår

Valda marketplace-avbildningar

Hanterade DevOps-pooler innehåller en uppsättning utvalda Microsoft-publicerade vm-avbildningar på Azure Marketplace för användning i dina pooler.

Azure-portalen

Välj Valda marketplace-avbildningar, välj önskad avbildning och välj önskad version. Välj senaste för att alltid använda den senaste versionen av avbildningen.

ARM-mall

Om du vill ange en vald marketplace-avbildning anger du resurs-ID för avbildningen resourceId med hjälp av egenskapen .

JSON

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

Azure CLI

Om du vill ange en vald marketplace-avbildning anger du resurs-ID:t för avbildningen resourceId med hjälp av egenskapen .

JSON

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

Azure Compute Gallery-avbildningar

Välj Azure Compute Gallery-avbildningar för att ange en bild från alla Azure Compute Galleries som är tillgängliga i dina prenumerationer. Generaliserade avbildningar med följande operativsystem stöds.

• 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

Viktigt

Hanterade DevOps-pooler stöder endast generaliserade Azure Compute Gallery-avbildningar.

Azure-portalen

ARM-mall

Om du vill ange en Azure Compute Gallery-avbildning anger du resurs-ID för avbildningen resourceId med hjälp av egenskapen .

JSON

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

Azure CLI

Om du vill ange en vald marketplace-avbildning anger du resurs-ID:t för avbildningen resourceId med hjälp av egenskapen .

JSON

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

Ge rollen Läsare åtkomst till DevOpsInfrastructure-tjänstens huvudnamn

Viktigt

Tilldela rollen Läsare till DevOpsInfrastructure Service Principal för de Azure Compute Gallery-avbildningar som du vill använda. Om du väljer en Azure Compute Gallery-avbildning som inte har den här åtkomsten konfigurerad misslyckas skapandet av poolen. Du kan tilldela rollen Läsare individuellt på bildnivå eller på bildgallerinivå för alla bilder i galleriet.

1. Gå till önskad resurs i Azure Portal. Om du vill kunna använda alla bilder i ett galleri går du till Azure Compute Gallery i Azure Portal. Om du bara vill använda en viss avbildning går du till den avbildningen.

2. Välj Åtkomstkontroll (IAM) .

3. Välj Lägg till>rolltilldelning för att öppna sidan Lägg till rolltilldelning.

4. Tilldela följande roll. Läs mer om att tilldela roller i Tilldela Azure-roller via Azure Portal.

   Inställning	Värde
   Roll	Läsare
   Tilldela åtkomst till	Tjänstens huvudnamn
   Medlemmar	DevOpsInfrastructure

   

Använda flera avbildningar per pool med alias

Om du har flera avbildningar i poolen kan du konfigurera din Azure DevOps-pipeline så att den använder en specifik avbildning genom att referera till ett alias för den avbildningen.

Om du har flera avbildningar i poolen och inte använder krav i dina pipelines för att ange en avbildning, körs pipelines med hjälp av den första listade avbildningen i poolen. Du kan ändra ordningen på bilderna i poolen genom att ändra ordningen på bilderna i listan images i avsnittet fabricProfile (om du använder mallar), eller genom att beställa bilder i avbildningslistan i Azure-portalen med dra och släpp.

Tips

Om dina pipelines får problem när du för första gången lägger till en ny bild i din pool, kontrollera då ordningen på bilderna i listan. Överväg att använda krav och alias för att specifikt ange vilken bild som ska användas för varje enskild pipeline.

Konfigurera avbildningsalias

Azure-portalen

Om du vill lägga till och hantera avbildningsalias går du till avsnittet Bilder i poolinställningarna och väljer ..., Lägg till alias.

Lägg till önskade alias i aliaslistan och välj Spara.

I följande exempel visas en pool med två Azure Pipelines-avbildningar och en vald marketplace-avbildning. Azure Pipeline-avbildningarna har sina standardalias visade, och den valda Marketplace-avbildningen har ett enda konfigurerat alias med namnet ubuntu-20.04-gen2.

ARM-mall

Om du vill konfigurera alias anger du dem i aliases listan. I följande exempel definieras en bild med ett enda alias med namnet ubuntu-20.04-gen2.

JSON

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

Azure CLI

Om du vill konfigurera alias anger du dem i aliases listan. I följande exempel definieras en bild med ett enda alias med namnet ubuntu-20.04-gen2.

JSON

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

Fördefinierade alias för Azure Pipelines-avbildning

Förutom alla alias som du konfigurerar har Azure Pipelines-avbildningar följande fördefinierade alias.

Avbildning av Azure Pipelines	Fördefinierade alias
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

Använda krav för att ange en avbildning

Om du har flera avbildningar i poolen kan du konfigurera en pipeline att köras på en specifik avbildning med hjälp av ett krav med namnet ImageOverride. När du anger efterfrågan i pipelinen ImageOverride skickar Hanterade DevOps-pooler jobbet endast till agenter som använder den avbildningen.

Om du vill köra en pipeline på Ubuntu 20.04-avbildningen från föregående exempel som hade ett ubuntu-20.04-gen2 alias anger du följande krav i avsnittet i pool pipelinen.

yml

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

Viktigt

Placera inte citattecken runt aliasnamnet på ImageOverride begäran, även om det har blanksteg i namnet.

Om du vill köra en pipeline med en Azure Pipelines-avbildning i poolen använder du aliaset i föregående tabell. Om du vill köra en pipeline på Azure Pipelines Windows Server 2022-avbildningen från föregående exempel anger du följande krav i avsnittet i pool din pipeline.

yml

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

Se även

• Konfigurera poolinställningar