Installatiekopieën van beheerde DevOps-pools configureren

Beheerde DevOps-pools bieden u verschillende opties voor installatiekopieën van virtuele machines voor het uitvoeren van pijplijnen in uw pool. U kunt uw pool maken met behulp van geselecteerde Azure Marketplace VM-installatiekopieën, uw eigen aangepaste installatiekopieën van de Azure Compute Gallery gebruiken of dezelfde installatiekopieën gebruiken als door Microsoft gehoste Azure Pipelines-agents.

Beheerde DevOps-pools kunnen worden geconfigureerd met één installatiekopieën of meerdere installatiekopieën. Wanneer uw pool meerdere installatiekopieën heeft, geven uw pijplijnen de installatiekopieën op waarop ze willen worden uitgevoerd met behulp van aliassen.

De afbeelding van uw pool kiezen

Azure-portal

Er wordt een standaardinstallatiekopieën geselecteerd wanneer u een beheerde DevOps-pool maakt. U kunt de standaardkeuze behouden of wijzigen tijdens het maken van een pool. Als u de installatiekopie wilt configureren nadat de pool is gemaakt, gaat u naar De groep Instellingen>, kiest u Toevoegen uit de afbeeldingsbibliotheek en selecteert u een of meer installatiekopieën voor uw pool.

ARM-sjabloon

Installatiekopieën worden geconfigureerd in de fabricProfile sectie van de resource-eigenschappen van beheerde DevOps-pools.

In het volgende voorbeeld worden drie afbeeldingen opgegeven. Zie de volgende secties in dit artikel voor meer informatie over het schema voor afbeeldingen.

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

Elke afbeelding kan de volgende eigenschappen hebben.

Eigenschappen	Beschrijving
aliases	Een optionele lijst met aliassen. U kunt vervolgens naar de installatiekopieën verwijzen met behulp van de aliassen in plaats van de volledige resource-id van de installatiekopieën.
resourceID	De resource-id van de te gebruiken installatiekopieën. Vereist bij het gebruik van installatiekopieën van azure Compute Gallery of geselecteerde Marketplace-installatiekopieën.
wellKnownImageName	De alias van de Azure Pipelines-installatiekopieën. Vereist bij het gebruik van Azure Pipelines-installatiekopieën.
buffer	Wanneer stand-byagents zijn ingeschakeld, buffer geeft u aan welk percentage stand-byagents moet worden toegewezen aan deze installatiekopieën. Het totaal van alle afbeeldingswaarden buffer moet gelijk zijn aan 100.

In het volgende voorbeeld worden drie afbeeldingen gedefinieerd. Stand-byagents zijn ingeschakeld, waarbij 100% van de stand-byagents zijn toegewezen aan de windows-2022 installatiekopieën.

"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

Installatiekopieën worden geconfigureerd in de fabric-profile sectie van de resource-eigenschappen van beheerde DevOps-pools.

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

In het volgende voorbeeld ziet u de images sectie van het bestand fabric-profile.json en geeft u drie afbeeldingen op. Zie de volgende secties in dit artikel voor meer informatie over het schema voor afbeeldingen.

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

Elke afbeelding kan de volgende eigenschappen hebben.

Eigenschappen	Beschrijving
aliases	Een optionele lijst met aliassen. U kunt vervolgens naar de installatiekopieën verwijzen met behulp van de aliassen in plaats van de volledige resource-id van de installatiekopieën.
resourceID	De resource-id van de te gebruiken installatiekopieën. Vereist bij het gebruik van installatiekopieën van azure Compute Gallery of geselecteerde Marketplace-installatiekopieën.
wellKnownImageName	De alias van de Azure Pipelines-installatiekopieën. Vereist bij het gebruik van Azure Pipelines-installatiekopieën.
buffer	Wanneer stand-byagents zijn ingeschakeld, buffer geeft u aan welk percentage stand-byagents moet worden toegewezen aan deze installatiekopieën. Het totaal van alle afbeeldingswaarden buffer moet gelijk zijn aan 100.

In het volgende voorbeeld worden drie afbeeldingen gedefinieerd. Stand-byagents zijn ingeschakeld, waarbij 100% van de stand-byagents zijn toegewezen aan de windows-2022 installatiekopieën.

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

