pivotalservices/concourse-curl-resource

cURL文件资源

镜像概述和主要用途

该镜像提供Concourse资源，用于跟踪单个URL可访问文件的更新。在流水线开发过程中，当所需工件仅能通过URL获取且尚未迁移至git或S3等文件管理仓库时，此资源非常实用。

核心功能和特性

• 跟踪URL可访问文件的更新状态
• 基于HTTP响应头的Last-Modified字段生成版本时间戳（格式：YYYYMMDDHHMMSS）
• 若Last-Modified字段不存在，使用请求当前时间生成版本时间戳
• 支持下载最新版本的文件
• 支持基本身份验证和跳过SSL验证

使用场景和适用范围

适用于Concourse CI/CD流水线开发阶段，特别是当需要使用仅通过URL提供的临时工件，且这些工件尚未纳入正式文件管理系统（如git或S3）的场景。

详细使用方法和配置说明

资源类型配置

首先需要在流水线中配置资源类型：

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

资源配置

源配置参数

• url: 必填。文件的URL地址。
• filename: 可选。下载文件的保存名称。若未提供，将使用完整URL字符串作为文件名。
• username: 可选。访问需要身份验证的仓库时使用的用户名。
• password: 可选。访问需要身份验证的仓库时使用的密码。
• skip_ssl_verification: 可选。设为true时跳过SSL验证，默认值为false。

示例配置

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  

行为说明

check：检查文件的最新版本

资源通过curl发送GET请求获取文件URL的HTTP头信息。若响应头包含Last-Modified字段，则使用该字段生成版本时间戳（格式：YYYYMMDDHHMMSS）。若不存在Last-Modified字段，则使用请求当前时间生成时间戳，这将导致每次执行check时都返回新版本。

要验证文件URL是否返回Last-Modified信息，可执行以下curl命令并在输出中查找"Last-Modified"字段：

bash
curl -I <file-url>

in：下载文件的最新版本

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

out：不支持

该资源不支持out操作。