zakdances/nodejs-nvidia repository overview

⁠Google Cloud Platform Node.js Docker Image

This repository contains the source for the Google-maintained Node.js docker⁠ image. This image can be found at launcher.gcr.io/google/nodejs or gcr.io/google-appengine/nodejs and can be used as the base image for running applications on Google App Engine Flexible⁠, Google Kubernetes Engine⁠, or any other Docker host.

This image is based on Ubuntu 16.0.4 and includes nodejs⁠ and npm⁠ installed from nodejs.org⁠ and yarn⁠ installed from yarnpkg.com⁠.

For a more thorough walk through of getting started with Node.js on Google Cloud Platform, please see the documentation and guides⁠.

⁠App Engine

To generate a Dockerfile that uses this image as a base, use the Cloud SDK⁠. From your existing Node.js application:

gcloud beta app gen-config --custom

You can then modify the Dockerfile and .dockerignore as needed for you application.

⁠Kubernetes Engine and Other Docker Hosts

For other docker hosts, you'll need to create a Dockerfile based on this image that copies your application code and installs dependencies. For example:

FROM launcher.gcr.io/google/nodejs

# Copy application code.
COPY . /app/

# Install dependencies.
RUN npm --unsafe-perm install

By default, the CMD is set to npm start. You can change this by specifying your own CMD or ENTRYPOINT⁠.

For a full example on deploying an application to Google Kubernetes Engine, see this tutorial⁠.

⁠Kubernetes Configuration

This image assumes your application listens on port 8080. To run an application based on this image inside a Kubernetes pod, you can use a Pod configuration like this:

kind: Pod
metadata:
  name: app
  namespace: default
spec:
  containers:
  - image: $IMAGE_NAME
    imagePullPolicy: IfNotPresent
    name: app
    ports:
    - containerPort: 8080
  restartPolicy: Always

⁠Installing a Different Node.js Version

The image includes the install_node script that can be used to install a particular Node.js version. For example:

FROM launcher.gcr.io/google/nodejs

# Install node.js 4.6.1
RUN install_node v4.6.1

# Copy application code.
COPY . /app/

# Install dependencies.
RUN npm --unsafe-perm install

Node.js is installed with binary packages hosted on a Google-provided mirror. Before installing the specified version of Node.js, checks are performed to verify that the associated binary is an official Node.js release. The install_node script will refuse to install a binary that fails this verification.

To override this behavior, and force the installation of the binary, pass the --ignore-verification-failure flag to install_node. However, it is highly recommended that you only install Node.js binaries that have been successfully verified.

⁠Contributing changes

• See CONTRIBUTING.md⁠

⁠Licensing

• See LICENSE.md⁠