Google Cloud Platform NodeJS Samples

This repository holds the samples used in the nodejs documentation on cloud.google.com/nodejs.

Google App Engine

This is a collection of samples and instructions to run common nodejs frameworks and applications on Google App Engine.

Frameworks

• Express.js - Source code | App Engine Tutorial | Live demo | Documentation
  • Express.js + Memcached Sessions - Source code | Documentation
• Geddy.js - Source code | App Engine Tutorial | Live demo | Documentation
• Hapi.js - Source code | App Engine Tutorial | Live demo | Documentation
• Loopback.js - Source code | App Engine Tutorial | Live demo | Documentation
• Koa.js - Source code | App Engine Tutorial | Live demo | Documentation
• Kraken.js - Source code | App Engine Tutorial | Live demo | Documentation
• Restify.js - Source code | App Engine Tutorial | Live demo | Documentation
• Sails.js - Source code | App Engine Tutorial | Live demo | Documentation

Databases

• MongoDB - Source code | App Engine Tutorial | Documentation
• Redis - Source code | App Engine Tutorial | Documentation

Tools

• gcloud-node - Source code | Documentation
• Bower - Source code | App Engine Tutorial | Documentation
• Grunt - Source code | App Engine Tutorial | Live demo | Documentation
• Mailgun - Source code | App Engine Tutorial | Documentation
• Sendgrid - Source code | App Engine Tutorial | Documentation
• Webpack - Source code | App Engine Tutorial | Documentation

Google Storage

• Auth sample - Source code | Google Cloud Docs

Example Apps

• nodejs-getting-started - Source code | App Engine Tutorial 1 | App Engine Tutorial 2
• gcloud-node-todos - Source code
• gitnpm - Source code
• gcloud-kvstore - Source code

More information

• Getting started with nodejs on Google Cloud
• See our other Google Cloud Platform github repos for sample applications and scaffolding for other frameworks and use cases.
• Using the gcloud npm module
• Logging to Google Cloud with Winston

Contributing changes

Contributions welcome!

See CONTRIBUTING.md

Running the tests

1. git clone git@github.com:GoogleCloudPlatform/nodejs-docs-samples.git
2. cd nodejs-docs-samples
3. npm install
4. Start Redis
5. Start Memcached
6. Set the TEST_PROJECT_ID environment variable to id of your project
7. npm test

Since the tests use Mocha.js, you can use the --grep option to run only the tests that match a provided pattern. The --invert option causes the matched tests to be excluded instead of included.

Run only the tests that match a pattern:

npm test -- -- --grep <pattern>

Only run the tests for the datastore sample:

npm test -- -- --grep datastore

Skip the tests that match a pattern:

npm test -- -- --grep <pattern> --invert

Run all but the datastore tests:

npm test -- -- --grep datastore --invert

Skip the tests that require Redis and Memcached:

npm test -- -- --grep "express-memcached-session|redis" --invert

Licensing

Apache Version 2.0

See LICENSE