如何通过aws ecs run-task结合execute-command在ECS Fargate打开公共镜像交互shell

报错原因说明 #

• Essential container in task exited报错：公开基础镜像（如alpine、busybox、Amazon Linux等）的默认命令执行完成后会直接终止进程，导致Fargate任务进入停止状态，而ecs execute-command仅支持对运行中状态的任务发起调用。
• exec: "sleep 10000": executable file not found报错：ECS的容器启动命令参数要求将命令和参数拆分为独立的数组元素，你将sleep 10000作为单个字符串传入时，系统会尝试寻找名称为sleep 10000的可执行文件，而非执行sleep命令传入10000参数。

具体实现方案 #

你可以直接使用Docker Hub公开的官方轻量镜像，配合shell脚本实现单步启动交互式shell、用完自动清理的需求，不需要自定义构建镜像。

前置要求 #

本地已经配置好AWS CLI权限，且ECS集群已经完成ecs exec相关配置：任务角色包含AmazonSSMManagedInstanceCore权限、任务定义开启exec功能、集群使用的子网有路由到SSM服务的路径。

一键执行脚本 #

替换脚本中尖括号内的配置参数后直接运行即可：

#!/bin/bash
# 替换为你自己的配置
CLUSTER_NAME=<你的ECS集群名称>
TASK_DEFINITION=<你的测试用任务定义名称，可直接绑定alpine:latest或amazonlinux:2公开镜像>
SUBNET_ID=<你的私有子网ID>
SECURITY_GROUP_ID=<你的安全组ID>
CONTAINER_NAME=<任务定义中的容器名称>

# 启动任务，设置兜底超时300秒，异常断开后也会自动退出避免残留
TASK_ARN=$(aws ecs run-task \
  --cluster $CLUSTER_NAME \
  --task-definition $TASK_DEFINITION \
  --launch-type FARGATE \
  --network-configuration "awsvpcConfiguration={subnets=[$SUBNET_ID],securityGroups=[$SECURITY_GROUP_ID],assignPublicIp=DISABLED}" \
  --enable-execute-command \
  --overrides '{"containerOverrides": [{"name": "'"$CONTAINER_NAME"'", "command": ["sleep", "300"]}]}' \
  --query 'tasks[0].taskArn' \
  --output text)

echo "等待任务启动中..."
aws ecs wait tasks-running --cluster $CLUSTER_NAME --tasks $TASK_ARN

# 进入交互式shell，用alpine镜像填/bin/sh，用Amazon Linux镜像可填/bin/bash
aws ecs execute-command \
  --cluster $CLUSTER_NAME \
  --task $TASK_ARN \
  --container $CONTAINER_NAME \
  --interactive \
  --command "/bin/sh"

# 退出shell后自动清理资源
echo "正在清理任务资源..."
aws ecs stop-task --cluster $CLUSTER_NAME --task $TASK_ARN > /dev/null
echo "资源清理完成"

其他说明 #

全程仅需要执行一次上述脚本即可完成所有操作，不需要后台任务长期驻留，退出shell后资源会自动销毁，300秒的兜底超时也能避免异常断开导致的资源浪费。

内容的提问来源于stack exchange，提问作者clay