novas0x2a/concourse-jenkins-resource

Jenkins资源镜像

镜像概述

这是一个Concourse CI的资源镜像，用于触发Jenkins构建并监控其状态，支持参数化构建和结果验证，帮助实现Concourse与Jenkins的CI/CD工作流集成。

核心功能

• 触发Jenkins作业构建（支持参数化构建）
• 监控Jenkins构建状态变化
• 获取构建结果详情（包括状态、URL、开始时间等）
• 验证构建结果是否符合预期（如要求SUCCESS状态）

使用场景

• 在Concourse流水线中触发Jenkins作业时
• 需要在Concourse中等待Jenkins作业完成并验证结果时
• 传递参数给Jenkins作业进行定制化构建时

配置说明

安装

在Concourse CI流水线中添加该资源类型：

yaml
resource_types:
- name: jenkins
  type: docker-image
  source:
    repository: novas0x2a/concourse-jenkins-resource
    tag: latest # 为确保构建可重现，建议使用特定版本标签而非依赖"latest"

源配置（Source Configuration）

• host：必填，Jenkins服务的主机名
• user：必填，Jenkins登录用户名
• pass：必填，Jenkins登录密码
• job：必填，Jenkins作业的路径（可通过浏览Jenkins作业页面复制URL获取，格式示例：/job/subdir/job/otherdir/job/my-cool-job）

行为说明

check：检查新构建

资源版本ID与Jenkins构建ID保持一致，用于检测是否有新的构建产生。

out：触发构建

启动Jenkins作业，并等待Jenkins分配作业ID（不等待作业完成，可通过get_params的requireResult在get步骤中等待结果）。

参数

• buildParams：字符串类型，若设置则使用buildWithParameters触发构建，并将该字符串作为POST数据传递（示例：buildType=full&bestAnimal=cat）

in：获取构建结果

获取特定Jenkins作业构建的状态信息，目标目录会生成以下文件：

• /raw：Jenkins返回的原始JSON API数据
• /result：Jenkins报告的构建结果字符串
• /url：构建的完整URL
• /start_time_ms：构建开始时间（Unix时间，毫秒）
• /start_time_s：构建开始时间（Unix时间，秒）

参数

• requireResult：字符串类型，若设置则阻塞直到作业完成，且Concourse的get步骤成功与否取决于Jenkins构建结果（区分大小写，示例：requireResult: SUCCESS表示仅当构建结果为SUCCESS时get步骤成功）

完整示例

yaml
resource_types:
- name: jenkins
  type: docker-image
  source:
    repository: novas0x2a/concourse-jenkins-resource
    tag: latest # 为确保构建可重现，建议使用特定版本标签而非依赖"latest"

resources:
- name: my-cool-job
  type: jenkins
  source:
    host: jenkins.company.com
    job: /job/my-group/job/my-cool-job
    user: ((jenkins.user))
    pass: ((jenkins.pass))

jobs:
- name: build-nonblocking
  plan:
  - put: my-cool-job

- name: build-blocking
  plan:
  - put: my-cool-job
    get_params:
      requireResult: SUCCESS

- name: build-with-params
  plan:
  - put: my-cool-job
    params:
      buildParams: buildType=full&bestAnimal=cat