18fgsa/http-resource

镜像概述

该镜像为Concourse CI的HTTP资源类型（http-resource）分支版本，基于@aequitas原项目构建。主要用于在Concourse CI流水线中与HTTP端点交互，实现HTTP资源的获取与版本控制。核心改进为新增基于ETag的版本检查机制，可更高效识别资源变化，减少不必要的网络传输和处理。

核心功能和特性

• 继承原HTTP资源功能：支持HTTP/HTTPS协议资源获取，可配置请求方法、请求头、认证信息等
• ETag版本检查：通过比较资源ETag值识别内容变化，避免重复下载未更新资源
• 版本追踪：自动以ETag作为版本标识，支持Concourse流水线追踪资源更新状态
• 轻量级设计：保持与原项目一致的轻量特性，易于集成到现有Concourse环境

使用场景和适用范围

• Concourse CI流水线：适用于所有基于Concourse构建的自动化流水线
• HTTP资源监控：需定期检查API响应、远程配置文件等HTTP资源变化的场景
• 高效资源同步：对带宽敏感或大体积资源，通过ETag检查减少网络传输
• 版本触发场景：需基于HTTP资源版本变化触发流水线执行的场景

使用方法和配置说明

配置参数

1. 资源类型定义（resource_types）

yaml
resource_types:
- name: http-etag-resource
  type: docker-image
  source:
    repository: [镜像仓库地址]  # 替换为实际镜像仓库地址

2. 资源配置（resources）

yaml
resources:
- name: [资源名称]
  type: http-etag-resource
  source:
    url: https://example.com/resource  # HTTP资源URL（必填）
    method: GET  # HTTP请求方法，默认为GET（可选）
    headers:  # 请求头（可选）
      Authorization: "Bearer token"
      Content-Type: "application/json"
    etag: true  # 是否启用ETag检查，默认为true（可选）
    # 继承原http-resource的其他参数：
    username: "user"  # 基本认证用户名（可选）
    password: "pass"  # 基本认证密码（可选）
    skip_ssl_verification: false  # 是否跳过SSL验证（可选）

示例配置

以下为完整Concourse pipeline示例，实现HTTP资源监控与自动处理：

yaml
resource_types:
- name: http-etag-resource
  type: docker-image
  source:
    repository: your-registry/http-etag-resource  # 替换为实际镜像仓库

resources:
- name: app-config
  type: http-etag-resource
  source:
    url: https://api.example.com/config.yaml
    headers:
      Authorization: "Bearer $(API_TOKEN)"
    skip_ssl_verification: false

jobs:
- name: process-config-update
  plan:
  - get: app-config
    trigger: true  # 资源版本变化时自动触发
  - task: analyze-config
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine}
      inputs:
      - name: app-config
      run:
        path: sh
        args:
        - -c
        - |
          echo "Config updated. New version ETag: $(cat app-config/.etag)"
          cat app-config/config.yaml | grep "version"

注意事项

• 需确保Concourse Worker可访问镜像仓库及目标HTTP资源URL
• ETag功能依赖服务端正确返回ETag响应头，若服务端不支持，将自动降级为原版本检查方式
• 敏感认证信息建议通过Concourse变量（如$(API_TOKEN)）注入，避免明文配置