Als u één installatiekopieën kiest, worden alle pijplijnen in uw pool uitgevoerd met die installatiekopieën. Als u meerdere installatiekopieën kiest, kunt u de installatiekopieën opgeven die per pijplijn moeten worden gebruikt. Zie Meerdere installatiekopieën per groep gebruiken voor meer informatie.

U kunt kiezen uit de volgende typen afbeeldingen.

• Azure Pipelines-installatiekopieën : kies uit dezelfde installatiekopieën die door Microsoft gehoste agents gebruiken.
• Geselecteerde marketplace-installatiekopieën : kies uit een set gecureerde door Microsoft gepubliceerde AZURE Marketplace VM-installatiekopieën.
• Installatiekopieën van de Azure Compute Gallery: kies uit uw eigen Installatiekopieën voor Azure Compute-galerieën. U moet de rol Lezer toewijzen aan de DevOpsInfrastructure-service-principal voor de installatiekopieën van de Azure Compute Gallery die u wilt gebruiken. Zie De rol Lezer toegang verlenen tot de DevOpsInfrastructure-service-principal voor meer informatie.

Azure Pipelines-installatiekopieën

Beheerde DevOps-pools bieden verschillende vooraf geconfigureerde installatiekopieën met dezelfde software als geselecteerde door Microsoft gehoste agents voor Azure Pipelines.

Azure-portal

ARM-sjabloon

Als u een Azure Pipelines-installatiekopieën wilt opgeven, geeft u de alias van de installatiekopieën op met behulp van de wellKnownImageName eigenschap. Bekijk een lijst met vooraf gedefinieerde aliassen van Azure Pipelines.

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

Azure-CLI

Als u een Azure Pipelines-installatiekopieën wilt opgeven, geeft u de alias van de installatiekopieën op met behulp van de wellKnownImageName eigenschap. Bekijk een lijst met vooraf gedefinieerde aliassen van Azure Pipelines.

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

Elke installatiekopieën bevatten de volgende geïnstalleerde software.

Afbeelding	Opgenomen software
Azure Pipelines - Windows Server 2022	Opgenomen software
Azure Pipelines - Windows Server 2019	Opgenomen software
Azure Pipelines - Ubuntu 22.04	Opgenomen software
Azure Pipelines - Ubuntu 20.04	Opgenomen software

Geselecteerde marketplace-installatiekopieën

Beheerde DevOps-pools bieden een set gecureerde door Microsoft gepubliceerde AZURE Marketplace VM-installatiekopieën voor gebruik in uw pools.

Azure-portal

Kies Geselecteerde marketplace-installatiekopieën, kies de gewenste installatiekopieën en kies de gewenste versie. Kies de meest recente om altijd de nieuwste versie van de installatiekopieën te gebruiken.

ARM-sjabloon

Als u een geselecteerde marketplace-installatiekopieën wilt opgeven, geeft u de resource-id van de installatiekopieën op met behulp van de resourceId eigenschap.

"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

Als u de geselecteerde marketplace-installatiekopieën wilt opgeven, geeft u de resource-id van de installatiekopieën op met behulp van de resourceId eigenschap.

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

Installatiekopieën van de Azure Compute-galerie

Kies Installatiekopieën in de Azure Compute Gallery om een installatiekopieën op te geven uit alle Azure Compute-galerieën die beschikbaar zijn in uw abonnementen. Gegeneraliseerde installatiekopieën met de volgende besturingssystemen worden ondersteund.

• 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

Belangrijk

Beheerde DevOps-pools ondersteunen alleen gegeneraliseerde installatiekopieën van de Azure Compute Gallery.

Azure-portal

ARM-sjabloon

Als u een azure Compute Gallery-installatiekopieën wilt opgeven, geeft u de resource-id van de installatiekopieën op met behulp van de resourceId eigenschap.

"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

Als u de geselecteerde marketplace-installatiekopieën wilt opgeven, geeft u de resource-id van de installatiekopieën op met behulp van de resourceId eigenschap.

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

Rol lezer toegang verlenen tot de DevOpsInfrastructure-service-principal

Belangrijk

