Provisioningscripts configureren voor images van Managed DevOps Pools

Beheerde DevOps-pools bieden de mogelijkheid om een PowerShell-script (Windows) of een Bash-script (Linux) uit te voeren op een installatiekopie in een pool voordat die aan een agent wordt toegewezen voor het uitvoeren van een taak. Deze functie maakt scenario's mogelijk, zoals het installeren van vertrouwde basis-CA's en het instellen van omgevingsvariabelen.

Beheerde DevOps-pools maken gebruik van een beheerde identiteit die is gekoppeld aan uw pool om de scripts van Azure Blob Storage naar de agent te downloaden en scriptlogboeken voor inrichting te uploaden om problemen op te lossen. Het inrichtingsscript wordt uitgevoerd wanneer de agent wordt gestart en u kunt de agent zo configureren dat deze opnieuw wordt opgestart nadat het script is uitgevoerd.

Voer de volgende stappen uit om de installatiekopie van een Managed DevOps Pool te configureren om een inrichtingsscript uit te voeren:

1. Maak twee blobcontainers in een Blob Storage-account: één voor de inrichtingsscripts en ondersteunende bestanden, en één voor het uploaden van scriptlogboeken voor inrichting. Upload uw inrichtingsscripts en eventuele ondersteunende bestanden naar de script-blobcontainer.
2. Koppel een beheerde identiteit aan uw beheerde DevOps-pool en wijs de vereiste rollen toe aan de beheerde identiteit op de juiste bereiken, zodat de agent de inrichtingsscripts kan lezen en scriptlogboeken voor inrichting kan uploaden.
3. Configureer uw images zodat ze de gewenste provisioningscripts gebruiken.

Prerequisites

• Een Azure Blob Storage-account. Het ondersteunde Azure Storage accounttype voor het inrichten van scripts voor beheerde DevOps-pools is Standard algemeen gebruik v2.
• Een beheerde DevOps-pool met een gekoppelde beheerde identiteit. Als uw beheerde DevOps-pool geen beheerde identiteit heeft, maakt u er een door de stappen te volgen in Een beheerde identiteit configureren voor uw beheerde DevOps-pool.

De blobcontainers maken

Beheerde DevOps-pools downloaden provisioneringsscripts en de ondersteunende bestanden van blobs in een container binnen een Blob Storage-account. Voor beheerde DevOps-pools zijn twee blobcontainers in het opslagaccount vereist: één voor het downloaden van het inrichtingsscript en ondersteunende bestanden, en één voor het uploaden van scriptlogboeken voor inrichting.

Maak de volgende twee blobcontainers in uw Blob Storage-account.

Upload uw inrichtingsscript en eventuele ondersteunende bestanden naar de blobcontainer van de scripts. Het inrichtingsscript moet een naam Startup.ps1 hebben voor Windows installatiekopieën of Startup.sh voor Linux-installatiekopieën. U kunt alle ondersteunende bestanden opnemen die vereist zijn voor de scripts in de blob. Wanneer de agent wordt gestart, worden deze bestanden gedownload naar de werkmap van de agent en wordt het inrichtingsscript vanaf die locatie uitgevoerd.

Azure rollen toewijzen aan de beheerde identiteit

Beheerde DevOps-pools maken gebruik van een beheerde identiteit voor toegang tot de blobcontainers voor de inrichtingsscripts en het inrichten van scriptlogboeken. U moet een beheerde identiteit koppelen aan uw beheerde DevOps-pool en de opgegeven rollen toewijzen aan de beheerde identiteit op de bereiken die in deze sectie worden beschreven. Als uw beheerde DevOps-pool geen beheerde identiteit heeft, maakt u er een door de stappen te volgen in Een beheerde identiteit configureren voor uw beheerde DevOps-pool.

• Als uw beheerde DevOps-pool één gekoppelde beheerde identiteit heeft, wordt die identiteit gebruikt voor toegang tot het inrichtingsscript en het inrichten van scriptlogboekcontainers.
• Als uw Managed DevOps-pool meer dan één gekoppelde beheerde identiteit heeft, geeft u een specifieke beheerde identiteit op die moet worden gebruikt voor inrichtingsscripts door de eigenschap Client-id van beheerde identiteit (provisioningScriptManagedIdentityResourceId) op te geven wanneer u uw installatiekopie configureert voor het gebruik van een inrichtingsscript.

