ksinkar/artifactory-resource

Artifactory资源镜像

镜像概述

本镜像为Concourse流水线提供JFrog Artifactory资源支持，可在流水线中部署（上传）和检索（下载）JFrog Artifactory服务器上的工件，帮助实现自动化的工件管理流程。

核心功能

• 定义Concourse流水线中的Artifactory资源类型
• 上传工件到Artifactory服务器
• 从Artifactory服务器检索指定版本的工件
• 支持正则表达式提取工件版本
• 灵活配置认证信息、SSL验证等参数

使用场景

1. 构建任务完成后，将生成的工件上传到Artifactory存储
2. 当Artifactory中有新工件发布时，触发流水线的后续任务（如部署、测试）

配置说明

资源类型定义

在Concourse流水线中定义Artifactory资源类型：

yaml
resource_types:
- name: artifactory
  type: docker-image
  source:
    repository: pivotalservices/artifactory-resource

资源配置（Source Configuration）

定义具体的Artifactory资源实例：

yaml
resources:
- name: file-repository
  type: artifactory
  source:
    endpoint: http://ARTIFACTORY-HOST-NAME:8081/artifactory  # 必选，Artifactory API端点
    repository: "/repository-name/sub-folder"  # 必选，包含路径的仓库（以/开头）
    regex: "myapp-(?<version>.*).txt"  # 必选，提取版本的正则表达式（含version分组）
    username: YOUR-ARTIFACTORY-USERNAME  # 可选，认证用户名
    password: YOUR-ARTIFACTORY-PASSWORD  # 可选，认证密码
    skip_ssl_verification: true  # 可选，是否跳过SSL验证（默认false）

参数配置（Parameter Configuration）

• file：put操作必选，需上传的工件路径
• regex：可选，覆盖资源定义中的regex
• folder：可选，追加到仓库路径的子文件夹（以/开头）
• skip_download：可选，跳过下载步骤（用于优化put性能）

流水线使用示例

上传工件到Artifactory

yaml
jobs:
- name: build-and-save-to-artifactory
  plan:
  - task: build-a-file
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: { repository: ubuntu }
      outputs: [name: build]
      run:
        path: sh
        args:
        - -exc
        - |
          DATESTRING=$(date +"%Y%m%d%H%S")
          echo "测试工件内容" > ./build/myapp-${DATESTRING}.txt
  - put: file-repository
    params: { file: ./build/myapp-*.txt }

从Artifactory检索工件

yaml
jobs:
- name: trigger-on-new-artifact
  plan:
  - get: file-repository
    trigger: true  # 当Artifactory有新工件时触发
  - task: use-artifact
    config:
      platform: linux
      image_resource: { repository: ubuntu }
      inputs: [name: file-repository]
      run:
        path: echo
        args: ["使用./file-repository中的工件"]

资源行为

• check：通过正则表达式检索Artifactory中的工件版本
• in：根据指定版本从Artifactory下载工件
• out：将指定工件上传到Artifactory仓库

开发指南

构建镜像

在项目根目录执行：

bash
docker build -t username/artifactory-resource .

运行测试

• 单元测试：需安装https://github.com/bats-core/bats-core%EF%BC%8C%E6%89%A7%E8%A1%8C%E5%8D%95%E5%85%83%E6%B5%8B%E8%AF%95%EF%BC%9A

  bash
  bats test/common.bats
  

• 集成测试：需先启动Artifactory容器（端口8081），再运行测试脚本：

  bash
  # 启动Artifactory
  docker run --name artifactory -d -p 8081:8081 docker.bintray.io/jfrog/artifactory-oss:latest
  
  # 运行集成测试
  docker run -it \
    --env ART_IP=127.0.0.1 \
    --env ART_USER=admin \
    --env ART_PWD=admin \
    username/artifactory-resource:latest \
    /opt/resource-tests/test-check.sh
  

Credits

本资源基于https://github.com/mborges-pivotal/artifactory-resource%E7%9A%84Artifactory%E8%B5%84%E6%BA%90%E5%B7%A5%E4%BD%9C%E5%BC%80%E5%8F%91%E3%80%82