AWS Toolkit 中的 Amazon Elastic Container Service（Amazon ECS）Exec - AWS Toolkit for JetBrains
Amazon ECS Exec 先决条件 使用 Amazon ECS Exec

AWS Toolkit 中的 Amazon Elastic Container Service（Amazon ECS）Exec

您可以使用 Amazon ECS Exec 功能，直接从 AWS Toolkit 发出单个命令或在 Amazon Elastic Container Service（Amazon ECS）容器中运行 Shell。

重要

启用和禁用 Amazon ECS Exec 会更改 AWS 账户中资源的状态。这包括停止和重新启动服务。在 Amazon ECS Exec 处于启用状态时更改资源状态可能会导致不可预测的结果。有关 Amazon ECS Exec 的更多信息，请参阅 Using Amazon ECS Exec for Debugging 开发人员指南。

Amazon ECS Exec 先决条件

需要满足某些先决条件才能使用 Amazon ECS Exec 功能。

重要

要为特定服务启用 Amazon ECS Exec，必须对该服务禁用 Amazon ECS Cloud Debugging。

Amazon ECS 要求

根据您的任务是托管在 Amazon EC2 上还是 AWS Fargate (Fargate) 上，Amazon ECS Exec 具有不同的版本要求。

  • 如果您使用的是 Amazon EC2，必须使用 2021 年 1 月 20 日之后发布的经 Amazon ECS 优化的 AMI，代理版本为 1.50.2 或更高。其他信息可在经 Amazon ECS 优化的 AMI 开发人员指南中找到。

  • 如果您使用的是 AWS Fargate，则必须使用平台版 1.4.0 或更高版本。开发人员指南 AWS Fargate 平台版本中提供了有关 Fargate 要求的更多信息。

AWS 账户配置和 IAM 权限

要使用 Amazon ECS Exec 功能，您需要拥有与您的 AWS 账户 关联的现有 Amazon ECS 集群。Amazon ECS Exec 使用 Systems Manager 与集群中的容器建立连接，并且需要特定的任务 IAM 角色权限才能与 SSM 服务通信。

您可以在 ECS Exec 所需的 IAM 权限开发人员指南中找到特定于 Amazon ECS Exec 的 IAM 角色和策略信息。

使用 Amazon ECS Exec

您可以直接在 AWS Toolkit for JetBrains 中通过 AWS Explorer 来启用或禁用 Amazon ECS Exec。启用 Amazon ECS Exec 后，您可以从 Amazon ECS 菜单中选择容器，然后对它们运行命令。

启用 Amazon ECS Exec

  1. 在 AWS Explorer 中，展开 Amazon ECS 菜单。

  2. 展开集群部分，然后选择要修改的集群。

  3. 打开要修改的服务的上下文菜单（右键单击），然后选择启用命令执行。

    注意

    如果为此服务启用了 Amazon ECS Cloud Debugging，启用命令执行选项将不可用。禁用 Cloud Debugging 时将恢复该选项，但会停止并重新启动您的服务。

重要

此操作将启动服务的新部署，可能需要几分钟。有关更多信息，请参阅本部分开头的注释。

禁用 Amazon ECS Exec

  1. 在 AWS Explorer 中，展开 Amazon ECS 菜单。

  2. 展开集群部分，然后选择要修改的集群。

  3. 打开服务的上下文菜单（右键单击），然后选择禁用命令执行。

重要

此操作将启动服务的新部署，可能需要几分钟。有关更多信息，请参阅本部分开头的注释。

对容器运行命令

要使用 AWS Explorer 对容器运行命令，必须启用 Amazon ECS Exec。如果未启用，请参阅本部分中的“启用 Amazon ECS Exec”步骤。

  1. 在 AWS Explorer 中，展开 Amazon ECS 菜单。

  2. 展开集群部分，然后选择要修改的集群。

  3. 展开服务以列出其容器。

  4. 打开要修改的容器的上下文菜单（右键单击），然后选择在容器中运行命令。

  5. 在在容器中运行命令对话框中，选择所需的任务 ARN。

  6. 您可以输入要运行的命令，也可以从同一会话期间运行的命令列表中选择相应命令。

  7. 选择 Execute（执行）。

在 Shell 中运行命令

要在 Shell 中使用 AWS Explorer 对容器运行命令，必须启用 Amazon ECS Exec。如果未启用，请参阅本部分中的“启用 Amazon ECS Exec”步骤。

  1. 在 AWS Explorer 中，展开 Amazon ECS 菜单。

  2. 展开集群部分，然后选择要修改的集群。

  3. 展开服务以列出其容器。

  4. 打开要修改的容器的上下文菜单（右键单击），然后选择打开交互式 Shell。

  5. 在交互式 Shell 对话框中，选择所需的任务 ARN。

  6. 从相应的下拉列表中选择一个 Shell，或输入要与之交互的 Shell 的名称。

  7. 如果您对设置感到满意，请选择执行。

  8. 当 Shell 在终端中打开后，您可以输入命令以与容器进行交互。