meteogroup/concourse-version-resource

Concourse 版本资源

概述

该Docker镜像实现了一个Concourse资源，用于基于时间的版本控制。版本字符串采用ISO 8601扩展格式的日期时间，其中冒号（:）转换为减号（-），时区为UTC，并相应地以"Z"为后缀。

核心功能

in 操作

资源目录将生成以下文件：

• version：包含版本字符串
• timestamp：包含ISO 8601日期时间字符串
• properties.sh：设置VERSION和TIMESTAMP shell变量
• properties.json：包含JSON对象，其中设置了version和timestamp属性

out 操作

始终返回新的版本响应，可用于重置管道中的版本。

check 操作

返回与out操作相同的输出数组，除非检查的版本字符串是当前时间或未来时间，则返回空数组。

使用场景

适用于需要基于时间自动生成版本号的Concourse管道，例如：

• 定期触发的构建或部署流程
• 需要按时间戳标记版本的应用发布
• 重置管道中版本序列的场景

使用方法

资源类型定义

在Concourse管道中定义资源类型：

yaml
resource_types:
- name: version-resource
  type: docker-image
  source:
    repository: <镜像仓库地址>  # 替换为实际镜像仓库地址

资源配置

配置资源使用该资源类型：

yaml
resources:
- name: time-based-version
  type: version-resource
  source: {}  # 该资源无需额外配置参数

在任务中使用

在作业中使用该资源获取版本信息：

yaml
jobs:
- name: get-version
  plan:
  - get: time-based-version
    trigger: true  # 可配置为定时触发
  - task: use-version
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine}
      inputs:
      - name: time-based-version
      run:
        path: sh
        args:
        - -c
        - |
          source time-based-version/properties.sh
          echo "当前版本: $VERSION"
          echo "当前时间戳: $TIMESTAMP"