Tutorial: crear una definición de trabajo de un solo nodo en los recursos de Amazon EC2

Para crear una nueva definición de trabajo en los recursos de Amazon EC2:

1. Abra la consola AWS Batch en https://console.aws.amazon.com/batch/.

2. En la barra de navegación, seleccione la Región de AWS a utilizar.

3. En el panel de navegación izquierdo, seleccione Definiciones de trabajos.

4. Seleccione Crear.

5. Para el Tipo de orquestación, seleccione Amazon Elastic Compute Cloud (Amazon EC2).

6. Para la Configuración de la plataforma EC2, desactive Habilitar el procesamiento paralelo de varios nodos.

7. En Nombre, escriba un nombre único para la definición de trabajo. El nombre puede tener una longitud máxima de 128 caracteres. Puede contener letras mayúsculas y minúsculas, números, guiones (-) y guiones bajos (_).

8. (Opcional) En Tiempo de espera de ejecución, introduzca el valor del tiempo de espera (en segundos). El tiempo de espera de ejecución es el tiempo que transcurre antes de que finalice un trabajo pendiente. Si un intento supera la duración del tiempo de espera, el intento se detiene y pasa a un estado FAILED. Para obtener más información, consulte Tiempos de espera de trabajo. El valor mínimo es de 60 segundos.

9. (Opcional) Activa la Prioridad de programación. Introduzca un valor de prioridad de programación entre 0 y 100. Los valores más altos tienen mayor prioridad.

10. (Opcional) En Intentos de trabajo, introduzca el número de veces que AWS Batch intenta mover el trabajo al estado RUNNABLE. Ingrese un número entero entre 1 y 10.

11. (Opcional) Para las Condiciones de la estrategia de reintento, seleccione Agregar evaluación al salir. Introduzca al menos un valor de parámetro y, a continuación, elija una Acción. Para cada conjunto de condiciones, la Acción debe estar configurada como Reintentar o Salir. Estas acciones significan lo siguiente:

    • Reintentar: AWS Batch vuelve a intentarlo hasta alcanzar el número de intentos de trabajo que especificó.

    • Salir: AWS Batch deja de volver a intentar el trabajo.

    importante

    Si elige Agregar evaluar al salir, debe configurar al menos un parámetro y elegir una Acción o Eliminar evaluar al salir.

12. (Opcional) Amplíe Etiquetas y, a continuación, elija Agregar etiqueta para agregar etiquetas al recurso. Elija Agregar nueva etiqueta e introduzca la clave y el valor opcional.

13. (Opcional) Active Propagar etiquetas para propagar etiquetas desde el trabajo y la definición del trabajo a la tarea de Amazon ECS.

14. Seleccione Página siguiente.

