Micro Toolkit

micro是微服務的工具庫

• 特性
• 開始使用
• 安裝Micro
• 依賴
• 服務發現
  • Consul
  • mDNS
• Protobuf
• 編寫服務
  • 使用模板生成
• 示例
  • 列出所有服務
  • 獲取指定名的服務
  • 調用服務
  • 執行API
  • 調用API
• 相關插件
  • 可插拔特性
  • 使用插件
  • 構建二進制文件
  • 激活插件

Micro是開發微服務的工具庫

概覽

Micro重點工作服務方向是滿足構建可伸縮的系統。Micro包含了微服務的架構模式，并把它把轉換成一系列構建平臺的工具。Micro深入復雜的分布式系統，且要把其簡化抽象成眾所周知的方式暴露給開發者使用。

技術本身是日新月異的。而那些基礎的技術棧也總是會發生變動。Micro工具插件化就是要處理這個問題。

Micro的愿景是，在任何技術棧中都可插拔，使用Micro構建永不過時的系統。

特性

micro工具庫由以下幾個部分組成：

• API Gateway: API網關作為單一的http入口，它使用服務發現中查詢的服務地址，把請求動態路由到具體服務。網關允許我們建立可伸縮的后臺微服務架構，并且讓工作在前端的公共API更健壯。Micro API基于服務發現擁有強大的路由能力，它可以處理http、gRPC、websocket、消息推送事件等等。

• Interactive CLI: 交互式的命令行接口。CLI通過終端可以描述、查詢、直接與平臺和服務進行交互。CLI提供所有的命令讓開發者明白微服務正在處理的事情。CLI也包含了交互模式。

• Service Proxy: 服務代理，這是一個在Go Micro和MUCP協議之上構建的透明的代理服務。它將服務發現、負載均衡、消息編碼、中間件、傳輸及代理插件卸載到單一位置。

可以單獨運行或與服務一起運行。

• Service Templates: 服務生成模板，目的是快速生成服務代碼，讓編寫代碼飛起來。Micro預置了一些模板用來編寫服務。 保持相同的方式編寫服務，提高效率。

• SlackOps Bot: Slack小機器人插件，當它運行中服務中時，這個插件允許開發者通過Slack消息來操作平臺。MicroBot插件提供聊天配置選項，這樣就可以讓團隊可以通過向小機器人發送聊天消息來做一些我們希望它做的事，這里面當然也包含像動態發現服務一樣創建slack命令。

• Web Dashboard: Web管理控制臺允許直接在Web頁面上查看服務的運行情況，展示端點信息，請求與響應狀態，甚至直接向服務進行查詢。管理控制臺也有CLI交互頁面提供給開發者在線上處理，就像直接操作終端一樣。

開始使用

• 安裝Micro
• 依賴
• 服務發現
• 編寫服務
• 示例
• 相關插件

安裝Micro

go get -u github.com/micro/micro

也可以通過Docker安裝

docker pull microhq/micro

依賴

micro工具庫有兩個依賴：

• Service Discovery - 用于服務名解析
• Protobuf - 代碼生成工具

服務發現

服務發現用于服務名解析、路由、集中元數據。

Micro使用go-micro來向服務發現中心發送注冊請求。

Consul

安裝并運行Consul

# install
brew install consul

# run
consul agent -dev

mDNS

Micro內置了mDNS組播系統，這是一種零依賴的服務注冊發現機制，它是區別于有注冊中心的替代方案。

通過在啟動指令中傳入--registry=mdns 或者在環境變量中設置MICRO_REGISTRY=mdns。

# 使用命令行參數
micro --registry=mdns list services

