

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

# Executivo do Amazon Elastic Container Service em AWS Toolkit for Visual Studio Code
<a name="ecs-exec"></a>

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

**Importante**  
Ativar e desativar o Amazon ECS Exec altera o estado dos recursos em sua conta. AWS As alterações incluem interromper e reiniciar o serviço. Alterar o estado dos recursos enquanto o Amazon ECS Exec está habilitado pode levar a resultados imprevisíveis. Para obter mais informações sobre o Amazon ECS Exec, 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.

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

Para usar o recurso Amazon ECS Exec, você precisa atender a determinados pré-requisitos.

### Requisitos do Amazon ECS
<a name="w2aac17c35c10c11b5"></a>

Dependendo se suas tarefas estão hospedadas no Amazon EC2 ou, o AWS Fargate Amazon ECS Exec tem requisitos de versão diferentes.
+ Se você estiver usando o Amazon EC2, deverá usar uma AMI otimizada para Amazon ECS que tenha sido lançada após 20 de janeiro de 2021, com a versão 1.50.2 ou superior do agente. Informações adicionais estão disponíveis para você no guia do desenvolvedor [Amazon ECS otimizado AMIs.](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html)
+ Se você estiver usando AWS Fargate, deverá usar a versão 1.4.0 ou superior da plataforma. Informações adicionais sobre os requisitos do Fargate estão disponíveis no guia do desenvolvedor das [versões da plataforma do AWS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html).

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

Para usar o recurso Amazon ECS Exec, você precisa ter um cluster Amazon ECS existente associado à sua conta. AWS O Amazon ECS Exec usa o Systems Manager para estabelecer uma conexão com os contêineres no cluster e exige permissões específicas de tarefa do perfil do IAM.

Você pode encontrar informações sobre a política e o perfil do IAM, específicas do Amazon ECS Exec, no guia do desenvolvedor das [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).

## Como trabalhar com o Amazon ECS Exec
<a name="w2aac17c35c10c15"></a>

Você pode ativar ou desativar o Amazon ECS Exec diretamente do AWS Explorer no Toolkit for VS Code. Ao habilitar o Amazon ECS Exec, você poderá escolher contêineres no menu do Amazon ECS e executar comandos neles.

### Habilitar o Amazon ECS Exec
<a name="w2aac17c35c10c15b5"></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="w2aac17c35c10c15b7"></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="w2aac17c35c10c15b9"></a>

Para executar comandos em um contêiner usando o AWS Explorer, o Amazon ECS Exec deve estar habilitado. Se não estiver habilitado, consulte o procedimento **Habilitar o ECS 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** será aberto com uma lista de tarefas em execução. Selecione o **ARN da tarefa** que você deseja.
**nota**  
Se apenas uma tarefa estiver em execução para esse serviço, ela será selecionada automaticamente e esta etapa será ignorada.

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