Freigeben über

Schnellstart: Erstellen eines verwalteten DevOps-Pools mithilfe einer ARM-Vorlage

  • Artikel

In diesem Artikel wird erläutert, wie Sie einen verwalteten DevOps-Pool mit einer ARM-Vorlage erstellen und eine Pipeline im neuen Pool ausführen.

Voraussetzungen

Bevor Sie die Schritte in diesem Artikel ausführen, müssen Sie Ihr Azure-Abonnement und Ihre Azure DevOps-Organisation für die Verwendung mit verwalteten DevOps-Pools konfiguriert haben, wie im Artikel "Voraussetzungen" beschrieben. Diese Schritte müssen nur einmal pro Azure-Abonnement und Azure DevOps-Organisation abgeschlossen werden.

Melden Sie sich bei der Azure-Befehlszeilenschnittstelle an.

Öffnen Sie eine Eingabeaufforderung (unter Windows, verwenden Sie die Windows-Eingabeaufforderung oder PowerShell), und führen Sie die folgenden Befehle aus.

  1. Melden Sie sich bei Azure CLI an.

    az login

  2. Wenn Sie über mehrere Azure-Abonnements verfügen, legen Sie Ihr Azure-Standardabonnement fest.

    az account set --subscription "My subscription name"

    Um eine Liste Ihrer Abonnements abzurufen, können Sie den folgenden Befehl ausführen.

    az account list -o table

    Wenn Sie über mehrere Mandanten verfügen oder weitere Informationen zum Arbeiten mit Azure-Abonnements mit Azure CLI anzeigen möchten, lesen Sie , wie Sie Azure-Abonnements mit der Azure CLI verwalten.

Erstellen einer Ressourcengruppe, eines Dev Centers und eines Dev Center-Projekts

  1. Führen Sie die Schritte zum Erstellen eines Dev Center in "Erstellen und Konfigurieren eines Dev Centers für Azure-Bereitstellungsumgebungen mithilfe der Azure CLI" aus.

    Sie müssen nur die Schritte im Abschnitt "Erstellen eines Dev Center " ausführen. Notieren Sie sich den Namen der Ressourcengruppe und den Dev Center-Namen.

  2. Führen Sie die Schritte zum Erstellen eines Projekts in "Erstellen und Konfigurieren eines Projekts mithilfe der Azure CLI" aus.

    Notieren Sie sich das id erstellte Projekt (nicht das devCenterId).

