troykinsella/concourse-artifactory-resource

concourse-artifactory-resource

镜像概述

concourse-artifactory-resource是Concourse CI的资源工具，用于将通用工件发布到Artifactory，支持三种版本策略（none、multi-file、single-file），满足不同场景下的工件发布与版本管理需求。

核心功能

支持三种版本策略：

• none：不处理版本，check和in操作无实际动作，仅用于简单发布文件（不适合下游任务触发）。
• multi-file：通过文件匹配和版本正则从文件名提取版本，适用于不覆盖旧文件且文件名含版本的场景。
• single-file：将单个文件的sha256值作为版本，适用于单文件覆盖发布的场景。

配置说明

源配置（Source Configuration）

通用属性

• url：必填，Artifactory实例的访问URL，例如https://tools.example.com/artifactory。
• repository：必填，Artifactory中的通用仓库名称，例如generic-local。
• api_key：必填，用于发布工件的API密钥。
• version_strategy：可选，版本策略，默认值为none。

各版本策略专属属性

• none：
  • path：可选，仓库下的目录路径，用于发布文件。
• multi-file：
  • file_pattern：可选，默认.*，用于过滤仓库目录中的文件的正则表达式。
  • path：可选，仓库下的目录路径，用于查找工件文件。
  • version_pattern：必填，从文件名提取版本的正则表达式，例如[0-9]+[.][0-9]+[.][0-9]+。
• single-file：
  • path：必填，仓库下单个文件的路径。

行为说明（Behaviour）

check操作

• none：无操作。
• multi-file：列出仓库目录中的文件，通过file_pattern过滤并提取版本。
• single-file：检查文件的sha256值作为版本。

in操作

• none：无操作。
• multi-file：下载对应版本的工件文件。
• single-file：下载最新工件文件并验证sha256值。

参数

• skip_download：可选，默认false，设置为true时不下载工件文件（none策略下无效）。

out操作：发布工件到Artifactory

• none：发布files目录中匹配glob的文件到指定路径。
• multi-file：发布匹配glob的文件，版本从文件名提取。
• single-file：发布指定路径的单个文件。

参数

• files：必填，包含待发布文件的目录路径。
• none/multi-file：
  • glob：可选，默认*，匹配待发布文件的 glob 表达式。

使用场景

• 简单发布工件到Artifactory（none策略）。
• 发布含版本号的多文件且不覆盖旧文件（multi-file策略）。
• 发布单文件并通过sha256值跟踪版本（single-file策略）。

部署示例

资源类型定义

yaml
resource_types:
- name: generic-artifact
  type: docker-image
  source:
    repository: troykinsella/concourse-artifactory-resource
    tag: latest

版本策略：none

yaml
resources:
- name: artifact
  type: generic-artifact
  source:
    url: https://tools.example.com/artifactory
    repository: generic-local
    api_key: asdf
    path: project-A

jobs:
- name: publish-source
  plan:
  - get: master # git资源
    trigger: true
  - task: 归档源码
    file: tasks/archive-source.yml
    input_mapping:
      source: master
    output_mapping:
      archive: files-to-publish
  - put: artifact
    params:
      files: files-to-publish
      glob: "*.tar.gz"

版本策略：multi-file

yaml
resources:
- name: artifact
  type: generic-artifact
  source:
    version_strategy: multi-file
    url: https://tools.example.com/artifactory
    repository: generic-local
    api_key: asdf
    path: path/to/dir
    file_pattern: 'foo-.*'
    version_pattern: '[0-9]+[.][0-9]+[.][0-9]+'

jobs:
- name: publish-source
  plan:
  - in_parallel:
    - get: master # git资源
      trigger: true
    - get: version # 版本资源
  - task: 归档源码 # 生成名为foo-1.2.3.tar.gz的文件
    file: tasks/archive-source.yml
    input_mapping:
      source: master
      version: version
    output_mapping:
      archive: file-to-publish
  - put: artifact
    params:
      files: files-to-publish
      glob: "*.tar.gz"

版本策略：single-file

yaml
resources:
- name: artifact
  type: generic-artifact
  source:
    version_strategy: single-file
    url: https://tools.example.com/artifactory
    repository: generic-local
    api_key: asdf
    path: path/to/file.tar.gz

jobs:
- name: 验证归档文件
  plan:
  - get: artifact
    trigger: true
  - task: 验证归档
    file: tasks/verify-archive.yml
    input_mapping:
      files: artifact
    params:
      FILE: file.tar.gz

许可证

MIT © Troy Kinsella