Configurar imágenes de grupos de DevOps administrados

Los Pools de DevOps gestionados te proporcionan varias opciones para las imágenes de máquina virtual (VM) para ejecutar pipelines en tu pool. Puede crear un grupo utilizando imágenes de VM del Marketplace seleccionadas, usar sus propias imágenes personalizadas de Azure Compute Gallery, o aprovechar las mismas imágenes que utilizan los agentes hospedados por Microsoft en Azure Pipelines.

Nota:

Las siguientes imágenes están obsoletas y se han eliminado.

Azure Pipelines: Windows Server 2019
Ubuntu 20.04

Para más información, véase Programación de obsolescencia de imágenes de grupos de DevOps administrados.

Puede configurar un grupo con una sola imagen o varias imágenes. Cuando tu grupo de recursos tiene varias imágenes, tus canalizaciones especifican la imagen en la que quieren ejecutarse mediante alias.

Selecciona la imagen de tu grupo

Se selecciona una imagen predeterminada al crear un grupo de DevOps administrado. Puede mantener la opción predeterminada o cambiarla durante la creación del grupo. Para configurar la imagen después de la creación del grupo, vaya a Configuración>Pool. Seleccione Agregar desde la Biblioteca de Imágenes, y luego seleccione una o varias imágenes para su conjunto.

Captura de pantalla que muestra cómo configurar una imagen.

Puede configurar imágenes en la fabricProfile sección de las propiedades del recurso de grupos de DevOps gestionados.

En el ejemplo siguiente se especifican tres imágenes. Para obtener más información sobre el esquema de las imágenes, consulte las secciones siguientes de este artículo.

{
    "$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": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    ...
                    "images": [
                        {
                            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
                            "aliases": [
                                "ubuntu-24.04-gen2"
                            ]
                        },
                        {
                            "wellKnownImageName": "windows-2022"
                        },
                        {
                            "wellKnownImageName": "ubuntu-22.04"
                        }
                    ]
                }
            }
        }
    ]
}

Cada imagen puede tener las siguientes propiedades:

Propiedad	Descripción
`aliases`	Una lista opcional de alias. Puede hacer referencia a la imagen mediante los alias en lugar del identificador de recurso completo de la imagen.
`resourceID`	Identificador de recurso de la imagen que se va a usar. Se requiere cuando se usan imágenes de Azure Compute Gallery o imágenes de Marketplace seleccionadas.
`wellKnownImageName`	El alias de la imagen de Azure Pipelines. Se requiere cuando se usan imágenes de Azure Pipelines.
`buffer`	Al habilitar agentes en espera, el `buffer` valor designa el porcentaje de agentes en espera que se asignarán a esta imagen. El total de todos los valores de imagen `buffer` debe ser igual a 100.

En el ejemplo siguiente se definen tres imágenes. Los agentes en reserva están habilitados, y el 100% de los agentes en reserva se asignan a la imagen windows-2022.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
        "aliases": [
            "ubuntu-24.04-gen2"
        ],
        "buffer": "0"
    },
    {
        "buffer": "100",
        "wellKnownImageName": "windows-2022"
    },
    {
        "buffer": "0",
        "wellKnownImageName": "ubuntu-22.04"
    }
]

Puede configurar imágenes en la fabric-profile sección de las propiedades del recurso de grupos de DevOps gestionados.

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

