

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

# Tutorial: Crie um ambiente computacional gerenciado usando instâncias gerenciadas do Amazon ECS
<a name="create-compute-environment-ecs-managed-instances"></a>

Este tutorial orienta você na criação de um ambiente AWS Batch computacional que usa instâncias gerenciadas do Amazon ECS. O Amazon ECS gerencia as instâncias do Amazon EC2 em seu nome — você especifica a capacidade máxima e as restrições opcionais da instância, e o Amazon ECS lida com o provisionamento, a escalabilidade e o encerramento.

## Pré-requisitos
<a name="create-ce-ecs-managed-instances-prerequisites"></a>

Antes de criar um ambiente computacional de instâncias gerenciadas do Amazon ECS, você deve ter o seguinte:
+ Uma função de infraestrutura do ** Amazon ECS ** — uma função do IAM que o Amazon ECS assume para gerenciar instâncias do Amazon EC2 em seu nome. A função deve ter uma política de confiança para`ecs.amazonaws.com`. Para obter mais informações, consulte a função IAM da infraestrutura do [ Amazon ECS ](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/infrastructure-iam-roles.html) no Guia * do desenvolvedor do * Amazon Elastic Container Service.
+ Um perfil de instância do ** Amazon EC2 ** — um perfil de instância que usa a política `AmazonECSInstanceRolePolicyForManagedInstances` gerenciada. A política de confiança deve `ec2.amazonaws.com` permitir assumir o papel.
+ Seu diretor do IAM deve ter `iam:PassRole` permissão para a função de infraestrutura com a condição`iam:PassedToService: ecs.amazonaws.com`.
+ Uma VPC com sub-redes com acesso externo à Internet (atribuição de IP público ou gateway NAT).

## Criação de um ambiente computacional de instâncias gerenciadas do Amazon ECS (console)
<a name="create-ce-ecs-managed-instances-console"></a>

1. Abra o AWS Batch console em [ https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).

1. Na barra de navegação, escolha o Região da AWS a ser usado.

1. No painel de navegação esquerdo, escolha ** Ambientes. **

1. Escolha ** Criar ambiente e**, em seguida, escolha ** Criar ambiente ** computacional.

1. Para o tipo ** de ambiente de computação**, escolha ** ECS Managed Instances. **

1. Em Nome do ambiente de ** computação**, insira um nome exclusivo. O nome pode ter até 128 caracteres e conter letras maiúsculas e minúsculas, números, hífens (-) e sublinhados (\_).

1. Em ** Máximo de vCPUs**, insira o número máximo de vCPUs para as quais o ambiente de computação pode ser escalado.

1. Para a função de ** infraestrutura**, escolha a função de infraestrutura do Amazon ECS que você criou como pré-requisito.

1. **Em Perfil de ** instância, escolha o perfil de instância do Amazon EC2 que você criou como pré-requisito.

1. Na ** seção ** Rede:

   1. Para ** VPC**, escolha a VPC em que as instâncias serão lançadas.

   1. Para ** Sub-redes**, escolha uma ou mais sub-redes. As sub-redes devem ter acesso de saída à Internet.

   1. Para grupos ** de segurança**, escolha um ou mais grupos de segurança para associar às instâncias.

1. (Opcional) Para o tipo de ** capacidade**, escolha ** Spot ** para usar instâncias spot para economizar custos em cargas de trabalho tolerantes a falhas. O padrão é **On-Demand**.

1. (Opcional) Para os tipos de instância ** permitidos**, especifique quais tipos de instância o Amazon ECS pode iniciar. Se você não especificar nenhum, todos os tipos de instância disponíveis serão elegíveis.

1. Escolha **Criar ambiente computacional**.

## Criação de um ambiente computacional de instâncias gerenciadas do Amazon ECS (AWS CLI)
<a name="create-ce-ecs-managed-instances-cli"></a>

Use o `create-compute-environment` comando para criar um ambiente computacional de instâncias gerenciadas do Amazon ECS.

### Exemplo básico
<a name="create-ce-ecs-managed-instances-cli-basic"></a>

O exemplo a seguir cria um ambiente computacional com a configuração mínima necessária. O Amazon ECS pode usar qualquer tipo de instância disponível.

