machinistlabs/concourse-http-publish

concourse-http-publish-resource

Concourse CI自定义资源类型，用于通过HTTP PUT发布工件

镜像概述

本镜像作为Concourse CI的扩展资源，提供安全的HTTP(S)工件发布能力，支持认证、归档、动态命名等功能，适用于CI/CD流程中的自动化工件分发场景。

核心功能

• 支持HTTP(S)基础认证上传
• 可选将工件打包为tar.gz格式
• 可添加操作系统（如linux）、架构（如amd64）到文件名
• 支持UTC时间戳格式（如+%Y%m%dT%H%MZ）生成带时间标记的文件名
• 提供dryrun测试模式（仅生成文件名和元数据，不上传）

使用场景

• CI/CD流水线中，将构建产物（二进制文件、软件包等）上传至指定HTTP服务器
• 自动化发布流程中，向内部或外部服务分发版本化工件

配置说明

源配置（Source Configuration）

所有字段必填：

• url：目标HTTP(S)端点地址
• username：认证用户名
• password：认证密码

动作（Actions）

check

暂未实现。

in

暂未实现。

put

执行HTTP PUT上传，参数说明：

• from（必填）：工件的相对路径
• to（必填）：目标服务器的子路径
• os（可选）：文件名附加的操作系统名称
• arch（可选）：文件名附加的架构名称
• datefmt（可选）：UTC时间戳格式（遵循date -u语法）
• archive（可选）：是否打包为tar.gz（布尔值）
• dryrun（可选）：测试模式（仅生成文件名，不上传，布尔值）

部署示例

yaml
# 定义资源类型
resource_types:
  - name: http-publish
    type: docker-image
    source:
      repository: machinistlabs/concourse-http-publish
      tag: latest

# 创建资源实例
resources:
  - name: artifact-publish
    type: http-publish
    icon: file-upload
    source:
      url: "https://ci.example.com/releases"
      username: ((http-publish-username))
      password: ((http-publish-password))

# 任务定义
jobs:
  - name: ship
    plan:
      - get: artifact
      - put: artifact-publish
        params:
          from: "artifact"
          to: "project-one"
          os: "linux"
          arch: "amd64"
          datefmt: "+%Y%m%dT%H%MZ"
          archive: true

示例将工件上传至https://ci.example.com/releases/project-one/artifact_linux_amd64_20190712T1250Z.tar.gz（时间戳为示例）。

FAQ

Q: 该资源是否已完全实现？
A: 尚未完善，计划补充check和in动作。

Q: 为何选择本资源而非http-put-resource？
A: 出于安全考虑（避免依赖未验证的社区镜像），且原工具实现过于复杂，本资源集成了归档等实用功能。