Nanophone

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #llm #linux #java #windows #awesome #cli #kubernetes #pytorch #mcp #openai

(★ 25)

Nanophone is a minimalistic library for Service Registration and Discovery and is the driving force behind the Equalizer middleware for aspnetcore.

Nanophone Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Icon](http://i.imgur.com/WnKfKOC.png?1) 
# Nanophone 
[![Build status](https://ci.appveyor.com/api/projects/status/hwk6g88wm7orvcog?svg=true)](https://ci.appveyor.com/project/lvermeulen/nanophone) [![license](https://img.shields.io/github/license/lvermeulen/Nanophone.svg?maxAge=2592000)](https://github.com/lvermeulen/Nanophone/blob/master/LICENSE) [![NuGet](https://img.shields.io/nuget/vpre/Nanophone.Core.svg?maxAge=2592000)](https://www.nuget.org/packages/Nanophone.Core/) [![Coverage Status](https://coveralls.io/repos/github/lvermeulen/Nanophone/badge.svg?branch=master)](https://coveralls.io/github/lvermeulen/Nanophone?branch=master) [![codecov](https://codecov.io/gh/lvermeulen/Nanophone/branch/master/graph/badge.svg)](https://codecov.io/gh/lvermeulen/Nanophone)
 [![Join the chat at https://gitter.im/lvermeulen/Nanophone](https://badges.gitter.im/lvermeulen/Nanophone.svg)](https://gitter.im/lvermeulen/Nanophone?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) ![](https://img.shields.io/badge/.net-4.5.1-yellowgreen.svg) ![](https://img.shields.io/badge/netstandard-1.6-yellowgreen.svg)
Nanophone is a minimalistic library for Service Registration and Discovery and is used by the [Equalizer](https://github.com/lvermeulen/Equalizer) middleware for aspnetcore.

## Features:
* Find available service instances by service name
* Find available service instances by service name and version (**strict semver 2.0**)
* Extensible service registry host - includes [Consul](https://www.consul.io/) and in-memory hosts
* Extensible service registry tenants - includes [Nancy](https://github.com/NancyFx/Nancy) and Web Api tenants
* Supports [eBay Fabio](https://github.com/eBay/fabio)
* Configuration provider for aspnetcore to use Consul key/value store
* Application services for aspnetcore to add tenants and health checks

## Usage:

* Find available service instances by service name:
~~~~
using System.Threading.Tasks;
using Nanophone.Core;
using Nanophone.RegistryHost.ConsulRegistry;

var serviceRegistry = new ServiceRegistry();
serviceRegistry.StartClient(new ConsulRegistryHost());

var instances = serviceRegistry.FindServiceInstancesAsync("my-service-name").Result;
foreach (var instance in instances)
{
    Console.WriteLine($"Address: {instance.Address}:{instance.Port}, Version: {instance.Version}");
}
~~~~

* Find available service instances by service name and version (**strict semver 2.0**):
~~~~
using System.Threading.Tasks;
using Nanophone.Core;
using Nanophone.RegistryHost.ConsulRegistry;

var serviceRegistry = new ServiceRegistry();
serviceRegistry.StartClient(new ConsulRegistryHost());

var instances = serviceRegistry.FindServiceInstancesWithVersionAsync("my-service-name", ">=1.2.0 <3.2.0").Result;
foreach (var instance in instances)
{
    Console.WriteLine($"Address: {instance.Address}:{instance.Port}, Version: {instance.Version}");
}
~~~~
**NOTE**: A full semver-compliant version is **required**. This means that e.g. "2.1" is not a valid version, and "2.1.0" or "2.1.1-beta2" are valid versions.

* Start Nancy service:
~~~~
using Nanophone.Core;
using Nanophone.RegistryHost.ConsulRegistry;
using Nanophone.RegistryTenant.Nancy;

var serviceRegistry = new ServiceRegistry();
serviceRegistry.AddTenant(new NancyRegistryTenant(new Uri("http://localhost:9001")), new ConsulRegistryHost(),
    "customers", "1.3.3");
~~~~

* Start Web Api service:
~~~~
using Microsoft.Owin.Hosting;
using Nanophone.Core;
using Nanophone.RegistryHost.ConsulRegistry;
using Nanophone.RegistryTenant.WebApi;

string url = "http://localhost:9000/";

var serviceRegistry = new ServiceRegistry();
serviceRegistry.AddTenant(new WebApiRegistryTenant(new Uri(url)), new ConsulRegistryHost(), 
    "date", "1.7.0-pre");

WebApp.Start<Startup>(url);
~~~~

* Configuration provider for aspnetcore:
~~~~
var config = new ConfigurationBuilder()
    .AddNanophoneKeyValues(() => new ConsulRegistryHost())
    .Build();

string value = new WebHostBuilder()
    .UseConfiguration(config)
    .GetSetting("my_key");
~~~~

* Application services for aspnetcore:
~~~~
var hostBuilder = new WebHostBuilder()
    .ConfigureServices(services =>
    {
        services.AddNanophone(() => new ConsulRegistryHost());
    })
    .Configure(app =>
    {
        app.AddTenant(new WebApiRegistryTenant(new Uri("http://localhost:1234")), nameof(MyService), "1.0.0");

var serviceRegistry = app.ApplicationServices.GetService<ServiceRegistry>();
        var instances = await serviceRegistry.FindServiceInstancesAsync(nameof(MyService));
    });
~~~~

## Thanks
* [SIM Card](https://thenounproject.com/term/sim-card/15160) icon by misirlou from [The Noun Project](https://thenounproject.com)
* Look, up in the sky. It's a bird. It's a plane. It's [LibLog](https://www.nuget.org/packages/LibLog/)!

Nanophone

Nanophone Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Nanophone

Nanophone Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README