Amazon Elastic Container Service Exec no AWS kit de ferramentas para AWS Cloud9 - AWS Cloud9
Pré-requisitos ECS do Amazon Exec Trabalhando com o Amazon ECS Exec

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 Elastic Container Service Exec no AWS kit de ferramentas para AWS Cloud9

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

Importante

Ativar e desativar o Amazon ECS Exec altera o estado dos seus ECS recursos no seu. 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á ativado pode levar a resultados imprevisíveis. Para obter mais informações sobre a AmazonECS, consulte Usando o Amazon ECS Exec para depuração no Amazon Developer Guide. ECS

Pré-requisitos ECS do Amazon Exec

Antes de usar o recurso Amazon ECS Exec, há certas condições de pré-requisitos que você deve atender.

ECSRequisitos da Amazon

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

  • Se você usa a AmazonEC2, deve usar uma Amazon ECS otimizada AMI 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 otimizada 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 as versões AWS Fargate da plataforma no Amazon ECS Developer Guide.

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

Para usar o recurso Amazon ECS Exec, você deve ter um ECS cluster Amazon existente associado ao seu Conta da AWS. O Amazon ECS Exec usa o Systems Manager para estabelecer uma conexão com os contêineres em seu cluster. Permissões de IAM função de tarefa ECSrequires específicas da Amazon para se comunicar com o SSM serviço.

Para obter informações sobre a IAM função e a política específicas do Amazon ECS Exec, consulte IAMas permissões necessárias para o ECS Exec no Amazon ECS Developer Guide.

Trabalhando com o Amazon ECS Exec

Você pode ativar ou desativar o Amazon ECS Exec diretamente do AWS Explorer no AWS Toolkit for. AWS Cloud9 Quando você habilitou o Amazon ECS Exec, escolha contêineres ECS no menu Amazon e execute comandos neles.

Habilitando o Amazon ECS Exec

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

  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.

Desativando o Amazon Exec ECS

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

  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 ele não estiver habilitado, consulte o procedimento Habilitando o Amazon ECS Exec nesta seção.

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

  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 é aberto com uma lista de tarefas em execução. Escolha a tarefa ARN 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.

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