Drone plugins > AWS S3
amazon_s3.svg

AWS S3

by drone-plugins


The S3 plugin uploads files and build artifacts to your S3 bucket, or S3-compatible bucket such as Minio.

Example

kind: pipeline
name: default

steps:
- name: upload
  image: plugins/s3
  settings:
    bucket: my-bucket-name
    access_key: a50d28f4dd477bc184fbd10b376de753
    secret_key: bc5785d3ece6a9cdefa42eb99b58986f9095ff1c
    source: public/**/*
    target: /target/location

Properties

  • endpoint

    stringoptional

    custom endpoint URL (optional, to use a S3 compatible non-Amazon service)

    Default: none

  • access_key

    stringoptional

    amazon key

    Default: none

  • secret_key

    stringoptional

    amazon secret

    Secret recommended

    Default: none

  • bucket

    stringrequired

    bucket name

    Default: none

  • region

    stringoptional

    bucket region (us-east-1, eu-west-1, etc)

    Default: none

  • acl

    stringoptional

    bucket acl (public-read, private, etc)

    Default: none

  • source

    stringrequired

    source location of the files, using a glob matching pattern. Location must be within the drone workspace.

    Default: none

  • target

    stringrequired

    target location of files in the bucket.

    Default: none

  • encryption

    stringoptional

    if provided, use server-side encryption

    Default: none

  • strip_prefix

    stringoptional

    strip the prefix from source path

    Default: none

  • exclude

    stringoptional

    glob exclusion patterns

    Default: none

  • path_style

    booleanoptional

    whether path style URLs should be used (true for minio)

    Default: false