如何在GitLab失败流水线邮件中添加实际错误信息？

GitLab默认的Pipelines emails集成仅提供基础的失败通知，不会包含流水线的具体错误输出，要实现邮件中附带最后N行失败日志的需求，需要通过自定义CI/CD作业来完成，以下是具体实现步骤：

实现思路 #

通过GitLab API获取失败作业的日志输出，截取最后指定行数（比如25行），然后将这些内容和流水线基本信息一起通过邮件发送，跳过原生通知的局限。

具体配置步骤 #

1. 创建API访问令牌
   在GitLab个人设置或项目设置中生成一个具有read_api权限的访问令牌，然后添加到项目的Settings --> CI/CD --> Variables中，命名为GITLAB_API_TOKEN（勾选"保护变量"和"掩码变量"以确保安全）。

2. 在.gitlab-ci.yml中添加自定义通知作业
   添加一个仅在流水线失败时触发的作业，示例配置如下：

send-failure-notification:
  stage: .post  # 确保该作业在所有其他作业完成后执行
  script:
    - |
      # 安装依赖（如果runner环境未预装）
      # apt-get update && apt-get install -y curl jq mailutils
      
      # 获取第一个失败作业的ID
      FAILED_JOB_ID=$(curl --silent --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/pipelines/$CI_PIPELINE_ID/jobs" | jq '.[] | select(.status == "failed") | .id' | head -n 1)
      
      # 获取该作业的最后25行日志
      JOB_OUTPUT=$(curl --silent --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/jobs/$FAILED_JOB_ID/trace" | tail -n 25)
      
      # 构造邮件内容
      SUBJECT="流水线失败: $CI_PROJECT_NAME - #$CI_PIPELINE_ID"
      BODY="流水线链接: $CI_PIPELINE_URL\n\n失败作业最后25行输出:\n$JOB_OUTPUT"
      
      # 发送邮件（根据runner环境调整邮件命令，这里用mail命令）
      echo -e "$BODY" | mail -s "$SUBJECT" your-notification-email@example.com
  rules:
    - if: '$CI_PIPELINE_STATUS == "failed"'
  needs: []  # 不依赖任何前置作业，确保即使其他作业失败也能执行

注意事项 #

• 如果runner环境没有预装curl、jq或邮件客户端，需要在script中添加安装命令（如示例中的注释部分）。
• 若流水线中有多个失败作业，上述脚本仅获取第一个失败作业的日志，可调整jq和head的逻辑来获取所有失败作业的输出。
• 邮件接收地址可根据需求设置为个人邮箱、团队邮箱，甚至可以通过变量动态配置。
• 该方案适用于所有技术栈项目（包括你的Java+Maven项目），不依赖具体语言或构建工具。

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