En el ejemplo siguiente se muestra la images sección del fabric-profile.json archivo y se especifican tres imágenes. Para obtener más información sobre el esquema de las imágenes, consulte las secciones siguientes de este artículo.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
            "aliases": [
                "ubuntu-24.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Cada imagen puede tener las siguientes propiedades:

Propiedad	Descripción
`aliases`	Una lista opcional de alias. Puede hacer referencia a la imagen mediante los alias en lugar del identificador de recurso completo de la imagen.
`resourceID`	Identificador de recurso de la imagen que se va a usar. Se requiere cuando se usan imágenes de Azure Compute Gallery o imágenes de Marketplace seleccionadas.
`wellKnownImageName`	El alias de la imagen de Azure Pipelines. Se requiere cuando se usan imágenes de Azure Pipelines.
`buffer`	Al habilitar agentes en espera, el `buffer` valor designa el porcentaje de agentes en espera que se asignarán a esta imagen. El total de todos los valores de imagen `buffer` debe ser igual a 100.

En el ejemplo siguiente se definen tres imágenes. Los agentes en espera están habilitados y el 100% de los agentes en espera están asignados a la windows-2022 imagen.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
            "aliases": [
                "ubuntu-24.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Puede configurar imágenes en la fabricProfile sección de las propiedades del recurso de grupos de DevOps gestionados.

En el ejemplo siguiente se especifican tres imágenes. Para obtener más información sobre el esquema de las imágenes, consulte las secciones siguientes de este artículo.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    fabricProfile: {
      ...
      images: [
        {
          resourceId: '/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest'
          aliases: [
            'ubuntu-24.04-gen2'
          ]
        }
        {
          wellKnownImageName: 'windows-2022'
        }
        {
          wellKnownImageName: 'ubuntu-22.04'
        }
      ]
    }
  }
}

Cada imagen puede tener las siguientes propiedades:

Propiedad	Descripción
`aliases`	Una lista opcional de alias. Puede hacer referencia a la imagen mediante los alias en lugar del identificador de recurso completo de la imagen.
`resourceID`	Identificador de recurso de la imagen que se va a usar. Se requiere cuando se usan imágenes de Azure Compute Gallery o imágenes de Marketplace seleccionadas.
`wellKnownImageName`	El alias de la imagen de Azure Pipelines. Se requiere cuando se usan imágenes de Azure Pipelines.
`buffer`	Al habilitar agentes en espera, el `buffer` valor designa el porcentaje de agentes en espera que se asignarán a esta imagen. El total de todos los valores de imagen `buffer` debe ser igual a 100.

En el ejemplo siguiente se definen tres imágenes. Los agentes en espera están habilitados y el 100% de los agentes en espera están asignados a la windows-2022 imagen.

images: [
  {
    resourceId: '/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest'
    aliases: [
      'ubuntu-24.04-gen2'
    ]
    buffer: 0
  }
  {
    buffer: 100
    wellKnownImageName: 'windows-2022'
  }
  {
    buffer: 0
    wellKnownImageName: 'ubuntu-22.04'
  }
]

Si selecciona una sola imagen, todos los pipelines de su grupo se ejecutan mediante esa imagen. Si selecciona varias imágenes, puede especificar la imagen que se usará por canalización. Para más información, consulte Uso de varias imágenes por grupo.

Si tiene varias imágenes en su grupo de imágenes y no usa requisitos en las canalizaciones para designar una imagen, las canalizaciones se ejecutan mediante la primera imagen listada en el grupo de imágenes. Puede cambiar el orden de las imágenes en su colección de dos maneras:

Usar plantillas: Cambie el orden de las imágenes en la images lista de la fabricProfile sección.
Use el arrastre: ordene las imágenes de la lista de imágenes en Azure Portal.

Puede seleccionar entre los siguientes tipos de imágenes:

Imágenes de Azure Pipelines: seleccione entre las mismas imágenes que usan los agentes hospedados por Microsoft.
Imágenes de Marketplace seleccionadas: seleccione entre un conjunto mantenido de imágenes de máquina virtual de Marketplace publicadas por Microsoft.
Imágenes de Azure Compute Gallery: seleccione entre sus propias imágenes de Azure Compute Gallery. Debe asignar el rol de Lector a la DevOpsInfrastructure entidad de servicio para las imágenes de Azure Compute Gallery que desea usar. Para obtener más información, consulte Concesión de acceso de rol lector a la DevOpsInfrastructure entidad de servicio.

Imágenes de Azure Pipelines

Los grupos de DevOps administrados proporcionan varias imágenes preconfiguradas que tienen el mismo software que los agentes hospedados por Microsoft seleccionados para Azure Pipelines.

