springio/artifactory-resource

Artifactory Resource 镜像文档

镜像概述

Artifactory Resource是一个Concourse资源类型镜像，专门用于在Concourse CI/CD管道中与JFrog Artifactory制品仓库进行集成。通过该资源，用户可以在Concourse管道中实现对Artifactory仓库中制品的版本检测、下载（in操作）和上传（out操作），简化CI/CD流程中制品管理环节。

核心功能与特性

• 版本检测（check操作）：自动检测Artifactory仓库中指定路径下的制品版本变化，支持按版本号排序
• 制品下载（in操作）：从Artifactory下载指定版本的制品到Concourse任务容器中
• 制品上传（out操作）：将Concourse任务生成的制品上传到Artifactory指定仓库路径
• 灵活配置：支持通过配置参数自定义Artifactory连接信息、仓库类型、制品路径等

支持的标签

• 按版本发布进行标记（例如：v1.0.0、v2.1.3等），对应仓库中的Release版本
• 每个标签的Dockerfile可参考：https://github.com/spring-io/artifactory-resource/blob/master/Dockerfile

使用场景

• CI流程中：从Artifactory下载依赖制品（如库文件、配置包等）供构建任务使用
• CD流程中：将构建生成的制品（如应用包、镜像等）上传到Artifactory进行版本化存储
• 版本控制：通过自动检测制品版本变化触发后续管道任务（如部署、测试等）

使用方法与配置说明

1. 在Concourse管道中定义资源类型

首先需要在管道配置中声明该资源类型：

yaml
resource_types:
- name: artifactory-resource
  type: docker-image
  source:
    repository: springio/artifactory-resource
    tag: <指定版本标签>  # 例如 v0.14.0

2. 配置资源实例

在管道中定义具体的Artifactory资源实例，需指定Artifactory连接信息和制品路径：

yaml
resources:
- name: my-artifactory-artifact
  type: artifactory-resource
  source:
    url: https://artifactory.example.com  # Artifactory服务URL
    username: admin  # Artifactory用户名（需有对应仓库操作权限）
    password: secret  # Artifactory密码或API密钥
    repository: my-repo  # Artifactory仓库名称
    repo_type: generic  # 仓库类型，支持generic、maven、npm等
    path: path/to/artifacts  # 制品在仓库中的路径
    # 可选：版本过滤，如正则表达式匹配版本号
    version_regexp: "v(\\d+\\.\\d+\\.\\d+)"

3. 管道任务中使用资源

下载制品（in操作）

在任务中通过get步骤下载制品：

yaml
jobs:
- name: use-artifact
  plan:
  - get: my-artifactory-artifact
    trigger: true  # 当制品版本更新时自动触发任务
  - task: process-artifact
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine}
      inputs:
      - name: my-artifactory-artifact  # 下载的制品会存放在此目录
      run:
        path: sh
        args:
        - -c
        - |
          ls -l my-artifactory-artifact/  # 查看下载的制品

上传制品（out操作）

在任务中通过put步骤上传制品：

yaml
jobs:
- name: build-and-upload
  plan:
  - task: build-artifact
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine}
      outputs:
      - name: build-output  # 任务生成的制品存放目录
      run:
        path: sh
        args:
        - -c
        - |
          echo "test artifact" > build-output/my-artifact-v1.0.0.txt
  - put: my-artifactory-artifact
    params:
      file: build-output/my-artifact-*.txt  # 指定要上传的制品文件路径
      # 可选：自定义上传后的制品名称
      # target: custom-name.txt

配置参数说明

Source配置参数

Out操作参数