Compartir a través de

Uso de Azure Batch para ejecutar cargas de trabajo de contenedor

  • Artículo

Azure Batch permite ejecutar y escalar un gran número de trabajos de computación por lotes en Azure. Las tareas por lotes se pueden ejecutar directamente en las máquinas virtuales (nodos) de un grupo de Batch, pero también se puede configurar un grupo de Batch para ejecutar tareas en contenedores compatibles con Docker en los nodos. En este artículo se muestra cómo crear un grupo de nodos de ejecución que admita la ejecución de tareas de contenedor y luego ejecutar las tareas de contenedor en el grupo.

Los ejemplos de código que hay aquí usan los SDK de Python, .NET y Batch. También puede usar otras herramientas y SDK de Batch, incluido Azure Portal, para crear grupos de Batch habilitados para contenedor y para ejecutar tareas de contenedor.

¿Por qué usar contenedores?

Los contenedores proporcionan una manera sencilla de ejecutar tareas de Batch sin tener que administrar un entorno ni dependencias para ejecutar las aplicaciones. Los contenedores implementan aplicaciones como unidades ligeras, portátiles y autosuficientes que se pueden ejecutar en varios entornos distintos. Por ejemplo, cree y pruebe localmente un contenedor y, después cargue la imagen de contenedor en un registro en Azure o en otro lugar. El modelo de implementación de contenedor garantiza que el entorno en tiempo de ejecución de la aplicación siempre esté correctamente instalado y configurado donde sea que se hospede la aplicación. Las tareas basadas en contenedor en Batch también pueden aprovechar las características de tareas no en contenedor, incluidos los paquetes de aplicación y la administración de archivos de recursos y archivos de salida.

Prerequisites

Debe estar familiarizado con los conceptos de contenedor y cómo crear un trabajo y un grupo de Batch.

  • Versiones del SDK: los SDK de Batch admiten las imágenes de contenedor en las siguientes versiones:

    • API de REST de Batch versión 2017-09-01.6.0
    • SDK de .NET de Batch versión 8.0.0
    • SDK de Python de Batch versión 4.0
    • SDK de Java de Batch versión 3.0
    • SDK de Node.js de Batch versión 3.0

  • Cuentas: en la suscripción de Azure, debe crear una cuenta de Batch y, opcionalmente, una cuenta de Azure Storage.

  • Una imagen de máquina virtual admitida: los contenedores solo se admiten en grupos creados con la configuración de máquina virtual a partir de imágenes admitidas (que se enumeran en la siguiente sección). Si proporciona una imagen personalizada, consulte las consideraciones en la siguiente sección y los requisitos en Uso de una imagen administrada para crear un grupo de imágenes personalizado.

Nota:

Desde versiones del SDK de Batch:

  • SDK de .NET de Batch versión 16.0.0
  • SDK de Python de Batch versión 14.0.0
  • SDK de Java de Batch versión 11.0.0
  • SDK de Node.js de Batch versión 11.0.0

SDK de Node.js de Batch versión 11.0.0 containerConfiguration requiere pasar la propiedad Type y los valores admitidos son: ContainerType.DockerCompatible y ContainerType.CriCompatible.

Tenga presentes las siguientes limitaciones:

  • Batch proporciona compatibilidad con acceso directo a memoria remota (RDMA) solo para contenedores que se ejecutan en grupos de Linux.
  • Para las cargas de trabajo de contenedor de Windows, debe elegir un tamaño de máquina virtual multinúcleo para el grupo

Importante

Docker, de forma predeterminada, crea un puente de red con una especificación de subred de 172.17.0.0/16. Si va a especificar una red virtual para el grupo, asegúrese de que no haya intervalos IP en conflicto.

Imágenes de máquina virtual admitidas

Use una de las siguientes imágenes Windows o Linux compatibles para crear un grupo de nodos de ejecución de máquinas virtuales para cargas de trabajo de contenedor. Para obtener más información sobre las imágenes de Marketplace compatibles con Batch, vea la lista de imágenes de máquinas virtuales.

Soporte técnico de Windows

