WebpackerUploader

Webpacker uploader provides an easy way to upload your assets to AWS S3. It knows which files to upload by reading the manifest.json file.

This is particularly useful if you serve your application's assets through a combination of S3 + CDN, outside of your Rails application.

Add this line to your application's Gemfile:

gem "webpacker_uploader", require: false

and run:

bundle install

or:

gem install webpacker_uploader

To use the aws provider install the aws-sdk-s3 gem. Add in your Gemfile:

gem "aws-sdk-s3", require: false

Usually, in a Rake task you would add the following to upload the assets to AWS S3:

require "webpacker_uploader"
require "webpacker_uploader/providers/aws"

provider_options = {
  credentials: { profile_name: "staging" },
  region: "eu-central-1",
  bucket: "application-assets-20200929124523451600000001"
}

provider = WebpackerUploader::Providers::Aws.new(provider_options)
WebpackerUploader.upload!(provider)

Currently, the only provider implemented is the AWS S3 provider.

The AWS S3 provider credentials can be configured in three ways. Passing a named profile name:

provider_options = {
  credentials: { profile_name: "staging" },
  region: "eu-central-1",
  bucket: "application-assets-20200929124523451600000001"
}

provider = WebpackerUploader::Providers::Aws.new(provider_options)

passing the access and the secret keys directly:

provider_options = {
  credentials: { access_key_id: "AKIAIOSFODNN7EXAMPLE", secret_access_key: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY" },
  region: "eu-central-1",
  bucket: "application-assets-20200929124523451600000001"
}

provider = WebpackerUploader::Providers::Aws.new(provider_options)

or using an EC2 instance profile:

provider_options = {
  credentials: { instance_profile: true },
  region: "eu-central-1",
  bucket: "application-assets-20200929124523451600000001"
}

provider = WebpackerUploader::Providers::Aws.new(provider_options)

Uploaded files can be prefixed by setting the prefix parameter during upload:

WebpackerUploader.upload!(provider, prefix: "assets")

This will prefix all remote file paths with assets so instead of storing packs/application-dd6b1cd38bfa093df600.css it will store assets/packs/application-dd6b1cd38bfa093df600.css.

WebpackerUploader.upload!(provider, cache_control: "public, max-age=3600")

This option is used to specify caching behavior along the request/reply chain.

⚠️ This option is applied to all uploaded files, not on a per-file basis.

WebpackerUploader currently supports the following configuration options:

It can be configured using a block:

WebpackerUploader.configure do |config|
  config.ignored_extensions = [".png", ".jpg", ".webp"]
  config.log_output = false
  config.public_manifest_path = "path/to/manifest.json"
  config.public_path = "path/to/public/dir"
end

or directly:

WebpackerUploader.config.log_output = false

The uploader used to skip .map files by default. This has changed (see CHANGELOG.md) and everything is uploaded by default now. To retain the previous functionality use:

# skip uploading map files
WebpackerUploader.config.ignored_extensions = [".map"]

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install.

This gem also provides an integration test suite. It runs using localstack. To run the integration tests, install docker on your system and spin up a localstack container running the s3 service.

docker compose -f "integration/docker-compose.yml" up --detach

To run the tests, use rake test:integration.

To stop the container once done run: docker-compose -f "integration/docker-compose.yml" down

Bug reports and pull requests are welcome on GitHub at https://github.com/tlatsas/webpacker_uploader.

See CONTRIBUTING.

The gem is available as open source under the terms of the MIT License.