15. En la sección Configuración del contenedor:

    1. En Imagen, elija la imagen Docker que desea utilizar para su trabajo. De manera predeterminada, las imágenes del registro de Docker Hub están disponibles. También es posible especificar otros repositorios con repository-url/image:tag. El nombre puede tener una longitud máxima de 225 caracteres. Puede contener letras mayúsculas y minúsculas, números, guiones medios (-), guiones bajos (_), dos puntos (:), barras inclinadas (/) y signos numéricos (#). Este parámetro se asigna a Image en la sección Crear un contenedor de la API remota de Docker y el parámetro IMAGE de docker run.

       nota

       La arquitectura de la imagen de Docker debe coincidir con la arquitectura del procesador de los recursos de computación en las que estén programadas. Por ejemplo, las imágenes de Docker basadas en Arm solo pueden ejecutarse en recursos de computación basados en Arm.

       • Las imágenes de los repositorios públicos de Amazon ECR utilizan las convenciones de nomenclatura completa registry/repository[:tag] o registry/repository[@digest] (por ejemplo, public.ecr.aws/registry_alias/my-web-app:latest).

       • Las imágenes de los repositorios de Amazon ECR utilizan la convención de nomenclatura completa registry/repository[:tag] (por ejemplo, aws_account_id.dkr.ecr.region.amazonaws.com/my-web-app:latest).

       • Las imágenes de los repositorios oficiales de Docker Hub utilizan un solo nombre (por ejemplo, ubuntu o mongo).

       • Las imágenes de otros repositorios de Docker Hub se clasifican con un nombre de organización (por ejemplo, amazon/amazon-ecs-agent).

       • Las imágenes de otros repositorios online se cualifican más con un nombre de dominio (por ejemplo, quay.io/assemblyline/ubuntu).

    2. Para la Sintaxis de comandos, elija Bash o JSON.

    3. En Comando, especifique los comandos que desea transmitir al contenedor. Para comandos más sencillos, introduzca el comando como lo haría para una línea de comandos. A continuación, compruebe que el resultado JSON es correcto y se ha transferido a Docker daemon. Para comandos más complicados (por ejemplo, con caracteres especiales), utilice la sintaxis JSON.

       sugerencia

       Seleccione Información para ver los códigos de ejemplo Bash y JSON.

       Este parámetro se asigna a Cmd en la sección Crear un contenedor de la API remota de Docker y el parámetro COMMAND se corresponde con docker run. Para obtener más información sobre el parámetro CMD de Docker, consulte https://docs.docker.com/engine/reference/builder/#cmd.

       nota

       También puede usar valores predeterminados para la sustitución de parámetros y marcadores de posición en el comando. Para obtener más información, consulte Parámetros.

    4. (Opcional) En Rol de ejecución, especifique un rol de IAM que conceda permiso a los agentes de contenedor de Amazon ECS para realizar llamadas a la API de AWS en su nombre. Esta característica utiliza roles de IAM de Amazon ECS para las tareas. Para obtener más información, consulte Roles de IAM de ejecución de tareas de Amazon ECS en la Guía para desarrolladores de Amazon Elastic Container Service.

    5. Para la configuración del rol de trabajo, elija un rol de IAM que tenga permisos para las API AWS. Esta característica utiliza roles de IAM de Amazon ECS para las tareas. Para obtener más información, consulte Roles de IAM para tareas en la Guía para desarrolladores de Amazon Elastic Container Service.

       nota

       Aquí solo se muestran roles con la relación de confianza del Rol de tarea de servicio de Amazon Elastic Container. Para obtener más información sobre cómo crear un rol de IAM para trabajos de AWS Batch, consulte Creación de un rol de IAM y una política para sus tareas en la Guía para desarrolladores de Amazon Elastic Container Service.

16. En Parámetros, elija Agregar parámetros para añadir marcadores de sustitución de parámetros como pares Clave y Valores opcionales.

17. En la sección de Configuración del entorno:

    1. En CPU virtuales, introduzca la cantidad de CPU virtuales que quiera reservar para el contenedor. Este parámetro se corresponde con CpuShares en la sección Crear un contenedor de la API remota de Docker y con la opción --cpu-shares de docker run. Cada vCPU es equivalente a 1 024 cuotas de CPU. Debe especificar al menos una vCPU.

    2. En Memoria, introduzca el límite de memoria disponible para el contenedor. Si su contenedor intenta superar la cantidad de memoria que ha especificado aquí, se detiene el contenedor. Este parámetro se corresponde con Memory en la sección Crear un contenedor de la API remota de Docker y con la opción --memory de docker run. Debe especificar al menos 4 MiB de memoria para un trabajo.

       nota

       Para maximizar el uso de los recursos, priorice la memoria para los trabajos de un tipo de instancia específico. Para obtener más información, consulte Administración de la memoria de recurso de computación.

    3. En Número de unidades GPU, seleccione el número de unidades GPU que desea reservar para el contenedor.

    4. (Opcional) En el caso de Variables de entorno, seleccione Agregar variable de entorno para añadir variables de entorno como pares de nombre-valor. Estas variables se transfieren al contenedor.

    5. (Opcional) En Secretos, seleccione Agregar secreto para añadir los secretos como pares de nombre-valor. Estos secretos están expuestos en el contenedor. Para obtener más información, consulte LogConfiguration:secretOptions.

18. Seleccione Página siguiente.

19. En la sección de Configuración de Linux:

    1. En Usuario, introduzca el nombre de usuario a utilizar dentro del contenedor. Este parámetro se corresponde con User en la sección Crear un contenedor de la API remota de Docker y con la opción --user de docker run.

    2. (Opcional) Para otorgar al contenedor de su trabajo permisos elevados en la instancia host (similares a los del usuario de root), arrastre el control deslizante Privilegiado hacia la derecha. Este parámetro se corresponde con Privileged en la sección Crear un contenedor de la API remota de Docker y con la opción --privileged de docker run.

    3. (Opcional) Active la opción Habilitar el proceso init para ejecutar un proceso init dentro del contenedor. Este proceso reenvía señales y recoge procesos.

20. (Opcional) En la sección de Configuración de Filesystem:

    1. Active la opción Habilitar el sistema de archivos de solo lectura para eliminar el acceso de escritura al volumen.

    2. En Tamaño de memoria compartida, introduzca el tamaño (en MiB) del /dev/shm volumen de .

    3. En Tamaño de intercambio máximo, introduzca la cantidad total de memoria de intercambio (en MiB) que puede utilizar el contenedor.

    4. En Intercambio, introduzca un valor entre 0 y 100 para indicar el comportamiento de intercambio del contenedor. Si no especifica un valor y el intercambio está activado, el valor predeterminado es 60. Para obtener más información, consulte LinuxParameters:swappiness.

    5. (Opcional) Expandir Configuración adicional.

    6. (Opcional) En el caso de Tmpfs, seleccione Agregar tmpfs para añadir una montura tmpfs.

    7. (Opcional) En el caso de los Dispositivos, seleccione Agregar dispositivo para añadir un dispositivo:

       1. En Container path (Ruta del contenedor), especifique la ruta de la instancia del contenedor que va a exponer el dispositivo asignado a la instancia del host. Si lo deja en blanco, se utiliza la ruta del host en el contenedor.

       2. En Host path (Ruta de host), especifique la ruta de un dispositivo de la instancia del host.

       3. En la página Permisos, haga clic en uno o varios permisos para aplicarlos al dispositivo. Los permisos disponibles son READ, WRITE y MKNOD.

    8. (Opcional) En Configuración de volúmenes, seleccione Agregar volumen para crear una lista de volúmenes que se transferirán al contenedor. Introduzca el Nombre y la Ruta de origen del volumen y, a continuación, seleccione Agregar volumen. También puede optar por activar Habilitar EFS.

    9. (Opcional) En Puntos de montaje, elija la configuración Agregar puntos de montaje para agregar puntos de montaje a los volúmenes de datos. Debe especificar el volumen de origen y la ruta del contenedor. Estos puntos de montaje se transfieren al Docker daemon de una instancia de contenedor. También puede elegir que el volumen sea de Solo lectura.

    10. (Opcional) En Configuración de Ulimits, seleccione Agregar ulimit para agregar un ulimits valor al contenedor. Introduzca los valores de Nombre, Límite flexible y Límite invariable y, a continuación, elija Agregar límite máximo.

21. (Opcional) En la sección de Configuración de registro:

    1. En el Controlador de registro, elija el controlador de registro que desee utilizar. Para obtener más información sobre los controladores de registro disponibles, consulte Controlador de registro en LogConfiguration:logDriver.

       nota

       Se utiliza el controlador de registro awslogs de forma predeterminada.

    2. En Opciones, elija Agregar opción para agregar una opción. Introduzca un par nombre-valor y, a continuación, elija Agregar opción.

    3. En Secretos, seleccione Agregar secreto. Introduzca un par nombre-valor y, a continuación, seleccione Agregar secreto para añadir un secreto.

       sugerencia

       Para obtener más información, consulte LogConfiguration:secretOptions.

22. Seleccione Página siguiente.

23. Para la Revisión de definición de trabajo, revise los pasos de configuración. Si necesita realizar cambios, elija Editar. Cuando haya terminado, seleccione Crear definición de trabajo.