tree: 5684017726a09df73d7cfb27263efc3ce57c7abb [path history] [tgz]
  1. route_guide/
  2. .gitignore
  3. greeter_client.js
  4. greeter_server.js
  5. helloworld.proto
  6. package.json
  7. README.md
examples/node/README.md

gRPC in 3 minutes (Node.js)

PREREQUISITES

  • node: This requires Node 10.x or greater.
  • homebrew on Mac OS X, linuxbrew on Linux. These simplify the installation of the gRPC C core.

INSTALL

  • On Mac OS X, install homebrew. On Linux, install linuxbrew. Run the following command to install gRPC Node.js.
$ curl -fsSL https://goo.gl/getgrpc | bash -s nodejs

This will download and run the gRPC install script, then install the latest version of gRPC Nodejs npm package.

  • Clone this repository

    $ git clone https://github.com/grpc/grpc.git
    
  • Install this package's dependencies

    $ cd examples/node
    $ npm install
    

TRY IT!

  • Run the server

    $ # from this directory (grpc_common/node).
    $ node ./greeter_server.js &
    
  • Run the client

    $ # from this directory
    $ node ./greeter_client.js
    

NOTE

This directory has a copy of helloworld.proto because it currently depends on some Protocol Buffer 2.0 syntax that is deprecated in Protocol Buffer 3.0.

TUTORIAL

You can find a more detailed tutorial in gRPC Basics: Node.js