Konfigurieren von Images für verwaltete DevOps-Pools

Verwaltete DevOps-Pools bieten Ihnen mehrere Optionen für virtuelle Computerimages für die Ausführung von Pipelines in Ihrem Pool. Sie können Ihren Pool mit ausgewählten Azure Marketplace-VM-Images erstellen, eigene benutzerdefinierte Azure Compute Gallery-Images verwenden oder dieselben Bilder wie von Microsoft gehostete Azure Pipelines-Agents verwenden.

Verwaltete DevOps-Pools können mit einem einzelnen Image oder mehreren Images konfiguriert werden. Wenn Ihr Pool über mehrere Images verfügt, geben Ihre Pipelines das Bild an, auf dem sie mit Aliasen ausgeführt werden sollen.

Wählen Sie das Image Ihres Pools aus.

Azure portal

Ein Standardimage wird ausgewählt, wenn Sie einen verwalteten DevOps-Pool erstellen. Sie können die Standardauswahl beibehalten oder während der Poolerstellung ändern. Um das Image nach der Poolerstellung zu konfigurieren, wechseln Sie zum Einstellungspool>, wählen Sie "Aus Bildbibliothek hinzufügen" aus, und wählen Sie ein oder mehrere Bilder für Ihren Pool aus.

ARM-Vorlage

Bilder werden im fabricProfile Abschnitt der Ressourceneigenschaften für verwaltete DevOps-Pools konfiguriert.

Im folgenden Beispiel werden drei Bilder angegeben. Weitere Informationen zum Schema für Bilder finden Sie in den folgenden Abschnitten in diesem Artikel.

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

Jedes Bild kann die folgenden Eigenschaften aufweisen.

Eigenschaft	Beschreibung
aliases	Eine optionale Liste von Aliasen. Sie können dann mithilfe der Aliase anstelle der vollständigen Ressourcen-ID des Bilds auf das Bild verweisen.
resourceID	Die Ressourcen-ID des zu verwendenden Bilds. Erforderlich, wenn Sie Azure Compute Gallery-Bilder oder ausgewählte Marketplace-Images verwenden.
wellKnownImageName	Der Alias des Azure Pipelines-Images. Erforderlich bei Verwendung von Azure Pipelines-Images.
buffer	Wenn Standby-Agents aktiviert sind, wird festgelegt, buffer welcher Prozentsatz der Standby-Agents diesem Image zugeordnet werden soll. Die Summe aller Bildwerte buffer muss 100 entsprechen.

Im folgenden Beispiel werden drei Bilder definiert. Standby-Agents sind aktiviert, wobei dem Image 100 % der Standby-Agents zugeordnet sind windows-2022 .

"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-Befehlszeilenschnittstelle

Bilder werden im fabric-profile Abschnitt der Ressourceneigenschaften für verwaltete DevOps-Pools konfiguriert.

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

Das folgende Beispiel zeigt den images Abschnitt der datei fabric-profile.json und gibt drei Bilder an. Weitere Informationen zum Schema für Bilder finden Sie in den folgenden Abschnitten in diesem Artikel.

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

Jedes Bild kann die folgenden Eigenschaften aufweisen.

Eigenschaft	Beschreibung
aliases	Eine optionale Liste von Aliasen. Sie können dann mithilfe der Aliase anstelle der vollständigen Ressourcen-ID des Bilds auf das Bild verweisen.
resourceID	Die Ressourcen-ID des zu verwendenden Bilds. Erforderlich, wenn Sie Azure Compute Gallery-Bilder oder ausgewählte Marketplace-Images verwenden.
wellKnownImageName	Der Alias des Azure Pipelines-Images. Erforderlich bei Verwendung von Azure Pipelines-Images.
buffer	Wenn Standby-Agents aktiviert sind, wird festgelegt, buffer welcher Prozentsatz der Standby-Agents diesem Image zugeordnet werden soll. Die Summe aller Bildwerte buffer muss 100 entsprechen.

Im folgenden Beispiel werden drei Bilder definiert. Standby-Agents sind aktiviert, wobei dem Image 100 % der Standby-Agents zugeordnet sind windows-2022 .

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

