任务元数据可用于 EC2 上的 Amazon ECS 任务 - Amazon Elastic Container Service

任务元数据可用于 EC2 上的 Amazon ECS 任务

Amazon ECS 容器代理提供了检索各种任务元数据和 Docker 统计数据的方法。这称为任务元数据终端节点。提供了以下版本：

  • 任务元数据端点版本 4 — 为容器提供各种元数据和 Docker 统计信息。还可以提供网络速率数据。可用于在运行至少 1.39.0 版本的 Amazon ECS 容器代理的Amazon EC2 Linux 实例上启动的 Amazon ECS 任务。对于使用 awsvpc 网络模式的 Amazon EC2 Windows 实例，Amazon ECS 容器代理的版本必须至少为 1.54.0。有关更多信息，请参阅 Amazon ECS 任务元数据端点版本 4。

  • 任务元数据端点版本 3 — 为容器提供各种元数据和 Docker 统计信息。可用于在运行至少 1.21.0 版本的 Amazon ECS 容器代理的Amazon EC2 Linux 实例上启动的 Amazon ECS 任务。对于使用 awsvpc 网络模式的 Amazon EC2 Windows 实例，Amazon ECS 容器代理的版本必须至少为 1.54.0。有关更多信息，请参阅 Amazon ECS 任务元数据端点版本 3。

  • 任务元数据端点版本 2–可用于在运行至少版本 1.17.0 的 Amazon ECS 容器代理的 Amazon EC2 Linux实例上启动的 Amazon ECS 任务。对于使用 awsvpc 网络模式的 Amazon EC2 Windows 实例，Amazon ECS 容器代理的版本必须至少为 1.54.0。有关更多信息，请参阅 Amazon ECS 任务元数据端点版本 2。

如果您的 Amazon ECS 任务托管在 Amazon EC2 上，或者如果您的任务使用 host 网络模式并托管在 Amazon ECS 托管实例上，您也可以使用实例元数据服务 (IMDS) 端点访问任务主机元数据。以下命令在托管任务的实例中运行时，会列出主机实例的 ID。

 curl http://169.254.169.254/latest/meta-data/instance-id

如果您的 Amazon ECS 任务托管在 Amazon EC2 上并采用仅 IPv6 配置，则可以使用 IPv6 IMDS 端点访问任务主机元数据。从托管任务的实例中运行以下命令时，会列出 IPv6 上主机实例的 ID。

 curl http://[fd00:ec2::254]/latest/meta-data/instance-id

要访问 IPv6 IMDS 端点，请在容器实例上启用 IPv6 IMDS 端点，并使用所选 SDK 的 IMDS 凭证提供程序将元数据服务端点模式配置为 IPv6。有关为容器实例启用 IPv6 IMDS 端点的更多信息，请参阅《Amazon EC2 用户指南》中的配置实例元数据服务选项。有关 SDK 的 IMDS 凭证提供程序的更多信息，请参阅《AWS SDK 和工具参考指南》中的 IMDS 凭证提供程序。

注意

启用 awsvpcTrunking 账户设置后，将无法访问 IPv6 IMDS 端点。要在启用 awsvpcTrunking 时访问容器实例 IAM 角色凭证，您可以改用任务 IAM 角色。有关任务 IAM 角色的更多信息，请参阅Amazon ECS 任务 IAM 角色。

您可以从端点获取的信息分为几个类别，例如 instance-id。有关您可以使用端点获取的不同类别的主机实例元数据的更多信息，请参阅实例元数据类别。