

# 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. Por padrão, o Amazon ECS fornece um provedor de capacidade padrão que seleciona automaticamente os tipos de instância de uso geral mais econômicos. No entanto, você pode criar provedores de capacidade personalizados para especificar atributos de instância, como tipos de instância, fabricantes de CPU, tipos de acelerador 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).