Wenn Sie ein einzelnes Image auswählen, verwenden alle Pipelines in Ihrem Pool dieses Image. Wenn Sie mehrere Bilder auswählen, können Sie das Bild angeben, das pro Pipeline verwendet werden soll. Weitere Informationen finden Sie unter Verwenden mehrerer Bilder pro Pool.

Sie können aus den folgenden Arten von Bildern wählen.

• Azure Pipelines-Images – Wählen Sie aus denselben Bildern aus, die von Microsoft gehostete Agents verwenden.
• Ausgewählte Marketplace-Images – Wählen Sie aus einer Reihe kuratierter microsoft veröffentlichter Azure Marketplace-VM-Images aus.
• Azure Compute Gallery-Bilder – Wählen Sie aus Ihren eigenen Azure Compute Gallery-Images aus. Sie müssen die Reader-Rolle dem DevOpsInfrastructure Service Principal für die Azure Compute Gallery-Images zuweisen, die Sie verwenden möchten. Weitere Informationen finden Sie unter Gewähren des Leseberechtigungszugriffs auf den DevOpsInfrastructure-Dienstprinzipal.

Azure Pipelines-Images

Verwaltete DevOps-Pools bieten mehrere vorkonfigurierte Images mit derselben Software wie ausgewählte von Microsoft gehostete Agents für Azure Pipelines.

Azure portal

ARM-Vorlage

Um ein Azure Pipelines-Image anzugeben, geben Sie den Alias des Bilds mithilfe der wellKnownImageName Eigenschaft an. Sehen Sie sich eine Liste der vordefinierten Aliase von Azure Pipelines an.

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

Azure-Befehlszeilenschnittstelle

Um ein Azure Pipelines-Image anzugeben, geben Sie den Alias des Bilds mithilfe der wellKnownImageName Eigenschaft an. Sehen Sie sich eine Liste der vordefinierten Aliase von Azure Pipelines an.

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

Jedes Image enthält die folgende installierte Software.

Abbildung	Enthaltene Software
Azure-Pipelines – Windows Server 2022	Enthaltene Software
Azure-Pipelines – Windows Server 2019	Enthaltene Software
Azure Pipelines – Ubuntu 22.04	Enthaltene Software
Azure Pipelines – Ubuntu 20.04	Enthaltene Software

Ausgewählte Marketplace-Bilder

Verwaltete DevOps-Pools bieten eine Reihe kuratierter von Microsoft veröffentlichter Azure Marketplace-VM-Images für die Verwendung in Ihren Pools.

Azure portal

Wählen Sie ausgewählte Marketplace-Bilder, wählen Sie das gewünschte Bild und dann die gewünschte Version aus. Wählen Sie die neueste Version aus, um immer die neueste Version des Images zu verwenden.

ARM-Vorlage

Um ein ausgewähltes Marketplace-Bild anzugeben, geben Sie die Ressourcen-ID des Bilds mithilfe der resourceId Eigenschaft an.

"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-Befehlszeilenschnittstelle

Um ein ausgewähltes Marketplace-Image anzugeben, geben Sie die Ressourcen-ID des Bilds mithilfe der resourceId Eigenschaft an.

"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-Bilder

Wählen Sie Azure Compute Gallery-Bilder aus, um ein Bild aus allen Azure Compute Gallerys anzugeben, die in Ihren Abonnements verfügbar sind. Generalisierte Images mit den folgenden Betriebssystemen werden unterstützt.

• 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

Wichtig

Verwaltete DevOps-Pools unterstützen nur generalisierte Azure Compute Gallery-Bilder.

Azure portal

ARM-Vorlage

Um ein Azure Compute Gallery-Bild anzugeben, geben Sie die Ressourcen-ID des Bilds mithilfe der resourceId Eigenschaft an.

"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-Befehlszeilenschnittstelle

Um ein ausgewähltes Marketplace-Image anzugeben, geben Sie die Ressourcen-ID des Bilds mithilfe der resourceId Eigenschaft an.

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

Gewähren des Leserollenzugriffs auf den DevOpsInfrastructure-Dienstprinzipal

Wichtig

