A Service Registry provides a database which applications can use in implementing the Service Discovery pattern; one of the key tenets of a microservice-based architecture. Trying to hand-configure each client of a service or adopt some form of access convention can be difficult and prove to be brittle in production. Instead, your applications can use a Service Registry to dynamically discover and call registered services.
There are several popular options for Service Registries. Netflix built and then open-sourced their own service registry, Eureka. Another relatively new, but increasingly popular option is Consul.
This repo contains various packages for interacting with Service Registries. The Pivotal.Discovery.Client provides a configurable generalized interface to Service Discovery and Registration. Currently you can use the client to work with the Spring Cloud Services Eureka Server as a Service Registry. In the near future support will be added for others.
Windows Master:
Windows Dev:
Linux/OS X Master:
Linux/OSX Dev:
The packages are intended to support both .NET 4.6.1+ and .NET Core (CoreCLR/CoreFX) runtimes. They are built and unit tested on Windows, Linux and OSX.
While the primary usage of the providers is intended to be with ASP.NET Core applications, they should also work fine with UWP, Console and ASP.NET 4.x apps.
Currently all of the code and samples have been tested on .NET Core 2.0, .NET 4.6.x, and on ASP.NET Core 2.0.0
For more information on how to use these components see the online Steeltoe documentation.
All new development is done on the dev branch. More stable versions of the packages can be found on the master branch. The latest prebuilt packages from each branch can be found on one of two MyGet feeds. Released version can be found on nuget.org.
To build and run the unit tests:
- .NET Core SDK 2.0.3 or greater
- .NET Core Runtime 2.0.3
To build the packages on windows:
- git clone ...
- cd clone directory
- cd src/project (e.g. cd src/Pivotal.Discovery.Client)
- dotnet restore
- dotnet pack --configuration Release or Debug
The resulting artifacts can be found in the bin folder under the corresponding project. (e.g. src/Pivotal.Discovery.Client/bin
To run the unit tests:
- git clone ...
- cd clone directory
- cd test/test project (e.g. cd test\Pivotal.Discovery.Client.Test)
- dotnet restore
- dotnet xunit -verbose
To build the packages on Linux/OSX:
- git clone ...
- cd clone directory
- cd src/project (e.g.. cd src/Pivotal.Discovery.Client)
- dotnet restore
- dotnet pack --configuration Release or Debug
The resulting artifacts can be found in the bin folder under the corresponding project. (e.g. src/Pivotal.Discovery.Client/bin
To run the unit tests:
- git clone ...
- cd clone directory
- cd test/test project (e.g. cd test/Pivotal.Discovery.Client.Test)
- dotnet restore
- dotnet xunit -verbose -framework netcoreapp2.0
See the Samples repo for examples of how to use these packages.