Compartir vía

Uso de una imagen administrada para crear un grupo de imágenes personalizadas

  • Artículo

Para crear un grupo de imágenes personalizadas para las máquinas virtuales (VM) del grupo de Batch, puede usar una imagen administrada para crear una imagen de Azure Compute Gallery. También se admite el uso de una imagen administrada, pero solo para las versiones de API hasta el 1 de agosto de 2019 inclusive.

Advertencia

La compatibilidad con la creación de un grupo de Batch mediante una imagen administrada se retirará después del 31 de marzo de 2026. Migre a hospedar imágenes personalizadas en Azure Compute Gallery para usarlas para crear un grupo de imágenes personalizado en Batch. Para más información, consulte la guía de migración.

En este tema se explica cómo crear un grupo de imágenes personalizadas a partir de una sola imagen administrada.

Requisitos previos

  • Un recurso de imagen administrada. Para crear un grupo de máquinas virtuales con una imagen personalizada, tiene que tener o crear un recurso de imagen administrada en la misma suscripción y región de Azure que la cuenta de Batch. La imagen debe crearse desde instantáneas del disco del sistema operativo de la máquina virtual y, opcionalmente, de sus discos de datos conectados.

    • Use una imagen personalizada única para cada grupo que cree.
    • Para crear un grupo con la imagen mediante las API de Batch, especifique el identificador de recurso de la imagen, cuyo formato es /subscriptions/xxxx-xxxxxx-xxxxx-xxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/myImage.
    • El recurso de imagen administrada debe existir durante la vigencia del grupo para permitir su escalado vertical y puede quitarse después de eliminar el grupo.

  • Autenticación de Microsoft Entra. La API de cliente de Batch debe usar la autenticación de Microsoft Entra. La compatibilidad de Azure Batch con Microsoft Entra ID se documenta en Autenticación de soluciones de servicios de Batch con Active Directory.

Preparación de una imagen administrada

En Azure, puede preparar una imagen administrada a partir de:

  • Instantáneas del sistema operativo y los discos de datos de una máquina virtual de Azure
  • Una máquina virtual de Azure generalizada con discos administrados
  • Un disco duro virtual local generalizado cargado en la nube

Para escalar grupos de Batch de forma confiable con una imagen administrada se recomienda crear la imagen administrada solo con el primer método: instantáneas de los discos de la máquina virtual. Consulte los siguientes pasos para preparar la máquina virtual, tomar una instantánea y crear una imagen administrada a partir de ella.

Preparación de la máquina virtual

Si va a crear una máquina virtual para la imagen, use una imagen propia de Azure Marketplace admitida por Batch como imagen base para la imagen administrada. Solo pueden usarse imágenes propias como imagen base. Para obtener una lista completa de las referencias de imágenes de Azure Marketplace compatibles con Azure Batch, consulte Lista de imágenes compatibles.

Nota:

No se puede usar una imagen de terceros que tenga licencias adicionales y términos de compra como imagen base. Para información sobre estas imágenes de Marketplace, consulte las instrucciones para las máquinas virtuales Linux o Windows.

Para usar una imagen de terceros, puede usar Azure Compute Gallery. Consulte Uso de Azure Compute Gallery para crear un grupo de imágenes personalizado para obtener más información.

  • Asegúrese de que la máquina virtual se crea con un disco administrado. Se trata de la configuración de almacenamiento predeterminada cuando se crea una máquina virtual.
  • No instale extensiones de Azure, como la extensión de script personalizado, en la máquina virtual. Si la imagen contiene una extensión preinstalada, Azure podría experimentar problemas al implementar el grupo de Batch.
  • Cuando use discos de datos conectados, debe montar y dar formato a los discos desde una máquina virtual para usarlos.
  • Asegúrese de que la imagen del sistema operativo base que proporcione usa la unidad temporal predeterminada. El agente de nodo de Batch actualmente espera la unidad temporal predeterminada.
  • Asegúrese de que el disco del sistema operativo no esté cifrado.
  • Una vez que la máquina virtual está en ejecución, conéctese a ella a través de RDP (para Windows) o SSH (para Linux). Instale el software necesario o copie los datos deseados.

Creación de una instantánea de máquina virtual

Una instantánea es una copia completa de solo lectura de un disco duro virtual. Para crear una instantánea de un sistema operativo de máquinas virtuales o discos de datos, puede usar las herramientas de Azure Portal o la línea de comandos. En cuanto a pasos y opciones de creación de una instantánea, consulte la guía para máquinas virtuales.

Creación de una imagen a partir de una o varias instantáneas

Para crear una imagen administrada a partir de una instantánea, use las herramientas de la línea de comandos de Azure, como el comando az image create. Puede crear una imagen mediante la especificación de una instantánea del disco del sistema operativo y, opcionalmente, una o varias instantáneas de disco de datos.

