创建Jenkins流水线时出现错误码127，pg_dump未找到求助

错误码127的核心原因是Jenkins执行脚本的环境里找不到pg_dump命令，以下是几种直接的解决方式：

1. 在Jenkins节点安装PostgreSQL客户端工具 #

• 如果Jenkins直接运行在物理/虚拟机服务器上，登录该服务器安装对应系统的PostgreSQL客户端包：
  • Debian/Ubuntu系统：

    sudo apt update && sudo apt install postgresql-client -y
    

  • RHEL/CentOS/Rocky系统：

    sudo dnf install postgresql -y
    

  安装完成后，pg_dump会被放入系统默认PATH路径（如/usr/bin/pg_dump），Jenkins即可正常调用。

2. 在脚本中指定pg_dump的绝对路径 #

若pg_dump已存在但不在Jenkins的环境PATH中，直接使用绝对路径执行命令：
先通过which pg_dump找到命令的实际路径，再修改流水线脚本：

/path/to/your/pg_dump -h 10.12.0.4 -U pet--rsmb--prod-l1--usr -w -c -f 2022-08-10t1228z-data.sql

例如路径为/usr/local/pgsql/bin/pg_dump，就替换成该绝对路径。

3. 配置Jenkins全局环境变量PATH #

• 进入Jenkins管理界面，依次选择「系统管理」→「系统配置」→「全局属性」
• 勾选「环境变量」，添加键为PATH，值为原系统PATH加上pg_dump所在目录（如$PATH:/usr/local/pgsql/bin）
• 保存配置后重新运行流水线即可。

4. 容器化Jenkins的处理方案 #

如果Jenkins通过容器部署，需要修改Jenkins镜像的Dockerfile，加入安装PostgreSQL客户端的步骤：

FROM jenkins/jenkins:lts
USER root
RUN apt update && apt install postgresql-client -y
USER jenkins

重新构建镜像并启动Jenkins容器即可解决问题。

补充说明：shell环境中错误码127就是「命令未找到」的标准返回值，本质是执行环境的PATH中不存在对应命令的可执行文件，从「让命令被环境找到」的方向入手即可解决。

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