Go 服务注册--consul

最新推荐文章于 2025-04-23 18:14:01 发布

转载最新推荐文章于 2025-04-23 18:14:01 发布 · 528 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://blog.youkuaiyun.com/qq_29632499/article/details/94621624

go 专栏收录该内容

27 篇文章

订阅专栏

本文介绍如何使用Consul作为注册中心，并结合micro工具实现微服务间的通信。包括安装配置Consul、micro及goprotobuf工具，编写Hello服务的API定义、服务器端与客户端代码，最终实现点对点通信。

转自：https://blog.youkuaiyun.com/qq_29632499/article/details/94621624

此文详细介绍使用consul作为注册中心，实现两个服务之间的通信，这里只用了点到点通信。

1 .安装consul - 注册中心

服务注册中心我们选择consul：

mac：brew install consul

windows：直接官网下载consul.exe可执行程序

运行consul：启动Consul agent的开发模式：

consul agent -dev

该命令快速启动一个单节点的consul，且为集群的领袖

查看Consul集群的成员：打开另一个终端执行：

consul members

也可以通过WebUI来查看各service状态：http://localhost:8500/

2 安装micro：微服务管理工具

micro是以go-micro框架为核心的微服务管理工具，通过它可以方便查看go-micro服务情况。

在$GOPATH目录下，执行

go get github.com/micro/micro

该命令会在bin目录（$GOBIN）下生成micro(.exe)工具
micro命令行工具可以提供诸如服务列表查看、服务详情查看、调用服务接口等功能。

3 安装goprotobuf相关工具：GRPC相关工具

protoc：Protobuf（Protocol Buffers - Google's data interchange format）编译器：
- windows下直接下载相关win的zip压缩文件（内含protoc.exe）
- mac： brew install protobuf
protoc-gen-go：goprotobuf 提供的 Protobuf 插件：在$GOPATH目录下执行go get github.com/micro/protobuf/{proto,protoc-gen-go}，该命令会在bin目录下生成protoc-gen-go(.exe)工具，protoc编译器利用protoc-gen-go插件将.proto文件转换为Golang源文件
protoc-gen-micro（Protobuf code generation for micro）：在$GOPATH目录下执行go get github.com/micro/protoc-gen-micro，该命令会在bin目录下生成protoc-gen-micro(.exe)，protoc编译器利用protoc-gen-micro插件将.proto文件转换为micro代码风格文件

goprotobuf编译参数：

-I参数：指定import路径，可以指定多个-I参数，编译时按照顺序查找，不指定时默认查找当前目录
--go_out：Golang编译支持，支持以下参数
```
 
```
1. - `plugins=plugin1+plugin2`：指定插件，支持grpc/micro，即：plugins=grpc+micro
2. - `M`参数：指定导入的.proto文件路径编译后对应的goalng包名（不指定默认.proto文件中import语句路径）
3. - `import_prefix=xxx`：为所有import路径添加前缀，主要用于编译子目录内的多个proto文件
4. - `import_path=foo/bar`：指定未声明package或go_package的文件的包名，最右边的斜线前的字符会被忽略

4 编写一个简单的Hello服务

至此，go-micro框架的编程环境已基本搭建好，接下来就是写代码了。

下面实现一个Hello服务：它接收一个字符串类型参数请求，返回一个字符串问候语：Hello 『参数值』。
1）定义API

创建helloworld/helloworld.proto文件：
使用protobuf文件来定义服务API接口

// The greeting service definition.
service Hello {
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
// The request message containing the user's name.
message HelloRequest {
string name = 1;
}
// The response message containing the greetings
message HelloReply {
string message = 1;
}

执行protoc命令，生成当前pb文件的go实现：

protoc  --micro_out=. --go_out=. ./helloworld/helloworld.proto

生成文件如下：

2）创建server

创建server/main.go文件：

package main
import (
proto "awesomeProject/helloworld"
"context"
"fmt"
"github.com/micro/go-micro"
"github.com/micro/go-micro/registry"
"github.com/micro/go-micro/registry/consul"
)
type Server struct {
}
func (s *Server) SayHello(ctx context.Context, in *proto.HelloRequest, res *proto.HelloReply) error {
fmt.Printf("%s", in.Name)
res.Message="I am a server"
return nil
}
func main() {
reg:=consul.NewRegistry(func(options *registry.Options) {
options.Addrs=[]string{"127.0.0.1:8500",}
})
service := micro.NewService(
micro.Registry(reg),
micro.Name("helloworldServer001"), // 服务名称
)
service.Init()
proto.RegisterHelloHandler(service.Server(), new(Server))
if err := service.Run(); err != nil {
fmt.Println(err)
}
}

3)模拟client

创建client/main.go文件：

package main
import (
proto "awesomeProject/helloworld"
"context"
"fmt"
"github.com/micro/go-micro"
"github.com/micro/go-micro/registry"
"github.com/micro/go-micro/registry/consul"
)
const ADDRESS = "localhost:50051"
func main() {
reg:=consul.NewRegistry(func(options *registry.Options) {
options.Addrs=[]string{
"127.0.0.1:8500",
}
})
service := micro.NewService(micro.Registry(reg),micro.Name("hello.client"))
service.Init()
helloService := proto.NewHelloService("helloworldServer001", service.Client())
res, err := helloService.SayHello(context.TODO(), &proto.HelloRequest{Name: "hellow ，I am Client--001"})
if err != nil {
fmt.Println(err)
}
fmt.Println("----->"+res.GetMessage())
}

5 运行Hello服务

启动consul
执行go run server/main.go命令，启动服务：

>go run server/main.go
2019/07/04 16:06:09 Transport [http] Listening on [::]:62381
2019/07/04 16:06:09 Broker [http] Connected to [::]:62382
2019/07/04 16:06:09 Registry [consul] Registering node: helloworldServer001-4ae1c14d-598f-4542-9fb3-cb295d9f00e6

3. 通过浏览器输入再次输入：http://localhost:8500, 查看当前已有服务：

4. 请求服务执行 go run client/main.go

客户端如下：接受到服务端返回I am server

服务端显示如下：