cloud-storage 0 npm

Simple node js module for uploading and removing files from Google Cloud Storage

3 years after

Cloud Storage

Simple wrapper for uploading and deleting files from Google Cloud Storage.

Thanks to @bsphere for https://github.com/bsphere/node-gcs

Installation

npm install cloud-storage

Getting Started

  1. Sign into the Google Cloud Console site: https://console.developers.google.com

  2. Go to your project and under APIs & auth click on Credentials

  3. Create an Oauth Service Account for your project if you don't already have one

  4. Under the Service Account section copy your email address (that is your accessId)

  5. If you do not have a private key, click Generate new key to generate one (this will download a .p12 file to your computer)

  6. Convert the key to a .pem file

    openssl pkcs12 -in path/to/key.p12 -nodes -nocerts > path/to/key.pem
  7. If prompted for a password enter notasecret

  8. Store this .pem file somewhere secret (the path to this file is your privateKey)

Usage

Creating a cloud storage object

var CloudStorage = require('cloud-storage');
var storage = new CloudStorage({
    accessId: '[email protected]',
    privateKey: '/path/to/private/key.pem'
});

Copying a file to cloud storage

// copy a local file or a url
storage.copy('/path/to/something.jpg', 'gs://some-bucket/something.jpg', function(err, url) {
    // public url for your file
    console.log(url);
});

Deleting a file from cloud storage

storage.remove('gs://some-bucket/something.jpg', function(err, success) {
    console.log(success);
});

Custom options and metadata

// if you want to get crazy you can pass in options and metadata
var options = {
    headers: {
        'Cache-Control': 'public, max-age=7200, no-transform',
        'X-Goog-Acl': 'bucket-owner-full-control'
    },
    metadata: {
        'width': 100,
        'height': 100
    },

    // remove the original file on disk after it is copied
    removeAfterCopy: true,

    // force an extension to be added to the destination
    forceExtension: true
};

storage.copy('http://someurl.com/path/to/file.jpg', 'gs://some-bucket/images/file', options, function(err, url) {

});

Get a url for a file

var url = storage.getUrl('gs://some-bucket/images/file.jpg')

// expiration time in seconds
var options = {
    expiration: 100,
    download: true
};

var signedUrl = storage.getSignedUrl('gs://some-bucket/images/file.jpg', options)

Related Repositories

lokad-cloud-storage

lokad-cloud-storage

(Not maintained anymore) Lokad.Cloud Storage Toolkit for Windows Azure ...

cloudmanic-storage

cloudmanic-storage

An abstract library that gives support to different cloud storage solutions. (Ie ...

cloud-storage-chrome-app

cloud-storage-chrome-app

Cloud Storage Chrome OS App ...

laravel-google-cloud-storage

laravel-google-cloud-storage

A Google Cloud Storage filesystem for Laravel ...

MySQL-backup-to-Google-Cloud-Storage

MySQL-backup-to-Google-Cloud-Storage

Backup daily/weekly/monhtly all your MySQL databases to Google Cloud Storage via ...


Top Contributors

ccampbell

Releases

-   0.1.3 zip tar
-   0.1.2 zip tar
-   0.1.1 zip tar
-   0.1.0 zip tar