如何在ECS Fargate蓝绿部署中启用命令执行功能？

当ECS Fargate服务使用CodeDeploy作为部署控制器（蓝绿部署）时，直接通过VSCode AWS Toolkit或aws ecs update-service命令启用执行命令功能会触发InvalidParameterException，提示必须通过CodeDeploy触发部署。以下是具体解决步骤：

步骤1：更新任务定义，启用执行命令功能 #

首先需要创建新的任务定义版本，开启执行命令功能：

• 手动编辑任务定义：在容器定义中添加"enableExecuteCommand": true；同时确保任务执行角色（Task Execution Role）拥有ecs:ExecuteCommand权限（可通过附加AmazonECSTaskExecutionRolePolicy托管策略，或自定义包含该权限的策略）。
• 使用CLI更新任务定义：

aws ecs register-task-definition \
  --region ap-northeast-2 \
  --cli-input-json file://path/to/your-updated-task-def.json

（注：updated-task-def.json是包含enableExecuteCommand: true配置的任务定义JSON文件）

步骤2：通过CodeDeploy触发部署，应用新任务定义 #

由于服务绑定了CodeDeploy部署控制器，必须通过CodeDeploy流程将新的任务定义部署到环境中：

• 通过AWS控制台操作：进入CodeDeploy控制台，选择对应应用和部署组，发起新部署并指定刚创建的任务定义版本。
• 使用CLI触发部署：

aws deploy create-deployment \
  --region ap-northeast-2 \
  --application-name <你的CodeDeploy应用名称> \
  --deployment-group-name <你的CodeDeploy部署组名称> \
  --revision revisionType=ECS,ecsDeployment={taskDefinition=<新任务定义ARN>,serviceName=<ECS服务名称>,clusterName=<ECS集群名称>}

步骤3：验证执行命令功能 #

部署完成后，可通过以下方式验证功能是否正常：

• 使用AWS CLI测试：

aws ecs execute-command \
  --region ap-northeast-2 \
  --cluster <ECS集群名称> \
  --task <目标任务ID> \
  --container <容器名称> \
  --command "/bin/sh" \
  --interactive

• 验证通过后，即可在VSCode AWS Toolkit中正常使用Fargate终端执行命令功能。

在AWS CodeDeploy的蓝绿部署模式中，部署流程核心是创建一套全新的资源（绿色环境），并逐步将流量切换到新环境。这种模式本身并不支持直接在实例上执行命令，因为CodeDeploy的核心聚焦于部署和流量切换过程。

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