Überprüfen und Speichern der Vorlage

  1. Erstellen Sie einen lokalen Dateinamen mdp-azure-deploy.json mit dem folgenden Inhalt. Diese Datei ist eine parametrisierte ARM-Vorlage, die eine microsoft.devopsinfrastructure/pools Ressource erstellt.

    {
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "type": "string"
        },
        "adoOrg": {
            "type": "string"
        },
        "devCenterResourceId": {
            "type": "string"
        },
        "imageName": {
            "type": "string"
        },
        "poolSize": {
            "type": "int"
        },
        "location": {
            "type": "string",
            "defaultValue": "eastus"
        }
    },
    "variables": {},
    "resources": [
        {
            "name": "[parameters('poolName')]",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "[parameters('location')]",
            "tags": {},
            "properties": {
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "[parameters('adoOrg')]",
                            "parallelism": 1
                        }
                    ],
                    "permissionProfile": {
                        "kind": "CreatorOnly"
                    },
                    "kind": "AzureDevOps"
                },
                "devCenterProjectResourceId": "[parameters('devCenterResourceId')]",
                "maximumConcurrency": "[parameters('poolSize')]",
                "agentProfile": {
                    "kind": "Stateless"
                },
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    },
                    "images": [
                        {
                            "wellKnownImageName": "[parameters('imageName')]",
                            "buffer": "*"
                        }
                    ],
                    "kind": "Vmss"
                }
            }
        }
    ]
}

  2. Erstellen Sie eine andere lokale Datei mit dem Namen mdp-azure-deploy-parameters.json , und speichern Sie sie im selben Ordner wie die erste Datei. Aktualisieren Sie die folgenden Eigenschaften so, dass sie den Details Ihrer Umgebung entsprechen.

    Parameter Wert
    poolName Aktualisieren Sie value mit dem gewünschten Namen Ihres Pools. Der Name muss aus alphanumerischen Zeichen, ., , -oder _, und zwischen 3 und 44 Zeichen länge bestehen. Der Name muss in Azure global eindeutig sein.
    adoOrg Aktualisieren und ersetzen your-organization Sie value den Namen Ihrer Azure DevOps-Organisation.
    devCenterResourceId Aktualisieren Sie value mit dem id vorherigen Schritt "Ressourcengruppe erstellen", "Dev Center" und "Dev Center" .
    imageName Dieses Beispiel ist für die Verwendung eines Azure Pipelines-Images konfiguriert und verwendet das Windows Server 2022-Image. Wenn Sie dies ändern möchten, wählen Sie aus den vordefinierten Aliasen des Azure Pipelines-Images aus. Verwaltete DevOps-Pools unterstützen auch Azure Compute Gallery-Images und ausgewählte Marketplace-Images. Informationen zum Konfigurieren einer Ressource für verwaltete DevOps-Pools für diese Imagetypen finden Sie unter Configure Managed DevOps Pools images.
    poolSize Aktualisieren Sie value mit der maximalen Anzahl von Agents, die Sie gleichzeitige Aufträge ausführen möchten. In diesem Beispiel ist dies 1.poolSize
    location Die Azure-Region für den Pool. In diesem Beispiel ist eastusdie Region . 
    {
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "value": "my-first-managed-pool"
        },
        "adoOrg": {
            "value": "https://dev.azure.com/your-organization"
        },
        "devCenterResourceId": {
            "value": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
        },
        "imageName": {
            "value": "windows-2022"
        },
        "poolSize": {
            "value": 1
        },
        "location": {
            "value": "eastus"
        }
    }
}

Erstellen des verwalteten DevOps-Pools

Öffnen Sie eine Eingabeaufforderung (unter Windows, verwenden Sie die Windows-Eingabeaufforderung oder PowerShell), und führen Sie die folgenden Befehle aus. Sie können die ersten beiden Befehle überspringen, wenn Ihre Azure CLI-Sitzung noch aktiv ist.

  1. Melden Sie sich bei Azure CLI an.

    az login

  2. Wenn Sie über mehrere Azure-Abonnements verfügen, legen Sie Ihr Azure-Standardabonnement fest.

    az account set --subscription "My subscription name"

    Um eine Liste Ihrer Abonnements abzurufen, können Sie den folgenden Befehl ausführen.

    az account list -o table

    Wenn Sie über mehrere Mandanten verfügen oder weitere Informationen zum Arbeiten mit Azure-Abonnements mit Azure CLI anzeigen möchten, lesen Sie , wie Sie Azure-Abonnements mit der Azure CLI verwalten.

  3. Wechseln Sie zum Ordner, wenn Sie die beiden JSON-Dateien aus dem vorherigen Schritt gespeichert haben. In diesem Beispiel werden die Dateien in C:\examples.

    cd c:\examples

  4. Erstellen Sie den verwalteten DevOps-Pool. Ersetzen Sie die <resourceGroupName> im ersten Schritt erstellte Ressourcengruppe.

    az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.json --parameters mdp-azure-deploy-parameters.json

    Wenn Ihr Abonnement nicht über die Kapazität zum Konfigurieren Ihres Pools mit der gewünschten Azure VM-SKU und der maximalen Anzahl von Agents verfügt, schlägt die Poolerstellung mit einem Fehler wie die folgende Meldung fehl. Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97. Informationen zum Beheben des Problems finden Sie unter Überprüfen von Kontingenten für Managed DevOps-Pools.

