ziporah/concourse-jenkins-resource

Jenkins资源镜像

该镜像为Concourse CI提供Jenkins资源类型，用于触发和监控Jenkins构建任务，是Concourse与Jenkins工作流集成的关键组件。

安装

在Concourse CI pipeline中添加Jenkins资源类型：

yaml
resource_types:
- name: jenkins
  type: docker-image
  source:
    repository: novas0x2a/concourse-jenkins-resource
    tag: latest # 建议使用特定标签确保构建可复现，避免依赖"latest"

源配置

• host: 必选。Jenkins服务器主机名。
• user: 必选。Jenkins登录用户名。
• pass: 必选。Jenkins登录密码。
• job: 必选。Jenkins任务路径（可通过任务页面URL获取，需包含"Build Now"或"Build with Parameters"链接，示例：/job/subdir/job/my-cool-job）。
• protocol: 可选。默认https，若Jenkins使用http需指定。
• port: 可选。Jenkins非标准运行端口（默认端口无需填写）。

核心功能

check: 检测新构建

资源版本ID与Jenkins构建ID保持一致，用于发现最新构建。

out: 触发构建

启动Jenkins任务并等待分配构建ID（不等待任务完成，可通过get步骤的requireResult参数等待结果）。
参数:

• buildParams: 字符串类型，使用buildWithParameters触发参数化构建，示例：buildType=full&bestAnimal=cat。

in: 获取构建结果

获取指定构建的状态信息，目标目录生成以下文件：

• /raw: Jenkins原始JSON API数据
• /result: 构建结果字符串
• /url: 构建完整URL
• /start_time_ms: 构建开始时间（毫秒级Unix时间）
• /start_time_s: 构建开始时间（秒级Unix时间）
  参数:
• requireResult: 字符串类型，阻塞直到任务完成，仅当构建结果匹配时get步骤成功（如requireResult: SUCCESS）。

使用场景

• 非阻塞式触发Jenkins构建
• 阻塞式等待Jenkins构建成功后继续流程
• 触发带参数的Jenkins构建任务

完整示例

yaml
resource_types:
- name: jenkins
  type: docker-image
  source:
    repository: novas0x2a/concourse-jenkins-resource
    tag: 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

构建镜像

bash
$ docker login harbor-docker-registry-dev.gp2.axadmin.net -u <<DOCKER_USER>> -p <<DOCKER_PASSWORD>>
$ docker build -t concourse-jenkins-resource .
$ docker tag concourse-jenkins-resource harbor-docker-registry-dev.gp2.axadmin.net/identifix_cms/concourse-jenkins-resource:v0.9
$ docker push harbor-docker-registry-dev.gp2.axadmin.net/identifix_cms/concourse-jenkins-resource:v0.9