pivotalservices/artifactory-resource

Artifactory资源镜像

镜像概述

本镜像为Concourse流水线提供Artifactory资源类型，用于与JFrog Artifactory服务器交互，实现工件的部署（上传）和检索（下载），是CI/CD流程自动化的关键组件。

核心功能

• 支持向Artifactory仓库部署工件（put操作）
• 支持从Artifactory仓库检索指定版本的工件（get操作）
• 通过正则表达式提取工件版本信息
• 支持HTTP(S)认证访问受保护的仓库
• 可选跳过SSL验证（适用于测试环境）

使用场景

1. CI流水线：构建完成后将产物（如二进制文件、配置包）上传至Artifactory
2. CD流水线：从Artifactory获取指定版本的工件进行部署
3. 触发任务：当Artifactory新增工件时自动触发流水线

配置说明

源配置（Source Configuration）

• endpoint：必填。Artifactory REST API端点，示例：http://YOUR-HOST_NAME:8081/artifactory
• repository：必填。仓库路径（含前导斜杠），示例：/generic/product/pcf
• regex：必填。提取版本的正则表达式（需含version分组），示例：myapp-(?<version>.*).tar.gz
• username：可选。访问认证仓库的用户名
• password：可选。访问认证仓库的密码
• skip_ssl_verification：可选。是否跳过SSL验证（true/false，默认false）

参数配置（Parameter Configuration）

• file：put操作必填。需上传的文件路径
• regex：可选。覆盖源配置中的正则表达式
• folder：可选。追加到仓库路径的子目录（需以斜杠开头）

部署示例

保存工件到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
        - |
          echo "Sample content" > ./build/myapp-$(date +"%Y%m%d%H%S").txt
  - put: file-repository
    params: { file: ./build/myapp-*.txt }

检索Artifactory工件

yaml
jobs:
- name: trigger-on-new-artifact
  plan:
  - get: file-repository
    trigger: true
  - task: use-artifact
    config:
      platform: linux
      image_resource: { repository: ubuntu }
      inputs: [name: file-repository]
      run:
        path: echo
        args: ["使用./file-repository中的文件"]

完整流水线示例见https://github.com/pivotalservices/artifactory-resource/blob/master/pipeline.yml

资源行为

• check：通过正则表达式检索工件版本
• in：根据指定版本检索工件
• out：部署工件到仓库（需指定file参数）

致谢

本资源基于https://github.com/mborges-pivotal/artifactory-resource的原始工作开发。