lpsk/artifactory-resource

Artifactory资源

本镜像为Concourse流水线提供Artifactory资源类型，用于与JFrog Artifactory服务器交互，实现 artifacts 的部署与检索。

核心功能

1. 定义Concourse流水线中的Artifactory资源
2. 向Artifactory服务器部署指定artifact
3. 从Artifactory服务器检索指定版本的artifact

使用场景

• CI/CD流水线中，将构建产物（如二进制文件、配置文件）存储到Artifactory
• 流水线依赖Artifactory中的artifact作为输入，触发后续任务（如部署、测试）

配置说明

源配置（Source Configuration）

• endpoint：必填。Artifactory REST API端点，例如 http://YOUR-HOST_NAME:8081/artifactory。
• repository：必填。Artifactory仓库路径（含文件夹），必须以斜杠开头，例如 /generic/product/pcf。
• regex：必填。用于提取artifact版本的正则表达式，必须包含 version 分组，例如 myapp-(?<version>.*).tar.gz。
• username：可选。访问认证仓库时的HTTP(S)用户名。
• password：可选。访问认证仓库时的HTTP(S)密码。
• skip_ssl_verification：可选。连接Artifactory API时跳过SSL验证，取值为 true 或 false（默认）。

参数配置（Parameter Configuration）

• file：put操作必填。需上传到Artifactory的文件路径。
• regex：可选。覆盖源配置中的regex。
• folder：可选。追加到源配置的repository路径，必须以斜杠开头。
• properties：put操作可选。与上传artifact关联的属性。
• sha256checksum：put操作可选。部署时设置sha256校验和，取值为 true 或 false（默认）。
• forcesha256checksum：put操作可选。强制使用 /api/checksum/sha256 设置校验和，取值为 true 或 false（默认）。

Concourse流水线示例

定义Artifactory资源类型与资源

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

resources:
- name: file-repository
  type: artifactory
  source:
    endpoint: http://ARTIFACTORY-HOST-NAME-GOES-HERE:8081/artifactory
    repository: "/repository-name/sub-folder"
    regex: "myapp-(?<version>.*).txt"
    username: YOUR-ARTIFACTORY-USERNAME
    password: YOUR-ARTIFACTORY-PASSWORD
    skip_ssl_verification: true

上传artifact到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
        - |
          export DATESTRING=$(date +"%Y%m%d")
          echo "This is my file" > ./build/myapp-$(date +"%Y%m%d%H%S").txt
          find .
  - put: file-repository
    params: { file: ./build/myapp-*.txt }

从Artifactory检索artifact

yaml
jobs:
- name: trigger-when-new-file-is-added-to-artifactory
  plan:
  - get: file-repository
    trigger: true
  - task: use-new-file
    config:
      platform: linux
      image_resource:
        type: docker-image
        source:
          repository: ubuntu
      inputs:
      - name: file-repository
      run:
        path: echo
        args:
        - "在此处使用来自 ./file-repository 的文件..."

完整流水线定义示例可参考 https://github.com/pivotalservices/artifactory-resource/blob/master/pipeline.yml%E3%80%82

资源行为

check：检索artifact版本

基于regex提取Artifactory中的artifact版本。

in：检索指定版本的artifact

与check逻辑类似，但根据提供的版本检索具体artifact。

out：部署artifact到仓库

部署指定artifact到Artifactory仓库。

参数

• file：必填。需部署的artifact路径。
• properties：可选。artifact关联的属性列表，详见 https://www.jfrog.com/confluence/display/RTF/Artifactory+REST+API#ArtifactoryRESTAPI-SetItemProperties%E3%80%82
• sha256checksum：可选。部署时设置sha256校验和，取值 true 或 false（默认）。
• forcesha256checksum：可选。强制使用 /api/checksum/sha256 设置校验和，取值 true 或 false（默认）。

Credits

本资源最初基于 https://github.com/mborges-pivotal/artifactory-resource 的Artifactory资源工作。