Cloud Functions samples.

Author: jmdobry

.jshintignore

@@ -6,5 +6,6 @@ appengine/sails/tasks/**
 appengine/sails/assets/**
 appengine/sails/api/responses/**
 appengine/webpack/dist/**
+functions/**
 **/node_modules/**
 coverage/

README.md

@@ -7,6 +7,7 @@ This repository holds Node.js samples used throughout [cloud.google.com]().
 ## Table of Contents
 
 * [Google App Engine](#google-app-engine)
+* [Google Cloud Functions](#google-cloud-functions)
 * [Google Cloud Logging](#google-cloud-logging)
 * [Google Cloud Pub/Sub](#google-cloud-pubsub)
 * [Google Cloud Storage](#google-cloud-storage)
@@ -67,10 +68,14 @@ __Other Examples__
 - Reading/writing from/to disk - [Source code][aedisk_1]
 - Serving static files - [Source code][aestaticfiles_1]
 
-## Google Cloud Datastorem
+## Google Cloud Datastore
 
 - Tasks sample - [Source code][datastore_1] | [Documentation][datastore_2]
 
+## Google Cloud Functions
+
+- Samples - [Source code][functions_1] | [Documentation][functions_2]
+
 ## Google Cloud Logging
 
 - Reading logs sample - [Source code][logging_read_1] | [Documentation][logging_read_2]
@@ -251,6 +256,9 @@ See [LICENSE](https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/ma
 [datastore_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/datastore/tasks.js
 [datastore_2]: https://cloud.google.com/datastore/docs/concepts/overview
 
+[functions_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/functions/
+[functions_2]: https://cloud.google.com/functions/docs
+
 [logging_read_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/logging/list.js
 [logging_read_2]: https://cloud.google.com/logging/docs/api/tasks/authorization
 [logging_write_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/logging/write.js

functions/helloworld/README.md

@@ -0,0 +1,19 @@
+# Google Cloud Functions Hello World! sample
+
+This sample shows a single exported function–a basic hello world example.
+
+## Deploy sample
+
+This example deploys the function with an HTTP trigger.
+
+```
+gcloud alpha functions deploy helloworld --bucket <your-bucket-name> --trigger-http
+```
+
+## Test the function
+
+```
+gcloud alpha functions call helloworld
+```
+
+Running the above command should print "Hello World!".

functions/helloworld/index.js

@@ -0,0 +1,20 @@
+// Copyright 2016, 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';
+
+// [START helloworld]
+exports.helloworld = function (context, data) {
+  context.success('Hello World!');
+};
+// [END helloworld]

functions/log/README.md

@@ -0,0 +1,17 @@
+# Google Cloud Functions message sample
+
+This sample shows writing to logs in a Cloud Function.
+
+## Deploy sample
+
+This example deploys the function with an HTTP trigger.
+
+```
+gcloud alpha functions deploy helloworld --bucket <your-bucket-name> --trigger-http
+```
+
+## Test the function
+
+```
+gcloud alpha functions call helloworld
+```

functions/log/index.js

@@ -0,0 +1,35 @@
+// Copyright 2016, 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';
+
+// [START log]
+exports.helloworld = function (context, data) {
+  console.log('I am a log entry!');
+  context.success();
+};
+// [END log]
+
+// [START walkthrough_pubsub]
+exports.hellotopic = function (context, data) {
+  console.log('My GCF Function: ' + data.message);
+  context.success();
+};
+// [END walkthrough_pubsub]
+
+// [START walkthrough_http]
+exports.hellohttp = function (context, data) {
+  // Use the success argument to send data back to the caller
+  context.success('My GCF Function: ' + data.message);
+};
+// [END walkthrough_http]

functions/message/README.md

@@ -0,0 +1,17 @@
+# Google Cloud Functions message sample
+
+This sample shows calling the `success` and `failure` callbacks.
+
+## Deploy sample
+
+This example deploys the function with an HTTP trigger.
+
+```
+gcloud alpha functions deploy helloworld --bucket <your-bucket-name> --trigger-http
+```
+
+## Test the function
+
+```
+gcloud alpha functions call helloworld
+```

functions/message/index.js

@@ -0,0 +1,29 @@
+// Copyright 2016, 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';
+
+// [START message]
+module.exports = {
+  helloworld: function (context, data) {
+    if (data.message !== undefined) {
+      // Everything is ok
+      console.log(data.message);
+      context.success();
+    } else {
+      // This is an error case
+      context.failure('No message defined!');
+    }
+  }
+};
+// [END message]

functions/module/README.md

@@ -0,0 +1,20 @@
+# Google Cloud Functions module sample
+
+This sample shows exporting a Google Cloud Function as part of a module, which
+is the method one would use to store multiple function in a single source file.
+
+## Deploy sample
+
+This example deploys the function with an HTTP trigger.
+
+```
+gcloud alpha functions deploy helloworld --bucket <your-bucket-name> --trigger-http
+```
+
+## Test the function
+
+```
+gcloud alpha functions call helloworld
+```
+
+Running the above command should print a generated UUID.

functions/module/index.js

@@ -0,0 +1,22 @@
+// Copyright 2016, 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';
+
+// [START module]
+module.exports = {
+  helloworld: function (context, data) {
+    context.success('Hello World!');
+  }
+};
+// [END module]