Wijs de rol Lezer toe aan de DevOpsInfrastructure-service-principal voor de installatiekopieën van de Azure Compute Gallery die u wilt gebruiken. Als u een azure Compute Gallery-installatiekopie selecteert waarvoor deze toegang niet is geconfigureerd, mislukt het maken van een pool. U kunt de rol Lezer afzonderlijk toewijzen op afbeeldingsniveau of op het niveau van de afbeeldingengalerie voor alle afbeeldingen in de galerie.

1. Ga naar de gewenste resource in Azure Portal. Als u alle installatiekopieën in een galerie wilt kunnen gebruiken, gaat u naar Azure Compute Gallery in Azure Portal. Als u alleen een specifieke afbeelding wilt gebruiken, gaat u naar die afbeelding.

2. Klik op Toegangsbeheer (IAM) .

3. Klik op Toevoegen>Roltoewijzing toevoegen om het deelvenster Roltoewijzing toevoegen te openen.

4. Wijs de volgende rol toe. Raadpleeg Azure-rollen toewijzen met Azure Portal voor informatie over het toewijzen van rollen.

   Instelling	Weergegeven als
   Role	Lezer
   Toegang toewijzen aan	Service-principal
   Leden	DevOpsInfrastructure

   

Meerdere installatiekopieën per pool gebruiken met aliassen

Als u meerdere installatiekopieën in uw pool hebt, kunt u uw Azure DevOps-pijplijn configureren om een specifieke installatiekopieën te gebruiken door te verwijzen naar een alias voor die installatiekopieën.

Afbeeldingsaliassen configureren

Azure-portal

Als u installatiekopieën wilt toevoegen en beheren, gaat u naar de sectie Afbeeldingen van poolinstellingen en kiest u ..., Alias toevoegen.

Voeg eventueel gewenste aliassen toe aan de aliaslijst en kies Opslaan.

In het volgende voorbeeld ziet u een pool met twee Azure Pipelines-installatiekopieën en één geselecteerde marketplace-installatiekopieën. De Azure Pipeline-installatiekopieën hebben hun standaardaliassen weergegeven en de geselecteerde marketplace-installatiekopie heeft één geconfigureerde alias met de naam ubuntu-20.04-gen2.

ARM-sjabloon

Als u aliassen wilt configureren, geeft u deze op in de aliases lijst. In het volgende voorbeeld wordt één afbeelding gedefinieerd met één alias met de naam 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"
        ]
    }
]

Azure-CLI

Als u aliassen wilt configureren, geeft u deze op in de aliases lijst. In het volgende voorbeeld wordt één afbeelding gedefinieerd met één alias met de naam 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"
        ]
    }
]

Vooraf gedefinieerde aliassen voor Azure Pipelines-installatiekopieën

Naast aliassen die u configureert, hebben Azure Pipelines-installatiekopieën de volgende vooraf gedefinieerde aliassen.

Installatiekopieën van Azure Pipelines	Vooraf gedefinieerde 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

Vereisten gebruiken om een afbeelding op te geven

Als u meerdere installatiekopieën in uw pool hebt, kunt u een pijplijn configureren voor uitvoering op een specifieke installatiekopieën met behulp van een vraag met de naam ImageOverride. Wanneer u de ImageOverride vraag in uw pijplijn opgeeft, verzendt Beheerde DevOps-pools de taak alleen naar agents die die installatiekopieën gebruiken.

Als u een pijplijn wilt uitvoeren op de Ubuntu 20.04-installatiekopie uit het vorige voorbeeld met een ubuntu-20.04-gen2 alias, geeft u de volgende vraag op in de pool sectie van uw pijplijn.

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

Belangrijk

Plaats geen aanhalingstekens rond de aliasnaam in de ImageOverride vraag, zelfs niet als deze spaties in de naam bevat.

Als u een pijplijn wilt uitvoeren met behulp van een Azure Pipelines-installatiekopieën in uw pool, gebruikt u de alias in de vorige tabel. Als u een pijplijn wilt uitvoeren op de Installatiekopieën van Azure Pipelines Windows Server 2022 uit het vorige voorbeeld, geeft u de volgende vraag op in de pool sectie van uw pijplijn.

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

Zie ook

• Groepsinstellingen configureren