Batch admite imágenes de Windows Server que tienen designaciones compatibles con contenedores. La API para enumerar todas las imágenes admitidas en Batch indica una capacidad DockerCompatible si la imagen admite contenedores Docker. Batch permite, pero no admite directamente, las imágenes publicadas por Mirantis con la capacidad indicada como DockerCompatible. Estas imágenes solo se pueden implementar en una cuenta de Batch del modo de asignación del grupo de suscripciones de usuario.

También puede crear una imagen personalizada para habilitar la funcionalidad de contenedor en Windows.

Nota:

Las SKU de imagen -with-containers o -with-containers-smalldisk se retiran. Consulte el anuncio para obtener más información y opciones alternativas del entorno de ejecución de contenedor.

Compatibilidad de Linux

En el caso de las cargas de trabajo de contenedor Linux, Batch actualmente admite estas imágenes de Linux publicadas en Azure Marketplace sin necesidad de una imagen personalizada.

  • Publicador: microsoft-dsvm
    • Oferta: ubuntu-hpc
  • Publicador: almalinux
    • Oferta: 8-hpc-gen1
    • Oferta: 8-hpc-gen2

Opciones de imagen alternativas

Actualmente hay otras imágenes publicadas por microsoft-azure-batch que admiten cargas de trabajo de contenedor:

  • Publicador: microsoft-azure-batch
    • Oferta: ubuntu-server-container
    • Oferta: ubuntu-server-container-rdma (para su uso exclusivo en SKU de máquinas virtuales con Infiniband)

Advertencia

Se recomienda usar imágenes distintas de las publicadas por microsoft-azure-batch, ya que estas imágenes están en desuso debido a la inminente finalización de la vida útil de la imagen.

Notas

La raíz de datos de Docker de las imágenes anteriores se encuentra en diferentes lugares:

  • Para la imagen de HPC o microsoft-dsvm (oferta: ubuntu-hpc, etc.), la raíz de datos de Docker no cambia del valor predeterminado de Docker, que es /var/lib/docker en Linux y C:\ProgramData\Docker en Windows. Estas carpetas se ubican en el disco del sistema operativo.

El uso de imágenes publicadas que no sean Batch, el disco del sistema operativo corre el riesgo de que se llene rápidamente a medida que se descargan las imágenes de contenedor.

Posibles soluciones para los clientes

Cambie la raíz de datos de Docker en una tarea de inicio al crear un grupo en BatchExplorer. Este es un ejemplo del comando Iniciar tarea:

1)  sudo systemctl stop docker
2)  sudo vi /lib/systemd/system/docker.service
    +++
    FROM:
    ExecStart=/usr/bin/docker daemon -H fd://
    TO:
    ExecStart=/usr/bin/docker daemon -g /new/path/docker -H fd://
    +++
3)  sudo systemctl daemon-reload
4)  sudo systemctl start docker

Estas imágenes solo se admiten para su uso en grupos de Azure Batch y están orientadas a la ejecución de contenedores Docker. Cuentan con:

  • Un entorno de ejecución de contenedores Moby compatible con Docker, preinstalado.
  • Controladores NVIDIA GPU y entorno de ejecución de contenedores de NVIDIA, preinstalados, para agilizar la implementación en máquinas virtuales de la serie N de Azure.
  • Las imágenes de máquina virtual con el sufijo -rdma están preconfiguradas con compatibilidad con tamaños de máquina virtual RDMA de InfiniBand. Estas imágenes de máquina virtual no deben usarse con tamaños de máquina virtual que no sean compatibles con InfiniBand.

También puede crear imágenes personalizadas compatibles con los contenedores de Batch en una de las distribuciones Linux compatibles con Batch. Para obtener compatibilidad con Docker en una imagen personalizada, instale un entorno de ejecución compatible con Docker adecuado, como una versión de Docker o Mirantis Container Runtime. La instalación de solo una herramienta compatible con la CLI de Docker no es suficiente; se requiere un entorno de ejecución compatible con Docker Engine.

Importante

