Jayant Kolhe 0718d2b38e Merge pull request #225 from tbetbetbe/grpc-nodejs-update-helloworld-install 10 years ago
..
route_guide 5e01a41855 added link to new public proto3 doc 10 years ago
.gitignore e89af55a86 Added node hello world example 10 years ago
README.md f7bdd61693 Updates the INSTALL nodejs helloworld 10 years ago
greeter_client.js e89af55a86 Added node hello world example 10 years ago
greeter_server.js 3440548d83 revert js changes. 10 years ago
helloworld.proto 600d70cd8d change proto README cpp node ruby 10 years ago
package.json 9e75610c13 update node grpc package dependencies 10 years ago

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-common.git
    
  • Install this package's dependencies

    $ cd grpc-common/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