Creación de un grupo a partir de una imagen administrada

Una vez que haya encontrado el identificador de recurso de la imagen administrada, cree un grupo de imágenes personalizado a partir de esa imagen. En los pasos siguientes se muestra cómo crear un grupo de imágenes personalizadas mediante el servicio Batch o la administración de Batch.

Nota:

Asegúrese de que la identidad que usa para la autenticación de Microsoft Entra tenga permisos en el recurso de imagen. Consulte Autenticación de soluciones de servicio de Batch con Active Directory.

El recurso para la imagen administrada debe existir durante la vigencia del grupo. Si se elimina el recurso subyacente, el grupo no se puede escalar.

SDK de .NET del servicio Batch

private static VirtualMachineConfiguration CreateVirtualMachineConfiguration(ImageReference imageReference)
{
    return new VirtualMachineConfiguration(
        imageReference: imageReference,
        nodeAgentSkuId: "batch.node.windows amd64");
}

private static ImageReference CreateImageReference()
{
    return new ImageReference(
        virtualMachineImageId: "/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Compute/images/{image definition name}");
}

private static void CreateBatchPool(BatchClient batchClient, VirtualMachineConfiguration vmConfiguration)
{
    try
    {
        CloudPool pool = batchClient.PoolOperations.CreatePool(
            poolId: PoolId,
            targetDedicatedComputeNodes: PoolNodeCount,
            virtualMachineSize: PoolVMSize,
            virtualMachineConfiguration: vmConfiguration);

        pool.Commit();
    }

API de REST de administración de Batch

URI DE LA API REST

 PUT https://management.azure.com/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Batch/batchAccounts/{account name}/pools/{pool name}?api-version=2020-03-01

Cuerpo de la solicitud

 {
   "properties": {
     "vmSize": "{VM size}",
     "deploymentConfiguration": {
       "virtualMachineConfiguration": {
         "imageReference": {
           "id": "/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Compute/images/{image name}"
         },
         "nodeAgentSkuId": "{Node Agent SKU ID}"
       }
     }
   }
 }

Consideraciones sobre grupos grandes

Si va a crear un grupo con cientos de máquinas virtuales o más con una imagen personalizada, es importante seguir las instrucciones anteriores para usar una imagen creada a partir de una instantánea de máquina virtual.

Además, tenga en cuenta las siguientes consideraciones:

  • Límites de tamaño: Batch limita el tamaño de grupo a 2500 nodos de proceso dedicados o 1000 nodos de acceso puntual con las imágenes personalizadas.

    Si usa la misma imagen (o varias imágenes basadas en la misma instantánea subyacente) para crear varios grupos, el número total de nodos de proceso de los grupos no puede superar los límites anteriores. No se recomienda usar una imagen o su instantánea subyacente para más de un grupo.

    Si configura el grupo con grupos NAT de entrada es posible que los límites se reduzcan.

  • Tiempo de espera del cambio de tamaño: si el grupo contiene un número fijo de nodos (no se escala automáticamente), aumente la propiedad resizeTimeout del grupo a un valor de 20 a 30 minutos. Si el grupo no alcanza su tamaño de destino en el tiempo de espera, realice otra operación de cambio de tamaño.

    Si tiene previsto un grupo de más de 300 nodos de proceso, es posible que necesite cambiar el tamaño del grupo varias veces para alcanzar el tamaño de destino.

Con Azure Compute Gallery, puede crear grupos más grandes con las imágenes personalizadas y con más réplicas de imágenes compartidas junto con ventajas de rendimiento mejoradas, como reducir el tiempo para que los nodos estén listos.

Consideraciones a la hora de usar Packer

Solo se puede crear un recurso de imagen administrada directamente con Packer mediante cuentas de Batch en modo de suscripción de usuario. Para las cuentas de modo de servicio de Batch, deberá crear primero un disco duro virtual y, después, importar el disco duro virtual a un recurso de imagen administrada. Según el modo de asignación de grupos (suscripción de usuario o servicio de Batch), los pasos para crear un recurso de imagen administrada varían.

Asegúrese de que el recurso utilizado para crear la imagen administrada exista durante la vigencia de los grupos que hacen referencia a la imagen personalizada. Si no lo hace, pueden ocurrir errores de asignación de grupo o errores de cambio de tamaño.

Si se quita la imagen o el recurso subyacente, puede obtener un error similar a: There was an error encountered while performing the last resize on the pool. Please try resizing the pool again. Code: AllocationFailed. Si recibe este error, asegúrese de que no se haya quitado el recurso subyacente.

Para obtener más información sobre el uso de Packer para crear una máquina virtual, consulte Creación de una imagen de Linux con Packer o Creación de una imagen de Windows con Packer.

Pasos siguientes