Konfigurowanie skryptów aprowizacji dla obrazów usługi Managed DevOps Pools

Zarządzane pule DevOps umożliwiają uruchomienie skryptu programu PowerShell (Windows) lub skryptu powłoki Bash (Linux) dla obrazu w puli, zanim zostanie on przypisany agentowi do uruchomienia zadania. Ta funkcja umożliwia wykonywanie takich zadań, jak instalowanie zaufanych głównych urzędów certyfikacji i ustawianie zmiennych środowiskowych.

Zarządzane pule DevOps używają tożsamości zarządzanej skojarzonej z twoją pulą do pobierania skryptów z usługi Azure Blob Storage na agenta oraz przesyłania dzienników skryptów aprowizacji do celów rozwiązywania problemów. Skrypt aprowizacji jest uruchamiany po uruchomieniu agenta i można skonfigurować agenta do ponownego uruchomienia po uruchomieniu skryptu.

Aby skonfigurować obraz zarządzanej puli DevOps w celu uruchomienia skryptu aprowizacji, wykonaj następujące kroki:

1. Utwórz dwa kontenery obiektów blob na koncie Blob Storage: jeden dla skryptów aprowizacji i plików pomocniczych oraz jeden na potrzeby przekazywania dzienników skryptów aprowizacji. Prześlij skrypty aprowizacji i wszystkie pliki pomocnicze do kontenera obiektów blob dla skryptów.
2. Powiąż tożsamość zarządzaną z pulą Managed DevOps Pool i przypisz wymagane role do tożsamości zarządzanej w odpowiednich zakresach, aby agent mógł odczytywać skrypty aprowizacji i przesyłać dzienniki skryptów aprowizacji.
3. Skonfiguruj obrazy tak, aby używały żądanych skryptów aprowizacji.

Wymagania wstępne

• Konto usługi Azure Blob Storage. Obsługiwanym typem konta usługi Azure Storage dla skryptów aprowizujących pule Managed DevOps jest konto Standard ogólnego przeznaczenia w wersji 2.
• Zarządzana pula DevOps ze skojarzoną tożsamością zarządzaną. Jeśli zarządzana pula DevOps nie ma tożsamości zarządzanej, utwórz je, wykonując kroki opisane w temacie Konfigurowanie tożsamości zarządzanej dla zarządzanej puli DevOps.

Utwórz kontenery obiektów blob

Zarządzane pule DevOps pobierają skrypty aprowizacji i ich pliki pomocnicze z obiektów blob w kontenerze na koncie Blob Storage. Managed DevOps Pools wymaga dwóch kontenerów obiektów blob na koncie magazynu: jednego do pobierania skryptu aprowizacji i plików pomocniczych oraz jednego do przesyłania dzienników skryptu aprowizacji.

Utwórz następujące dwa kontenery obiektów blob na swoim koncie usługi Blob Storage.

Prześlij skrypt aprowizacji i wszelkie pliki pomocnicze do kontenera obiektów blob scripts. Skrypt aprowizacji musi mieć nazwę Startup.ps1 dla obrazów Windows lub Startup.sh obrazów systemu Linux. Możesz dołączyć do obiektu blob wszystkie pliki pomocnicze wymagane przez skrypty. Po uruchomieniu agenta te pliki są pobierane do katalogu roboczego agenta, a skrypt aprowizacji jest wykonywany z tej lokalizacji.

Przypisz role platformy Azure do tożsamości zarządzanej

Managed DevOps Pools używa tożsamości zarządzanej do uzyskiwania dostępu do kontenerów blob dla skryptów aprowizacji i ich dzienników. Musisz skojarzyć tożsamość zarządzaną z pulą Managed DevOps i przypisać określone role do tej tożsamości zarządzanej w zakresach opisanych w tej sekcji. Jeśli zarządzana pula DevOps nie ma tożsamości zarządzanej, utwórz je, wykonując kroki opisane w temacie Konfigurowanie tożsamości zarządzanej dla zarządzanej puli DevOps.

• Jeśli pula Managed DevOps Pool ma jedną skojarzoną tożsamość zarządzaną, ta tożsamość jest używana do uzyskiwania dostępu do skryptu aprowizacji i kontenerów dzienników skryptu aprowizacji.
• Jeśli pula Managed DevOps ma więcej niż jedną skojarzoną zarządzaną tożsamość, podczas konfigurowania obrazu do używania skryptu aprowizacji należy wyznaczyć konkretną zarządzaną tożsamość, która ma być używana przez skrypty aprowizacji, określając właściwość Identyfikator klienta zarządzanej tożsamości (provisioningScriptManagedIdentityResourceId).

Przypisz role z poniższej tabeli do tożsamości zarządzanej skojarzonej z pulą Managed DevOps w określonych zakresach, aby umożliwić agentowi pobieranie skryptów i przesyłanie dzienników skryptu aprowizacji. Aby uzyskać więcej informacji na temat przypisywania ról Azure, zobacz Kroki przypisywania roli Azure.

Skonfiguruj obraz, aby używał skryptu aprowizującego

Aby użyć skryptu aprowizacji z obrazem, skonfiguruj następujące właściwości obrazu.

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

Błędy konfiguracyjne

W poniższej tabeli wymieniono kody błędów i opisy skryptu aprowizacji.

Dzienniki skryptu inicjowania obsługi

Dzienniki skryptów aprowizacji zawierają standardowe dane wyjściowe (stdout) i błąd standardowy (stderr) wygenerowany przez skrypt. Zarządzane pule DevOps zapisują te dzienniki w kontenerze obiektów blob mdpprovisioningscriptlogs na wskazanym koncie magazynu. Obiekty blob są zorganizowane w katalogu wirtualnym, którego nazwa ma format mdp-{poolName}-{agentMachineName}. Ten katalog wirtualny zawiera output katalog wirtualny z plikami stderr.log i stdout.log oraz script katalog wirtualny z kopią uruchomionego skryptu.

Zarządzane pule DevOps nie zarządzają tymi dziennikami, dlatego należy zarządzać okresem ich przechowywania na swoim koncie magazynu za pomocą zasad zarządzania cyklem życia usługi Azure Blob Storage. Poniższe przykładowe zasady o nazwie DeleteOldMDPLogs usuwają obiekty blob dziennika trzy dni po ich ostatniej modyfikacji.

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

Możesz uzyskać pomoc dotyczącą sztucznej inteligencji od GitHub Copilot do tworzenia zasad zarządzania cyklem życia Azure Blob Storage. Dostosuj następujący monit, aby utworzyć zasady zarządzania cyklem życia Azure Blob Storage.

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

Aby uzyskać więcej informacji na temat zasad generowanych przez Copilot, możesz poprosić Copilot o podanie wyjaśnienia wygenerowanych zasad w wierszu polecenia.

Copilot jest obsługiwany przez sztuczną inteligencję, więc możliwe są niespodzianki i błędy. Aby uzyskać więcej informacji, zobacz Copilot — często zadawane pytania.

Aby uzyskać więcej informacji, zobacz Azure Blob Storage zasady zarządzania cyklem życia i Konfigurowanie zasad zarządzania cyklem życia.

Zobacz także

• Skonfiguruj tożsamość zarządzaną dla usługi Managed DevOps Pool
• Konfigurowanie obrazów zarządzanych pul DevOps
• Monitorowanie zarządzanych pul DevOps