Go - Micro微服務(wù)框架實(shí)踐 - API（十三）

Micro的api就是api網(wǎng)關(guān)

創(chuàng)新互聯(lián)服務(wù)項(xiàng)目包括故城網(wǎng)站建設(shè)、故城網(wǎng)站制作、故城網(wǎng)頁(yè)制作以及故城網(wǎng)絡(luò)營(yíng)銷(xiāo)策劃等。多年來(lái)，我們專(zhuān)注于互聯(lián)網(wǎng)行業(yè)，利用自身積累的技術(shù)優(yōu)勢(shì)、行業(yè)經(jīng)驗(yàn)、深度合作伙伴關(guān)系等，向廣大中小型企業(yè)、政府機(jī)構(gòu)等提供互聯(lián)網(wǎng)行業(yè)的解決方案，故城網(wǎng)站推廣取得了明顯的社會(huì)效益與經(jīng)濟(jì)效益。目前，我們服務(wù)的客戶(hù)以成都為中心已經(jīng)輻射到故城省份的部分城市，未來(lái)相信會(huì)繼續(xù)擴(kuò)大服務(wù)區(qū)域并繼續(xù)獲得客戶(hù)的支持與信任！

API參考了 API網(wǎng)關(guān)模式 為服務(wù)提供了一個(gè)單一的公共入口?；诜?wù)發(fā)現(xiàn)，使得micro api可以提供具備http及動(dòng)態(tài)路由的服務(wù)。

Micro的API基于HTTP協(xié)議。請(qǐng)求的API接口通過(guò)HTTP協(xié)議訪(fǎng)問(wèn)，并且路由是基于服務(wù)發(fā)現(xiàn)機(jī)制向下轉(zhuǎn)發(fā)的。 Micro API在 go-micro 之上開(kāi)發(fā)，所以它集成了服務(wù)發(fā)現(xiàn)、負(fù)載均衡、編碼及基于RPC的通信。

因?yàn)閙icro api內(nèi)部使用了go-micro，所以它自身也是可插拔的。 參考 go-plugins 了解對(duì)gRPC、kubernetes、etcd、nats、及rabbitmq等支持。另外，api也使用了 go-api ，這樣，接口handler也是可以配置的。

ACME（ Automatic Certificate Management Environment）是由 Let’s Encrypt 制定的安全協(xié)議。

可以選擇是否配置白名單

API服務(wù)支持TLS證書(shū)

API使用帶分隔符的命名空間來(lái)在邏輯上區(qū)分后臺(tái)服務(wù)及公開(kāi)的服務(wù)。命名空間及http請(qǐng)求路徑會(huì)用于解析服務(wù)名與方法，比如 GET /foo HTTP/1.1 會(huì)被路由到 go.micro.api.foo 服務(wù)上。

API默認(rèn)的命名空間是 go.micro.api ，當(dāng)然，也可以修改：

我們演示一個(gè)3層的服務(wù)架構(gòu)：

完整示例可以參考： examples/greeter

先決條件：我們使用Consul作為默認(rèn)的服務(wù)發(fā)現(xiàn)，所以請(qǐng)先確定它已經(jīng)安裝好了，并且已經(jīng)運(yùn)行，比如執(zhí)行 consul agent -dev 這樣子方式運(yùn)行。

向micro api發(fā)起http請(qǐng)求

HTTP請(qǐng)求的路徑 /greeter/say/hello 會(huì)被路由到服務(wù) go.micro.api.greeter 的方法 Say.Hello 上。

繞開(kāi)api服務(wù)并且直接通過(guò)rpc調(diào)用：

使用JSON的方式執(zhí)行同一請(qǐng)求：

micro api提供下面類(lèi)型的http api接口

請(qǐng)看下面的例子

Handler負(fù)責(zé)持有并管理HTTP請(qǐng)求路由。

默認(rèn)的handler使用從注冊(cè)中心獲取的端口元數(shù)據(jù)來(lái)決定指向服務(wù)的路由，如果路由不匹配，就會(huì)回退到使用”rpc” hander。在注冊(cè)時(shí)，可以通過(guò) go-api 來(lái)配置路由。

API有如下方法可以配置請(qǐng)求handler：

通過(guò) /rpc 入口可以繞開(kāi)handler處理器。

API處理器接收任何的HTTP請(qǐng)求，并且向前轉(zhuǎn)發(fā)指定格式的RPC請(qǐng)求。

RPC處理器接收json或protobuf格式的HTTP POST請(qǐng)求，然后向前轉(zhuǎn)成RPC請(qǐng)求。

代理Handler其實(shí)是內(nèi)置在服務(wù)發(fā)現(xiàn)中的反向代理服務(wù)。

