danrspencer/jira-resource

Jira工单资源

该镜像为Concourse CI/CD平台的Jira资源插件，用于在自动化流程中创建、更新Jira工单，实现工单管理与CI/CD pipeline的无缝集成。

核心功能

• 创建新Jira工单或更新已有工单
• 支持标准字段（描述、截止日期等）与自定义字段配置
• 执行工单状态流转（如提交、开发中）
• 添加观察者与评论记录
• 支持变量替换（$FILE、$NOW）生成动态内容

使用场景

• CI/CD流程中自动创建发布工单
• 构建失败时生成缺陷工单
• 版本更新时同步工单状态与描述
• 自动化添加观察者跟踪流程进展

配置说明

源配置（Source Configuration）

支持Atlassian Cloud Jira的API Token认证及旧版Jira Server的用户名密码认证：

yaml
resources:
  - name: jira
    type: jira-resource
    source:
      url: https://your-jira.atlassian.net
      email: your-email@example.com
      apitoken: your-api-token
      project: YOUR_PROJECT_KEY

旧版Jira Server配置：

yaml
resources:
  - name: jira
    type: jira-resource
    source:
      url: https://your-jira-server.com
      username: your-username
      password: your-password
      project: YOUR_PROJECT_KEY

资源类型配置

yaml
resource_types:
  - name: jira-resource
    type: docker-image
    source:
      repository: danrspencer/jira-resource
      tag: latest

参数说明

• issue_key: 目标工单ID（更新已有工单时使用）
• summary: 工单标题（创建工单必填）
• issue_type: 工单类型（如Bug、Change）
• fields: 标准字段配置（description、duedate等）
• custom_fields: 自定义字段配置（支持文本、下拉列表等类型）
• transitions: 状态流转步骤（按顺序执行）
• watchers: 观察者用户名列表
• comments: 评论内容（支持文件导入与文本替换）

示例

快速更新工单

yaml
- name: update-jira
  plan:
    - put: jira
      params:
        issue_type: Change
        issue_key: BUILD-11
        summary: Build v1.0.1
        fields:
          description: 版本v1.0.1构建完成

完整发布工单示例

yaml
jobs:
  - name: create-release-ticket
    plan:
      - get: code-base
        trigger: true
      - get: version
      - task: generate-release-notes
        config:
          platform: linux
          image_resource:
            type: docker-image
            source: { repository: travix/base-alpine-git }
          inputs: [name: code-base, name: version]
          outputs: [name: messages]
          run: path: code-base/ci/scripts/write-release-notes
      - put: jira
        params:
          issue_type: Change
          summary:
            text: Build v$FILE
            file: version/version
          fields:
            description:
              text: |
                常规发布
                
                $FILE
                
                _由Concourse自动生成_
              file: messages/jira-release-notes
            environment: 生产环境
            duedate: $NOW+1h
          custom_fields:
            awesome_level:
              id: ***
              value: 非常棒
          transitions: [Submit]
          watchers: [dave, amier]
          comments:
            - content: 发布工单已创建