如何从Argo触发Jenkins Pipeline并保存其输出？

1. 配置Jenkins API访问权限 #

• 登录Jenkins，进入目标用户的「设置」页面，生成并保存新的API令牌（和用户名一起作为后续认证凭据）。
• 打开目标Jenkins Pipeline的配置页，确保开启远程触发支持：
  • 勾选「触发远程构建」（可选设置认证令牌，推荐用API令牌做基础认证）。
  • 若需传递参数，确保Pipeline已配置对应参数项。

2. 在Argo Workflow中实现触发逻辑 #

可以通过Argo的http模板直接触发Jenkins API，或用script模板调用curl处理任务状态轮询、输出捕获等复杂逻辑。

示例Workflow片段（触发+等待完成+捕获输出）

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: jenkins-trigger-workflow-
spec:
  entrypoint: main-flow
  templates:
    - name: main-flow
      steps:
        - - name: trigger-jenkins
            template: invoke-jenkins-api
        - - name: wait-for-completion
            template: poll-jenkins-status
            arguments:
              parameters:
                - name: job-url
                  value: "{{steps.trigger-jenkins.outputs.parameters.job-url}}"
        - - name: process-output
            template: use-jenkins-result
            arguments:
              parameters:
                - name: output-log
                  value: "{{steps.wait-for-completion.outputs.parameters.final-log}}"

    # 触发Jenkins Pipeline的HTTP模板
    - name: invoke-jenkins-api
      http:
        url: "http://jenkins-service:8080/job/YourPipelineName/buildWithParameters"
        method: POST
        auth:
          basic:
            username: "your-jenkins-username"
            password: "your-jenkins-api-token"
        headers:
          - name: Content-Type
            value: "application/x-www-form-urlencoded"
        # 传递参数给Jenkins（按需调整）
        body: "SOURCE_DATA_PATH=/data/input&PROCESS_TYPE=batch"
        successCondition: "response.statusCode == 201"
      outputs:
        parameters:
          - name: job-url
            valueFrom:
              jsonPath: "{.executable.url}"

    # 轮询Jenkins任务状态，直到完成并导出日志
    - name: poll-jenkins-status
      inputs:
        parameters:
          - name: job-url
      script:
        image: curlimages/curl:latest
        command: [sh]
        source: |
          #!/bin/sh
          JOB_URL="{{inputs.parameters.job-url}}"
          JENKINS_USER="your-jenkins-username"
          JENKINS_TOKEN="your-jenkins-api-token"
          LOG_FILE="/tmp/jenkins-output.log"

          while true; do
            # 获取任务当前状态
            STATUS=$(curl -s -u ${JENKINS_USER}:${JENKINS_TOKEN} ${JOB_URL}/api/json | grep -o '"result":"[^"]*"' | cut -d'"' -f4)
            if [ "$STATUS" != "null" ]; then
              # 下载完整任务日志
              curl -s -u ${JENKINS_USER}:${JENKINS_TOKEN} ${JOB_URL}/logText/progressiveText > ${LOG_FILE}
              echo "Jenkins任务最终状态: $STATUS" >> ${LOG_FILE}
              break
            fi
            sleep 30
          done
      outputs:
        parameters:
          - name: final-log
            valueFrom:
              path: /tmp/jenkins-output.log

    # 后续步骤使用Jenkins输出的示例
    - name: use-jenkins-result
      inputs:
        parameters:
          - name: output-log
      container:
        image: alpine:latest
        command: [sh, -c]
        args: ["echo 'Jenkins任务输出:' && cat <<EOF
{{inputs.parameters.output-log}}
EOF"]

3. 关键注意事项 #

• 网络连通性：确保Argo集群能访问Jenkins服务（同集群内用Service名称，外部需配置公开URL）。
• 权限最小化：Jenkins API令牌仅授予触发目标Pipeline、读取任务状态和日志的权限，避免过度授权。
• 超时控制：在Workflow的spec中添加activeDeadlineSeconds，防止Jenkins任务超时导致Argo流程挂起。
• 动态参数：可通过Argo的parameters动态替换Jenkins API请求中的参数值，适配不同场景。

内容的提问来源于stack exchange，提问作者László Marton