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
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á.
Amazon ECS Exec no kit de ferramentas da AWS para o AWS Cloud9
É possível emitir comandos únicos em um contêiner do Amazon Elastic Container Service (Amazon ECS) com o kit de ferramentas da AWS para 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 no Guia do desenvolvedor do Amazon ECS.
Pré-requisitos do Amazon ECS Exec
Antes de usar o recurso Amazon ECS Exec, você precisa atender a certas condições de pré-requisito.
Requisitos do Amazon ECS
Dependendo do local em que suas tarefas estão armazenadas, se no Amazon EC2 ou no AWS Fargate, 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 AMIs otimizadas para Amazon ECS no Guia do desenvolvedor do Amazon ECS.
Se você utilizar o AWS Fargate, deverá usar a versão 1.4.0 ou posterior da plataforma. Para obter mais informações, consulte Versões da plataforma AWS Fargate no Guia do desenvolvedor do Amazon ECS.
Configuração da conta da AWS e permissões do IAM
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. Para se comunicar com o serviço SSM, o Amazon ECS exige permissões específicas do perfil do IAM de tarefa.
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 no Guia do desenvolvedor do Amazon ECS.
Como trabalhar com o Amazon ECS Exec
É possível habilitar ou desabilitar o Amazon ECS Exec diretamente pelo AWS Explorer no kit de ferramentas da AWS para 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
No AWS Explorer, localize e expanda o menu do Amazon ECS.
Expanda o cluster com o serviço que você deseja modificar.
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
No AWS Explorer, localize e expanda o menu do Amazon ECS.
Expanda o cluster que contém o serviço que você deseja.
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 referentes a 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 nesta seção.
No AWS Explorer, localize e expanda o menu do Amazon ECS.
Expanda o cluster que contém o serviço que você deseja.
Expanda o serviço para listar os contêineres associados.
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).
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.
Quando solicitado, insira o comando que você deseja executar e pressione Enter para continuar.
