Configure los scripts de aprovisionamiento para las imágenes de Managed DevOps Pools

Los grupos administrados de DevOps permiten ejecutar un script de PowerShell (Windows) o de Bash (Linux) en una imagen de un grupo antes de asignarla a un agente para ejecutar un trabajo. Esta característica habilita escenarios como la instalación de entidades de certificación raíz de confianza y la configuración de variables de entorno.

Los grupos de DevOps administrados usan una identidad administrada asociada al grupo para descargar los scripts de Azure Blob Storage al agente y cargar registros de scripts de aprovisionamiento para solucionar problemas. El script de aprovisionamiento se ejecuta cuando se inicia el agente y puede configurar el agente para que se reinicie después de que se ejecute el script.

Para configurar una imagen de grupo de DevOps administrado para ejecutar un script de aprovisionamiento, siga estos pasos:

1. Cree dos contenedores de blobs en una cuenta de Blob Storage: una para los scripts de aprovisionamiento y los archivos auxiliares, y otra para cargar registros de scripts de aprovisionamiento. Cargue los scripts de aprovisionamiento y los archivos de soporte en el contenedor de blobs del script.
2. Asocie una identidad administrada al grupo de DevOps administrado y asigne los roles necesarios a la identidad administrada en los ámbitos adecuados para que el agente pueda leer los scripts de aprovisionamiento y cargar los registros de scripts de aprovisionamiento.
3. Configure las imágenes para usar los scripts de aprovisionamiento deseados.

Prerequisites

• Una cuenta Azure Blob Storage. El tipo de cuenta de almacenamiento de Azure compatible con los scripts de aprovisionamiento de pools de DevOps administrados es Estándar de uso general v2.
• Un grupo de DevOps administrado con una identidad administrada asociada. Si el grupo de DevOps administrado no tiene una identidad administrada, cree una siguiendo los pasos descritos en Configuración de una identidad administrada para el grupo de DevOps administrado.

Creación de contenedores de blobs

Los grupos administrados de DevOps descargan scripts de aprovisionamiento y sus archivos auxiliares desde objetos binarios almacenados en un contenedor de una cuenta de Blob Storage. Los grupos de DevOps administrados requieren dos contenedores de blobs en la cuenta de almacenamiento: uno para descargar el script de aprovisionamiento y los archivos auxiliares, y otro para cargar registros de scripts de aprovisionamiento.

Cree los dos contenedores de blobs siguientes en la cuenta de Blob Storage.

Cargue el script de aprovisionamiento y los archivos auxiliares en el contenedor de blobs de scripts. El script de aprovisionamiento debe llamarse Startup.ps1 para imágenes de Windows, o Startup.sh para imágenes de Linux. Puede incluir en el blob cualquier archivo de apoyo que requieran los scripts. Cuando se inicia el agente, estos archivos se descargan en el directorio de trabajo del agente y el script de aprovisionamiento se ejecuta desde esa ubicación.

Asignación de roles de Azure a la identidad administrada

Managed DevOps Pools usa una identidad administrada para acceder a los contenedores de blobs de los scripts de aprovisionamiento y sus registros. Debe asociar una identidad administrada con el grupo de DevOps administrado y asignar los roles especificados a la identidad administrada en los ámbitos descritos en esta sección. Si el grupo de DevOps administrado no tiene una identidad administrada, cree una siguiendo los pasos descritos en Configuración de una identidad administrada para el grupo de DevOps administrado.

• Si su Managed DevOps Pool tiene una única identidad administrada asociada, esa identidad se utiliza para acceder al script de aprovisionamiento y a los contenedores de registros del script de aprovisionamiento.
• Si su grupo administrado de DevOps tiene más de una identidad administrada asociada, designe una identidad administrada específica para usarla con los scripts de aprovisionamiento; para ello, especifique la propiedad Id. de cliente de identidad administrada (provisioningScriptManagedIdentityResourceId) al configurar su imagen para usar un script de aprovisionamiento.

Asigne los roles de la siguiente tabla a la identidad administrada asociada del grupo de Managed DevOps en los ámbitos especificados para permitir que el agente descargue los scripts y cargue los registros del script de aprovisionamiento. Para obtener más información sobre cómo asignar roles de Azure, consulte Pasos para asignar un rol de Azure.

Configure su imagen para usar el script de aprovisionamiento

Para usar un script de aprovisionamiento con una imagen, configure las siguientes propiedades de imagen.

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

Errores de aprovisionamiento

En la tabla siguiente se enumeran los códigos de error y las descripciones del script de aprovisionamiento.

Registros del script de aprovisionamiento

Los registros de script de aprovisionamiento contienen la salida estándar (stdout) y el error estándar (stderr) generados por el script. Managed DevOps Pools escribe estos registros en el contenedor de blobs mdpprovisioningscriptlogs de la cuenta de almacenamiento que especifique. Los blobs se organizan en un directorio virtual cuyo nombre usa el formato mdp-{poolName}-{agentMachineName}. Este directorio virtual contiene un output directorio virtual con stderr.log archivos y stdout.log y un script directorio virtual con una copia del script que se ejecutó.

Managed DevOps Pools no administra estos registros, por lo que debe administrar su retención en la cuenta de almacenamiento mediante las directivas de administración del ciclo de vida de Azure Blob Storage. La siguiente directiva de ejemplo denominada DeleteOldMDPLogs elimina blobs de registro tres días después de la última modificación.

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

Puede obtener ayuda de inteligencia artificial de GitHub Copilot para crear directivas de administración del ciclo de vida de Azure Blob Storage. Personalice el siguiente mensaje para crear directivas de administración del ciclo de vida de Azure Blob Storage.

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

Para obtener más detalles sobre la directiva generada por Copilot, puede pedir Copilot que proporcione una explicación de la directiva generada en el mensaje.

Copilot funciona con IA, por lo que es posible que se produzcan sorpresas y errores. Para obtener más información, consulte las preguntas frecuentes sobre el uso general de Copilot.

Para obtener más información, consulte Azure Blob Storage directivas de administración del ciclo de vida y Configuración de una directiva de administración del ciclo de vida.

Consulte también

• Configuración de una identidad administrada para el grupo de DevOps administrado
• Configurar imágenes de grupos de DevOps administrados
• Supervisión de grupos de DevOps administrados