如何在GitLab Pipeline中为Shell脚本配置PATH环境变量？

问题场景 #

我有一个bash脚本plan.sh，在GitLab Pipeline执行过程中会被多次调用。原本使用完整路径执行脚本，为简化调用，尝试将脚本所在目录加入PATH环境变量，之后直接用文件名执行，但在before_script中执行chmod +x plan.sh时出现错误：chmod: cannot access 'plan.sh': No such file or directory。

原配置：

plan:
  before_script:
   - chmod +x ${CI_PROJECT_DIR}/gitlab/deploy/plan/plan.sh     
  script:    
    - cd ${FOLDER1}
    - ${CI_PROJECT_DIR}/gitlab/deploy/plan/plan.sh
    
    - cd ${FOLDER2}    
    - ${CI_PROJECT_DIR}/gitlab/deploy/plan/plan.sh

    - cd ${FOLDER3}
    - ${CI_PROJECT_DIR}/gitlab/deploy/plan/plan.sh

修改后的配置：

plan:
  before_script:
   - export PATH=${CI_PROJECT_DIR}/gitlab/deploy/plan:$PATH
   - chmod +x plan.sh     
  script:    
    - cd ${FOLDER1}
    - plan.sh
    
    - cd ${FOLDER2}    
    - plan.sh

    - cd ${FOLDER3}
    - plan.sh

问题原因 #

PATH环境变量的作用是让系统执行命令时，到指定目录查找可执行文件，但chmod是文件操作命令，它需要明确的文件路径（相对或绝对）。虽然你把脚本目录加入了PATH，但当前工作目录并非脚本所在目录，直接写plan.sh时，chmod会在当前工作目录下查找文件，因此找不到目标脚本。

解决方案 #

方案1：保留PATH设置，chmod用完整路径 #

这是最稳妥的方式，既保留PATH简化后续调用，又确保chmod能准确定位脚本：

plan:
  before_script:
   - export PATH=${CI_PROJECT_DIR}/gitlab/deploy/plan:$PATH
   - chmod +x ${CI_PROJECT_DIR}/gitlab/deploy/plan/plan.sh     
  script:    
    - cd ${FOLDER1}
    - plan.sh
    
    - cd ${FOLDER2}    
    - plan.sh

    - cd ${FOLDER3}
    - plan.sh

方案2：切换到脚本目录执行chmod #

先cd到脚本所在目录，完成权限修改后再设置PATH，可选回到项目根目录：

plan:
  before_script:
   - cd ${CI_PROJECT_DIR}/gitlab/deploy/plan
   - chmod +x plan.sh
   - export PATH=$(pwd):$PATH
   - cd ${CI_PROJECT_DIR}  # 回到项目根目录，不影响后续cd操作
  script:    
    - cd ${FOLDER1}
    - plan.sh
    
    - cd ${FOLDER2}    
    - plan.sh

    - cd ${FOLDER3}
    - plan.sh

方案3：用which配合chmod（不推荐） #

依赖PATH生效，通过which plan.sh获取脚本绝对路径后再执行chmod，若PATH配置错误会导致失败：

plan:
  before_script:
   - export PATH=${CI_PROJECT_DIR}/gitlab/deploy/plan:$PATH
   - chmod +x $(which plan.sh)     
  script:    
    - cd ${FOLDER1}
    - plan.sh
    
    - cd ${FOLDER2}    
    - plan.sh

    - cd ${FOLDER3}
    - plan.sh

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