Bundler-Source-Aws-S3

This is a bundler plugin which adds support for s3 as a source for gems.

Installation

Setup the aws cli

There are multiple ways to install the aws cli (including homebrew). This plugin will use the aws cli to pull gems from your s3 source. There is an expectation that if you want to use s3 as a gem source, you'll probably already have this installed.

Setup s3 as a gem source

First, you should already have gems in s3 and you should be able to install them with Rubygems. Follow the guide for using s3 as a gem source.

For this plugin to work the aws cli should be able to fetch your gems. The plugin will run a command like aws s3 sync s3://your-source <local path> and you may want to verify that you have aws cli setup correctly (permissions, etc) to be able to run that command.

Add aws-s3 source to your Gemfile

In your Gemfile, add a source like this:

source('s3://my-bucket/gems', type: 'aws-s3') do
  gem 'my-cool-gem'
end

When Bundler sees the type: 'aws-s3' it will automatically install and use this plugin to install gems from your s3 source.

Development

We don't have a very good development story (there are no tests, yay!). You'll want to fork this repository and use your own fork by adding this to a Gemfile that you plan to use to test your fork:

plugin 'bundler-source-aws-s3', git: 'https://github.com/<you>/bundler-source-aws-s3.git'

You may also want to wipe a few directories out as you test:

rm -rf ./.bundle/plugin
rm -rf ~/.bundle/bundler-source-aws-s3

You may also want to wipe out the install_path for the s3 uri you're testing against. You can find that in irb by instantiating your plugin like:

>> BundlerSourceAwsS3::S3Source.new(uri: 's3://vying-gems').send(:install_path)

Although this will only work if you're running irb in a directory with a Gemfile and a .bundle/ directory. These can be empty as of this writing.

It can also help to poke at the plugin in irb:

irb -I . -r bundler -r plugins.rb

Other s3 source plugins

As of this writing there is another gem called bundler-source-s3 that doesn't work and you probably don't want to confuse with this gem. If you use type 's3' (instead of 'aws-s3') in your Gemfile you'll get that plugin, not this one.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/eki/bundler-source-aws-s3.

License

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