Weisen Sie die Leserrolle dem DevOpsInfrastructure Service Principal für die Azure Compute Gallery-Images zu, die Sie verwenden möchten. Wenn Sie ein Azure Compute Gallery-Image auswählen, das diesen Zugriff nicht konfiguriert hat, schlägt die Poolerstellung fehl. Sie können die Reader-Rolle einzeln auf Bildebene oder auf Der Ebene der Bildergalerie für alle Bilder im Katalog zuweisen.

1. Wechseln Sie zur gewünschten Ressource im Azure-Portal. Um alle Bilder in einem Katalog verwenden zu können, wechseln Sie im Azure-Portal zu Azure Compute Gallery. Wenn Sie nur ein bestimmtes Bild verwenden möchten, wechseln Sie zu diesem Bild.

2. Wählen Sie Zugriffssteuerung (IAM) aus.

3. Wählen Sie Hinzufügen>Rollenzuweisung hinzufügen aus, um die Seite Rollenzuweisung hinzufügen zu öffnen.

4. Weisen Sie die folgende Rolle zu. Ausführliche Informationen finden Sie unter Zuweisen von Azure-Rollen über das Azure-Portal.

   Einstellung	Wert
   Role	Leser
   Zugriff zuweisen zu	Dienstprinzipal
   Member	DevOpsInfrastructure

   

Verwenden mehrerer Bilder pro Pool mit Aliasen

Wenn Sie mehrere Bilder in Ihrem Pool haben, können Sie Ihre Azure DevOps-Pipeline so konfigurieren, dass ein bestimmtes Bild verwendet wird, indem Sie auf einen Alias für dieses Bild verweisen.

Konfigurieren von Bildaliasen

Azure portal

Um Bildaliasen hinzuzufügen und zu verwalten, wechseln Sie zum Abschnitt "Bilder " der Pooleinstellungen, und wählen Sie "...", "Alias hinzufügen" aus.

Fügen Sie der Aliasliste alle gewünschten Aliase hinzu, und wählen Sie "Speichern" aus.

Das folgende Beispiel zeigt einen Pool mit zwei Azure Pipelines-Images und einem ausgewählten Marketplace-Image. Die Azure Pipeline-Images werden standardmäßige Aliase angezeigt, und das ausgewählte Marketplace-Image verfügt über einen einzelnen konfigurierten Alias namens ubuntu-20.04-gen2.

ARM-Vorlage

Um Aliase zu konfigurieren, geben Sie sie in der aliases Liste an. Im folgenden Beispiel wird ein Bild mit einem einzigen Alias namens definiert 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-Befehlszeilenschnittstelle

Um Aliase zu konfigurieren, geben Sie sie in der aliases Liste an. Im folgenden Beispiel wird ein Bild mit einem einzigen Alias namens definiert 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"
        ]
    }
]

Vordefinierte Aliase des Azure Pipelines-Images

Neben allen von Ihnen konfigurierten Aliasen verfügen Azure Pipelines-Images über die folgenden vordefinierten Aliase.

Azure Pipelines-Image	Vordefinierter 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

Verwenden von Anforderungen zum Angeben eines Bilds

Wenn Sie über mehrere Images in Ihrem Pool verfügen, können Sie eine Pipeline so konfigurieren, dass sie auf einem bestimmten Image ausgeführt wird, indem Sie eine Anforderung namens verwenden ImageOverride. Wenn Sie die ImageOverride Nachfrage in Ihrer Pipeline angeben, sendet Managed DevOps Pools den Auftrag nur an Agents, die dieses Image verwenden.

Zum Ausführen einer Pipeline auf dem Ubuntu 20.04-Image aus dem vorherigen Beispiel mit einem ubuntu-20.04-gen2 Alias geben Sie die folgende Anforderung im pool Abschnitt Ihrer Pipeline an.

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

Wichtig

Platzieren Sie keine Anführungszeichen um den Aliasnamen in der ImageOverride Anforderung, auch wenn sie Leerzeichen im Namen enthält.

Um eine Pipeline mit einem Azure Pipelines-Image in Ihrem Pool auszuführen, verwenden Sie den Alias in der vorherigen Tabelle. Wenn Sie eine Pipeline im Windows Server 2022-Image von Azure-Pipelines aus dem vorherigen Beispiel ausführen möchten, geben Sie die folgende Anforderung im pool Abschnitt Ihrer Pipeline an.

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

Siehe auch

• Konfigurieren von Pooleinstellungen