go-micro使用Consul做服务发现的方法和原理

go-micro v4默认使用mdns做服务发现。不过也支持采用其它的服务发现中间件,因为多年来一直使用Consul做服务发现,为了方便和其它服务集成,所以还是选择了Consul。这篇文章将介绍go-micro使用Consul做服务发现的方法。关于Consul的使用方式请参考我的另一篇文章:使用Consul做服务发现的若干姿势

安装Consul

如果你已经安装Consul,或者对Consul很熟悉了,按照自己的方式处理Consul就行了。

这里提供一个通过docker快速安装Consul的方式,当然前提是你得安装了docker。

执行命令:

docker run --name consul1 -p 8500:8500 -p 8300:8300 -p 8301:8301 -p 8302:8302  -d consul:latest

这会在docker容器中启动一个最新版本的Consul服务,并将相关端口开放给主机。

安装Consul插件

使用Consul作为服务注册和服务发现,需要先安装go-micro的consul插件:

go get github.com/go-micro/plugins/v4/registry/consul

服务端使用Consul

服务注册

为了使用Consul做服务注册,需要为go-micro server显式的指定Consul Registry。直接看代码吧:

func main() {

    registry := consul.NewRegistry()

    rpcServer := server.NewServer(
        server.Name("registry-consul.service"),
        server.Address("0.0.0.0:8001"),
        server.Registry(registry),
    )

    proto.RegisterHelloHandler(rpcServer, &Hello{})

    service := micro.NewService(
        micro.Server(rpcServer),
    )

    service.Init()

    // Run server
    if err := service.Run(); err != nil {
        log.Fatal(err)
    }
}

通过 consul.NewRegistry() 创建一个Consul 注册中心,然后使用 server.NewServer 创建Server的时候把它设置进去;同时我们需要指定服务的名称,这里设置的是 registry-consul.service;另外这里不使用随机端口,指定了一个服务的监听地址。这样基本就OK了。

img

这里并没有指定Consul的连接地址,因为按照推荐的Consul部署方式,服务所在机器或者容器中应该部署一个Consul的客户端,程序可以直接通过 127.0.0.1:8500 访问到它。如果要显示指定,可以在NewRegistry时设置:

    registry := consul.NewRegistry(
        registry.Addrs("127.0.0.1:8500"),
    )

注册过程

通过一张图来看一下,go-micro注册服务到Consul时都做了什么。

img

服务注册关键是实现两个动作:

1、注册: rpcServer启动的时候,会调用到自身的Register方法,Register方法会调用consul插件的Register方法,然后调用到consul自身SDK提供的Agent.ServiceRegister方法,将服务注册到Consul中。注册的服务名称就是NewServer时的server.Name。

2、健康上报: 即刷新TTL,服务注册成功后,会启动一个定时器定时调用consul插件的Register方法,这个方法内部判断服务注册过,则会调用consul自身SDK提供的Agent.PassTTL方法,刷新Consul中对应服务的TTL。

健康检查

go-micro服务的健康状态是通过TTL维护的,服务需要定时去刷新TTL,如果TTL超过指定的时间没有被刷新,则服务会被认为是不健康的。默认情况下有三个设置会涉及到TTL,还是先来看代码:

registry := consul.NewRegistry()

    regCheckFunc := func(ctx context.Context) error {
        fmt.Println(time.Now().Format("2006-01-02 15:04:05") + " do register check")
        if 1+1 == 2 {
            return nil
        }
        return errors.New("this not earth")
    }

    rpcServer := server.NewServer(
        server.Name("registry-consul.service"),
        server.Address("0.0.0.0:8001"),
        server.Registry(registry),
        server.RegisterCheck(regCheckFunc),
        server.RegisterInterval(10*time.Second),
        server.RegisterTTL(20*time.Second),
    )

    proto.RegisterHelloHandler(rpcServer, &Hello{})

    service := micro.NewService(
        micro.Server(rpcServer),
    )

    //service.Init()

    if err := service.Run(); err != nil {
        log.Fatal(err)
    }

