README.md

Samples

• Introduction
• Simple Discovery Sample
  • Provider
  • Consumer

Introduction

The samples show applications that can be used with the Service Registry. For any sample, make sure that you first have service discovery running:

cargo run -p service_discovery

Simple Discovery Sample

This example shows how a provider and consumer communicate, using the service registry to register and discover. The two applications then directly communicate with one another, through a known interface. You can add the same logic to your own applications to get started using Service Discovery.

The provider application consists of one gRPC service, the Hello World service. This service just logs and returns a message with "Hello, " followed by the input string from the request. The provider registers itself with the service registry, so that it can be consumed by other applications.

The consumer "discovers" the location of the Hello World service by calling discover on the service registry. The consumer then validates that the communication_kind (which can include the protocol and api specification type) and communication_reference (a string to identify the api specification) are what it expects and knows how to communicate with. Finally, the consumer calls the SayHello method on the uri provided in the discover response to use the provider directly. You will see the output of these operations in the terminal windows when you run the services.

Provider

To run the provider, open a new terminal window under the sample discovery provider directory and run:

cargo run

Consumer

To run the consumer, open a new terminal window under the sample discovery consumer directory and run:

cargo run