

 AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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

# Como trabalhar com o Amazon Elastic Container Service
<a name="ecs"></a>

O AWS Cloud9 IDE fornece algum suporte para o [Amazon Elastic Container Service (Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/)). Você pode usar o AWS Cloud9 IDE para gerenciar os recursos do Amazon ECS. Por exemplo, você pode criar definições de tarefas.

**Topics**
+ [Amazon ECS Exec no AWS kit de ferramentas para AWS Cloud9](ecs-cloud9-exec.md)

# Amazon ECS Exec no AWS kit de ferramentas para AWS Cloud9
<a name="ecs-cloud9-exec"></a>

Você pode emitir comandos únicos em um contêiner do Amazon Elastic Container Service (Amazon ECS) com AWS o Toolkit for. AWS Cloud9 Você pode fazer isso usando o recurso do Amazon ECS Exec. 

**Importante**  
Habilitar e desabilitar o Amazon ECS Exec altera o estado dos recursos do ECS em sua Conta da AWS. As alterações incluem interromper e reiniciar o serviço. Além disso, alterar o estado dos recursos enquanto o Amazon ECS Exec está habilitado pode levar a resultados imprevisíveis. Para obter mais informações, consulte [Usar o Amazon ECS Exec para depuração](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html#ecs-exec-considerations) no *Guia do desenvolvedor do Amazon ECS*.

## Pré-requisitos do Amazon ECS Exec
<a name="ecs-exec-prereq"></a>

Antes de usar o recurso Amazon ECS Exec, você precisa atender a certas condições de pré-requisito.

### Requisitos do Amazon ECS
<a name="ecs-requirements"></a>

Dependendo se suas tarefas estão hospedadas no Amazon EC2 ou AWS Fargate se o Amazon ECS Exec tem requisitos de versão diferentes.
+ Se você usar o Amazon EC2, deverá usar uma AMI otimizada para o Amazon ECS que tenha sido lançada após 20 de janeiro de 2021, com a versão 1.50.2 ou posterior do agente. Para obter mais informações, consulte [Amazon ECS otimizado AMIs](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html) no *Amazon ECS Developer Guide.*
+ Se você usa AWS Fargate, você deve usar a plataforma versão 1.4.0 ou posterior. Para obter mais informações, consulte [Versões da plataforma AWS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html) no *Guia do desenvolvedor do Amazon ECS*.

### AWS configuração da conta e permissões do IAM
<a name="ecs-configuration"></a>

Para usar o recurso do Amazon ECS Exec, um cluster existente do Amazon ECS deve estar associado à sua Conta da AWS. O Amazon ECS Exec usa o Systems Manager para estabelecer uma conexão com os contêineres no cluster. Permissões ECSrequires específicas da função Task IAM da Amazon para se comunicar com o serviço SSM.

Para obter informações sobre a política e o perfil do IAM específicas ao Amazon ECS Exec, consulte [Permissões do IAM necessárias para o ECS Exec](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html#ecs-exec-enabling-and-using) no *Guia do desenvolvedor* do *Amazon ECS*.

## Como trabalhar com o Amazon ECS Exec
<a name="working-with-ecs-exec"></a>

Você pode ativar ou desativar o Amazon ECS Exec diretamente do AWS Explorer no AWS Toolkit for. AWS Cloud9 Ao habilitar o Amazon ECS Exec, escolha “containers” (contêineres) no menu do Amazon ECS e execute comandos referentes a eles.

### Habilitar o Amazon ECS Exec
<a name="enabling-exec"></a>

1. No AWS Explorer, localize e expanda o menu Amazon ECS.

1. Expanda o cluster com o serviço que você deseja modificar.

1. Abra o menu de contexto (clique com o botão direito do mouse) do serviço e escolha **Enable Command Execution** (Habilitar execução de comandos).

**Importante**  
Essa etapa inicia uma nova implantação do serviço e pode levar alguns minutos. Para obter mais informações, consulte a nota no início desta seção.

### Desabilitar o Amazon ECS Exec
<a name="disabling-ecs-exec"></a>

1. No AWS Explorer, localize e expanda o menu Amazon ECS.

1. Expanda o cluster que contém o serviço que você deseja.

1. Abra o menu de contexto (clique com o botão direito do mouse) do serviço e escolha **Disable Command Execution** (Desabilitar execução de comandos).

**Importante**  
Essa etapa inicia uma nova implantação do serviço e pode levar alguns minutos. Para obter mais informações, consulte a nota no início desta seção.

### Executar comandos referentes a um contêiner
<a name="run-commands-container"></a>

Para executar comandos em um contêiner usando o AWS Explorer, o Amazon ECS Exec deve estar habilitado. Se ele não estiver habilitado, consulte o procedimento [Habilitar o Amazon ECS Exec](#enabling-exec) nesta seção.

1. No AWS Explorer, localize e expanda o menu Amazon ECS.

1. Expanda o cluster que contém o serviço que você deseja.

1. Expanda o serviço para listar os contêineres associados.

1. Abra o menu de contexto do contêiner (clique com o botão direito do mouse) e escolha **Run Command in Container** (Executar comando no contêiner).

1. Um **prompt** é aberto com uma lista de tarefas em execução. Escolha o **ARN da tarefa** que você deseja.
**nota**  
Se apenas uma tarefa estiver em execução, não será aberto nenhum prompt. Em vez disso, a tarefa será selecionada automaticamente.

1. Quando solicitado, insira o comando que você deseja executar e pressione **Enter** para continuar.