事件處理器使用go-micro的broker代理接收http請(qǐng)求并把請(qǐng)求作為消息傳到消息總線(xiàn)上。

Web處理器是，它是內(nèi)置在服務(wù)發(fā)現(xiàn)中的HTTP反向代理服務(wù)，支持web socket。

/rpc 端點(diǎn)允許繞過(guò)主handler，然后與任何服務(wù)直接會(huì)話(huà)。

示例：

更多信息查看可運(yùn)行的示例： github.com/micro/examples/api

解析器，Micro使用命名空間與HTTP請(qǐng)求路徑來(lái)動(dòng)態(tài)路由到具體的服務(wù)。

API命名的空間是 go.micro.api ?？梢酝ㄟ^(guò)指令 --namespace 或者環(huán)境變量 MICRO_NAMESPACE= 設(shè)置命名空間。

下面說(shuō)一下解析器是如何使用的：

RPC解析器示例中的RPC服務(wù)有名稱(chēng)與方法，分別是 go.micro.api.greeter ， Greeter.Hello 。

URL會(huì)被解析成以下幾部分：

帶版本號(hào)的API URL也可以很容易定位到具體的服務(wù)：

代理解析器只處理服務(wù)名，所以處理方案和RPC解析器有點(diǎn)不太一樣。

URL會(huì)被解析成以下幾部分：

golang 微服務(wù)開(kāi)發(fā)（一）

本項(xiàng)目旨在使用golang 搭建一個(gè)微服務(wù)應(yīng)用。

gin做api和rpc的客戶(hù)端 go-micro作為后臺(tái)微服務(wù)

···

// gin

Frame

- app // 控制器

- conf // 配置文件

- middleward // 中間件

- models // 模型

- routes // 路由

- services // 服務(wù)層

- uitl // 工具

- main.go // 入口

// app 目錄

app

- api

- v1

- goods.go

- v2

- route.go

- app.go

//conf目錄

conf

- config.ini

models

- models.go

services

- xxxService.go

util

- config.go

···

Go微服務(wù)--常見(jiàn)的微服務(wù)框架

近幾年誕生了很多微服務(wù)框架，比如JAVA的Spring Cloud、Dubbo;Golang的GoKit和GoMicro以及NodeJs的Seneca。幾乎每種主流語(yǔ)言都有其對(duì)應(yīng)的微服務(wù)框架。

Go在微服務(wù)框架中有其獨(dú)特的優(yōu)勢(shì)，至于優(yōu)勢(shì)在哪，自行g(shù)oogle。

1、GoKit框架

這是一個(gè)工具包的集合，可以幫助攻城獅構(gòu)建強(qiáng)大、可靠和可維護(hù)的微服務(wù)。提供了用于實(shí)現(xiàn)系統(tǒng)監(jiān)控和彈性模式組件的庫(kù)，例如日志、跟蹤、限流、熔斷等。

基于這個(gè)框架的應(yīng)用程序架構(gòu)由三個(gè)主要的部分組成：

傳輸層：用于網(wǎng)絡(luò)通信，服務(wù)通常使用HTTP或者gRPC等網(wǎng)絡(luò)傳輸協(xié)議，或者使用NATS等發(fā)布訂閱系統(tǒng)相互通信。

接口層：是服務(wù)器和客戶(hù)端的基本構(gòu)建塊。每個(gè)對(duì)外提供的接口方法都會(huì)定義為一個(gè)Endpoint，一遍在服務(wù)器和客戶(hù)端之間進(jìn)行網(wǎng)絡(luò)通信，每個(gè)端點(diǎn)使用傳輸層通過(guò)HTTP或gRPC等具體通信模式對(duì)外提供服務(wù)

服務(wù)成：具體的業(yè)務(wù)邏輯實(shí)現(xiàn)

2、GoMicro框架

這是一個(gè)基于Go語(yǔ)言實(shí)現(xiàn)的插件化RPC微服務(wù)框架。提供了服務(wù)發(fā)現(xiàn)、負(fù)載均衡、同步傳輸、異步通信以及事件驅(qū)動(dòng)等機(jī)制，嘗試簡(jiǎn)化分布式系統(tǒng)之間的通信，讓開(kāi)發(fā)者更專(zhuān)注于自身業(yè)務(wù)邏輯的開(kāi)發(fā)。

GoMicro的設(shè)計(jì)哲學(xué)是可插拔的架構(gòu)理念，提供了可快速構(gòu)建系統(tǒng)的組件，并且可以根據(jù)自身的需求對(duì)GoMicro提供的默認(rèn)實(shí)現(xiàn)進(jìn)行定制。所有插件都可在倉(cāng)庫(kù)github.com/micro/go-plugins 中找到。