Ni Microsoft ni Azure Batch proporcionarán compatibilidad con problemas relacionados con Docker (cualquier versión o edición), Mirantis Container Runtime o entornos de ejecución de Moby. Los clientes que eligen usar estos entornos de ejecución en sus imágenes deben ponerse en contacto con la empresa o entidad que proporciona soporte técnico para problemas en tiempo de ejecución.

Más consideraciones para usar una imagen Linux personalizada:

  • Para aprovechar el rendimiento de GPU de los tamaños de la serie N de Azure al usar una imagen personalizada, instale previamente los controladores NVIDIA. Además, debe instalar la utilidad de motor de Docker para GPU NVIDIA, NVIDIA Docker.
  • Use un tamaño de máquina virtual compatible con RDAM para acceder a la red RDMA de Azure. Los controladores RDMA necesarios están instalados en HPC de CentOS e imágenes de Ubuntu compatibles con Batch. Puede ser necesaria una configuración adicional para ejecutar cargas de trabajo MPI. Consulte Uso de instancias RDMA o GPU en grupos de Batch.

Configuración del contenedor de grupo de Batch

Para habilitar un grupo de Batch para ejecutar cargas de trabajo de contenedor, se debe especificar la opción ContainerConfiguration en el objeto VirtualMachineConfiguration del grupo. Este artículo incluye vínculos a la referencia de la API de .NET de Batch. Puede encontrar la configuración correspondiente en la API Batch Python.

Puede crear un grupo habilitado para contenedores con o sin imágenes de contenedor capturadas previamente, tal como se muestra en los ejemplos siguientes. El proceso de extracción (o captura previa) permite cargar previamente imágenes de contenedor desde Docker Hub u otro registro de contenedor en Internet. Para obtener el mejor rendimiento, use un registro de contenedor de Azure en la misma región que la cuenta de Batch.

La ventaja de capturar previamente las imágenes de contenedor es que, cuando las tareas comienzan a ejecutarse por primera vez, no tienen que esperar a que la imagen del contenedor se descargue. La configuración de contenedor extrae las imágenes de contenedor de las máquinas virtuales cuando se crea el grupo. Las tareas que se ejecutan en el grupo pueden entonces hacer referencia a la lista de las imágenes de contenedor y opciones de ejecución de contenedor.

Nota:

Docker Hub limita el número de extracción de imágenes. Asegúrese de que la carga de trabajo no supera los límites de velocidad publicados para imágenes basadas en Docker Hub. Se recomienda usar Azure Container Registry directamente o aprovechar caché de artefactos en ACR.

Grupo sin imágenes de contenedor previamente capturadas

Para configurar un grupo habilitado para contenedores sin imágenes de contenedor previamente capturadas, defina los objetos ContainerConfiguration y VirtualMachineConfiguration como se muestra en los ejemplos siguientes. En estos ejemplos se usa la imagen de Ubuntu Server para grupos de contenedores de Azure Batch de Marketplace.

Nota: La versión del servidor de Ubuntu usada en el ejemplo tiene fines ilustrativos. No dude en cambiar el node_agent_sku_id a la versión que está usando.

image_ref_to_use = batch.models.ImageReference(
    publisher='microsoft-dsvm',
    offer='ubuntu-hpc',
    sku='2204',
    version='latest')

"""
Specify container configuration. This is required even though there are no prefetched images.
"""

container_conf = batch.models.ContainerConfiguration()

new_pool = batch.models.PoolAddParameter(
    id=pool_id,
    virtual_machine_configuration=batch.models.VirtualMachineConfiguration(
        image_reference=image_ref_to_use,
        container_configuration=container_conf,
        node_agent_sku_id='batch.node.ubuntu 22.04'),
    vm_size='STANDARD_D2S_V3',
    target_dedicated_nodes=1)
...

ImageReference imageReference = new ImageReference(
    publisher: "microsoft-dsvm",
    offer: "ubuntu-hpc",
    sku: "2204",
    version: "latest");

// Specify container configuration. This is required even though there are no prefetched images.
ContainerConfiguration containerConfig = new ContainerConfiguration();

// VM configuration
VirtualMachineConfiguration virtualMachineConfiguration = new VirtualMachineConfiguration(
    imageReference: imageReference,
    nodeAgentSkuId: "batch.node.ubuntu 22.04");
