pr/5

.jshintignore

@@ -0,0 +1,5 @@
+appengine/kraken/public/components/**
+appengine/sails/config/**
+appengine/sails/tasks/**
+appengine/sails/assets/**
+node_modules

.travis.yml

@@ -40,4 +40,4 @@ install:
 #Use '-q' to disable interactive prompts
 
 script:
-  - jshint --exclude-path=.gitignore .
+  - jshint --exclude-path=.jshintignore .

README.md

@@ -1,12 +1,38 @@
-## Google Cloud Platform NodeJS Samples
+# Google Cloud Platform NodeJS Samples
 
-This repository holds the samples used in the nodejs documentation on [cloud.google.com](https://cloud.google.com).
+This repository holds the samples used in the nodejs documentation on [cloud.google.com/nodejs](https://cloud.google.com/nodejs).  
 
 [![Build Status](https://travis-ci.org/GoogleCloudPlatform/nodejs-docs-samples.svg)](https://travis-ci.org/GoogleCloudPlatform/nodejs-docs-samples)
 
-See our other [Google Cloud Platform github
-repos](https://github.com/GoogleCloudPlatform) for sample applications and
-scaffolding for other frameworks and use cases.
+## Google App Engine
+
+This is a collection of samples and instructions to run common nodejs frameworks and applications on [Google App Engine](http://cloud.google.com/nodejs).  
+
+### Frameworks
+
+- [Express](appengine/express/)
+- [Hapi](appengine/hapi/)
+- [Loopback](appengine/loopback/)
+- [Sails](appengine/sails/)
+- [Koa](appengine/koa/)
+- [Kraken](appengine/kraken/)
+- [Restify](appengine/restify/)
+- [Geddy](appengine/geddy/)
+
+### Services
+
+- [Redis](appengine/redis/)
+
+### Tools
+
+- [Grunt](appengine/grunt/)
+
+### More information
+
+- [Getting started with nodejs on Google Cloud](http://cloud.google.com/nodejs/)
+- See our other [Google Cloud Platform github repos](https://github.com/GoogleCloudPlatform) for sample applications and scaffolding for other frameworks and use cases.
+- [Using the `gcloud` npm module](https://googlecloudplatform.github.io/gcloud-node/#/)
+- [Logging to Google Cloud with Winston](https://github.com/GoogleCloudPlatform/winston-gae)
 
 ## Contributing changes
 

appengine/README.md

@@ -0,0 +1,29 @@
+# nodejs -> Google App Engine
+
+This is a collection of samples and instructions to run common nodejs frameworks and applications on [Google App Engine](http://cloud.google.com/nodejs).  
+
+## Frameworks
+
+- [Express](express/)
+- [Hapi](hapi/)
+- [Loopback](/loopback)
+- [Sails](sails/)
+- [Koa](koa/)
+- [Kraken](kraken/)
+- [Restify](restify/)
+- [Geddy](geddy/)
+
+## Services
+
+- [Redis](redis/)
+
+## Tools
+
+- [Grunt](grunt/)
+
+## More info
+
+- [Getting started with nodejs on Google Cloud](http://cloud.google.com/nodejs/)
+- [Using the `gcloud` npm module](https://googlecloudplatform.github.io/gcloud-node/#/)
+- [Logging to Google Cloud with Winston](https://github.com/GoogleCloudPlatform/winston-gae)
+

appengine/express/README.md

@@ -0,0 +1,25 @@
+# Express -> Google App Engine
+
+This is a simple guide to running [expressjs](http://expressjs.com/) on Google App Engine.
+
+1. [Create a new Express app](http://expressjs.com/starter/generator.html)
+
+2. Create an `app.yaml` in the root of your application with the following contents:
+
+```yaml
+runtime: nodejs
+vm: true
+env_variables:
+  PORT: 8080
+```
+
+3. Deploy your app. For convenience, you can use an npm script to run the command. Modify your `package.json` to include:
+
+```js
+"scripts": {
+  "start": "node ./bin/www",
+  "deploy": "gcloud preview app deploy app.yaml --set-default --project [project id]"
+}
+```
+
+At the terminal you can now run `npm run deploy` to deploy your application.

appengine/express/app.js

@@ -0,0 +1,72 @@
+// Copyright 2015, Google, Inc.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+var express = require('express');
+var path = require('path');
+var logger = require('morgan');
+var cookieParser = require('cookie-parser');
+var bodyParser = require('body-parser');
+
+var routes = require('./routes/index');
+var users = require('./routes/users');
+
+var app = express();
+
+// view engine setup
+app.set('views', path.join(__dirname, 'views'));
+app.set('view engine', 'jade');
+
+app.use(logger('dev'));
+app.use(bodyParser.json());
+app.use(bodyParser.urlencoded({ extended: false }));
+app.use(cookieParser());
+app.use(express.static(path.join(__dirname, 'public')));
+
+app.use('/', routes);
+app.use('/users', users);
+
+// catch 404 and forward to error handler
+app.use(function(req, res, next) {
+  var err = new Error('Not Found');
+  err.status = 404;
+  next(err);
+});
+
+// error handlers
+
+// development error handler
+// will print stacktrace
+if (app.get('env') === 'development') {
+  app.use(function(err, req, res) {
+    res.status(err.status || 500);
+    res.render('error', {
+      message: err.message,
+      error: err
+    });
+  });
+}
+
+// production error handler
+// no stacktraces leaked to user
+app.use(function(err, req, res) {
+  res.status(err.status || 500);
+  res.render('error', {
+    message: err.message,
+    error: {}
+  });
+});
+
+
+module.exports = app;

appengine/express/app.yaml

@@ -0,0 +1,18 @@
+# Copyright 2015, Google, Inc.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+runtime: nodejs
+api_version: 1
+vm: true
+env_variables:
+  PORT: 8080

appengine/express/bin/www

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+'use strict';
+
+/**
+ * Module dependencies.
+ */
+
+var app = require('../app');
+var debug = require('debug')('express:server');
+var http = require('http');
+
+/**
+ * Get port from environment and store in Express.
+ */
+
+var port = normalizePort(process.env.PORT || '3000');
+app.set('port', port);
+
+/**
+ * Create HTTP server.
+ */
+
+var server = http.createServer(app);
+
+/**
+ * Listen on provided port, on all network interfaces.
+ */
+
+server.listen(port);
+server.on('error', onError);
+server.on('listening', onListening);
+
+/**
+ * Normalize a port into a number, string, or false.
+ */
+
+function normalizePort(val) {
+  var port = parseInt(val, 10);
+
+  if (isNaN(port)) {
+    // named pipe
+    return val;
+  }
+
+  if (port >= 0) {
+    // port number
+    return port;
+  }
+
+  return false;
+}
+
+/**
+ * Event listener for HTTP server "error" event.
+ */
+
+function onError(error) {
+  if (error.syscall !== 'listen') {
+    throw error;
+  }
+
+  var bind = typeof port === 'string'
+    ? 'Pipe ' + port
+    : 'Port ' + port;
+
+  // handle specific listen errors with friendly messages
+  switch (error.code) {
+    case 'EACCES':
+      console.error(bind + ' requires elevated privileges');
+      process.exit(1);
+      break;
+    case 'EADDRINUSE':
+      console.error(bind + ' is already in use');
+      process.exit(1);
+      break;
+    default:
+      throw error;
+  }
+}
+
+/**
+ * Event listener for HTTP server "listening" event.
+ */
+
+function onListening() {
+  var addr = server.address();
+  var bind = typeof addr === 'string'
+    ? 'pipe ' + addr
+    : 'port ' + addr.port;
+  debug('Listening on ' + bind);
+}

