Configurare gli script di provisioning per le immagini dei pool di DevOps gestiti

I pool DevOps gestiti offrono la possibilità di eseguire uno script di PowerShell (Windows) o uno script Bash (Linux) per un'immagine in un pool prima che venga assegnato a un agente per eseguire un processo. Questa funzionalità abilita scenari come l'installazione di ca radice attendibili e l'impostazione delle variabili di ambiente.

I pool DevOps gestiti usano un'identità gestita associata al pool per scaricare gli script da Archiviazione BLOB di Azure all'agente e caricare i log degli script di provisioning per la risoluzione dei problemi. Lo script di provisioning viene eseguito all'avvio dell'agente ed è possibile configurare l'agente per il riavvio dopo l'esecuzione dello script.

Per configurare un'immagine del pool DevOps gestito per eseguire uno script di provisioning, seguire questa procedura:

1. Creare due contenitori BLOB in un account gestione rete virtuale di Azure: uno per gli script di provisioning e i file di supporto e uno per il caricamento dei log di script di provisioning. Carica gli script di provisioning e gli eventuali file di supporto nel contenitore BLOB degli script.
2. Associare un'identità gestita al pool di DevOps gestito e assegnare i ruoli necessari all'identità gestita negli ambiti appropriati in modo che l'agente possa leggere gli script di provisioning e caricare i log degli script di provisioning.
3. Configurate le immagini per utilizzare gli script di provisioning desiderati.

Prerequisiti

• Un account di Archiviazione BLOB di Azure. Il tipo di account Archiviazione di Azure supportato per gli script di provisioning dei pool di DevOps gestiti è Standard per utilizzo generico v2.
• Un pool DevOps gestito con un'identità gestita associata. Se il pool devOps gestito non ha un'identità gestita, crearne uno seguendo la procedura descritta in Configurare un'identità gestita per il pool DevOps gestito.

Creare i contenitori blob

I pool devOps gestiti scaricano gli script di provisioning e i relativi file di supporto dai BLOB in un contenitore in un account gestione rete virtuale di Azure. I pool DevOps gestiti richiedono due contenitori BLOB nell'account di archiviazione: uno per scaricare lo script di provisioning e i file di supporto e uno per il caricamento dei log di script di provisioning.

Creare i due contenitori BLOB seguenti nell'account gestione rete virtuale di Azure.

Carica lo script di provisioning e gli eventuali file di supporto nel contenitore blob degli script. Lo script di provisioning deve essere denominato Startup.ps1 per le immagini Windows o Startup.sh per le immagini Linux. È possibile includere qualsiasi file di supporto richiesto dagli script nel BLOB. All'avvio dell'agente, questi file vengono scaricati nella directory di lavoro dell'agente e lo script di provisioning viene eseguito da questa posizione.

Assegnare ruoli di Azure all'identità gestita

I pool DevOps gestiti usano un'identità gestita per accedere ai contenitori blob per gli script di provisioning e i log degli script di provisioning. È necessario associare un'identità gestita al pool devOps gestito e assegnare i ruoli specificati all'identità gestita negli ambiti descritti in questa sezione. Se il pool devOps gestito non ha un'identità gestita, crearne uno seguendo la procedura descritta in Configurare un'identità gestita per il pool DevOps gestito.

• Se il pool DevOps gestito ha una sola identità gestita associata, tale identità viene utilizzata per accedere allo script di provisioning e ai contenitori dei log dello script di provisioning.
• Se il tuo Managed DevOps Pool ha più di un'identità gestita associata, designa un'identità gestita specifica da usare per gli script di provisioning specificando la proprietà ID client dell'identità gestita (provisioningScriptManagedIdentityResourceId) quando configuri l'immagine per usare uno script di provisioning.

Assegnare i ruoli nella tabella seguente all'identità gestita associata al Managed DevOps Pool negli ambiti indicati per consentire all'agente di scaricare gli script e caricare i log dello script di provisioning. Per altre informazioni sull'assegnazione di ruoli Azure, vedere Passaggi per assegnare un ruolo Azure.

Configura l'immagine per utilizzare lo script di provisioning

Per usare uno script di provisioning con un'immagine, configurare le proprietà dell'immagine seguenti.

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

Errori di provisioning di sistema

Nella tabella seguente sono elencati i codici di errore e le descrizioni degli script di provisioning.

Log degli script di provisioning

I log degli script di provisioning contengono l'output standard (stdout) e l'errore standard (stderr) generati dallo script. I pool DevOps gestiti scrivono questi log nel contenitore BLOB mdpprovisioningscriptlogs dell'account di archiviazione specificato. I BLOB sono organizzati in una directory virtuale il cui nome usa il formato mdp-{poolName}-{agentMachineName}. Questa directory virtuale contiene una directory virtuale output con file stderr.log e stdout.log, e una directory virtuale script con una copia dello script che è stato eseguito.

I pool DevOps gestiti non gestiscono questi log, quindi è necessario gestire la conservazione nell'account di archiviazione usando i criteri di gestione del ciclo di vita Archiviazione BLOB di Azure. Il criterio di esempio seguente denominato DeleteOldMDPLogs elimina i BLOB di log tre giorni dopo l'ultima modifica.

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

È possibile ottenere assistenza per l'intelligenza artificiale da GitHub Copilot per creare criteri di gestione del ciclo di vita Archiviazione BLOB di Azure. Personalizza il prompt seguente per creare i criteri di gestione del ciclo di vita di Archiviazione BLOB di Azure.

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

Per ottenere altri dettagli sui criteri generati da Copilot, è possibile chiedere Copilot di fornire una spiegazione dei criteri generati nella richiesta.

Copilot è alimentato dall'IA, quindi sono possibili sorprese ed errori. Per ulteriori informazioni, consultare le FAQ generali sull'utilizzo di Copilot.

Per altre informazioni, vedere Archiviazione BLOB di Azure criteri di gestione del ciclo di vita e Configurare i criteri di gestione del ciclo di vita.

Vedere anche

• Configurare un'identità gestita per il pool devOps gestito
• Configurare le immagini di Managed DevOps Pools
• Monitora i pool DevOps gestiti