如何通过AWS CLI复制旧版容器定义创建ECS任务定义新版本？

要实现和AWS ECS UI完全一致的行为（复制旧版本所有属性到新版本，仅修改需要更新的内容），你可以通过以下步骤操作，无需手动提取零散属性：

核心思路 #

利用aws ecs describe-task-definition获取旧版本任务定义的完整配置，仅修改需要更新的字段（比如容器镜像），再通过register-task-definition提交新版本，这样会保留旧版本的所有属性（包括容器定义的全部配置、角色、资源限制、网络模式等）。

具体操作步骤 #

1. 获取旧版本任务定义的完整JSON配置 #

替换<任务定义家族>:<版本号>为你的实际值，比如my-task:3：

OLD_TASK_DEF=$(aws ecs describe-task-definition --task-definition <任务定义家族>:<版本号> --query 'taskDefinition' --output json)

--query 'taskDefinition'用于过滤掉返回结果中外层的元数据，只保留任务定义本身的核心配置。

2. 修改需要更新的字段（以容器镜像为例） #

使用jq工具（需提前安装）修改容器镜像地址，替换<ECR镜像地址:标签>为你的新镜像地址，比如123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:v2：

# 单容器场景：修改第一个容器的镜像
NEW_TASK_DEF=$(echo "$OLD_TASK_DEF" | jq --arg NEW_IMAGE "<ECR镜像地址:标签>" '.containerDefinitions[0].image = $NEW_IMAGE')

# 多容器场景：根据容器名匹配修改（比如容器名为web）
NEW_TASK_DEF=$(echo "$OLD_TASK_DEF" | jq --arg NEW_IMAGE "<ECR镜像地址:标签>" '.containerDefinitions[] |= if .name == "web" then .image = $NEW_IMAGE else . end')

3. 注册新版本任务定义 #

将修改后的完整配置提交，ECS会自动生成新版本号：

aws ecs register-task-definition --cli-input-json "$NEW_TASK_DEF"

为什么你之前的方法不符合预期 #

你之前仅传递了--container-definitions参数，而没有包含任务定义的其他关键属性（比如executionRoleArn、taskRoleArn、networkMode、cpu/memory配置等），导致新版本仅保留了容器定义的部分内容，丢失了旧版本的其他属性，因此和UI操作效果不一致。

额外场景：无需修改属性直接创建新版本 #

如果只是想复制旧版本所有属性创建新版本（和UI中直接点击「创建新版本」不做任何修改的行为一致），直接执行以下命令即可：

aws ecs register-task-definition --cli-input-json "$OLD_TASK_DEF"

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