Amazon Linux EC2中Docker config.json缺失，配置ECR凭证助手遇阻求助

核心原因 #

Docker不会自动创建~/.docker目录，只有执行过需要读写该目录的Docker命令（比如docker login、docker pull）后，才会自动生成这个目录及默认的config.json。全新安装Docker且未执行过任何交互命令时，该目录不存在，直接写入文件就会报错。

解决步骤 #

1. 先创建.docker目录 #

在写入配置文件前，手动创建目录（-p参数确保嵌套目录不存在时也能正常创建）：

mkdir -p ~/.docker

2. 写入credHelpers配置 #

执行你的写入命令：

echo "{ \"credHelpers\": { \"acc_id.dkr.ecr.acc_region.amazonaws.com\": \"ecr-login\" } }" > ~/.docker/config.json

3. EC2 Userdata适配注意事项 #

如果将脚本作为EC2 Userdata执行：

• Userdata默认以root用户运行，~指向/root，和手动操作路径一致
• 可以将创建目录和写入配置合并为一条命令，避免分步执行的潜在问题：

  mkdir -p ~/.docker && echo "{ \"credHelpers\": { \"acc_id.dkr.ecr.acc_region.amazonaws.com\": \"ecr-login\" } }" > ~/.docker/config.json
  

• 确保Amazon ECR Credential Helper已正确安装（Amazon Linux上可通过amazon-linux-extras install docker后，安装amazon-ecr-credential-helper包）

4. 容器内调试的特殊处理 #

如果在容器内调试脚本：

• 容器内默认无~/.docker目录，同样需要先执行创建目录的步骤
• 若仅调试脚本逻辑，保证目录创建步骤存在即可；实际部署到EC2实例时，再确保Docker和credential helper依赖齐全

验证方法 #

执行完命令后，检查配置文件是否生成：

cat ~/.docker/config.json

输出正确的JSON内容则配置成功。之后可尝试拉取ECR镜像，验证credential helper是否生效：

docker pull acc_id.dkr.ecr.acc_region.amazonaws.com/your-image:tag

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