El ciclo de vida de las imágenes de Azure Pipelines que se ofrecen en grupos de DevOps administrados sigue el ciclo de vida de las imágenes del agente hospedado por Microsoft. Si una imagen de los agentes hospedados por Microsoft está en desuso, la imagen correspondiente de los pools de DevOps administrados también se considera en desuso durante un período de tiempo similar. La versión de las imágenes disponibles en los agentes hospedados por Microsoft podría ser ligeramente diferente de la versión de las imágenes disponibles en grupos de DevOps administrados para el mismo tipo de imagen.

Para obtener más información sobre el ciclo de vida de las imágenes en los grupos administrados de DevOps, consulte Ciclo de vida de las imágenes.

Para especificar una imagen de Azure Pipelines, selecciónela en la lista.

Captura de pantalla que muestra imágenes de Azure Pipelines.

Al especificar una imagen de Azure Pipelines mediante Azure Portal, la versión más reciente de la imagen se usa de forma predeterminada. Si una nueva versión de una imagen de Azure Pipelines rompe tu pipeline, puedes elegir una versión anterior de la lista Versión.

Para especificar una imagen de Azure Pipelines, proporcione el alias de la imagen mediante la wellKnownImageName propiedad . Consulte una lista de alias predefinidos para imágenes de Azure Pipelines.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

Puede especificar una versión en la wellKnownImageName configuración (por ejemplo "wellKnownImageName": "windows-2022/latest" , o "wellKnownImageName": "windows-2022/20250427.1.0"). Si no especifica una versión, latest se usa.

Para especificar una imagen de Azure Pipelines, proporcione el alias predefinido de la imagen mediante la wellKnownImageName propiedad . Consulte una lista de alias predefinidos para imágenes de Azure Pipelines.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

images: [
  {
    wellKnownImageName: 'windows-2022'
  }
]

Puede especificar una versión en la wellKnownImageName configuración (por ejemplo wellKnownImageName: 'windows-2022/latest' , o wellKnownImageName: 'windows-2022/20250427.1.0'). Si no especifica una versión, latest se usa.

Cada imagen incluye el siguiente software instalado:

Imagen	Software incluido
Azure Pipelines: Windows Server 2025	Software incluido
Azure Pipelines: Windows Server 2022	Software incluido
Azure Pipelines: Ubuntu 24.04	Software incluido
Azure Pipelines: Ubuntu 22.04	Software incluido

Nota:

Las siguientes imágenes están obsoletas y se han eliminado.

Azure Pipelines: Windows Server 2019
Ubuntu 20.04

Para más información, véase Programación de obsolescencia de imágenes de grupos de DevOps administrados.

Imágenes de Marketplace seleccionadas

Los grupos de DevOps gestionados proporcionan un conjunto seleccionado de imágenes de máquina virtual de marketplace publicadas por Microsoft para su uso en los grupos.

Captura de pantalla que muestra las imágenes de Marketplace seleccionadas.

Elija Imágenes de Marketplace seleccionadas. Seleccione la imagen deseada y, a continuación, seleccione la versión deseada. Para usar siempre la versión más reciente de una imagen, seleccione latest (Más reciente).

Para especificar una imagen de Marketplace seleccionada, proporcione el identificador de recurso de la imagen mediante la resourceId propiedad .

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/Publishers/canonical/ArtifactTypes/VMImage/Offers/ubuntu-24_04-lts/Skus/server/versions/latest"
    }
]

Para especificar una imagen de Marketplace seleccionada, proporcione el identificador de recurso de la imagen mediante la resourceId propiedad .

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/Publishers/canonical/ArtifactTypes/VMImage/Offers/ubuntu-24_04-lts/Skus/server/versions/latest"
    }
]

Para especificar una imagen de Marketplace seleccionada, proporcione el identificador de recurso de la imagen mediante la resourceId propiedad .

images: [
  {
    resourceId: '/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest'
  }
]

Imágenes de Azure Compute Gallery

