View a markdown version of this page

Cree una definición de trabajo en las instancias administradas de Amazon ECS - AWS Batch
Crear una definición de trabajo en las instancias administradas de Amazon ECS (consola)Crear una definición de trabajo en las instancias administradas de Amazon ECS (AWS CLI)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cree una definición de trabajo en las instancias administradas de Amazon ECS

Las definiciones de trabajo de las instancias administradas de Amazon ECS se utilizan ecsProperties con la capacidad de la plataformaMANAGED_INSTANCES. A diferencia de Fargate, no hay restricciones en cuanto a las combinaciones de tamaño de vCPU y memoria, y se admiten los recursos de GPU. Para obtener más información sobre los parámetros compatibles, consulte. Definiciones de trabajo en las instancias administradas de Amazon ECS

Crear una definición de trabajo en las instancias administradas de Amazon ECS (consola)

Para crear una nueva definición de trabajo en las instancias administradas de Amazon ECS:

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

  2. En la barra de navegación superior, elige el Región de AWS que deseas usar.

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

  4. Seleccione Crear.

  5. Para el tipo de orquestación, elija ECS Managed Instances.

  6. 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 (_).

  7. (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.

  8. Para el rol de ejecución, elija un rol de IAM que otorgue al agente contenedor de Amazon ECS permiso para realizar llamadas a la AWS API en su nombre. Este rol es obligatorio para los trabajos de instancias administradas de Amazon ECS. Por ejemplo, el rol se usa para extraer imágenes de contenedores de Amazon ECR.

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

    1. En Imagen, introduzca la imagen del contenedor que se va a utilizar para el trabajo. Las imágenes de los registros de Amazon ECR se pueden especificar con la repository-url/image:tag convención de nomenclatura. Las imágenes de los registros públicos utilizan la URI completa (por ejemplo,). public.ecr.aws/amazonlinux/amazonlinux:2023

    2. En Comando, introduzca el comando que desea pasar al contenedor.

    3. En CPU virtuales, especifique la cantidad de CPU virtuales que quiera reservar para el contenedor.

    4. En Memoria, especifique el límite de memoria (en MiB) disponible para el contenedor.

    5. (Opcional) En el caso de las GPU, especifique la cantidad de dispositivos de GPU que desea poner a disposición del contenedor. El entorno de procesamiento debe tener instancias de GPU disponibles.

  10. (Opcional) Amplíe Etiquetas y, a continuación, elija Agregar etiqueta para agregar etiquetas al recurso. Active Propagar etiquetas para propagar etiquetas desde el trabajo y la definición del trabajo.

  11. Seleccione Crear una definición de trabajo.

Crear una definición de trabajo en las instancias administradas de Amazon ECS (AWS CLI)

Utilice el register-job-definition comando para crear una definición de trabajo para las instancias administradas de Amazon ECS.

Ejemplo básico

El siguiente ejemplo crea una definición de trabajo mínima que ejecuta un comando sencillo.

$ aws batch register-job-definition \
    --job-definition-name my-managed-instances-job-def \
    --type container \
    --platform-capabilities MANAGED_INSTANCES \
    --ecs-properties '{
      "taskProperties": [{
        "containers": [{
          "image": "public.ecr.aws/amazonlinux/amazonlinux:2023",
          "name": "main",
          "command": ["echo", "hello managed instances"],
          "resourceRequirements": [
            {"type": "VCPU", "value": "1"},
            {"type": "MEMORY", "value": "1024"}
          ]
        }],
        "executionRoleArn": "arn:aws:iam::123456789012:role/ecsTaskExecutionRole"
      }]
    }'

Definición de trabajo de GPU

El siguiente ejemplo crea una definición de trabajo que solicita recursos de GPU.

$ aws batch register-job-definition \
    --job-definition-name my-gpu-managed-instances-job-def \
    --type container \
    --platform-capabilities MANAGED_INSTANCES \
    --ecs-properties '{
      "taskProperties": [{
        "containers": [{
          "image": "123456789012.dkr.ecr.us-east-1.amazonaws.com/my-gpu-image:latest",
          "name": "main",
          "command": ["nvidia-smi"],
          "resourceRequirements": [
            {"type": "VCPU", "value": "4"},
            {"type": "MEMORY", "value": "16384"},
            {"type": "GPU", "value": "1"}
          ]
        }],
        "executionRoleArn": "arn:aws:iam::123456789012:role/ecsTaskExecutionRole"
      }]
    }'

Multi-container Definición de trabajo (sidecar)

En el siguiente ejemplo, se crea una definición de trabajo con un contenedor principal y un contenedor de registro lateral.

$ aws batch register-job-definition \
    --job-definition-name my-sidecar-managed-instances-job-def \
    --type container \
    --platform-capabilities MANAGED_INSTANCES \
    --ecs-properties '{
      "taskProperties": [{
        "containers": [{
          "image": "public.ecr.aws/amazonlinux/amazonlinux:2023",
          "name": "main",
          "command": ["echo", "processing data"],
          "essential": true,
          "resourceRequirements": [
            {"type": "VCPU", "value": "2"},
            {"type": "MEMORY", "value": "4096"}
          ]
        },
        {
          "image": "public.ecr.aws/amazonlinux/amazonlinux:2023",
          "name": "sidecar",
          "command": ["echo", "logging sidecar"],
          "essential": false,
          "resourceRequirements": [
            {"type": "VCPU", "value": "1"},
            {"type": "MEMORY", "value": "512"}
          ]
        }],
        "executionRoleArn": "arn:aws:iam::123456789012:role/ecsTaskExecutionRole"
      }]
    }'