Anzeigen des erstellten Pools im Azure-Portal

  1. Melden Sie sich beim Azure-Portal an.

  2. Suchen Sie nach verwalteten DevOps-Pools , und wählen Sie sie aus den verfügbaren Optionen aus.

  3. Wählen Sie ihren neuen verwalteten DevOps-Pool aus der Liste aus.

  4. Wählen Sie JSON-Ansicht aus, um das JSON-Format Ihrer Ressource für verwaltete DevOps-Pools anzuzeigen.

    Screenshot der Schaltfläche

Anzeigen des Agentpools in Azure DevOps

  1. Wechseln Sie zum Azure DevOps-Portal, und melden Sie sich bei Ihrer Azure DevOps-Organisation an (https://dev.azure.com/{your-organization}).

  2. Wechseln Sie zu den Azure DevOps-Organisationseinstellungen>.

    Screenshot der Schaltfläche

  3. Wechseln Sie zu Pipelines-Agent-Pools>, und stellen Sie sicher, dass Ihr neuer Pool aufgeführt ist. Wenn Sie gerade den verwalteten DevOps-Pool erstellt haben, kann es einige Minuten dauern, bis der neue Pool in der Agentsliste angezeigt wird.

    Screenshot der Liste der Agentpools.

Ausführen einer Pipeline in Ihrem neuen Pool

In diesem Schritt erstellen wir eine einfache Pipeline im Standard-Repository eines Azure DevOps-Projekts und führen sie in Ihrem neuen verwalteten DevOps-Pool aus.

  1. Wechseln Sie zum Azure DevOps-Portal, und melden Sie sich bei Ihrer Azure DevOps-Organisation an (https://dev.azure.com/{your-organization}).

  2. Wechseln Sie zu dem Projekt, in dem Sie die Pipeline ausführen möchten, und wählen Sie "Pipelines" aus.

    Screenshot der Liste

  3. Wählen Sie "Neue Pipeline " aus (oder "Pipeline erstellen", wenn dies Ihre erste Pipeline ist).

    Screenshot der Schaltfläche

  4. Wählen Sie Azure Repos Git aus.

    Screenshot der Repositorytypen.

  5. Wählen Sie das Repository aus, das denselben Namen wie Ihr Projekt hat. In diesem Beispiel heißt das Projekt "FabrikamFiber", daher wählen wir das Repository mit demselben Namen aus.

    Screenshot des FabrikamFiber-Repositorys.

  6. Wählen Sie "Startpipeline" aus.

    Screenshot der Pipelinevorlagenliste.

  7. Standardmäßig verwendet die Startvorlage einen von Microsoft gehosteten Linux-Agent. Bearbeiten Sie die Pipelinevorlage, und ändern Sie den pool Abschnitt so, dass er sich auf den Pool bezieht, den Sie in den vorherigen Schritten erstellt haben.

    # Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest

    In diesem Beispiel heißt der Name fabrikam-managed-poolder verwalteten DevOps-Pools , ersetzen Sie vmImage: ubuntu-latest also durch name: fabrikam-managed-pools, und geben Sie den Namen Ihres verwalteten DevOps-Pools an.

    # Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool

  8. Wählen Sie "Speichern und ausführen" aus, und wählen Sie "Speichern" aus, und führen Sie zum Bestätigen ein zweites Mal aus.

    Screenshot der Schaltfläche

  9. Wenn dies die erste Pipeline ist, die in diesem Pool ausgeführt wird, werden Sie möglicherweise aufgefordert, Berechtigungen zu erteilen, bevor die Pipeline ausgeführt wird.

  10. Beobachten Sie, wie die Pipeline in Azure DevOps ausgeführt wird, und Sie können zum Azure-Portal wechseln und den ausgeführten Agent in der Ansicht "Agents" anzeigen.

Bereinigen von Ressourcen

Wenn Sie die Schnellstartanleitung abgeschlossen haben, löschen Sie die erstellten Ressourcen, wenn Sie sie nicht weiterhin verwenden möchten.

Um den verwalteten DevOps-Pool, dev Center und Dev Center-Projekt zu löschen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen, die sie enthält.

Siehe auch