View a markdown version of this page

Crie uma definição de trabalho nas instâncias gerenciadas do Amazon ECS - AWS Batch
Criação de uma definição de trabalho nas instâncias gerenciadas do Amazon ECS (console)Criação de uma definição de trabalho nas instâncias gerenciadas do Amazon ECS (AWS CLI)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Crie uma definição de trabalho nas instâncias gerenciadas do Amazon ECS

As definições de tarefas das Instâncias Gerenciadas do Amazon ECS são usadas ecsProperties com a capacidade da MANAGED_INSTANCES plataforma. Ao contrário do Fargate, não há restrições nas combinações de vCPU e tamanho de memória, e os recursos de GPU são suportados. Para obter mais informações sobre os parâmetros suportados, consulteDefinições de trabalho nas instâncias gerenciadas do Amazon ECS.

Criação de uma definição de trabalho nas instâncias gerenciadas do Amazon ECS (console)

Para criar uma nova definição de tarefa nas instâncias gerenciadas do Amazon ECS:

  1. Abra o AWS Batch console em https://console.aws.amazon.com/batch/.

  2. Na barra de navegação superior, escolha o Região da AWS que deseja usar.

  3. No painel de navegação esquerdo, escolha Definições de trabalho.

  4. Escolha Criar.

  5. Para o tipo de orquestração, escolha ECS Managed Instances.

  6. Em Nome, insira um nome exclusivo para a sua definição de trabalho. Os nomes podem ter até 128 caracteres. Podem conter letras minúsculas, maiúsculas, números, hifens e (-) e sublinhados (_).

  7. (Opcional) Em Tempo Limite de Execução, insira o valor do tempo limite (em segundos). O tempo limite de execução é o período de tempo antes que um trabalho não concluído seja encerrado. Se uma tentativa exceder o tempo limite, ela será interrompida e passada para um status FAILED. Para mais informações, consulte Tempos limite de trabalho. O valor mínimo é 60 segundos.

  8. Para a função de execução, escolha uma função do IAM que conceda ao agente de contêiner do Amazon ECS permissão para fazer chamadas de AWS API em seu nome. Essa função é necessária para trabalhos de instâncias gerenciadas do Amazon ECS. Por exemplo, a função é usada para extrair imagens de contêiner do Amazon ECR.

  9. Na seção Configuração de Contêiner:

    1. Em Imagem, insira a imagem do contêiner a ser usada no trabalho. As imagens nos registros do Amazon ECR podem ser especificadas com a convenção de repository-url/image:tag nomenclatura. Imagens em registros públicos usam o URI completo (por exemplo,public.ecr.aws/amazonlinux/amazonlinux:2023).

    2. Em Comando, insira o comando a ser passado para o contêiner.

    3. Para vCPUs, especifique o número de vCPUs a serem reservadas para o contêiner.

    4. Para Memória, especifique o limite de memória (em MiB) disponível para o contêiner.

    5. (Opcional) Para GPUs, especifique o número de dispositivos de GPU a serem disponibilizados para o contêiner. O ambiente de computação deve ter instâncias de GPU disponíveis.

  10. (Opcional) Expanda Tags e então, escolha Adicionar Tag para adicionar tags ao recurso. Ative Propagar tags para propagar tags do trabalho e da definição do trabalho.

  11. Escolha Criar definição de tarefa.

Criação de uma definição de trabalho nas instâncias gerenciadas do Amazon ECS (AWS CLI)

Use o register-job-definition comando para criar uma definição de tarefa para instâncias gerenciadas do Amazon ECS.

Exemplo básico

O exemplo a seguir cria uma definição mínima de tarefa que executa um comando simples.

$ 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"
      }]
    }'

Definição de tarefa de GPU

O exemplo a seguir cria uma definição de tarefa 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 definição de trabalho (secundário)

O exemplo a seguir cria uma definição de tarefa com um contêiner principal e um contêiner de registro secundário.

$ 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"
      }]
    }'