James NugentandGitHub
da92dbf8aa
This commit adds a new crate `tonic-health` which implements the [standard GRPC Health Checking][checking] protocol. Currently there is only a server implementation, though others have alluded in the discussion in #135 that client implementations exist which could also be imported as necessary. A example server has also been added - once the client work is done a client for this should be added also. [checking]: https://github.com/grpc/grpc/blob/master/doc/health-checking.md Fixes #135.
92 lines
1.1 KiB
Markdown
92 lines
1.1 KiB
Markdown
# Examples
|
|
|
|
Set of examples that show off the features provided by `tonic`.
|
|
|
|
## Helloworld
|
|
|
|
### Client
|
|
|
|
```bash
|
|
$ cargo run --bin helloworld-client
|
|
```
|
|
|
|
### Server
|
|
|
|
```bash
|
|
$ cargo run --bin helloworld-server
|
|
```
|
|
|
|
## RouteGuide
|
|
|
|
### Client
|
|
|
|
```bash
|
|
$ cargo run --bin routeguide-client
|
|
```
|
|
|
|
### Server
|
|
|
|
```bash
|
|
$ cargo run --bin routeguide-server
|
|
```
|
|
|
|
## Authentication
|
|
|
|
### Client
|
|
|
|
```bash
|
|
$ cargo run --bin authentication-client
|
|
```
|
|
|
|
### Server
|
|
|
|
```bash
|
|
$ cargo run --bin authentication-server
|
|
```
|
|
|
|
## Load balance
|
|
|
|
### Client
|
|
|
|
```bash
|
|
$ cargo run --bin load-balance-client
|
|
```
|
|
|
|
### Server
|
|
|
|
```bash
|
|
$ cargo run --bin load-balance-server
|
|
```
|
|
|
|
## TLS (rustls)
|
|
|
|
### Client
|
|
|
|
```bash
|
|
$ cargo run --bin tls-client
|
|
```
|
|
|
|
### Server
|
|
|
|
```bash
|
|
$ cargo run --bin tls-server
|
|
```
|
|
|
|
## Health Checking
|
|
|
|
### Server
|
|
|
|
```bash
|
|
$ cargo run --bin health-server
|
|
```
|
|
|
|
### Notes:
|
|
|
|
If you are using the `codegen` feature, then the following dependencies are
|
|
**required**:
|
|
|
|
* [bytes](https://crates.io/crates/bytes)
|
|
* [prost](https://crates.io/crates/prost)
|
|
* [prost-derive](https://crates.io/crates/prost-derive)
|
|
|