appengine/express/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "express",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "start": "node ./bin/www",
+    "deploy": "gcloud preview app deploy app.yaml --set-default --project express-demo"
+  },
+  "dependencies": {
+    "body-parser": "~1.12.4",
+    "cookie-parser": "~1.3.5",
+    "debug": "~2.2.0",
+    "express": "~4.12.4",
+    "jade": "~1.9.2",
+    "morgan": "~1.5.3",
+    "serve-favicon": "~2.2.1"
+  }
+}

appengine/express/public/stylesheets/style.css

@@ -0,0 +1,21 @@
+/** Copyright 2015, Google, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+body {
+  padding: 50px;
+  font: 14px "Lucida Grande", Helvetica, Arial, sans-serif;
+}
+
+a {
+  color: #00B7FF;
+}

appengine/express/routes/index.js

@@ -0,0 +1,24 @@
+// Copyright 2015, Google, Inc.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+var express = require('express');
+var router = express.Router();
+
+/* GET home page. */
+router.get('/', function(req, res) {
+  res.render('index', { title: 'Express |2|' });
+});
+
+module.exports = router;

appengine/express/routes/users.js

@@ -0,0 +1,24 @@
+// Copyright 2015, Google, Inc.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+var express = require('express');
+var router = express.Router();
+
+/* GET users listing. */
+router.get('/', function(req, res) {
+  res.send('respond with a resource');
+});
+
+module.exports = router;