Seleccione Imágenes de Azure Compute Gallery para especificar una imagen de cualquier galería disponible en las suscripciones. Se admiten imágenes generalizadas con los siguientes sistemas operativos:

Windows Server 2025
Windows Server 2022
Windows 11
Ubuntu 24.04
Ubuntu 22.04
Debian 9
RHEL 9
RHEL 8
SUSE 15
SUSE 12

Importante

Los grupos de DevOps administrados solo admiten imágenes generalizadas de Azure Compute Gallery.

Los grupos de DevOps administrados no admiten imágenes de Azure Compute Gallery que cree mediante una imagen base de pago. Si recibe un error como "Image Base no se admite, ya que es una imagen de pago. Proporcione una imagen diferente gratuita", seleccione otra imagen de Azure Compute Gallery basada en una máquina virtual que cree mediante un plan de precios gratuito para la imagen base.

Captura de pantalla que muestra imágenes de Azure Compute Gallery.

Para especificar una imagen de Azure Compute Gallery, proporcione el identificador de recurso de la imagen mediante la resourceId propiedad .

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404"
    }
]

Para especificar una imagen de Azure Compute Gallery, proporcione el identificador de recurso de la imagen mediante la resourceId propiedad .

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404"
    }
]

Para especificar una imagen de Azure Compute Gallery, proporcione el identificador de recurso de la imagen mediante la resourceId propiedad .

images: [
  {
    resourceId: '/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404'
  }
]

Concesión de acceso de rol lector a la entidad de servicio DevOpsInfrastructure

Importante

Asigne el rol Lector al DevOpsInfrastructure principal de servicio para las imágenes de Azure Compute Gallery que desea usar. Si selecciona una imagen de Azure Compute Gallery que no tiene este acceso configurado, se producirá un error en la creación del grupo. Puede asignar el rol Lector individualmente en el nivel de imagen o en el nivel de galería de imágenes para todas las imágenes de la galería.

Vaya al recurso de almacenamiento deseado en Azure Portal. Para usar todas las imágenes de una galería, vaya a Azure Compute Gallery en Azure Portal. Para usar solo una imagen específica, vaya a esa imagen.
Selecciona Access Control (IAM).
Seleccione Agregar>Agregar asignación de roles para abrir la página Agregar asignación de roles.
Asigna el siguiente rol. Para ver los pasos detallados, consulte Asignación de roles de Azure mediante Azure Portal.

Configuración Valor

Rol Lector

Asignar acceso a entidad de servicio

Miembros DevOpsInfrastructure

Configuración	Valor
Rol	Lector
Asignar acceso a	entidad de servicio
Miembros	`DevOpsInfrastructure`

Usar varias imágenes por grupo con alias

Si hay varias imágenes en el grupo, puede definir la canalización de Azure DevOps para que use una imagen específica haciendo referencia a un alias para esa imagen.

Usar plantillas: Cambie el orden de las imágenes en la images lista de la fabricProfile sección.
Use el arrastre: ordene las imágenes de la lista de imágenes en Azure Portal.

Si las tuberías experimentan problemas después de agregar una nueva imagen al repositorio, compruebe el orden de las imágenes de la lista. Considere la posibilidad de usar demandas y alias para designar explícitamente qué imagen debe usar cada canalización.

Configuración de alias de imagen

Para agregar y administrar alias de imagen, vaya a la sección Imágenes de la configuración del grupo y seleccione ...>Agregue alias.

Agregue los alias deseados a la lista Alias y, a continuación, seleccione Guardar.

Captura de pantalla que muestra el panel Alias.

En el ejemplo siguiente se muestra un grupo con dos imágenes de Azure Pipelines y una imagen de Marketplace seleccionada. Las imágenes de Azure Pipeline muestran sus alias predeterminados y la imagen de Marketplace seleccionada muestra un único alias configurado denominado ubuntu-24.04-gen2.

Captura de pantalla que muestra un conjunto de varias imágenes con alias.