# 使用環境變量
MICRO_REGISTRY=mdns micro list services`

查看更多關于插件的資料：go-plugins.

Protobuf

Protobuf功能是代碼生成，可以免去手寫一些模板化的代碼。

# 安裝protobuf
brew install protobuf

# 安裝golang的protobuf代碼生成器 protoc-gen-go
go get -u github.com/golang/protobuf/{proto,protoc-gen-go}

# 安裝micro的protobuf插件 protoc-gen-micro
go get -u github.com/micro/protoc-gen-micro

更多資料請查看protoc-gen-micro。

編寫服務

上面說過Micro是有模板生成功能可以快速生成服務應用。

詳情可以翻閱：go-micro.

使用模板生成

下面演示使用micro new命令來快速生成一個示例服務

生成的服務會被放到$GOPATH的相對目錄下：

micro new github.com/micro/example

剛這個命令生成的目錄如下所示：

example/
    Dockerfile  # A template docker file
    README.md   # A readme with command used
    handler/    # Example rpc handler
    main.go     # The main Go program
    proto/      # Protobuf directory
    subscriber/ # Example pubsub Subscriber

然后使用protoc把proto方便生成go源碼

protoc --proto_path=. --micro_out=. --go_out=. proto/example/example.proto

下面就可以像運行其它go語言程序一下執行下面的命令了：

go run main.go

示例

剛我們通過micro new生成了命令并跑了起來，下面我們測一下。

• 列出所有服務
• 獲取服務信息
• 調用服務
• 執行API
• 調用API

列出所有服務

通過服務發現注冊的服務都可以被列出來

micro list services

相關服務：

consul
go.micro.srv.example
topic:topic.go.micro.srv.example

示例中的注冊了的應用使用的限定了的注冊名go.micro.srv.example，go.micro.srv是后臺服務名的默認前綴

獲取指定名的服務

每一個服務注冊都是通過唯一的id、地址及元數據。

micro get service go.micro.srv.example

輸出的結果：

service  go.micro.srv.example

version latest

ID  Address Port    Metadata
go.micro.srv.example-437d1277-303b-11e8-9be9-f40f242f6897   192.168.1.65    53545   transport=http,broker=http,server=rpc,registry=consul

Endpoint: Example.Call
Metadata: stream=false

Request: {
    name string
}

Response: {
    msg string
}

Endpoint: Example.PingPong
Metadata: stream=true

Request: {}

Response: {}

Endpoint: Example.Stream
Metadata: stream=true

Request: {}

Response: {}

Endpoint: Func
Metadata: subscriber=true,topic=topic.go.micro.srv.example

Request: {
    say string
}

Response: {}

Endpoint: Example.Handle
Metadata: subscriber=true,topic=topic.go.micro.srv.example

Request: {
    say string
}

Response: {}

調用服務

通過CLI命令行接口來調用RPC服務，這次查詢我們使用JSON來發送：

micro call go.micro.srv.example Example.Call '{"name": "John"}'

輸出的結果：

{
    "msg": "Hello John"
}

可以查看cli文檔來查看更多信息。

下面，我們試一下通過HTTP來調用服務。

執行API

Micro API本質上是一個http協議的網關接口，它會把動態路由到轉到后臺服務中。

MICRO_API_HANDLER=rpc \
MICRO_API_NAMESPACE=go.micro.srv \ 
micro api

說明信息：

• MICRO_API_HANDLER http API的觸發方法
• MICRO_API_NAMESPACE API所屬服務的命名空間?

調用API

發送一個POST請求到API：

curl -XPOST -H 'Content-Type: application/json' -d '{"name": "John"}' http://localhost:8080/example/call

結果：

{"msg":"Hello John"}

更多詳情信息翻看api doc。

相關插件

Micro是基于go-micro來開發插件。

Go-micro向分布式系統架構可抽離的基礎部分提供抽象。

可插拔特性

下面列表出的Micro特性都是可插拔的：

• broker - 發布訂閱消息的代理
• registry - 服務發現與注冊
• selector - 客戶端負載均衡
• transport - 傳輸，請求-響應或者雙向流
• client - 管理以上特性的客戶端
• server - 管理以上特性的服務端

Find plugins at go-plugins

使用插件

插件的集成很簡單，只需要創建個文件并引用這些插件即可。

import (
    // etcd v3 registry
    _ "github.com/micro/go-plugins/registry/etcdv3"
    // nats transport
    _ "github.com/micro/go-plugins/transport/nats"
    // kafka broker
    _ "github.com/micro/go-plugins/broker/kafka"
)

構建二進制文件

直接使用Go命令行工具鏈即可。

# 本地打包
go build -i -o micro ./main.go ./plugins.go

# 打包成docker鏡像
CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -ldflags '-w' -i -o micro ./main.go ./plugins.go

激活插件

引用插件后如果要激活，那么可以使用命令行或者設置環境變量即可。

# 命令行參數 
micro --registry=etcdv3 --transport=nats --broker=kafka [其它命令]

# 環境變量
MICRO_REGISTRY=etcdv3 MICRO_TRANSPORT=nats MICRO_BROKER=kafka micro [其它命令]