通过Docker部署AWS CDK时遭遇bash: cdk: command not found错误

问题描述 #

通过Dockerfile.infra构建镜像，执行docker-compose --file docker-compose-infra.yml build无任何报错，但运行docker-compose --file docker-compose-infra.yml run cdk执行cdk deploy时，触发bash: cdk: command not found错误。Dockerfile构建阶段已执行npm install -g aws-cdk-lib全局安装CDK相关包。

可能原因及排查方案 #

1. 安装的包并非CDK CLI工具 #

aws-cdk-lib是CDK的核心开发库，用于编写CDK栈代码，但提供cdk命令行工具的包是aws-cdk。如果只安装了aws-cdk-lib，容器里根本不会有cdk可执行文件，自然会提示找不到命令。

验证方式：在Dockerfile中添加npm list -g命令，构建后运行容器查看全局安装的包列表，确认是否有aws-cdk。

2. npm全局可执行文件路径未加入系统PATH #

即使正确安装了aws-cdk，如果其所在的全局bin目录不在容器的PATH环境变量中，bash也无法找到cdk命令。npm全局安装的可执行文件默认路径通常是/usr/local/bin，但如果修改过npm的prefix配置，路径会变化。

验证方式：在Dockerfile中添加echo $PATH和which cdk命令，构建后运行容器查看输出，确认PATH是否包含cdk所在的目录。

3. 容器运行用户与安装用户不一致 #

如果Dockerfile中用USER指令切换了运行用户，而CDK是用root用户安装的，且全局bin目录权限限制了普通用户访问，或者普通用户的PATH未包含该目录，也会导致找不到命令。

验证方式：在容器中切换到运行用户，手动执行which cdk查看是否能找到命令。

解决方法 #

• 修正安装命令：将Dockerfile中的npm install -g aws-cdk-lib替换为npm install -g aws-cdk（如果需要同时使用开发库，可以保留aws-cdk-lib的安装，额外加上aws-cdk）
• 确保PATH包含全局bin目录：在Dockerfile中添加ENV PATH="/usr/local/bin:${PATH}"（根据实际npm全局路径调整）
• 统一用户上下文：如果使用自定义用户，要么在该用户下执行npm install -g，要么确保该用户能访问全局bin目录的可执行文件

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