如何在Amazon Linux 2 Elastic Beanstalk中因钩子脚本命令失败终止部署

在基于Amazon Linux 2的Elastic Beanstalk环境中，我们可以通过.platform/hooks和.platform/confighooks目录放置脚本，实现部署或配置变更时自动运行代码。但默认情况下，钩子脚本内的命令执行失败不会终止整个部署流程——这会导致部署表面显示成功，实际代码却因依赖缺失等问题无法正常运行。

比如下面的钩子脚本，当npm install --production执行失败时，部署仍会完成，但项目会缺失必要的npm依赖包：

#!/bin/bash

npm install --production

other_command
other_command_2

要让钩子脚本中的命令失败时触发部署终止，可以用以下几种方法：

方法一：全局启用错误终止（set -e） #

在脚本开头添加set -e命令，它会让脚本在任何命令返回非零退出码时立即终止执行，同时让钩子脚本整体返回失败状态，触发Elastic Beanstalk终止部署。

修改后的脚本示例：

#!/bin/bash
set -e

npm install --production

other_command
other_command_2

一旦npm install --production执行失败，脚本会立刻停止，不再执行后续命令，Elastic Beanstalk会检测到钩子执行失败，进而终止整个部署流程。

方法二：针对特定命令做错误检查 #

如果不需要全局启用错误终止，可以对关键命令单独添加失败退出逻辑，用|| exit 1实现——当命令执行失败时，直接让脚本以非零码退出，触发部署终止。

示例：

#!/bin/bash

npm install --production || exit 1

other_command
other_command_2

这种方式更灵活，适合只需要对特定核心命令做失败校验的场景。

方法三：处理管道命令的错误（set -eo pipefail） #

如果脚本中包含管道命令（比如command1 | command2），默认情况下只有最后一个命令的退出码会被检测。添加set -eo pipefail可以让管道中任意一个命令失败时，整个管道返回失败状态，配合set -e能更全面地捕获错误。

示例：

#!/bin/bash
set -eo pipefail

npm install --production | grep "success"

other_command
other_command_2

注意事项 #

确保钩子脚本拥有可执行权限（比如通过chmod +x your-script.sh设置），否则Elastic Beanstalk无法执行脚本，也会引发部署异常。

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