simplediscovery's Introduction

SimpleDiscovery

HttpClientFactory based client service discovery for .NET Core

NuGet Packages

Package Name	Target Framework	NuGet
SimpleDiscovery	.NET Standard 2.0
SimpleDiscovery.AzureAppConfiguration	.NET Standard 2.0
SimpleDiscovery.AzureResourceManager	.NET Standard 2.0
SimpleDiscovery.EnvironmentVariables	.NET Standard 2.0

Basic usage

1. Install nuget package

# Test use only for Azure Functions
Install-Package SimpleDiscovery.EnvironmentVariables -Pre

# Recommend
Install-Package SimpleDiscovery.AzureAppConfiguration -Pre
# or
Install-Package SimpleDiscovery.AzureResourceManager -Pre

2. Deploy Azure App Configuration

https://docs.microsoft.com/en-us/azure/azure-app-configuration/

The key name is saved as Registry:<service name>. The value sets an endpoint, such as a REST API.

3. Setup `SimpleDiscovery`

Adding AppConfiguration connection string

dotnet user-secrets set "ConnectionStrings:AppConfig" "__AzureAppConfiguration_ConnectionString__"

Register `SimpleDiscovery` to DI

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSimpleDiscovery()
                .AddAzureAppConfiguration(Configuration.GetConnectionString("AppConfig"));

        // Match the service name registered in App Configuration
        services.AddHttpClient<BuchizoService>()
                .WithSimpleDiscovery();

        services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
    }
}

4. Using HttpClientFactory

public class BuchizoController : Controller
{
    public BuchizoController(BuchizoService buchizoService)
    {
        _buchizoService = buchizoService;
    }

    private readonly BuchizoService _buchizoService;

    public async Task<IActionResult> Index()
    {
        // SimpleDiscovery automatically resolves destination host
        var response = await _buchizoService.GetSAsync("/");

        return Content(response);
    }
}