Para configurar alias, especifíquelos en la lista aliases. En el ejemplo siguiente se define una imagen con un único alias denominado ubuntu-24.04-gen2.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
        "aliases": [
            "ubuntu-24.04-gen2"
        ]
    }
]

Para configurar alias, especifíquelos en la lista aliases. En el ejemplo siguiente se define una imagen con un único alias denominado ubuntu-24.04-gen2.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
        "aliases": [
            "ubuntu-24.04-gen2"
        ]
    }
]

Para configurar alias, especifíquelos en la lista aliases. En el ejemplo siguiente se define una imagen con un único alias denominado ubuntu-24.04-gen2.

images: [
  {
    resourceId: '/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest'
    aliases: [
        'ubuntu-24.04-gen2'
    ]
  }
]

Alias de imágenes predefinidas de Azure Pipelines

Además de los alias que configure, las imágenes de Azure Pipelines tienen los siguientes alias predefinidos.

Imagen de Azure Pipelines	Alias predefinido
Azure Pipelines: Windows Server 2025	`windows-2025`
Azure Pipelines: Windows Server 2022	`windows-2022`
Azure Pipelines: Ubuntu 24.04	`ubuntu-24.04`
Azure Pipelines: Ubuntu 22.04	`ubuntu-22.04`

Uso de demandas para especificar una imagen

Si hay varias imágenes en el grupo, puede definir una canalización para que se ejecute en una imagen específica mediante una petición con el nombre ImageOverride. Cuando especificas la demanda en la ImageOverride canalización, los Pools de DevOps administrados envían el trabajo solo a los agentes que usan esa imagen.

Para ejecutar una canalización en la imagen de Ubuntu 24.04 del ejemplo anterior que tenía el alias ubuntu-24.04-gen2, indique el siguiente requisito en la sección pool de la canalización.

pool:
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals ubuntu-24.04-gen2

Importante

No coloque comillas alrededor del nombre del alias en el comando ImageOverride, incluso si el nombre tiene espacios.

Para ejecutar una canalización mediante una imagen de Azure Pipelines en tu grupo, use el alias de la tabla anterior. Para ejecutar una canalización en la imagen de Windows Server 2022 de Azure Pipelines del ejemplo anterior, indique la siguiente demanda en la sección pool de la canalización:

pool:
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals windows-2022

Ciclo de vida de la imagen

Las imágenes de los agentes de los Grupos DevOps Administrados se retiran cuando el sistema operativo de la imagen finaliza su ciclo de soporte técnico. Las imágenes basadas en versiones anteriores de sistemas operativos se pueden retirar cuando se publican imágenes basadas en nuevas versiones de los sistemas operativos.

Las imágenes de Azure Pipelines ofrecen las mismas imágenes y siguen un cronograma de desuso similar al de los agentes hospedados por Microsoft.
Las imágenes de Marketplace seleccionadas normalmente se retiran cuando el sistema operativo de la imagen alcanza el final de su ciclo de vida de soporte técnico.

Planificación de obsolescencia de imágenes

No hay ningún desuso de imágenes pendiente en Conjuntos de DevOps Gestionados en este momento. Las siguientes imágenes han quedado en desuso y se han quitado.

Windows Server 2019 se ha quitado de las imágenes de Azure Pipelines.
Ubuntu 20.04 se ha quitado de las imágenes de Azure Pipelines y las imágenes de Marketplace seleccionadas.

Configurar las opciones del grupo

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-03-03

Compartir a través de

Configurar imágenes de grupos de DevOps administrados

Selecciona la imagen de tu grupo

Imágenes de Azure Pipelines

Imágenes de Marketplace seleccionadas

Imágenes de Azure Compute Gallery

Concesión de acceso de rol lector a la entidad de servicio DevOpsInfrastructure

Usar varias imágenes por grupo con alias

Configuración de alias de imagen

Alias de imágenes predefinidas de Azure Pipelines

Uso de demandas para especificar una imagen

Ciclo de vida de la imagen

Planificación de obsolescencia de imágenes

Contenido relacionado

Comentarios

Recursos adicionales