go微服务系列(一) - go micro入门

• 1. 什么是go micro
  • 1.1 go micro作用
  • 1.2 go micro架构组成
• 2. go micro入门
• 3. 结合consul进行服务注册/发现
  • 3.1 consul的安装
  • 3.2 服务注册代码示例
  • 3.2 服务发现代码示例

1. 什么是go micro

1.1 go micro作用

它是一个可插入的RPC框架，用于在Go中编写微服务。开箱即用，您将收到：

• 服务发现: 应用程序自动注册到服务发现系统
• 负载平衡: 客户端负载平衡，用于平衡服务实例之间的请求
• 同步通信: 提供请求 / 响应传输层。
• 异步通信: 内置发布 / 订阅功能。
• 消息编码: 基于消息的内容类型头的编码 / 解码。
• RPC 客户机/服务器包: 利用上述功能并公开接口来构建微服务

1.2 go micro架构组成

Go 微体系结构可以描述为三层堆栈

顶层由客户端-服务器模型和服务抽象组成。

• 服务器: 用于编写服务的构建块
• 客户端: 提供了向服务请求的接口。

底层由以下类型的插件组成：

• 代理: 为异步发布/订阅通信提供消息代理的接口。
• 编解码器: 用于编码/解码消息。支持的格式包括 json，bson，protobuf，msgpack 等。
• 注册表: 提供服务发现机制(默认为 Consul)
• 选择器: 建立在注册表上的负载平衡抽象。它允许使用诸如随机，轮循，最小康等算法来 “选择” 服务。
  传输 - 服务之间同步请求 / 响应通信的接口。
• Go Micro还提供了Sidecar等功能。这使您可以使用Go以外的语言编写的服务

Sidecar提供服务注册，gRPC编码/解码和HTTP处理程序。它支持多种语言。

2. go micro入门

最简单的用法大概如下，结合net/http标准库监听路由

package main

import (
	"github.com/micro/go-micro/web"
	"net/http"
)

func main() {

	server := web.NewService(web.Address(":8081")) // 路由
	server.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("hello go micro"))
	})
	_ = server.Run()
}

也可以集成第三方web框架作为路由

• 比如gin

package main

import (
	"net/http"

	"github.com/gin-gonic/gin"
	"github.com/micro/go-micro/web"
)

func main() {
    // 使用gin作为路由
	r := gin.Default()
	r.GET("/user", func(c *gin.Context) {
		c.String(http.StatusOK, "user api")
	})

	server := web.NewService(
		web.Address(":8081"),                                // 端口
		web.Metadata(map[string]string{"protocol": "http"}), // 元信息
		web.Handler(r)) // 路由
		
	_ = server.Run()
}

3. 结合consul进行服务注册/发现

微服务里最重要的关键一步就是服务注册

常用的有consul、etcd、zookeeper、eureka

我们这里使用consul

3.1 consul的安装

这里直接使用docker安装

docker run -d --name=cs -p 8500:8500 consul agent -server -bootstrap -ui -client 0.0.0.0

然后再访问端口8500，如下现实安装成功

3.2 服务注册代码示例

github.com/micro/go-micro/registry/consul
上面这个在1.14.0版本之后删除了，要用这个github.com/micro/go-plugins/registry/consul，或者换成etcd作为注册中心

package main

import (
	"net/http"

	"github.com/gin-gonic/gin"
	"github.com/micro/go-micro/registry"
	"github.com/micro/go-micro/web"
	"github.com/micro/go-plugins/registry/consul"
)

func main() {
    // 添加consul地址
	cr := consul.NewRegistry(
		registry.Addrs("127.0.0.1:8500"))
    
    // 使用gin作为router
	router := gin.Default()
	router.GET("/user", func(c *gin.Context) {
		c.String(http.StatusOK, "user api")
	})
    
    // 初始化go micro
	server := web.NewService(
		web.Name("productService"),                          // 当前微服务服务名
		web.Registry(cr),                                    // 注册到consul
		web.Address(":8081"),                                // 端口
		web.Metadata(map[string]string{"protocol": "http"}), // 元信息
		web.Handler(router)) // 路由

	_ = server.Run()
}

把上述代码运行起来，再去consul界面查看，发现productService服务添加成功

然后把代码停掉，再去consul界面查看，productService就没了，非常方便

3.2 服务发现代码示例

package main

import (
	"fmt"
	"log"

	"github.com/micro/go-micro/client/selector"
	"github.com/micro/go-micro/registry"
	"github.com/micro/go-plugins/registry/consul"
)

func main() {
	// 1.连接到consul
	cr := consul.NewRegistry(registry.Addrs("127.0.0.1:8500"))

	// 2.根据service name获取对应的微服务列表
	services, err := cr.GetService("productService")
	if err != nil {
		log.Fatal("cannot get service list")
	}

	// 3.使用random随机获取其中一个实例
	next := selector.Random(services)
	svc, err := next()
	if err != nil {
		log.Fatal("cannot get service")
	}

	fmt.Println("[测试输出]:", svc.Id, svc.Address, svc.Metadata)
}

然后使用goland先启动服务注册中的productService的微服务，再启动服务发现中的代码。

服务发现将会输出如下，服务发现成功：