.NET Core微服务实施之Consul服务发现与治理
Consul官网:https://www.consul.io
Consul下载地址:https://www.consul.io/downloads.html
Consul nuget 命令:Install-Package Consul
我的理解是,Consul是一个服务管理者,系统中所有使用到的服务他都帮你管理好,促销高峰需要新增服务的时候,服务开启来就自动注册到Consul中,服务下线关闭,也自动从Consul注销,无缝衔接,对于使用者来说,你只需要跟Consul说我要某某某服务,Consul就会返回当前在Consul上注册的可用的服务给回你,你也无需像以前那样将服务的地址配置在系统当中,就好像DNS服务器那样,你输入域名,DNS服务器返回其中一个IP地址给你,然后你就可以正常访问, 另外在集群环境下选择服务的策略交给调用方,你可以选择随机、轮询、权重等方式,具体视乎你的需求。
一、Windows系统启动Consul
这里以Windows系统进行演示,实际项目中可以搭建在Linux上,下载到本地之后解压,使用命令行模式进入到Consul目录,输入命令启动Consul服务:
consul.exe agent -dev
启动Consul成功,命令行信息中显示,可以使用地址: http://127.0.0.1:8500 打开UI管理界面进行查看管理操作。
二、.NET Core+Consul 演示
1、新建一个ASP.NET Core Web 应用程序,nuget安装Consul:Install-Package Consul
2、增加用于Consul健康监测的Controller,这里就是一个简单的Controller、Action,能正常被访问即可。
namespace MsgService.Controllers { [Produces("application/json")] [Route("api/Health")] public class HealthController : Controller { [HttpGet] public IActionResult Get() { Console.WriteLine("健康检查" + DateTime.Now); return Content("ok"); } } }
3、修改应用程序站点的Startup类 ,在函数Configure 中增加多一个参数 IApplicationLifetime appLifeTime,然后在Configure函数中增加注册、注销的代码,这段代码的意思是,当应用程序站点启动或者注销的时候,就会对Consul进行消息通知。这里ConsulConfig方法里写死了我本机运行的Consul地址:http://127.0.0.1:8500,实际项目中肯定是要做成配置的。
//Consul 新增 IApplicationLifetime appLifeTime参数 public void Configure(IApplicationBuilder app, IHostingEnvironment env, IApplicationLifetime appLifeTime) { //注册Consul string ip = Configuration["ip"]; string port = Configuration["port"]; string serviceName = "MsgService"; string serviceId = serviceName + Guid.NewGuid(); using (var consulClient = new ConsulClient(ConsulConfig)) { AgentServiceRegistration asr = new AgentServiceRegistration { Address = ip, Port = Convert.ToInt32(port), ID = serviceId, Name = serviceName, Check = new AgentServiceCheck { DeregisterCriticalServiceAfter = TimeSpan.FromSeconds(5), HTTP = $"http://{ip}:{port}/api/Health", Interval = TimeSpan.FromSeconds(10), Timeout = TimeSpan.FromSeconds(5), }, }; consulClient.Agent.ServiceRegister(asr).Wait(); } //注销Consul appLifeTime.ApplicationStopped.Register(() => { using (var consulClient = new ConsulClient(ConsulConfig)) { Console.WriteLine("应用退出,开始从consul注销"); consulClient.Agent.ServiceDeregister(serviceId).Wait(); } }); } //Consul 配置委托 private void ConsulConfig(ConsulClientConfiguration config) { config.Address = new Uri("http://127.0.0.1:8500"); //Demo硬编码Consul的地址 config.Datacenter = "dc1"; }
4、修改应用程序站点的Program.BuildWebHost 方法,目的是方便我们在web应用程序bin目录下以指定的IP地址、指定的端口启动服务
/// <summary> /// 设置NetCore监听端口取命令行中的参数 /// </summary> /// <param name="args"></param> /// <returns></returns> public static IWebHost BuildWebHost(string[] args) { var config = new ConfigurationBuilder() .AddCommandLine(args) .Build(); string ip = config["ip"]; string port = config["port"]; Console.WriteLine($"ip={ip},port={port}"); return WebHost.CreateDefaultBuilder(args) .UseStartup<Startup>() .UseUrls($"http://{ip}:{port}") .Build(); }
5、启动服务
打开应用程序目录定位在bin目录下,使用命令行模式输入命令,以指定的IP、指定的端口启动服务, 一切正常的话,在consul管理界面可以看到已经注册上的服务信息。
这里只注册一个服务进行演示,在实际微服务项目中,肯定是集群环境的,比如同一个服务,你有4台机器,那consul上就注册了4个,服务名字都是一样的,只是URL地址不一样,当遇上促销的时候,服务压力比较大,这时候当要加多一台服务器,新的服务就自动加到consul上来,消费者就从consul取其中一个服务进行调用。
dotnet 【应用程序.dll】 --ip 127.0.0.1 --port 6001
三、服务消费
1、新建一个.NET Core 控制台应用程序;
2、nuget安装Consul组件;
3、取出已经在Consul注册的全部服务
static void Main(string[] args) { using (var consul = new Consul.ConsulClient(c => { c.Address = new Uri("http://127.0.0.1:8500"); })) { //取在Consul注册的全部服务 var services = consul.Agent.Services().Result.Response; foreach (var s in services.Values) { Console.WriteLine($"ID={s.ID},Service={s.Service},Addr={s.Address},Port={s.Port}"); } } Console.ReadKey(); } }
现在在Consul已经注册了3个MsgService服务,打印在控制台上。
4、随机从注册的服务中取出其中一个服务
当我们在consul上注册了N个相同的服务之后,我们肯定不能每次都选取某一个服务的,不然得累死那台服务,而其他服务却是空闲的状态,因此我们加入随机选取的逻辑,从注册的N个服务中,随机选取其中一个服务,另外还有其他比如轮询,权重等等的策略,使得我们更灵活的调用服务。
using (var consul = new Consul.ConsulClient(c => { c.Address = new Uri("http://127.0.0.1:8500"); //Consul地址 })) { //取出全部的MsgService服务 var services = consul.Agent.Services().Result.Response.Values.Where(p => p.Service.Equals("MsgService", StringComparison.OrdinalIgnoreCase)); //客户端负载均衡,随机选出一台服务 Random rand = new Random(); var index = rand.Next(services.Count()); var s = services.ElementAt(index); Console.WriteLine($"Index={index},ID={s.ID},Service={s.Service},Addr={s.Address},Port={s.Port}"); }
5、服务调用
//向服务发送请求 using (var httpClient = new HttpClient()) using (var httpContent = new StringContent("{phoneNum:'119',msg:'help me'}", Encoding.UTF8, "application/json")) { var result = httpClient.PostAsync($"http://{s.Address}:{s.Port}/api/SMS/Send_LX", httpContent); Console.WriteLine($"调用{s.Service},状态:{result.Result.StatusCode}"); }