amazon-web-services - 获取托管特定服务名称的 ECS 任务的 EC2 实例 ID

Question

使用 AWS SSM 插件，您可以使用以下命令登录 ECS 容器:

aws ssm start-session --target i-<ec2 instance target id>
sudo su
docker ps
docker exec -it <image id> bash

诀窍是您需要首先找到正确的 ec2 实例 ID。这可以通过几个命令行调用手动完成。例如

aws ecs list-container-instances --cluster <cluster name>
aws ecs list-tasks --cluster <cluster name>

但这并没有给我我想要的东西，即一个能够指定 ECS 服务名称并立即登录到托管该服务任务的 EC2 实例的快速脚本或 oneliner。

显然可能有多个实例托管来自服务的多个任务 - 第一个是可以的。

总之，如何获取托管特定服务名称的任务的 EC2 实例 ID。理想情况下，该实例 ID 可以通过管道传输到 aws ssm 命令中。

Answer 1

每个容器都有一个可用的容器元数据文件。文件位置自动放置在环境变量 ECS_CONTAINER_METADATA_FILE 中。

根据 the docs ，您必须启用容器元数据，因为默认情况下它不可用。这可以通过在 ECS EC2 实例的 /etc/ecs/ecs.config 文件中设置 ECS_ENABLE_CONTAINER_METADATA=true 来完成。 (更新文件后必须重新启动ECS代理)。

您可以通过运行 cat $ECS_CONTAINER_METADATA_FILE 来查看容器中文件的内容。例如，

{
    "Cluster": "default",
    "ContainerInstanceARN": "arn:aws:ecs:us-west-2:012345678910:container-instance/1f73d099-b914-411c-a9ff-81633b7741dd",
    "TaskARN": "arn:aws:ecs:us-west-2:012345678910:task/2b88376d-aba3-4950-9ddf-bcb0f388a40c",
    "ContainerID": "98e44444008169587b826b4cd76c6732e5899747e753af1e19a35db64f9e9c32",
    "ContainerName": "metadata",
    "DockerContainerName": "/ecs-metadata-7-metadata-f0edfbd6d09fdef20800",
    "ImageID": "sha256:c24f66af34b4d76558f7743109e2476b6325fcf6cc167c6e1e07cd121a22b341",
    "ImageName": "httpd:2.4",
    "PortMappings": [
        {
            "ContainerPort": 80,
            "HostPort": 80,
            "BindIp": "",
            "Protocol": "tcp"
        }
    ],
    "Networks": [
        {
            "NetworkMode": "bridge",
            "IPv4Addresses": [
                "172.17.0.2"
            ]
        }
    ],
    "MetadataFileStatus": "READY"
}

有了这些信息，我们可以进行 API 调用来获取容器正在其上运行的 EC2 实例 ID。对于以下示例，我假设 jq 和 aws-cli 安装在您的容器中。我还假设您已将环境变量 ECS_CLUSTER 添加到 Task Definition 中，其中包含 ECS 集群的名称。

#!/bin/bash -e
CONTAINER_ARN=$(cat ${ECS_CONTAINER_METADATA_FILE} | jq -r '.ContainerInstanceARN')

CONTAINER_DESCRIPTION=$(aws ecs describe-container-instances --container-instances ${CONTAINER_ARN} --cluster ${ECS_CLUSTER} --region ${YOUR_REGION})

EC2_INSTANCE_ID=$(echo ${CONTAINER_DESCRIPTION} | jq -r '.containerInstances[0].ec2InstanceId')

echo ${EC2_INSTANCE_ID}

我正在容器中运行类似的脚本。确保配置与任务的 IAM 角色关联的 IAM 策略，以便它有权执行 ecs:DescribeContainerInstances 操作。