firespring/concourse-s3-sync-resource

firespring/concourse-s3-sync-resource 镜像说明

镜像概述

本镜像作为Concourse CI的第三方资源类型，提供本地目录与AWS S3存储桶之间的同步功能，可无缝集成到CI/CD流水线中，实现构建产物、静态资源等文件的自动化上传，提升开发部署效率。

核心功能

1. 支持指定本地目录同步至AWS S3桶
2. 适配Concourse CI资源接口，可作为流水线中的put/get步骤使用
3. 支持配置AWS访问凭证、S3桶区域、目标路径等参数
4. 自动处理文件同步逻辑，确保数据一致性

使用场景

1. CI/CD流水线中上传静态网站资源至S3托管服务
2. 自动化备份项目构建产物到S3存储
3. 同步日志或数据文件到S3进行长期归档
4. 多环境部署中同步配置文件到S3桶

配置说明

在Concourse流水线中定义该资源时，需配置以下核心参数：

• access_key_id: AWS访问密钥ID
• secret_access_key: AWS秘密访问密钥
• bucket: 目标S3桶名称
• region: S3桶所在区域（如ap-southeast-1）
• source_dir: 本地待同步目录路径
• target_dir: S3桶内的目标路径

部署示例

Concourse流水线资源配置

yaml
resources:
  - name: s3-static-resource
    type: docker-image
    source:
      repository: firespring/concourse-s3-sync-resource
      tag: latest

  - name: my-web-s3-bucket
    type: s3-static-resource
    source:
      access_key_id: ((aws_access_key))
      secret_access_key: ((aws_secret_key))
      bucket: my-web-bucket
      region: ap-southeast-1
      source_dir: ./build/static
      target_dir: /public/assets

流水线Job使用示例

yaml
jobs:
  - name: deploy-to-s3
    plan:
      - get: web-project
        trigger: true
      - task: build-web
        file: web-project/tasks/build.yml
      - put: my-web-s3-bucket
        params:
          sync_dir: web-project/build/static