cincan/s3-resource-simple

Concourse CI 简单S3资源

该镜像为Concourse CI提供S3资源支持，与官方S3资源相比，可上传或下载多个文件，且支持自定义端点，兼容Minio等S3协议存储服务。

核心功能

1. 批量上传/下载文件到S3或兼容存储桶
2. 支持自定义S3端点（适配Minio等非AWS存储）
3. 支持AWS凭证认证或EC2角色凭证自动获取
4. 灵活的同步选项（基于AWS CLI sync参数）

使用场景

• CI/CD流水线中同步构建产物到S3存储桶
• 从S3兼容存储中拉取依赖文件到CI任务环境
• 跨环境同步文件到Minio等私有存储服务

配置说明

资源类型定义

在流水线YAML中添加资源类型：

yaml
resource_types:
- name: s3-resource-simple
  type: docker-image
  source:
    repository: cincan/s3-resource-simple

资源配置

定义具体资源实例：

yaml
resources:
- name: my-s3-resource
  type: s3-resource-simple
  source:
    access_key_id: {{aws-access-key}}
    secret_access_key: {{aws-secret-key}}
    bucket: {{storage-bucket-name}}
    endpoint: {{s3-compatible-endpoint}} # 如Minio地址：http://minio:9000
    path: optional/path/in/bucket # 可选，指定桶内路径
    options: ["--exclude '*'", "--include 'results/*'"] # 可选，同步过滤规则
    region: eu-west-2 # 可选，指定AWS区域（如伦敦）

任务使用示例

在流水线任务中使用该资源：

yaml
jobs:
- name: sync-to-s3
  plan:
  - get: build-artifacts # 从其他资源获取构建产物
  - put: my-s3-resource # 上传到S3存储
    params:
      file: build-artifacts/*

关键参数说明

• 凭证: 若未提供access_key_id和secret_access_key，将自动从EC2元数据服务获取角色凭证
• 同步选项: 支持AWS CLI sync的所有参数，如--exclude/--include过滤文件
• 区域: 部分AWS区域（如伦敦）需指定region以启用Signature Version 4认证