timotto/artifactory-resource

Artifactory资源镜像

镜像概述

本镜像为Concourse流水线提供Artifactory资源支持，用于与JFrog Artifactory服务器交互，实现工件的部署和检索，并扩展支持X-JFrog-Art-Api头，帮助用户构建基于Artifactory的自动化CI/CD流程。

核心功能

1. 定义Concourse流水线中的Artifactory资源类型
2. 向Artifactory服务器上传指定工件
3. 从Artifactory服务器检索符合正则表达式的工件
4. 支持用户名密码、X-JFrog-Art-Api token两种认证方式
5. 可配置跳过SSL验证（适用于测试环境）

使用场景

1. Concourse流水线中构建产物的存储与分发
2. 基于Artifactory的持续集成/持续部署流程
3. 需要与JFrog Artifactory集成的自动化流水线场景

配置说明

资源类型定义

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

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

资源配置（Source Configuration）

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

参数配置（Parameter Configuration）

• file: put操作必填。需上传到Artifactory的文件路径
• regex: 可选。覆盖资源配置中的regex
• folder: 可选。追加到资源配置的repository路径后，需以斜杠开头

使用示例

向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检索工件

yaml
jobs:
- name: trigger-when-new-file-is-added
  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路径下的文件..."

资源行为

check

基于正则表达式检索Artifactory中的工件版本。

in

与check逻辑类似，但根据指定版本检索工件。

out

向Artifactory仓库部署工件，需指定file参数。

Credits

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