Wijs de rollen in de volgende tabel toe aan de gekoppelde beheerde identiteit van de Managed DevOps Pool binnen de opgegeven bereiken, zodat de agent de scripts kan downloaden en de logboeken van het provisioningscript kan uploaden. Zie Stappen voor het toewijzen van een Azure-rol voor meer informatie over het toewijzen van Azure rollen.

Configureer je image voor het gebruik van het provisioningscript

Als u een inrichtingsscript met een image wilt gebruiken, configureert u de volgende image-eigenschappen.

{
    "$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": "2026-06-02",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    ...
                    "images": [
                        {
                            "wellKnownImageName": "ubuntu-24.04",
                            "provisioningScriptStorageAccountResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}",
                            "provisioningScriptEntryPoint": "provisioningscript",
                            "provisioningScriptManagedIdentityClientId": "{managedIdentityClientId}",
                            "provisioningScriptShouldRestart": false
                        }
                    ]
                }
            }
        }
    ]
}

az resource update \
  --ids "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevOpsInfrastructure/pools/{poolName}" \
  --api-version "2026-06-02" \
  --set properties.fabricProfile.images[0].provisioningScriptStorageAccountResourceId="/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}" \
        properties.fabricProfile.images[0].provisioningScriptEntryPoint="provisioningscript" \
        properties.fabricProfile.images[0].provisioningScriptManagedIdentityClientId="{managedIdentityClientId}" \
        properties.fabricProfile.images[0].provisioningScriptShouldRestart=false

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2026-06-02' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    fabricProfile: {
      ...
      images: [
        {
          wellKnownImageName: 'ubuntu-24.04'
          provisioningScriptStorageAccountResourceId: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}'
          provisioningScriptEntryPoint: 'provisioningscript'
          provisioningScriptManagedIdentityClientId: '{managedIdentityClientId}'
          provisioningScriptShouldRestart: false
        }
      ]
    }
  }
}

Provisioneringsfouten

De volgende tabel bevat foutcodes en beschrijvingen van het inrichtingsscript.

Scriptlogboeken inrichten

Logboeken van het provisioning-script bevatten de standaarduitvoer (stdout) en de standaardfoutenuitvoer (stderr) die door het script worden gegenereerd. Beheerde DevOps-pools schrijven deze logboeken naar de mdpprovisioningscriptlogs blobcontainer in het opslagaccount dat u opgeeft. De blobs worden geordend onder een virtuele map waarvan de naam de indeling mdp-{poolName}-{agentMachineName}gebruikt. Deze virtuele map bevat een output virtuele map met stderr.log en stdout.log bestanden en een script virtuele map met een kopie van het script dat is uitgevoerd.

Beheerde DevOps-pools beheren deze logboeken niet, dus u moet de bewaarperiode in uw opslagaccount beheren met behulp van Azure Blob Storage beleid voor levenscyclusbeheer. Het volgende voorbeeldbeleid met de naam DeleteOldMDPLogs verwijdert logboek-blobs drie dagen nadat ze voor het laatst zijn gewijzigd.

{
  "rules": [
    {
      "enabled": true,
      "name": "DeleteOldMDPLogs",
      "type": "Lifecycle",
      "definition": {
        "actions": {
          "baseBlob": {
            "delete": {
              "daysAfterModificationGreaterThan": 3
            }
          }
        },
        "filters": {
          "blobTypes": [
            "blockBlob"
          ],
          "prefixMatch": [
            "mdpprovisioningscriptlogs/"
          ]
        }
      }
    }
  ]
}

U kunt AI-hulp krijgen van GitHub Copilot om Azure Blob Storage levenscyclusbeheerbeleid te bouwen. Pas de volgende prompt aan om Azure Blob Storage beleid voor levenscyclusbeheer te maken.

Build an Azure Blob Storage lifecycle management policy named DeleteOldMDPLogs that deletes logs after three days.

Voor meer informatie over het beleid dat door Copilot is gegenereerd, kunt u Copilot vragen een uitleg te geven van het gegenereerde beleid in uw prompt.

Copilot wordt aangedreven door AI, dus verrassingen en fouten zijn mogelijk. Zie voor meer informatie de veelgestelde vragen over algemeen gebruik van Copilot.

Zie Azure Blob Storage beleid voor levenscyclusbeheer en een levenscyclusbeheerbeleid configureren voor meer informatie.

Zie ook

• Een beheerde identiteit configureren voor uw beheerde DevOps-pool
• Beheerde DevOps-pools-images configureren
• Beheerde DevOps-groepen bewaken