![1.png](https://ucc.alicdn.com/pic/developer-ecology/514aac62e26c4fa49807767187eae178.png)

作者 | 張斌斌

> **導讀**：本文主要介紹如何使用 Golang 生態中的微服務框架 Go-Micro(v2) 整合 Nacos 進行服務註冊與發現。(Go-Micro 目前已經是 v3 版本，但由於某些原因專案已經更名為 nitro 具體原因大家可以去 github 中檢視。)

# 相關背景知識

## 1. Go-Micro

Go Micro 是一個基於 Go 語言編寫的、用於構建微服務的基礎框架，提供了分散式開發所需的核心元件，包括 RPC 和事件驅動通訊等。

它的設計哲學是「可插拔」的外掛化架構，其核心專注於提供底層的介面定義和基礎工具，這些底層介面可以相容各種實現。例如 Go Micro 預設透過 consul 進行服務發現，透過 HTTP 協議進行通訊，透過 protobuf 和 json 進行編解碼，以便你可以基於這些開箱提供的元件快速啟動，但是如果需要的話，你也可以透過符合底層介面定義的其他元件替換預設元件，比如透過 nacos, etcd 或 zookeeper 進行服務發現，這也是外掛化架構的優勢所在：不需要修改任何底層程式碼即可實現上層元件的替換。

### 1）Micro 概述

Micro 是一個微服務工具包，包括：

- **API**

提供並將 HTTP 請求路由到相應微服務的 API 閘道器。它充當微服務訪問的單一入口，將 HTTP 請求轉換為 RPC 並轉發給相應的服務也可以用作反向代理。

![2.png](https://ucc.alicdn.com/pic/developer-ecology/62ea185c1cbe4f38ba0c1b84133294dd.png)

- **Web**

UI 是 go-micro 的 web 版本，允許透過 UI 互動訪問環境。在未來，它也將是一種聚合微型 Web 服務的方式。它包含一種 Web 應用程式的代理方式。將 /[name] 透過登錄檔路由到相應的服務。Web UI 將字首“go.micro.web。”（可以配置）新增到名稱中，在登錄檔中查詢它，然後將進行反向代理。

![3.png](https://ucc.alicdn.com/pic/developer-ecology/f7521cc69d0c449eb100d119e51c3385.png)

- **Sidecar**

go-micro 的 HTTP 介面版本，這是將非 Go 應用程式整合到微環境中的一種方式。

![4.png](https://ucc.alicdn.com/pic/developer-ecology/37c2c21669524a02ab3b19ecb545cec9.png)

- **Bot**

Hubot 風格的 bot，位於您的微服務平臺中，可以透過 Slack，HipChat，XMPP 等進行互動。它透過訊息傳遞提供 CLI 的功能。可以新增其他命令來自動執行常見的操作任務。

![5.png](https://ucc.alicdn.com/pic/developer-ecology/83df5421edd04fd589a378d8d5f51bb0.png)

- **CLI**

一個直接的命令列介面來與你的微服務進行互動，它提供了一種觀察和與執行環境互動的方式。

### 2）Go-Micro 元件

用於在 Go 中編寫微服務的外掛式 RPC 框架。它提供了用於服務發現，客戶端負載平衡，編碼，同步和非同步通訊庫。go-micro 是一個獨立的庫，可以獨立於其他工具包使用。

![6.png](https://ucc.alicdn.com/pic/developer-ecology/c2807b53a45f4783961858e046421fcf.png)

go-micro 是元件化的框架，每一個基礎功能都是一個 interface ，方便擴充套件。同時，元件又是分層的，上層基於下層功能向上提供服務，整體構成 go-micro 框架。go-micro 框架的構成元件有：

- **Registry**

提供服務發現機制：解析服務名字至服務地址。目前支援的註冊中心有 consul、etcd、 zookeeper、dns、gossip 等。

- **Selector**

選擇器透過選擇提供負載均衡機制。當客戶端向伺服器發出請求時，它將首先查詢服務的登錄檔。這通常會返回一個表示服務的正在執行的節點列表。選擇器將選擇這些節點中的一個用於查詢。多次呼叫選擇器將允許使用平衡演算法。目前的方法是迴圈法，隨機雜湊和黑名單。

- **Broker**

釋出和訂閱的可插入介面，服務之間基於訊息中介軟體的非同步通訊方式，預設使用 http 方式，線上通常使用訊息中介軟體，如 Nats、Kafka、RabbitMQ 和 http（用於開發）。

- **Transport**

透過點對點傳輸訊息的可插拔介面。目前的實現是 http，rabbitmq 和 nats 。透過提供這種抽象，運輸可以無縫地換出。

- **Codec**

服務之間訊息的編碼/解碼。

- **Plugins**

提供 go-micro 的 micro/go-plugins 外掛。

- **Server**

伺服器是構建正在執行的微服務的介面。它提供了一種提供 RPC 請求的方法。該元件基於上面的 Registry/Selector/Transport/Broker 元件，對外提供一個統一的服務請求入口。

- **Client**

提供一種製作 RPC 查詢的方法訪問微服務的客戶端。它結合了登錄檔，選擇器，代理和傳輸。它還提供重試，超時，使用上下文等。類似 Server 元件，它也是透過 Registry/Selector/Transport/Broker 元件實現查詢1服務、負載均衡、同步通訊、非同步訊息等功能。
## 2. Nacos

Nacos 是一個更易於構建雲原生應用的動態服務發現、配置管理和服務管理的平臺，Nacos 脫胎於阿里巴巴內部的 ConfigServer 和 Diamond ，是它們的開源實現。經歷過雙十一流量峰值和阿里巴巴經濟體超大規模容量的考驗，沉澱了阿里巴巴軟負載團隊在這個領域十年的經驗，在穩定性和功能性上都有很好的保障。

Nacos 邏輯架構及其元件概覽圖：

![7.png](https://ucc.alicdn.com/pic/developer-ecology/21d0364ccd9d495eb0f5c352ea5f6ba4.png)

# 快速開始

## 1. Go-Micro 服務端

### 1）安裝 protoc

Protobuf 是 Protocol Buffers 的簡稱，它是 Google 公司開發的一種資料描述語言，並於 2008 年對外開源。Protobuf 剛開源時的定位類似於 XML、JSON 等資料描述語言，透過附帶工具生成程式碼並實現將結構化資料序列化的功能。我們需要利用 protoc 生成服務端程式碼。

```
o get github.com/golang/protobuf/protoc-gen-go
```

### 2）安裝 Go-Micro/v2

```
go install github.com/micro/micro/v2
```

### 3）新建 golang 專案(服務端)

- 在專案根目錄下建立 proto 資料夾，用來存放 protobuf 檔案

- 在 proto 資料夾下建立 greeter.proto 檔案

![8.png](https://ucc.alicdn.com/pic/developer-ecology/47adbcf430f2425b85f6d612482fa744.png)

- 檔案內容如下：

在服務端中使用 protobuf 檔案定義了一個服務叫做 Greeter 的處理器,它有一個接收 HelloRequest 並返回 HelloResponse 的 Hello 方法。

```
syntax = "proto3";
package helloworld;
service Greeter {
    rpc Hello(HelloRequest) returns (HelloResponse) {}
}
message HelloRequest {
    string name = 1;
}
message HelloResponse {
    string greeting = 2;
}
```

- 生成相應的 Go 程式碼

```
protoc  --micro_out=. --go_out=. proto/greeter.proto
```

- 在 proto 目錄下，生成了 pb.go 以及 pb.micro.go 兩個檔案

![9.png](https://ucc.alicdn.com/pic/developer-ecology/6f73fd0abed64c2b9076caa9efab8328.png)

- 建立 server.go 並執行

```
package main
import (
    "context"
    helloworld "go-micro-nacos-demo1/proto"
    "github.com/micro/go-micro/v2"
    "github.com/micro/go-micro/v2/logger"
    "github.com/micro/go-micro/v2/registry"
    nacos "github.com/micro/go-plugins/registry/nacos/v2"
)
type Helloworld struct{}
// Call is a single request handler called via client.Call or the generated client code
func (e *Helloworld) Hello(ctx context.Context, req *helloworld.HelloRequest, rsp *helloworld.HelloResponse) error {
    logger.Info("Received Helloworld.Call request")
    return nil
}
func main() {
    addrs := make([]string, 1)
    addrs[0] = "console.nacos.io:80"
    registry := nacos.NewRegistry(func(options *registry.Options) {
        options.Addrs = addrs
    })
    service := micro.NewService(
        // Set service name
        micro.Name("my.micro.service"),
        // Set service registry
        micro.Registry(registry),
    )
    helloworld.RegisterGreeterHandler(service.Server(), new(Helloworld))
    service.Run()
}
```

- 在 Nacos console 中可以看到 my.micro.service 成功註冊

![10.png](https://ucc.alicdn.com/pic/developer-ecology/cf38615efe114063b6fc36c9a30d6a4f.png)

## 2. Go-Micro 客戶端

- 建立 client.go （為了方便演示，本文在同一專案下建立了 cient.go）。

![11.png](https://ucc.alicdn.com/pic/developer-ecology/2964a6c704704b49a031675195e2d802.png)

```
package main
import (
    "context"
    "fmt"
    helloworld "go-micro-nacos-demo1/proto"
    "github.com/micro/go-micro/v2"
    "github.com/micro/go-micro/v2/registry"
    nacos "github.com/micro/go-plugins/registry/nacos/v2"
)
const serverName = "my.micro.service"
func main() {
    addrs := make([]string, 1)
    addrs[0] = "console.nacos.io:80"
    r := nacos.NewRegistry(func(options *registry.Options) {
        options.Addrs = addrs
    })
    // 定義服務，可以傳入其它可選引數
    service := micro.NewService(
        micro.Name("my.micro.service.client"),
        micro.Registry(r))
    // 建立新的客戶端
    greeter := helloworld.NewGreeterService(serverName, service.Client())
    // 呼叫greeter
    rsp, err := greeter.Hello(context.TODO(), &helloworld.HelloRequest{Name: "John"})
    if err != nil {
        fmt.Println(err)
    }
    //獲取所有服務
    fmt.Println(registry.ListServices())
    //獲取某一個服務
    services, err := registry.GetService(serverName)
    if err != nil {
        fmt.Println(err)
    }
    //監聽服務
    watch, err := registry.Watch()
    fmt.Println(services)
    // 列印響應請求
    fmt.Println(rsp.Greeting)
    go service.Run()
    for {
        result, err := watch.Next()
        if len(result.Action) > 0 {
            fmt.Println(result, err)
        }
    }
}
```

- 執行客戶端，在 nacos console 中可以看到客戶端服務也註冊到了 nacos 中。

![12.png](https://ucc.alicdn.com/pic/developer-ecology/150715e6cb374b09a82445acd9b00014.png)

- server.go 的控制檯中列印了呼叫日誌。

![13.png](https://ucc.alicdn.com/pic/developer-ecology/4ec44aef5b7b439bbc829ca6d0c2280f.png)

## 3. Go-Micro 整合 Nacos 功能說明

### 1）server.go

服務端:使用 go-micro 建立服務端 Demo，並註冊到 nacos 。

```
registry := nacos.NewRegistry(func(options *registry.Options) {
        options.Addrs = addrs
   })
   service := micro.NewService(
        // Set service name
        micro.Name("my.micro.service"),
        // Set service registry
        micro.Registry(registry),
   )
   service.Run()
```

### 2）client.go

使用 go-micro 建立客戶端 Demo ,註冊到 nacos :

```
r := nacos.NewRegistry(func(options *registry.Options) {
        options.Addrs = addrs
    })
    service := micro.NewService(
        micro.Name("my.micro.service.client"),
        micro.Registry(r))
```

客戶端呼叫：

```
// 建立新的客戶端
    greeter := helloworld.NewGreeterService(serverName, service.Client())
    // 呼叫greeter
    rsp, err := greeter.Hello(context.TODO(), &helloworld.HelloRequest{Name: "John"})
```

查詢服務列表：

```
services,err:=registry.ListServices()
```

獲取某一個服務：

```
service, err := registry.GetService(serverName)
```

訂閱服務：

```
watch, err := registry.Watch()
    for {
        result, err := watch.Next()
        if len(result.Action) > 0 {
            fmt.Println(result, err)
        }
    }
```

# 總結

使用 Go-Micro 整合 Nacos 完成服務註冊與發現是比較簡單容易上手的，本專案中 client.go 使用的 nacos 客戶端是 go-mirco 提供的預設配置。

go-micro 的 registry 介面自由度較高，我們可以利用 context 完成 nacos 客戶端引數的配置, 如何使用 context 設定 nacos 客戶端引數可參考:[https://github.com/micro/go-](https://github.com/micro/go-)plugins/blob/master/registry/nacos/nacos_test.go)

## 相關連結

- **Demo 地址**：[https://github.com/sanxun0325/go-micro-nacos-demo](https://github.com/sanxun0325/go-micro-nacos-demo
- **Go-Micro**: [https://github.com/asim/nitro](https://github.com/asim/nitro)
- **Nacos**: [https://nacos.io/zh-cn/index.html](https://nacos.io/zh-cn/index.html)
- **Nacos 釘釘社群交流群**：30438813, 23191211(Nacos golang 生態交流群)
- **Nacos-SDK-Go 專案地址**：[https://github.com/nacos-group/nacos-sdk-go](https://github.com/nacos-group/nacos-sdk-go)

## 作者簡介

**張斌斌**（Github賬號：sanxun0325）Nacos Commiter，Sentinel-Golang Contributor，現任職 OpenJaw 微服務團隊。目前主要負責 Nacos，Sentinel-Golang 社群相關專案的開發工作，以及 Nacos在Golang 微服務生態中的推廣整合工作。

> “[阿里巴巴雲原生](http://mp.weixin.qq.com/s?__biz=MzUzNzYxNjAzMg==&mid=2247495998&idx=2&sn=bf06b9fce41924049c42f27c55d306c5&chksm=fae6faf1cd9173e7000ad2686a35702d71a6828ed94f9432444743443babf9dcfded1c59ab75&token=1794504628&lang=zh_CN#rd)關注微服務、Serverless、容器、Service Mesh 等技術領域、聚焦雲原生流行技術趨勢、雲原生大規模的落地實踐，做最懂雲原生開發者的公眾號。”

微服務框架 Go-Micro 整合 Nacos 實戰之服務註冊與發現

相關文章