plugins/s3

drone-s3

镜像概述和主要用途

drone-s3是由https://github.com/drone-plugins/drone-s3维护的Drone CI官方插件，通过https://beta.drone.io/drone-plugins/drone-s3构建并推送。该插件专为Drone CI/CD流水线设计，用于在构建过程中与Amazon S3或兼容S3 API的对象存储服务（如MinIO）进行交互，实现构建产物、依赖文件等的上传、下载、同步等操作，简化持续集成流程中的对象存储管理。

核心功能和特性

• S3兼容交互：支持与Amazon S3及所有兼容S3 API的对象存储服务（如MinIO、Ceph RGW等）进行交互。
• 文件操作支持：提供文件上传、下载、目录同步等核心功能，满足CI/CD流程中对对象存储的常见需求。
• Drone CI原生集成：作为Drone CI的官方插件，可直接在Drone流水线配置中使用，无需额外适配。
• 社区维护：由drone-plugins社区持续维护，与Drone CI生态深度整合，更新及时。

使用场景和适用范围

drone-s3适用于所有基于Drone CI/CD的开发团队，尤其适合以下场景：

• 构建产物分发：在CI流程中，将编译后的二进制文件、静态网站资源（如前端构建产物）等上传至S3存储桶，用于后续分发或部署。
• 依赖文件管理：从S3下载项目依赖文件（如大型库、预制工具），加速构建过程，减少重复下载。
• 配置文件同步：将CI/CD所需的配置文件、密钥文件等从S3同步至构建环境，或反之将构建过程中生成的配置文件上传至S3归档。

详细使用方法和配置说明

基本使用方式

drone-s3作为Drone CI插件，需在Drone流水线配置文件（.drone.yml）的steps中定义使用步骤，通过settings配置交互参数。

核心配置参数

使用示例

示例1：上传构建产物至AWS S3

在Drone流水线中，将前端构建后的dist目录下所有文件上传至AWS S3的my-app-builds桶的v1.2.3目录：

yaml
steps:
- name: upload to s3
  image: docker.xuanyuan.run/plugins/s3
  settings:
    access_key:
      from_secret: aws_access_key  # 从Drone密钥管理中获取
    secret_key:
      from_secret: aws_secret_key  # 从Drone密钥管理中获取
    region: us-east-1
    bucket: my-app-builds
    source: dist/*
    target: /v1.2.3/
    overwrite: true
    acl: public-read  # 允许公开访问构建产物

示例2：从MinIO下载依赖文件

从MinIO服务下载项目依赖文件至构建环境：

yaml
steps:
- name: download dependencies from minio
  image: docker.xuanyuan.run/plugins/s3
  settings:
    access_key:
      from_secret: minio_access_key
    secret_key:
      from_secret: minio_secret_key
    endpoint: https://minio.example.com  # MinIO服务端点
    bucket: project-deps
    source: deps.tar.gz  # S3中的文件路径
    target: /app/deps/  # 本地目标路径
    # 下载模式需额外配置（具体参数参考插件文档）

注意事项

• 敏感信息（如access_key、secret_key）应通过Drone的密钥管理功能（from_secret）注入，避免明文暴露。
• 使用非AWS S3服务时，需通过endpoint参数指定服务地址，并确保S3 API兼容性。
• 详细参数及高级用法可参考https://github.com/drone-plugins/drone-s3。