aboutsummaryrefslogtreecommitdiffhomepage
path: root/examples/node/README.md
diff options
context:
space:
mode:
authorGravatar Tim Emiola <tbetbetbe@users.noreply.github.com>2015-08-27 15:26:45 -0700
committerGravatar Tim Emiola <tbetbetbe@users.noreply.github.com>2015-08-27 15:26:45 -0700
commit1029e7049cea55a8880b8fe9167bd3f0e483b037 (patch)
tree4c4e0d614b98be379581f121ab664b4c5196c7d1 /examples/node/README.md
parent60ff5c3c872b9630e256772c0440a169c7cfae10 (diff)
parent43f1bf84aae3c753f1b797227e13075891431a56 (diff)
Merge pull request #3109 from stanley-cheung/move_grpc_common_examples_here
Move grpc common examples here
Diffstat (limited to 'examples/node/README.md')
-rw-r--r--examples/node/README.md60
1 files changed, 60 insertions, 0 deletions
diff --git a/examples/node/README.md b/examples/node/README.md
new file mode 100644
index 0000000000..045fe51ede
--- /dev/null
+++ b/examples/node/README.md
@@ -0,0 +1,60 @@
+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.
+
+ ```sh
+ $ 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
+
+ ```sh
+ $ git clone https://github.com/grpc/grpc.git
+ ```
+
+ - Install this package's dependencies
+
+ ```sh
+ $ cd examples/node
+ $ npm install
+ ```
+
+TRY IT!
+-------
+
+ - Run the server
+
+ ```sh
+ $ # from this directory (grpc_common/node).
+ $ node ./greeter_server.js &
+ ```
+
+ - Run the client
+
+ ```sh
+ $ # 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][]
+
+[homebrew]:http://brew.sh
+[linuxbrew]:https://github.com/Homebrew/linuxbrew#installation
+[gRPC install script]:https://raw.githubusercontent.com/grpc/homebrew-grpc/master/scripts/install
+[gRPC Basics: Node.js]:https://github.com/grpc/grpc/blob/master/examples/node/route_guide/README.md