gcloud-promise
v0.1.4
Published
Promises based interface to Google Cloud services
Downloads
3
Maintainers
Readme
gcloud-promise
A promises based node interface to Google cloud services.
Currently, support is implemented for
- Google Cloud Storage and
- Google Datastore.
Google provides a gcloud, a node binding which is similar in spirit. This project grew out of a need/desire to use a promises based interface. The code is much smaller, and IMHO, much easier to understand. YMMV.
Installation
Simply,
npm install gcloud-promise
Get gcloud credentials
Get credentials to access your datastore
Follow instructions at: https://cloud.google.com/datastore/docs/activate The Google cloud API provides 2 mechanisms of access:
- From Google Compute Engine
- From other platforms (like localhost, AWS etc).
At this point, only #2 has been tested with this library.
- create a service account and
- download credentials to project_keyFile.json (keep this away from the main code directory and never commit it to the same VCS as your code)
Setup environment variable to track the key file.
export GCLOUD_KEYFILE=/path/to/project_keyFile.json
Library initialization
var acct = {
keyFilename: process.env.GCLOUD_KEYFILE,
project_id: ‘myProject’,
cust_id: ‘cust1’
},
gcloud = require(‘gcloud-promise’)(acct.keyFilename);
Google cloud storage
var ds = gcloud.datastore(acct.project_id),
data = [{
name: ‘entity1’,
prop1: ‘just a prop’,
prop2: 23,
prop3: 42.1,
prop4: true
}, {
name: ‘entity2’,
prop1: ‘just a prop again’,
prop2: 76,
prop3: 3.147,
prop4: false
}]
ds.transaction().then(function(transaction) {
/* Please understand datastore keys and entities.
This loop converts a simple javascript object array
into an entities array that the datastore can save, query and fetch
*/
var entities = data.reduce(function(acc, datum) {
var key = ds.key(acct.cust_id, [[‘EntityKind’, datum.name]]);
acc.push(ds.entity.toProto(datum, key));
});
transaction
.upsert(entities)
.commit()
.then(function(result) {
if (result.statusCode === 200) {
console.log(‘Commit succeeded:’ + result.statusCode + ‘ ‘ + JSON.stringify(result.body));
} else {
throw(‘Commit failure ‘ + result.statusCode + ‘ ‘ + JSON.stringify(result.errors));
}
});
}).catch(function(err) {
throw(‘Commit failed:’ + err);
})
ds.gql().
Google storage
var stor = gcloud.storage(acct.project_id),
test = {
bucket_name: acct.project_id + ‘-test-bucket-123456’,
file_name: acct.project_id + ‘-test-file-123456’,
data: ‘{“key1”: “val1”, “key2”: “val2”}’
};
stor.bucket.create(test.bucket_name).then(function(d){
console.log('\n -> created bucket:' + JSON.stringify(d));
}).then(function() {
return stor.bucket.get(test.bucket_name).then(function(d){
console.log('\n -> get bucket:' + JSON.stringify(d));
});
}).then(function(){
return stor.bucket.list().then(function(d) {
console.log('\n -> list buckets:' + JSON.stringify(d));
});
}).then(function() {
return stor.file.create(test.bucket_name, test.file_name, test.data).then(function(d) {
console.log('\n -> create file:' + JSON.stringify(d));
});
}).then(function() {
return stor.file.create(test.bucket_name, test.file_name, test.data).then(function(d) {
console.log('\n -> create2 file:' + JSON.stringify(d));
});
}).then(function() {
return stor.file.get(test.bucket_name, test.file_name).then(function(d) {
console.log('\n -> get file:' + JSON.stringify(d));
});
}).then(function() {
return stor.file.delete(test.bucket_name, test.file_name).then(function(d) {
console.log('\n -> delete file:' + JSON.stringify(d));
});
}).then(function() {
return stor.bucket.delete(test.bucket_name).then(function(d) {
console.log('\n -> deleted bucket:' + JSON.stringify(d));
});
});