virtualMachineConfiguration.ContainerConfiguration = containerConfig;

// Create pool
CloudPool pool = batchClient.PoolOperations.CreatePool(
    poolId: poolId,
    targetDedicatedComputeNodes: 1,
    virtualMachineSize: "STANDARD_D2S_V3",
    virtualMachineConfiguration: virtualMachineConfiguration);

Captura previa de imágenes para la configuración de contenedor

Para la captura previa de imágenes de contenedor en el grupo, agregue la lista de imágenes de contenedor (container_image_names en Python) a ContainerConfiguration.

En el siguiente ejemplo básico de Python se muestra cómo capturar previamente una imagen de contenedor Ubuntu estándar desde Docker Hub.

image_ref_to_use = batch.models.ImageReference(
    publisher='microsoft-dsvm',
    offer='ubuntu-hpc',
    sku='2204',
    version='latest')

"""
Specify container configuration, fetching the official Ubuntu container image from Docker Hub.
"""

container_conf = batch.models.ContainerConfiguration(
    container_image_names=['ubuntu'])

new_pool = batch.models.PoolAddParameter(
    id=pool_id,
    virtual_machine_configuration=batch.models.VirtualMachineConfiguration(
        image_reference=image_ref_to_use,
        container_configuration=container_conf,
        node_agent_sku_id='batch.node.ubuntu 22.04'),
    vm_size='STANDARD_D2S_V3',
    target_dedicated_nodes=1)
...

En el siguiente ejemplo de C# se da por hecho que quiere capturar previamente una imagen de TensorFlow desde Docker Hub. Este ejemplo contiene una tarea de inicio que se ejecuta en el host de máquina virtual de los nodos de grupo. Podría ejecutar una tarea de inicio en el host, por ejemplo, para montar un servidor de archivos al que pueda accederse desde los contenedores.

ImageReference imageReference = new ImageReference(
    publisher: "microsoft-dsvm",
    offer: "ubuntu-hpc",
    sku: "2204",
    version: "latest");

ContainerRegistry containerRegistry = new ContainerRegistry(
    registryServer: "https://hub.docker.com",
    identityReference: new ComputeNodeIdentityReference() { ResourceId = "/subscriptions/SUB/resourceGroups/RG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name" }
);

// Specify container configuration, prefetching Docker images
ContainerConfiguration containerConfig = new ContainerConfiguration();
containerConfig.ContainerImageNames = new List<string> { "tensorflow/tensorflow:latest-gpu" };
containerConfig.ContainerRegistries = new List<ContainerRegistry> { containerRegistry };

// VM configuration
VirtualMachineConfiguration virtualMachineConfiguration = new VirtualMachineConfiguration(
    imageReference: imageReference,
    nodeAgentSkuId: "batch.node.ubuntu 22.04");
virtualMachineConfiguration.ContainerConfiguration = containerConfig;

// Set a native host command line start task
StartTask startTaskContainer = new StartTask( commandLine: "<native-host-command-line>" );

// Create pool
CloudPool pool = batchClient.PoolOperations.CreatePool(
    poolId: poolId,
    virtualMachineSize: "Standard_NC6S_V3",
    virtualMachineConfiguration: virtualMachineConfiguration);

// Start the task in the pool
pool.StartTask = startTaskContainer;
...

Captura previa de imágenes desde un registro de contenedor privado

También puede capturar previamente imágenes de contenedor mediante la autenticación a un servidor de registro de contenedor privado. En los ejemplos siguientes, los objetos ContainerConfiguration y VirtualMachineConfiguration capturan previamente una imagen privada de TensorFlow de un registro de contenedor de Azure privado. La referencia de imagen es la misma que en el ejemplo anterior.

image_ref_to_use = batch.models.ImageReference(
    publisher='microsoft-dsvm',
    offer='ubuntu-hpc',
    sku='2204',
    version='latest')

# Specify a container registry
subscription_id = "yyyy-yyy-yyy-yyy-yyy"
resource_group_name = "TestRG"
user_assigned_identity_name = "testUMI"
resource_id = f"/subscriptions/{subscription_id}/resourceGroups/{resource_group_name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user_assigned_identity_name}"

