shreddedbacon/git-release-tags

Git Release Tags资源

镜像概述

这是一个Concourse资源，用于从GitHub标签获取发布版本，仅支持符合语义化版本（semver）的标签。适用于您未管理且仅打版本标签而非创建GitHub Release的仓库（例如nginx/nginx仓库的release-1.12.0类标签）。

核心功能

• 检查GitHub仓库标签中的语义化版本发布
• 下载对应版本的源码包
• 支持通过标签前缀、版本家族等条件过滤目标版本
• 可配置GitHub API调用参数（如每页结果数、最大页数）

使用场景

• 监控第三方开源仓库（如nginx）的版本标签更新
• 自动获取指定版本家族的源码包用于后续构建或部署流程

配置说明

资源类型定义

yaml
resource_types:
- name: git-release-tags
  type: docker-image
  source:
    repository: shreddedbacon/git-release-tags

资源配置

yaml
resources:
- name: nginx
  type: git-release-tags
  source:
    repo: nginx
    owner: nginx
    token: <GitHub API令牌>
    tag_prefix: release-
    per_page: 100
    version_family: 1.12

参数说明：

• repo：GitHub仓库名称
• owner：GitHub仓库所有者名称
• token：GitHub API令牌（用于访问私有仓库或提高API速率限制）
• tag_prefix：版本标签的前缀（如nginx使用release-）
• per_page：GitHub API调用每页返回的结果数，默认20
• version_family：指定要监控的版本家族（如仅关注1.12系列版本）
• get_assets：设为True时仅获取带有发布资产的标签
• get_source_tar：设为False时不下载源码包
• page_max：若第一页无结果，循环查询的最大页数

行为说明

check：检查版本标签

检查是否有新的版本标签。可通过fly -t <target> check-resource -r <pipeline>/<resource_name> --from version:<version>查询特定版本。

in：下载版本

在目标目录生成以下文件：

• source.tar.gz：版本对应的源码包
• url：包含文件URL的文件
• version：资源版本信息

out：未实现

无操作

示例

yaml
jobs:
- name: get-nginx-source
  plan:
  - get: nginx
    trigger: true