adamkl/gitlab-merge-request-resource

GitLab合并请求Concourse资源镜像

镜像概述

本镜像作为Concourse CI/CD的资源类型，用于与GitLab集成，实现对合并请求（Merge Request）的自动化检查和状态更新，帮助团队在流水线中高效管理代码合并流程。

核心功能

1. check：检测GitLab仓库中是否有新的合并请求或已存在的合并请求有新提交。
2. in：克隆合并请求的源分支到本地。
3. out：更新合并请求的状态（如pending、running、success、failed等），在GitLab UI中直观展示。

使用场景

适用于Concourse CI/CD流水线中，当GitLab有新的合并请求时自动触发测试任务，并根据测试结果更新合并请求状态，确保只有通过测试的代码才能被合并。

配置说明

资源类型定义

yaml
resource_types:
- name: merge-request
  type: docker-image
  source:
    repository: mastertinner/gitlab-merge-request-resource

资源配置

yaml
resources:
- name: repo-mr
  type: merge-request
  source:
    uri: https://gitlab.com/myname/myproject.git
    private_token: XXX
    username: my_username
    password: xxx

配置参数说明

• uri：仓库地址（必填）。
• private_token：GitLab用户的私人令牌（必填，可在个人设置中获取）。
• private_key：SSH认证用的私钥（可选，用于拉取代码时的SSH授权），示例：

  yaml
  private_key: |
    -----BEGIN RSA PRIVATE KEY-----
    MIIEowIBAAKCAQEAtCS10/f7W7lkQaSgD/mVeaSOvSF9ql4hf/zfMwfVGgHWjj+W
    <更多文本>
    DWiJL+OFeg9kawcUL6hQ8JeXPhlImG6RTUffma9+iGQyyBMCGd1l
    -----END RSA PRIVATE KEY-----
  

• username：HTTP(S)认证的用户名（可选）。
• password：HTTP(S)认证的密码（可选）。
• no_ssl：是否使用HTTP而非HTTPS访问GitLab API（可选，设为true则禁用HTTPS）。
• skip_ssl_verification：是否跳过SSL验证（可选，默认false）。

注意：需提供private_key或username+password其中一种认证方式。

流水线示例

yaml
jobs:
- name: test-merge-request
  plan:
  - get: repo
    resource: repo-mr
    trigger: true
  - put: repo-mr
    params:
      repository: repo
      status: running
  - task: run-tests
    file: repo/ci/tasks/run-tests.yml
  on_failure:
    put: repo-mr
    params:
      repository: repo
      status: failed
  on_success:
    put: repo-mr
    params:
      repository: repo
      status: success