Carrierwave Google Storage

Use the official google-cloud gem by Google for Google Cloud Storage, instead of Fog.

No need to activate Interoperable Access on your project.
Rely on Google's preferred authentication mechanism. ie: Service Accounts.

Installation

Add this line to your application's Gemfile:

gem 'carrierwave-google-storage'

Rails Compatibility:

Rails 4 and 5.

Usage

In config/initializers/carrierwave.rb add the following initialization code:

CarrierWave.configure do |config|
  config.storage                             = :gcloud
  config.gcloud_bucket                       = 'your-bucket-name'
  config.gcloud_bucket_is_public             = true
  config.gcloud_authenticated_url_expiration = 600
  
  config.gcloud_attributes = {
    expires: 600
  }
  
  config.gcloud_credentials = {
    gcloud_project: 'gcp-project-name',
    gcloud_keyfile: 'path-to-gcp-keyfile.json'
  }
end

Then, in your Uploader classes:

class FileUploader < CarrierWave::Uploader::Base
   storage :gcloud
end

How to get the Keyfile?

To generate a new keyfile, perform the following steps:

Go to Cloud Console > API Manager > Credentials
Click Create Credentials > Service Account Key
Service Account > New Service Account
Give any name for "Service Account Name"
Set Key type to JSON
Click "Create"

Here's a quick GIF for those who are visual like myself:

Contributing

Environment Variables and such

You should have access to a Google Cloud Platform account, as you'll need the keyfile and a project ID in order to contribute to the development of this gem. You'll need the the following files:

.gcp-keyfile.json (sample file provided: .gcp-keyfile.sample.json)
.env (sample file provided: .env.sample)

If you have any questions, please feel free to open up issues and/or PR's. Contributions are welcomed.

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.

You get extra attention, if your PR includes specs/tests.

Fork or clone the project.
Create your feature branch ($ git checkout -b my-new-feature)
Install the dependencies by doing: $ bundle install in the project directory.
Add your bug fixes or new feature code.
New features should include new specs/tests.
Bug fixes should ideally include exposing specs/tests.
Commit your changes ($ git commit -am 'Add some feature')
Push to the branch ($ git push origin my-new-feature)
Open your Pull Request!

License

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

gerbal / carrierwave-google-storage Goto Github PK