evoila/concourse-curl-resource

cURL File Resource 镜像文档

概述

cURL File Resource 镜像用于跟踪单个URL可访问文件的更新状态。在流水线开发过程中，当所需工件只能通过URL地址获取，且尚未迁移至Git或S3等文件管理仓库时，该资源可提供有效的文件跟踪能力。

核心功能和特性

• 文件更新跟踪：通过检查文件的HTTP响应头信息，确定文件是否有更新
• 灵活的文件命名：支持自定义下载文件的名称，若未指定则使用完整URL作为文件名
• 认证支持：可配置用户名和密码访问需要认证的资源
• SSL验证控制：支持跳过SSL验证（默认关闭）
• 版本生成机制：基于HTTP响应头的Last-Modified字段生成版本时间戳，若该字段不存在则使用请求时间

使用场景和适用范围

适用于Concourse CI/CD流水线开发场景，特别是以下情况：

• 所需构建工件仅能通过URL地址获取
• 工件尚未迁移至Git、S3等正式文件管理仓库
• 需要跟踪远程文件的更新状态以触发流水线执行

使用方法和配置说明

资源配置示例

资源类型定义

yaml
resource_types:
- name: file-url
  type: docker-image
  source:
    repository: pivotalservices/concourse-curl-resource
    tag: latest

资源实例配置

yaml
resources:
- name: my-file
  type: file-url
  source:
    url: http://www-us.apache.org/dist/lucene/java/5.5.4/lucene-5.5.4-src.tgz  
    filename: lucene-5.5.4-src.tgz  
    # 可选配置
    # username: your-username
    # password: your-password
    # skip_ssl_verification: false

源配置参数说明

• url：必填，文件的URL地址
• filename：可选，下载文件的保存名称，未提供时使用完整URL作为文件名
• username：可选，访问需要认证的资源时的用户名
• password：可选，访问需要认证的资源时的密码
• skip_ssl_verification：可选，是否跳过SSL验证，设为true时跳过，默认false

行为说明

check：检查文件的最新版本

通过curl发送GET请求获取文件URL的HTTP头信息：

• 若响应头包含Last-Modified字段，则使用该字段值生成格式为"YYYYMMDDHHMMSS"的版本时间戳
• 若响应头不包含Last-Modified字段，则使用当前请求时间生成版本时间戳，这将导致每次执行check都会返回新版本

验证文件是否返回Last-Modified信息：

bash
curl -I <file-url>

在输出中查找"Last-Modified"字段。

in：下载文件的最新版本

通过curl命令下载文件的最新版本。

out：不支持

该资源不支持out操作。