.NET Service Discovery & Registration

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 Steeltoe.Discovery.Eureka.Client enables using Spring Cloud Eureka Server as a Service Registry while Steeltoe.Discovery.Client provides a configurable generalized interface to Service Discovery and Registration. Normally you will want to use the Steeltoe.Discovery.Client and configure it to work with the Service Registry (i.e. Eureka, Consul) you intend to use in your app. Currently the client only supports Eureka, but in the near future we will be adding others.

Windows Master:

Windows Dev:

Linux/OS X Master:

Linux/OSX Dev:

.NET Runtime & Framework Support

The packages are intended to support both .NET 4.5.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 1.1, .NET 4.5.1/4.6.x, and on ASP.NET Core 1.1.0.

Usage

For more information on how to use these components see the online Steeltoe documentation.

Nuget Feeds

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.

Development feed (Less Stable) - https://www.myget.org/gallery/steeltoedev

Master feed (Stable) - https://www.myget.org/gallery/steeltoemaster

Release or Release Candidate feed - https://www.nuget.org/.

Building Pre-requisites

To build and run the unit tests:

1. .NET Core SDK 1.0.4 or greater
2. .NET Core Runtime 1.1

Building Packages & Running Tests - Windows

To build the packages on windows:

1. git clone ...
2. cd clone directory
3. Install .NET Core SDK
4. dotnet restore src
5. cd src\project (e.g. cd src\Steeltoe.Discovery.Client)
6. dotnet pack --configuration Release or Debug

The resulting artifacts can be found in the bin folder under the corresponding project. (e.g. src/Steeltoe.Discovery.Client/bin

To run the unit tests:

1. git clone ...
2. cd clone directory
3. Install .NET Core SDK
4. dotnet restore test
5. cd test\test project (e.g. cd test\Steeltoe.Discovery.Client.Test)
6. dotnet xunit -verbose

Building Packages & Running Tests - Linux/OSX

To build the packages on Linux/OSX:

1. git clone ...
2. cd clone directory
3. Install .NET Core SDK
4. dotnet restore src
5. cd src/project (e.g.. cd src/Steeltoe.Discovery.Client)
6. dotnet pack --configuration Release or Debug

The resulting artifacts can be found in the bin folder under the corresponding project. (e.g. src/Steeltoe.Discovery.Client/bin

To run the unit tests:

1. git clone ...
2. cd clone directory
3. Install .NET Core SDK
4. dotnet restore test
5. cd test\test project (e.g. cd test/Steeltoe.Discovery.Client.Test)
6. dotnet xunit -verbose -framework netcoreapp1.1

Sample Applications

See the Samples repo for examples of how to use these packages.