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 AWS kit de ferramentas para AWS Cloud9
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 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 se suas tarefas estão hospedadas na Amazon EC2 ou AWS Fargate, se o Amazon ECS Exec tem requisitos de versão diferentes.
Se você usa a Amazon EC2, deve usar uma AMI otimizada do Amazon ECS que foi lançada após 20 de janeiro de 2021, com uma versão de agente 1.50.2 ou posterior. Para obter mais informações, consulte Amazon ECS otimizado AMIs 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 no Guia do desenvolvedor do Amazon ECS.
AWS configuração da conta 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. 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 no Guia do desenvolvedor do Amazon ECS.
Como trabalhar com o Amazon ECS Exec
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
No AWS Explorer, localize e expanda o menu 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 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 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 nesta seção.
No AWS Explorer, localize e expanda o menu 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.
