启动模板UserData脚本连接ECS集群失效，需手动重启ECS服务

问题描述 #

通过UserData脚本配置EC2实例加入ECS集群时，实例无法自动加入集群，必须手动登录后重启ECS服务才能正常连接。在脚本末尾添加stop/start ECS服务的命令也无法解决该问题。

原UserData脚本：

#!/bin/bash

sudo amazon-linux-extras disable docker
sudo amazon-linux-extras install -y ecs
echo ECS_CLUSTER=ClusterName | sudo tee -a /etc/ecs/ecs.config
echo ECS_ENABLE_GPU_SUPPORT=true | sudo tee -a /etc/ecs/ecs.config
sudo systemctl enable --now ecs

可能原因 #

脚本中修改ecs.config配置文件后直接启用并启动ECS服务，服务启动时可能还未读取到最新配置；后续添加的stop/start命令可能在服务未完全启动完成时就执行，导致配置未被正确加载。

解决方案 #

方案1：调整命令顺序+增加等待时间 #

先启用服务，等待服务初始化完成后再重启，确保配置被正确读取：

#!/bin/bash

sudo amazon-linux-extras disable docker
sudo amazon-linux-extras install -y ecs
echo ECS_CLUSTER=ClusterName | sudo tee -a /etc/ecs/ecs.config
echo ECS_ENABLE_GPU_SUPPORT=true | sudo tee -a /etc/ecs/ecs.config
sudo systemctl enable ecs
# 等待服务完成初始化
sleep 10
sudo systemctl restart ecs

方案2：先停服务再写配置 #

调整脚本顺序，确保配置写入完成后再启动服务，避免服务提前读取旧配置：

#!/bin/bash

sudo amazon-linux-extras disable docker
sudo amazon-linux-extras install -y ecs
# 停止可能已启动的ecs进程，忽略未启动的情况
sudo systemctl stop ecs || true
echo ECS_CLUSTER=ClusterName | sudo tee -a /etc/ecs/ecs.config
echo ECS_ENABLE_GPU_SUPPORT=true | sudo tee -a /etc/ecs/ecs.config
sudo systemctl enable --now ecs

方案3：刷新服务配置后重启 #

先刷新系统服务配置，再重启ECS服务，确保配置变更被识别：

#!/bin/bash

sudo amazon-linux-extras disable docker
sudo amazon-linux-extras install -y ecs
echo ECS_CLUSTER=ClusterName | sudo tee -a /etc/ecs/ecs.config
echo ECS_ENABLE_GPU_SUPPORT=true | sudo tee -a /etc/ecs/ecs.config
sudo systemctl enable --now ecs
sudo systemctl daemon-reload
sleep 5
sudo systemctl restart ecs

验证方法 #

1. 使用修改后的UserData启动EC2实例
2. 登录ECS集群控制台，检查实例是否自动加入
3. 若问题依旧，可登录实例查看ECS服务日志排查异常：sudo journalctl -u ecs.service

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