Node.js samples for Google Cloud Platform products.
See cloud.google.com/nodejs to get up and running with Node.js on Google Cloud Platform.
Table of Contents
- Client libraries
- Code samples
- Storage and Databases
- Big Data
- Machine Learning
- Management Tools
- Identity and Security
- Other sample applications
Install Node.js v4.5.0 or greater
Clone this repository:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
Change directory in to the project:
Obtain authentication credentials.
Create local credentials by running the following command and following the oauth2 flow (read more about the command here):
gcloud auth application-default login
In non-Google Cloud environments, GCE instances created without the correct scopes, or local workstations where the
gcloud beta auth application-default logincommand fails, use a service account by doing the following:
- Go to API Manager -> Credentials
- Click "New Credentials", and create a service account or click here
- Download the JSON for this service account, and set the
GOOGLE_APPLICATION_CREDENTIALSenvironment variable to point to the file containing the JSON credentials.
Note for code running on GCE, GAE, or other environments:
On Google App Engine, the credentials should be found automatically.
On Google Compute Engine, the credentials should be found automatically, but require that you create the instance with the correct scopes.
gcloud compute instances create --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/compute,https://www.googleapis.com/auth/compute.readonly" test-instance
If you did not create the instance with the right scopes, you can still upload a JSON service account and set
Read more about Google Cloud Platform Authentication.
Note for running unit tests:
Install semistandard (lint tool)
How to run a sample
Change directory to one of the sample folders, e.g.
Install the sample's dependencies (see the sample's README for details):
yarnexclusively, don't mix them.
Run the sample:
node sample_file.js [args]...
The recommended, idiomatic client for Google Cloud Platform services.
An older Node.js client library for making REST requests to Google APIs. Use this for Google Cloud APIs that are not yet supported by the Google Cloud Node.js client library.
Google App Engine
Google App Engine is a fully managed serverless application platform.
View the App Engine Node.js samples.
Google Compute Engine
Compute Engine lets you create and run virtual machines on Google infrastructure.
View the Compute Engine Node.js samples.
Google Container Engine
Container Engine: Run Docker containers on Google Cloud Platform, powered by Kubernetes.
View the Container Engine Node.js samples.
Google Cloud Functions (Beta)
Cloud Functions is a lightweight, event-based, asynchronous compute solution that allows you to create small, single-purpose functions that respond to Cloud events without the need to manage a server or a runtime environment.
View the Cloud Functions Node.js samples.
Storage and Databases
Cloud Spanner is a managed, mission-critical, globally consistent and scalable relational database service.
View the Cloud Spanner Node.js samples.
Google Cloud Datastore
Cloud Datastore is a NoSQL document database built for automatic scaling, high performance, and ease of application development.
View the Cloud Datastore Node.js samples.
Google Cloud Storage
Cloud Storage allows world-wide storage and retrieval of any amount of data at any time.
Google Cloud Storage Transfer API
The Google Cloud Storage Transfer API allows you to quickly import online data into Google Cloud Storage.
BigQuery is Google's fully managed, petabyte scale, low cost analytics data warehouse.
View the BigQuery Node.js samples.
Google Cloud Pub/Sub
Cloud Pub/Sub is a fully-managed real-time messaging service that allows you to send and receive messages between independent applications.
View the Cloud Pub/Sub Node.js samples.
Google Cloud Natural Language API
Cloud Natural Language API provides natural language understanding technologies to developers, including sentiment analysis, entity recognition, and syntax analysis. This API is part of the larger Cloud Machine Learning API.
Google Cloud Speech API (Beta)
The Cloud Speech API enables easy integration of Google speech recognition technologies into developer applications.
View the Cloud Speech API Node.js samples.
Google Translate API
With the Google Translate API, you can dynamically translate text between thousands of language pairs.
View the Translate API Node.js samples.
Google Cloud Video Intelligence API
The Cloud Video Intelligence API allows developers to use Google video analysis technology as part of their applications.
Google Cloud Vision API
The Cloud Vision API allows developers to easily integrate vision detection features within applications, including image labeling, face and landmark detection, optical character recognition (OCR), and tagging of explicit content.
View the Cloud Vision API Node.js samples.
Stackdriver Debugger makes it easier to view the application state without adding logging statements.
View the Stackdriver Debugger Node.js sample.
Stackdriver Logging allows you to store, search, analyze, monitor, and alert on log data and events from Google Cloud Platform and Amazon Web Services.
Stackdriver Monitoring collects metrics, events, and metadata from Google Cloud Platform, Amazon Web Services (AWS), hosted uptime probes, application instrumentation, and a variety of common application components including Cassandra, Nginx, Apache Web Server, Elasticsearch and many others.
Stackdriver Trace is a distributed tracing system for Google Cloud Platform that collects latency data from App Engine applications and displays it in near real time in the Google Cloud Platform Console.
View the Stackdriver Trace Node.js sample.
Google Cloud DNS
Publish your domain names using Google's infrastructure for production-quality, high-volume DNS services. Google's global network of anycast name servers provide reliable, low-latency authoritative name lookups for your domains from anywhere in the world. Read more about Google Cloud DNS.
Identity and Security
Google Cloud Key Management Service
The Data Loss Prevention API provides programmatic access to a powerful detection engine for personally identifiable information and other privacy-sensitive data in unstructured data streams.
Google Cloud Key Management Service
The Cloud KMS API is a service that allows you to keep encryption keys centrally in the cloud, for direct use by cloud services.
Other sample applications
Bookshelf tutorial app
The Bookshelf app is a sample web app written in Node.js that shows you how to use a variety of Google Cloud Platform features.
LabelCat is a NodeJS app that uses the Google Cloud Prediction API to automatically label GitHub Issues as they are created.
In the Node.js Web App Google Cloud Platform codelab, you learn how to integrate Google Cloud Platform services into a Node.js web application to store data, upload images, and authenticate users.
Contributions welcome! See the Contributing Guide.
Apache Version 2.0