

# Criar um provedor de capacidade para instâncias gerenciadas do Amazon ECS
<a name="create-capacity-provider-managed-instances"></a>

As instâncias gerenciadas do Amazon ECS usam provedores de capacidade para gerenciar a capacidade computacional das workloads. Ao criar um provedor de capacidade sem especificar `instanceRequirements`, o Amazon ECS seleciona automaticamente os [tipos de instância de uso geral com melhor custo-benefício](https://aws.amazon.com/ec2/instance-types/general-purpose/). Você pode criar provedores de capacidade com o `instanceRequirements` para especificar atributos de instância, como tipos de instância, fabricantes de CPU, tipos de aceleradores e outros requisitos.

Os provedores de capacidade personalizados usam a seleção de tipo de instância baseada em atributo, o que permite expressar os requisitos da instância como um conjunto de atributos. Esses requisitos são traduzidos automaticamente para todos os tipos de instância do Amazon EC2 correspondentes, simplificando a criação e a manutenção das configurações do tipo de instância. Para saber mais sobre requisitos de instância e seleção baseada em atributo, consulte a documentação [Seleção de tipo de instância baseada em atributo do Amazon EC2 Fleet](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-attribute-based-instance-type-selection.html) no *Guia do usuário do Amazon EC2*.

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

Antes de começar, certifique-se de ter concluído os seguintes procedimentos:
+ Determine que tipo de monitoramento usar. Para obter mais informações, consulte [Monitoramento detalhado para instâncias gerenciadas do Amazon ECS](monitoring-managed-instances.md#detailed-monitoring-managed-instances).
+ Tenha um cluster existente ou planeje criar um. Para obter mais informações, consulte [Criar um cluster para instâncias gerenciadas do Amazon ECS](create-cluster-managed-instances.md).
+ Você tem os perfis do IAM necessários para instâncias gerenciadas do Amazon ECS. Isso inclui:
  + **Perfil de infraestrutura**: permite que o Amazon ECS faça chamadas para serviços da AWS em seu nome para gerenciar a infraestrutura de instâncias gerenciadas do Amazon ECS.

    Para obter mais informações, consulte [Perfil do IAM de infraestrutura do Amazon ECS](infrastructure_IAM_role.md).
  + **Perfil de instância**: fornece permissões para o agente de contêiner do Amazon ECS e para o daemon do Docker em execução nas instâncias gerenciadas.

    Para obter mais informações, consulte [Perfil de instância de instâncias gerenciadas do Amazon ECS](managed-instances-instance-profile.md).

Entenda como escolher suas instâncias. Para obter mais informações, consulte [Práticas recomendadas de seleção de instâncias gerenciadas do Amazon ECS](managed-instances-instance-selection-best-practices.md).

## Procedimento do console
<a name="create-capacity-provider-managed-instances-console"></a>

**Para criar um provedor de capacidade para instâncias gerenciadas do Amazon ECS (console do Amazon ECS)**

1. Abra o console em [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Na barra de navegação, selecione a Região a ser usada.

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

1. Na página **Clusters**, escolha o nome do cluster.

1. Na página do cluster, escolha a guia **Infraestrutura**.

1. Na seção **Provedores de capacidade**, escolha **Criar provedor de capacidade**.

1. Em **Configuração do provedor de capacidade**, configure o seguinte:
   + Em **Nome do provedor de capacidade**, insira um nome exclusivo para o provedor de capacidade.
   + Em **Tipo de provedor de capacidade**, escolha **Instâncias gerenciadas do Amazon ECS**.

1. Em **Configuração de instância**, configure o seguinte:
   + Em **Perfil de instância**, escolha o perfil criado para as instâncias gerenciadas do Amazon ECS.
   + Em **Perfil de infraestrutura**, escolha o perfil criado para as instâncias gerenciadas do Amazon ECS.

1. Em **Requisitos de instância**, especifique os atributos para suas instâncias. É possível configurar qualquer combinação de:
   + **Contagem de vCPUs**: especifique o número de vCPUs (por exemplo, `4` ou `8-16` para um intervalo).
   + **Memória (MiB)**: especifique a quantidade de memória em MiB (por exemplo, `8192` ou `16384-32768` para um intervalo).
   + **Tipos de instância**: especifique tipos de instância específicos (por exemplo, `m5.large,m5.xlarge,c5.large`).
   + **Fabricantes de CPU**: escolha entre `intel`, `amd` ou `amazon-web-services`.
   + **Tipos de acelerador**: especifique os tipos de acelerador, como `gpu`, `fpga` ou `inference`.
   + **Contagem de aceleradores**: especifique o número de aceleradores (por exemplo, `1` ou `2-4` para um intervalo).

1. Em **Configuração avançada**, escolha uma das seguintes opções de monitoramento:
   + Para que o CloudWatch envie métricas de verificação de status, escolha **Básico**.
   + Para que o CloudWatch envie todas as métricas, escolha **Detalhado**.

1. (Opcional) Para ajudar a identificar seu provedor de capacidade, expanda **Tags** e configure suas tags.

   Para habilitar a propagação de tags do provedor de capacidade para recursos gerenciados, como instâncias inicializadas no provedor de capacidade, em **Propagar tags de**, escolha **Provedor de capacidade**.

   [Adicionar uma tag] Selecione **Add tag** (Adicionar tag) e faça o seguinte:
   + Em **Key (Chave)**, insira o nome da chave.
   + Em **Valor** insira o valor da chave.

1. Escolha **Criar**.

## Procedimento da AWS CLI
<a name="create-capacity-provider-managed-instances-cli"></a>

Você pode criar um provedor de capacidade para instâncias gerenciadas do Amazon ECS usando a AWS CLI. Use a versão mais recente da AWS CLI. Para obter informações sobre como atualizar para a versão mais recente [Consulte instalar ou atualizar para a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).

**Para criar um provedor de capacidade para instâncias gerenciadas do Amazon ECS (AWS CLI)**

1. Execute o seguinte comando:

   ```
   aws ecs create-capacity-provider --cli-input-json file://capacity-provider-definition.json
   ```

   O seguinte `capacity-provider-definition.json` pode ser usado para especificar os requisitos básicos da instância, o tamanho do armazenamento da instância e permitir a propagação de tags:

   ```
   {
       "name": "my-managed-instances-provider",
       "cluster": "my-cluster",
       "tags": [ 
           { 
               "key": "version",
               "value": "test"
           }
       ],    
       "managedInstancesProvider": {
           "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
           "instanceLaunchTemplate": {
               "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceRole",
               "instanceRequirements": {
                   "vCpuCount": {
                       "min": 4,
                       "max": 8
                   },
                   "memoryMiB": {
                       "min": 8192,
                       "max": 16384
                   }
               },
               "networkConfiguration": {
                   "subnets": [
                       "subnet-abcdef01234567",
                       "subnet-bcdefa98765432"
                   ],
                   "securityGroups": [
                       "sg-0123456789abcdef"
                   ]
               },
               "storageConfiguration": {
                   "storageSizeGiB": 100
               },
               "monitoring": "basic"
           },
           "propagateTags": "CAPACITY_PROVIDER"
       }
   }
   ```

1. Verifique se o seu provedor de capacidade foi criado com êxito:

   ```
   aws ecs describe-capacity-providers \
       --capacity-providers my-managed-instances-provider
   ```

## Próximas etapas
<a name="capacity-provider-managed-instances-next-steps"></a>

Depois de criar seu provedor de capacidade, você pode usá-lo ao criar serviços ou executar tarefas:
+ Para usar o provedor de capacidade com um serviço, consulte [Criação de uma implantação de atualização contínua do Amazon ECS](create-service-console-v2.md).
+ Para usar o provedor de capacidade com tarefas autônomas, consulte [Execução de uma aplicação como uma tarefa do Amazon ECS](standalone-task-create.md).