关于这三个设置,这里简单介绍下:

**1、server.RegisterCheck(regCheckFunc) ** 服务刷新TTL之前,会调用一个函数检查服务的状态,这个函数的返回值是error类型。默认的函数不进行任何检查,直接返回nil,代表服务状态正常;我们可以自己写一个函数,进行一些检查逻辑,比如是否要下线维护。如果返回的error不是nil,go-micro会尝试在Consul中注销服务,则调用方将不会再访问到这个服务节点。

2、server.RegisterInterval(10*time.Second) 这个设置指定程序去刷新TLL的频率。

3、server.RegisterTTL(20*time.Second) 这个设置指定TTL的生存周期,如果超过这个时间没有刷新TTL,则Consul会认为服务是不健康。

另外需要注意不要使用service.Init(),因为这里边会覆盖 RegisterIntervalRegisterTTL 的设置,除非你不关心这两个参数。关于这个问题可以参考:https://github.com/asim/go-micro/issues/2488

客户端使用Consul

调用服务

为了使用Consul做服务发现,需要为go-micro service显式的指定Consul Registry。还是直接看代码:

    registry := consul.NewRegistry()

    service := micro.NewService(
        micro.Client(client.NewClient()),
        micro.Registry(registry),
    )

    service.Init()
    client := proto.NewHelloService("registry-consul.service", service.Client())

    rsp, err := client.Say(context.TODO(), &proto.SayRequest{Name: "BOSSMA"})
    if err != nil {
        fmt.Println(err)
    }

    fmt.Println(rsp)

代码很简单,指定consul作为服务发现组件后,调用服务的时候传递的服务名称就会使用consul进行解析,获取到IP、端口后,再进行实际调用。

发现过程

还是先来看张图,从调用 XXXService 的方法 YYY 开始:

e6c9d24ely1h1lmywl9pwj20u014zgp4.jpeg

整个过程分为两个大的步骤,第一步获取要调用服务的地址,第二步通过http请求调用服务。我们重点看第一步通过Consul获取服务这块。

首先进入一个Selector,就是选择器的意思。Selector首先看缓存中有没有缓存请求服务的地址信息,如果没有就去Consul查询,查询到之后再通过指定的选择策略选出来一个地址,用于后续http请求。这里默认的选择策略是随机选择,比如查询到这个服务有三个部署节点,随机策略会随机返回其中某一个地址。

除了随机策略,go-micro还提供了一个轮询策略,这时候需要自己创建一个Selector:

    registry := consul.NewRegistry()
    selector := selector.NewSelector(
        selector.SetStrategy(selector.RoundRobin),
        selector.Registry(registry),
    )

    service := micro.NewService(
        micro.Client(client.NewClient()),
        micro.Selector(selector),
        //micro.Registry(registry),
    )

另外从上面的示意图中,我们可以看到Selector调用了Registry,所以这里创建Selector的时候,我们把Registry设置了进去,然后再把创建的Selector设置到Service中。其实还有另一种方式,把设置Registry放到设置Selector后边,同样可以把Registry注册到Selector中,但是这样比较隐晦,还需要注意设置顺序,我不推荐。不过如果在Selector之外需要使用Registry的时候,还是需要使用micro.Registry(registry)进行注册,这个例子中并没有相关场景。

效果展示

先启动服务端,然后启动客户端,截图如下:

img

以上就是本文的主要内容,如有错漏欢迎反馈。

演示代码已上传到Github:https://github.com/bosima/go-demo/tree/main/go-micro-registry-consul

收获更多架构知识,请关注公众号 萤火架构。原创内容,转载请注明出处。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,602评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,442评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,878评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,306评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,330评论 5 373
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,071评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,382评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,006评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,512评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,965评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,094评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,732评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,283评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,286评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,512评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,536评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,828评论 2 345

推荐阅读更多精彩内容