container_registry = batch.models.ContainerRegistry(
        registry_server="myRegistry.azurecr.io",
        identity_reference = ComputeNodeIdentityReference(resource_id = resource_id))

# Create container configuration, prefetching Docker images from the container registry
container_conf = batch.models.ContainerConfiguration(
        container_image_names = ["myRegistry.azurecr.io/samples/myImage"],
        container_registries =[container_registry])

new_pool = batch.models.PoolAddParameter(
            id="myPool",
            virtual_machine_configuration=batch.models.VirtualMachineConfiguration(
                image_reference=image_ref_to_use,
                container_configuration=container_conf,
                node_agent_sku_id='batch.node.ubuntu 22.04'),
            vm_size='STANDARD_D2S_V3',
            target_dedicated_nodes=1)

// Specify a container registry
ContainerRegistry containerRegistry = new ContainerRegistry(
    registryServer: "myContainerRegistry.azurecr.io",
    identityReference: new ComputeNodeIdentityReference() { ResourceId = "/subscriptions/SUB/resourceGroups/RG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name" }
);

// Create container configuration, prefetching Docker images from the container registry
ContainerConfiguration containerConfig = new ContainerConfiguration();
containerConfig.ContainerImageNames = new List<string> {
        "myContainerRegistry.azurecr.io/tensorflow/tensorflow:latest-gpu" };
containerConfig.ContainerRegistries = new List<ContainerRegistry> { containerRegistry } );

// VM configuration
VirtualMachineConfiguration virtualMachineConfiguration = new VirtualMachineConfiguration(
    imageReference: imageReference,
    nodeAgentSkuId: "batch.node.ubuntu 22.04");
virtualMachineConfiguration.ContainerConfiguration = containerConfig;

// Create pool
CloudPool pool = batchClient.PoolOperations.CreatePool(
    poolId: poolId,
    targetDedicatedComputeNodes: 2,
    virtualMachineSize: "Standard_NC6S_V3",
    virtualMachineConfiguration: virtualMachineConfiguration);
...

Compatibilidad con identidad administrada para ACR

Al acceder a contenedores almacenados en Azure Container Registry, se puede usar una identidad administrada para autenticarse con el servicio. Para usar una identidad administrada, asegúrese primero de que la identidad se ha asignado al grupo y de que la identidad tiene el rol AcrPull asignado para el registro de contenedor al que desea acceder. A continuación, simplemente diga a Batch qué identidad usar al autenticarse con ACR.

ContainerRegistry containerRegistry = new ContainerRegistry(
    registryServer: "myContainerRegistry.azurecr.io",
    identityReference: new ComputeNodeIdentityReference() { ResourceId = "/subscriptions/SUB/resourceGroups/RG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name" }
);

// Create container configuration, prefetching Docker images from the container registry
ContainerConfiguration containerConfig = new ContainerConfiguration();
containerConfig.ContainerImageNames = new List<string> {
        "myContainerRegistry.azurecr.io/tensorflow/tensorflow:latest-gpu" };
containerConfig.ContainerRegistries = new List<ContainerRegistry> { containerRegistry } );

// VM configuration
VirtualMachineConfiguration virtualMachineConfiguration = new VirtualMachineConfiguration(
    imageReference: imageReference,
    nodeAgentSkuId: "batch.node.ubuntu 22.04");
virtualMachineConfiguration.ContainerConfiguration = containerConfig;

// Create pool
CloudPool pool = batchClient.PoolOperations.CreatePool(
    poolId: poolId,
    targetDedicatedComputeNodes: 2,
    virtualMachineSize: "Standard_NC6S_V3",
    virtualMachineConfiguration: virtualMachineConfiguration);
...

Configuración de contenedor para la tarea

