@bbc/webpack-s3-uploader NPM

webpack-s3-uploader

Webpack plugin to push assets to s3

Context

There are already a number of webpack plugins out in the wild that can push assets to S3, so you might be wondering why we rolled out our own. In very simple terms, we had issues with all the other ones and the effort involved in just creating our own highly outweighed the effort we were putting into debugging the existing ones.

Usage

In webpack.config.js:

const WebpackS3Uploader = require('@bbc/webpack-s3-uploader');

{
  ...
  plugins: [
    new WebpackS3Uploader({
      whitelist: ['js', 'css'],
      logger: console,
      basePath: 'webpack/assets',
      directory: './web/assets',
      s3Options: {
        region: 'eu-west-1',
        httpOptions: {
          timeout: 240000,
          connectTimeout: 240000
        }
      },
      s3UploadOptions: {
        ACL: 'public-read',
        CacheControl: 'public, max-age=15552000, immutable',
      }
    })
  ]
}

Options

whitelist: Required An array of extensions to include in the upload. For example - 'js', 'css'
directory: Required Provide a directory to upload
s3Options: Provide options for S3 object s3Config
s3UploadOptions: Provide upload options putObject
logger: A logger object that supports the standard .info, .log, .error, etc API
basePath: Provide the namespace where upload files on S3