tbede/gitlab-resource

Gitlab状态资源

用于更新GitLab提交的构建状态，助力CI/CD流程中构建进度的可视化跟踪。

源配置

• gitlab_url：必填。GitLab实例的URL地址。
• api_key：必填。GitLab的API密钥，所属用户需至少拥有开发者权限。
• group：必填。仓库所属的GitLab组名称。
• project：必填。仓库的项目名称。
• verify_ssl：可选。是否验证GitLab API端点的SSL证书，默认值为true。

参数

• build_status：必填。目标构建状态，可选值为pending、running、success、canceled、failed。
• repo：必填。已检出Git仓库的资产名称或输入路径。
• status_name：可选。状态名称标识，默认值为default。

使用场景

适用于CI/CD流水线中，在构建启动、成功、失败或取消时自动更新GitLab提交状态，让团队成员直观了解代码提交的构建结果。

配置示例

yaml
resource_types:
- name: gitlab-status
  type: docker-image
  source:
    repository: tbede/gitlab-resource
    tag: 0.1.0

resources:
- name: source
  type: git
  source:
    branch: master
    uri: [***]
    username: buildbot
    password: ((gitlabtoken))
- name: gitlab-status
  type: gitlab-status
  source:
    api_key: ((gitlabtoken))
    gitlab_url: [***]
    verify_ssl: false
    group: mygroup
    project: myrepo

jobs:
- name: build
  plan:
  - get: source
    trigger: true
  - put: gitlab-status
    params:
      build_status: running
      repo: source
  - put: ....
    # 此处放置构建任务逻辑
    on_success:
      put: gitlab-status
      params:
        build_status: success
        repo: source
    on_failure:
      put: gitlab-status
      params:
        build_status: failed
        repo: source
    on_abort:
      put: gitlab-status
      params:
        build_status: canceled
        repo: source