Para ejecutar una tarea de contenedor en un grupo habilitado para contenedores, indique opciones específicas de contenedor. La configuración incluye la imagen que se usará, el registro y las opciones de ejecución del contenedor.

  • Use la propiedad ContainerSettings de las clases de tarea para configurar opciones específicas de contenedor. Esta configuración se define por la clase TaskContainerSettings. Tenga en cuenta que la opción de contenedor --rm no requiere una otra opción --runtime, ya que de esto se encarga Batch.

  • Si ejecuta tareas en imágenes de contenedor, la tarea en la nube y la tarea del administrador de trabajos requieren la configuración del contenedor. Sin embargo, la tarea de inicio, la tarea de preparación de trabajos y la tarea de liberación de trabajos no requieren configuración del contenedor (es decir, pueden ejecutarse en un contexto de contenedor o directamente en el nodo).

  • En el caso de Linux, Batch asigna el permiso de usuario o grupo al contenedor. Si el acceso a cualquier carpeta del contenedor requiere permisos de administrador, es posible que tenga que ejecutar la tarea como ámbito de grupo con el nivel de elevación de administrador. Esto garantiza que Batch ejecute la tarea como raíz en el contexto del contenedor. De lo contrario, es posible que un usuario que no sea administrador no tenga acceso a esas carpetas.

  • En el caso de los grupos de contenedores con hardware habilitado para GPU, Batch habilita automáticamente la GPU para las tareas de contenedor, por lo que no debe incluir el argumento –gpus.

Línea de comandos de tareas de contenedor

Al ejecutar una tarea de contenedor, Batch usa automáticamente el comando docker create para crear un contenedor con la imagen especificada en la tarea. Batch luego controla la ejecución de tareas en el contenedor.

Al igual que con las tareas de Batch sin contenedor, establece una línea de comandos para una tarea de contenedor. Dado que Batch crea automáticamente el contenedor, la línea de comandos especifica solo el o los comandos que se ejecutan en el contenedor.

A continuación se muestran los comportamientos predeterminados que Batch aplica a las tareas de contenedor de Docker:

Asegúrese de revisar la documentación de Docker entre ENTRYPOINT y CMD para comprender los efectos de interacción que pueden surgir cuando las imágenes de contenedor tienen un ENTRYPOINT especificado y también se especifica una línea de comandos de tarea.

Si desea invalidar la imagen de contenedor ENTRYPOINT, puede especificar el argumento --entrypoint <args> como containerRunOption. Consulte las ContainerRunOptions opcionales para conocer los argumentos que puede proporcionar al comando docker create que Batch utiliza para crear y ejecutar el contenedor. Por ejemplo, para establecer un directorio de trabajo para el contenedor, establezca la opción --workdir <directory>.

A continuación se muestran algunos ejemplos de imágenes de contenedor y opciones de contenedor de Batch o líneas de comandos de tarea y su efecto:

  • No se especifica la imagen de contenedor ENTRYPOINT y la línea de comandos de tarea de Batch es "/bin/sh -c python myscript.py".
    • Batch crea el contenedor con la línea de comandos de la tarea Batch tal como se especifica y la ejecuta en el directorio de trabajo de la tarea Batch. Esto puede provocar un error si "myscript.py" no está en el directorio de trabajo de la tarea Batch.
    • Si la línea de comandos de la tarea se especificó como "/bin/sh -c python /path/to/script/myscript.py", esta tarea puede funcionar correctamente incluso con el directorio de trabajo establecido como directorio de trabajo de la tarea Batch si se cumplen todas las dependencias del script.
  • La imagen de contenedor ENTRYPOINT se especifica como "./myscript.sh" y la línea de comandos de la tarea Batch está vacía.
    • Batch crea el contenedor que se basa en ENTRYPOINT y lo ejecuta en el directorio de trabajo de la tarea Batch. Esta tarea puede producir un error si la imagen de contenedor WORKDIR no es la misma que el directorio de trabajo de la tarea Batch, que depende de varios factores, como el sistema operativo, el identificador de trabajo, el identificador de tarea, etc.
    • Si "--workdir /path/to/script" se especificó como contenedorRunOption, esta tarea puede funcionar correctamente si se cumplen todas las dependencias del script.
  • La imagen de contenedor ENTRYPOINT no se especifica, la línea de comandos de la tarea Batch es "./myscript.sh" y WORKDIR se invalida en ContainerRunOptions como "--workdir /path/to/script".
    • Batch crea el contenedor con el directorio de trabajo en "/path/to/script" y ejecuta la línea de comandos "./myscript.sh", que se ejecuta correctamente, ya que el script se encuentra en el directorio de trabajo especificado.

