GitLab CI流水线中Jinja2命令未找到问题求助

核心问题分析 #

• GitLab CI的每个Job运行在独立隔离容器中，prepare阶段克隆的jinja2docker目录会在Job结束后被自动清理（日志中已显示Removing jinja2docker/），导致process阶段无法访问该工具。
• 即使目录未被清理，克隆后也未将jinja2命令添加到系统环境变量PATH中，系统无法识别该命令。

解决方案1：直接安装Jinja2命令行工具（最简方案） #

直接在process阶段安装官方维护的jinja2-cli，无需依赖第三方仓库克隆。基于你使用的Alpine镜像，可通过以下方式安装：

修改后的完整.gitlab-ci.yml配置：

variables:
  TEMPLATE_FILE: email_template.html
  VARIABLES_FILE: recipient_data.yml
  OUTPUT_FILE: output.txt

process:
  stage: process
  script:
    - echo "Installing Jinja2 CLI..."
    # 若镜像自带pip，使用此命令安装
    - pip install jinja2-cli
    # 若Alpine镜像未预装pip，可改用apk安装
    # - apk add --no-cache py3-jinja2-cli
    - echo "Processing template and variables using Jinja2..."
    - jinja2 $TEMPLATE_FILE $VARIABLES_FILE -o $OUTPUT_FILE
    - echo "Processing complete!"
    # 将生成文件推送到Git仓库
    - git config --global user.name "GitLab CI/CD"
    - git config --global user.email "ci@example.com"
    - git add $OUTPUT_FILE
    - git commit -m "CI: Add generated output file"
    - git push origin $CI_COMMIT_BRANCH
  # 保存生成文件为制品
  artifacts:
    paths:
      - $OUTPUT_FILE
    expire_in: 1 week

解决方案2：使用jinja2docker预构建镜像 #

直接使用封装好的jinja2docker镜像，避免手动安装依赖：

variables:
  TEMPLATE_FILE: email_template.html
  VARIABLES_FILE: recipient_data.yml
  OUTPUT_FILE: output.txt

process:
  stage: process
  image: dinuta/jinja2docker:latest
  script:
    - echo "Processing template and variables using Jinja2..."
    - jinja2 $TEMPLATE_FILE $VARIABLES_FILE -o $OUTPUT_FILE
    - echo "Processing complete!"
    # 镜像默认无git，需先安装才能推送
    - apk add --no-cache git
    - git config --global user.name "GitLab CI/CD"
    - git config --global user.email "ci@example.com"
    - git add $OUTPUT_FILE
    - git commit -m "CI: Add generated output file"
    - git push origin $CI_COMMIT_BRANCH
  artifacts:
    paths:
      - $OUTPUT_FILE
    expire_in: 1 week

解决方案3：复用prepare阶段文件（不推荐，流程繁琐） #

若必须使用克隆的jinja2docker，需通过artifacts将prepare阶段的目录传递给process阶段，并调整命令执行路径：

variables:
  TEMPLATE_FILE: email_template.html
  VARIABLES_FILE: recipient_data.yml
  OUTPUT_FILE: output.txt

prepare:
  stage: prepare
  script:
    - echo "Preparing files for processing..."
    - git clone https://github.com/dinuta/jinja2docker.git
    - echo "Jinja2 repository cloned and ready for use."
  artifacts:
    paths:
      - jinja2docker/
    expire_in: 1 hour

process:
  stage: process
  script:
    - echo "Processing template and variables using Jinja2..."
    # 进入克隆目录执行脚本
    - cd jinja2docker
    - python jinja2cli.py ../$TEMPLATE_FILE ../$VARIABLES_FILE -o ../$OUTPUT_FILE
    - cd ..
    - echo "Processing complete!"
    # 推送生成文件到Git
    - git config --global user.name "GitLab CI/CD"
    - git config --global user.email "ci@example.com"
    - git add $OUTPUT_FILE
    - git commit -m "CI: Add generated output file"
    - git push origin $CI_COMMIT_BRANCH
  artifacts:
    paths:
      - $OUTPUT_FILE
    expire_in: 1 week

额外注意事项 #

• Git推送需确保CI/CD用户拥有仓库写入权限，建议在项目设置中配置SSH_PRIVATE_KEY变量实现免密推送。
• 制品保存通过artifacts配置实现，可根据需求调整expire_in过期时间。

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