Executivo do Amazon Elastic Container Service em AWS Toolkit for Visual Studio Code

PDFRSS

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 no Guia do desenvolvedor.

Pré-requisitos do Amazon ECS Exec

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

Requisitos do Amazon ECS

Dependendo se suas tarefas estão hospedadas na Amazon EC2 ou AWS Fargate, o Amazon ECS Exec tem requisitos de versão diferentes.

• Se você estiver usando a Amazon EC2, deverá usar uma AMI otimizada do Amazon ECS que foi lançada após 20 de janeiro de 2021, com uma versão de agente de 1.50.2 ou superior. Informações adicionais estão disponíveis para você no guia do desenvolvedor Amazon ECS otimizado AMIs.

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

AWS configuração da conta e permissões do IAM

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.

Como trabalhar com o Amazon ECS Exec

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

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

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

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

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

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

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

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.

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

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

4. 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).

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

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