Directorio de trabajo de tareas de contenedor

Una tarea de contenedor de Batch se ejecuta en un directorio de trabajo del contenedor similar al directorio que Batch configura para una tarea normal (que no es de tipo contenedor). Este directorio de trabajo es diferente de la instrucción WORKDIR si se ha configurado en la imagen, o el directorio de trabajo de contenedor predeterminado (C:\ en un contenedor de Windows, o / en un contenedor de Linux).

Para una tarea de contenedor de Batch:

  • Todos los directorios incluidos de forma recursiva debajo de AZ_BATCH_NODE_ROOT_DIR en el nodo host (la raíz de los directorios de Azure Batch) se asignan al contenedor.
  • Todas las variables de entorno de tareas se asignan al contenedor.
  • El directorio de trabajo AZ_BATCH_TASK_WORKING_DIR de la tarea en el nodo se configura igual que para una tarea normal y se asigna al contenedor.

Importante

En el caso de los grupos de contenedores de Windows en familias de máquinas virtuales con discos efímeros, todo el disco efímero se asigna al espacio de contenedor debido a las limitaciones del contenedor de Windows.

Estas asignaciones le permiten trabajar con tareas de contenedor de manera muy similar a las tareas sin contenedores. Por ejemplo, instale aplicaciones mediante paquetes de aplicación, acceda a los archivos de recursos desde Azure Storage, use la configuración del entorno de la tarea, y conserve los archivos de salida de la tarea una vez que se detenga el contenedor.

Independientemente de cómo se establezca WORKDIR para una imagen de contenedor, tanto stdout.txt como stderr.txt se capturan en el AZ_BATCH_TASK_DIR.

Solucionar problemas de tareas de contenedor

Si la tarea de contenedor no se ejecuta según lo previsto, puede que tenga que obtener información sobre la configuración de WORKDIR o ENTRYPOINT de la imagen de contenedor. Para ver la configuración, ejecute el comando docker image inspect.

Si es necesario, ajuste la configuración de la tarea de contenedor según la imagen:

  • Especifique una ruta de acceso absoluta en la línea de comandos de la tarea. Si se usa el script ENTRYPOINT predeterminado de la imagen para la línea de comandos de la tarea, asegúrese de haber establecido una ruta de acceso absoluta.
  • En las opciones de ejecución del contenedor de la tarea, cambie el directorio de trabajo para que coincida con el WORKDIR en la imagen. Por ejemplo, establezca --workdir /app.

Ejemplos de la tarea de contenedor

En el siguiente fragmento de código de Python se muestra una línea de comandos básica que se ejecuta en un contenedor creado a partir de una imagen ficticia extraída de Docker Hub. En este caso, la opción del contenedor --rm quita el contenedor después de que finaliza la tarea, y la opción --workdir establece un directorio de trabajo. La línea de comandos reemplaza el script ENTRYPOINT del contenedor con un comando de shell sencillo que escribe un archivo pequeño en el directorio de trabajo de la tarea en el host.

task_id = 'sampletask'
task_container_settings = batch.models.TaskContainerSettings(
    image_name='myimage',
    container_run_options='--rm --workdir /')
task = batch.models.TaskAddParameter(
    id=task_id,
    command_line='/bin/sh -c \"echo \'hello world\' > $AZ_BATCH_TASK_WORKING_DIR/output.txt\"',
    container_settings=task_container_settings
)

En el siguiente ejemplo de C# muestra la configuración de contenedor básica para una tarea en la nube:

// Simple container task command
string cmdLine = "c:\\app\\myApp.exe";

TaskContainerSettings cmdContainerSettings = new TaskContainerSettings (
    imageName: "myimage",
    containerRunOptions: "--rm --workdir c:\\app"
    );

CloudTask containerTask = new CloudTask (
    id: "Task1",
    commandline: cmdLine);
containerTask.ContainerSettings = cmdContainerSettings;

Pasos siguientes