Configurar scripts de aprovisionamento das imagens do Managed DevOps Pools

Os Managed DevOps Pools oferecem a opção de executar um script PowerShell (Windows) ou um script Bash (Linux) para uma imagem num pool antes de ser atribuída a um agente para executar um trabalho. Esta funcionalidade permite cenários como a instalação de CAs raiz confiáveis e a definição de variáveis de ambiente.

O Managed DevOps Pools utiliza uma identidade gerida associada ao seu pool para transferir os scripts do Armazenamento de Blobs do Azure para o agente e carregar os registos dos scripts de aprovisionamento para resolução de problemas. O script de provisionamento corre quando o agente inicia, e podes configurar o agente para reiniciar depois do script ser executado.

Para configurar uma imagem de Managed DevOps Pool para executar um script de provisionamento, execute os seguintes passos:

1. Crie dois contentores de blob numa conta de Armazenamento de Blobs: um para os scripts de provisionamento e ficheiros de suporte, e outro para carregar registos de scripts de provisionamento. Carrega os teus scripts de provisionamento e quaisquer ficheiros de suporte para o contentor de blob de scripts.
2. Associe uma identidade gerida ao seu Managed DevOps Pool e atribua os papéis necessários à identidade gerida nos escopos apropriados para que o agente possa ler os scripts de provisionamento e carregar os logs de scripts de provisionamento.
3. Configura as tuas imagens para utilizar os scripts de provisionamento desejados.

Pré-requisitos

• Uma conta Armazenamento de Blobs do Azure. O tipo de conta do Armazenamento do Azure suportado para scripts de aprovisionamento de Managed DevOps Pools é Standard general-purpose v2.
• Um conjunto gerido de DevOps com uma identidade gerida associada. Se o seu Managed DevOps Pool não tiver uma identidade gerida, crie uma seguindo os passos em Configurar uma identidade gerida para o seu Managed DevOps Pool.

Crie os contentores de blobs

Os Pools DevOps Geridos descarregam scripts de provisionamento e os seus ficheiros de suporte a partir de blobs num contentor numa conta Armazenamento de Blobs. Os Pools DevOps Geridos requerem dois contentores de blob na conta de armazenamento: um para descarregar o script de provisionamento e os ficheiros de suporte, e outro para carregar os logs dos scripts de provisionamento.

Crie os seguintes dois contentores de blob na sua conta de Armazenamento de Blobs.

Carrega o teu script de provisionamento e quaisquer ficheiros de suporte para o contentor de blob do script. O script de provisionamento deve ser nomeado Startup.ps1 para imagens do Windows ou Startup.sh para imagens do Linux. Podes incluir quaisquer ficheiros de suporte exigidos pelos scripts no blob. Quando o agente inicia, estes ficheiros são descarregados para o diretório de trabalho do agente, e o script de provisionamento é executado a partir dessa localização.

Atribuir funções do Azure à identidade gerida

Managed DevOps Pools utiliza uma identidade gerida para aceder aos contentores de blobs dos scripts de provisionamento e aos registos desses scripts. Deve associar uma identidade gerida ao seu Pool de DevOps Gerido e atribuir as funções especificadas à identidade gerida nos âmbitos descritos nesta secção. Se o seu Managed DevOps Pool não tiver uma identidade gerida, crie uma seguindo os passos em Configurar uma identidade gerida para o seu Managed DevOps Pool.

• Se o seu Managed DevOps Pool tiver uma única identidade gerida associada, essa identidade é utilizada para aceder aos contentores do script de aprovisionamento e dos registos do script de aprovisionamento.
• Se o seu Managed DevOps Pool tiver mais do que uma identidade gerida associada, designe uma identidade gerida específica para usar no provisionamento de scripts, especificando a propriedade Managed ID do cliente (provisioningScriptManagedIdentityResourceId) ao configurar a sua imagem para usar um script de provisionamento.

Atribuir os papéis na tabela seguinte à identidade gerida associada ao Managed DevOps Pool nos escopos especificados para permitir que o agente descarregue os scripts e carregue os registos de scripts de provisionamento. Para mais informações sobre atribuição de funções no Azure, consulte Passos para atribuir uma função no Azure.

Configure a sua imagem para usar o script de provisionamento

Para usar um script de provisionamento com uma imagem, configure as seguintes propriedades da imagem.

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

Erros de provisionamento

A tabela seguinte lista os códigos de erro e as respetivas descrições dos scripts de aprovisionamento.

Provisionamento de logs de scripts

Os logs de script de provisionamento contêm a saída padrão (stdout) e o erro padrão (stderr) gerados pelo script. Os Conjuntos de DevOps geridos escrevem estes registos no contentor de blobs mdpprovisioningscriptlogs na conta de armazenamento que indicar. Os blobs estão organizados sob um diretório virtual cujo nome utiliza o formato mdp-{poolName}-{agentMachineName}. Este diretório virtual contém um output diretório virtual com stderr.log e stdout.log ficheiros, e um script diretório virtual com uma cópia do script que foi executado.

O Managed DevOps Pools não gere estes registos, por isso deve gerir a sua retenção na sua conta de armazenamento usando as políticas de gestão do ciclo de vida do Armazenamento de Blobs do Azure. A política de exemplo seguinte, denominada DeleteOldMDPLogs, elimina blobs de registo três dias após a sua última modificação.

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

Pode obter assistência de IA no GitHub Copilot para construir políticas de gestão do ciclo de vida do Armazenamento de Blobs do Azure. Personalize o seguinte prompt para criar políticas de gestão do ciclo de vida do Armazenamento de Blobs do Azure.

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

Para obter mais detalhes sobre a apólice gerada pelo Copilot, pode pedir ao Copilot que forneça uma explicação da apólice gerada no seu prompt.

O Copilot é alimentado por IA, por isso surpresas e erros são possíveis. Para mais informações, consulte Perguntas frequentes sobre o uso geral do Copilot.

Para mais informações, consulte as políticas de gestão do ciclo de vida do Armazenamento de Blobs do Azure e Configurar uma política de gestão do ciclo de vida.

Consulte também

• Configure uma identidade gerida para o seu Managed DevOps Pool
• Configurar imagens de pools de DevOps gerenciados
• Monitorizar pools de DevOps geridos