mirror of https://github.com/grpc/grpc.git
The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
https://grpc.io/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
54 lines
1.7 KiB
54 lines
1.7 KiB
gRPC in 3 minutes (Ruby) |
|
======================== |
|
|
|
BACKGROUND |
|
------------- |
|
For this sample, we've already generated the server and client stubs from [helloworld.proto](https://github.com/grpc/grpc-common/blob/master/protos/helloworld.proto). |
|
|
|
PREREQUISITES |
|
------------- |
|
|
|
This requires Ruby 2.1, as the gRPC API surface uses keyword args. |
|
|
|
If you don't have that installed locally, you can use [RVM](https://www.rvm.io/) to use Ruby 2.1 for testing without upgrading the version of Ruby on your whole system. |
|
```sh |
|
$ command curl -sSL https://rvm.io/mpapis.asc | gpg --import - |
|
$ \curl -sSL https://get.rvm.io | bash -s stable --ruby=ruby-2.1 |
|
$ |
|
$ # follow the instructions to ensure that your're using the latest stable version of Ruby |
|
$ # and that the rvm command is installed |
|
``` |
|
- Make sure your run `source $HOME/.rvm/scripts/rvm` as instructed to complete the set up of RVM |
|
|
|
INSTALL |
|
------- |
|
|
|
- Clone this repository. |
|
- Follow the instructions in [INSTALL](https://github.com/grpc/grpc/blob/master/INSTALL) to install the gRPC C core. |
|
- *Temporary* Install the full gRPC distribution from source on your local machine and update path: in [Gemfile](https://github.com/grpc/grpc-common/blob/master/ruby/Gemfile) to refer src/ruby within it. |
|
- this is necessary until the gRPC ruby gem is published |
|
- Use bundler to install |
|
```sh |
|
$ # from this directory |
|
$ gem install bundler && bundle install |
|
``` |
|
|
|
Try it! |
|
------- |
|
|
|
- Run the server |
|
```sh |
|
$ # from this directory |
|
$ bundle exec ./greeter_server.rb & |
|
``` |
|
|
|
- Run the client |
|
```sh |
|
$ # from this directory |
|
$ bundle exec ./greeter_client.rb |
|
``` |
|
|
|
Tutorial |
|
-------- |
|
|
|
You can find a more detailed tutorial in [gRPC Basics: Ruby](https://github.com/grpc/grpc-common/blob/master/ruby/route_guide/README.md)
|
|
|