```
$ aws batch create-compute-environment \
    --compute-environment-name {{my-managed-instances-ce}} \
    --type MANAGED \
    --state ENABLED \
    --compute-resources '{
      "type": "ECS_MANAGED_INSTANCES",
      "maxvCpus": 256,
      "managedInstancesProvider": {
        "infrastructureRoleArn": "arn:aws:iam::{{123456789012}}:role/{{ecsInfrastructureRole}}",
        "instanceLaunchTemplate": {
          "ec2InstanceProfileArn": "arn:aws:iam::{{123456789012}}:instance-profile/{{ecsInstanceProfile}}",
          "networkConfiguration": {
            "subnets": ["{{subnet-abcde012}}", "{{subnet-bcde012a}}"],
            "securityGroups": ["{{sg-abcde012}}"]
          }
        }
      }
    }'
```

### Identifique com tipos de instância específicos
<a name="create-ce-ecs-managed-instances-cli-spot"></a>

O exemplo a seguir cria um ambiente Spot-backed computacional restrito a tipos específicos de instância.

```
$ aws batch create-compute-environment \
    --compute-environment-name {{my-spot-managed-instances-ce}} \
    --type MANAGED \
    --state ENABLED \
    --compute-resources '{
      "type": "ECS_MANAGED_INSTANCES",
      "maxvCpus": 1000,
      "managedInstancesProvider": {
        "infrastructureRoleArn": "arn:aws:iam::{{123456789012}}:role/{{ecsInfrastructureRole}}",
        "instanceLaunchTemplate": {
          "ec2InstanceProfileArn": "arn:aws:iam::{{123456789012}}:instance-profile/{{ecsInstanceProfile}}",
          "networkConfiguration": {
            "subnets": ["{{subnet-abcde012}}", "{{subnet-bcde012a}}"],
            "securityGroups": ["{{sg-abcde012}}"]
          },
          "instanceRequirements": {
            "allowedInstanceTypes": ["m5.large", "m5.xlarge", "m6i.large", "m6i.xlarge"]
          },
          "capacityOptionType": "SPOT"
        }
      }
    }'
```

Saída:

```
{
    "computeEnvironmentName": "my-spot-managed-instances-ce",
    "computeEnvironmentArn": "arn:aws:batch:us-east-1:123456789012:compute-environment/my-spot-managed-instances-ce"
}
```

### Com reservas de capacidade
<a name="create-ce-ecs-managed-instances-cli-reservations"></a>

O exemplo a seguir cria um ambiente computacional que visa as reservas de On-Demand capacidade para obter capacidade previsível.

```
$ aws batch create-compute-environment \
    --compute-environment-name {{my-reserved-managed-instances-ce}} \
    --type MANAGED \
    --state ENABLED \
    --compute-resources '{
      "type": "ECS_MANAGED_INSTANCES",
      "maxvCpus": 512,
      "managedInstancesProvider": {
        "infrastructureRoleArn": "arn:aws:iam::{{123456789012}}:role/{{ecsInfrastructureRole}}",
        "instanceLaunchTemplate": {
          "ec2InstanceProfileArn": "arn:aws:iam::{{123456789012}}:instance-profile/{{ecsInstanceProfile}}",
          "networkConfiguration": {
            "subnets": ["{{subnet-abcde012}}", "{{subnet-bcde012a}}"],
            "securityGroups": ["{{sg-abcde012}}"]
          },
          "instanceRequirements": {
            "allowedInstanceTypes": ["m5.xlarge", "m5.2xlarge"]
          },
          "capacityReservations": {
            "reservationGroupArn": "arn:aws:ec2:{{us-east-1}}:{{123456789012}}:capacity-reservation-group/{{my-reservation-group}}",
            "reservationPreference": "RESERVATIONS_FIRST"
          }
        }
      }
    }'
```

## Próximas etapas
<a name="create-ce-ecs-managed-instances-next-steps"></a>

Depois de criar seu ambiente de computação, conclua as seguintes etapas para executar trabalhos:

1. Crie uma fila de tarefas e associe seu ambiente computacional de instâncias gerenciadas do Amazon ECS a ela. Para obter mais informações, consulte [Criar uma fila de trabalhos.](create-job-queue.md).

1. Crie uma definição de tarefa com `platformCapabilities` set to `MANAGED_INSTANCES` e using`ecsProperties`. Para obter mais informações, consulte [Definições de trabalho nas instâncias gerenciadas do Amazon ECS](ecs-managed-instances-job-definitions.md).

1. Envie um trabalho para a fila de trabalhos. Para obter mais informações, consulte [Tutorial: enviar um trabalho](submit_job.md).