雲原生 go-zero 微服務框架

0. go-zero介紹

go-zero是一個集成了各類工程實踐的web和rpc框架。經過彈性設計保障了大併發服務端的穩定性，經受了充分的實戰檢驗。

go-zero包含極簡的API定義和生成工具goctl，能夠根據定義的api文件一鍵生成Go, iOS, Android, Kotlin, Dart, TypeScript, JavaScript代碼，並可直接運行。

使用go-zero的好處：

• 輕鬆得到支撐千萬日活服務的穩定性
• 內建級聯超時控制、限流、自適應熔斷、自適應降載等微服務治理能力，無需配置和額外代碼
• 微服務治理中間件可無縫集成到其它現有框架使用
• 極簡的API描述，一鍵生成各端代碼
• 自動校驗客戶端請求參數合法性
• 大量微服務治理和併發工具包

1. go-zero框架背景

18年初，曉黑板後端在通過頻繁的宕機後，決定從Java+MongoDB的單體架構遷移到微服務架構，通過仔細思考和對比，咱們決定：

• 基於Go語言
  • 高效的性能
  • 簡潔的語法
  • 普遍驗證的工程效率
  • 極致的部署體驗
  • 極低的服務端資源成本
• 自研微服務框架
  • 我的有過不少微服務框架自研經驗
  • 須要有更快速的問題定位能力
  • 更便捷的增長新特性

2. go-zero框架設計思考

對於微服務框架的設計，咱們指望保障微服務穩定性的同時，也要特別注重研發效率。因此設計之初，咱們就有以下一些準則：

• 保持簡單
• 高可用
• 高併發
• 易擴展
• 彈性設計，面向故障編程
• 儘量對業務開發友好，封裝複雜度
• 儘量約束作一件事只有一種方式

咱們經歷不到半年時間，完全完成了從Java+MongoDB到Golang+MySQL爲主的微服務體系遷移，並於18年8月底徹底上線，穩定保障了曉黑板後續增加，確保了整個服務的高可用。

3. go-zero項目實現和特色

go-zero是一個集成了各類工程實踐的包含web和rpc框架，有以下主要特色：

• 強大的工具支持，儘量少的代碼編寫
• 極簡的接口
• 徹底兼容net/http
• 支持中間件，方便擴展
• 高性能
• 面向故障編程，彈性設計
• 內建服務發現、負載均衡
• 內建限流、熔斷、降載，且自動觸發，自動恢復
• API參數自動校驗
• 超時級聯控制
• 自動緩存控制
• 鏈路跟蹤、統計報警等
• 高併發支撐，穩定保障了曉黑板疫情期間天天的流量洪峯

以下圖，咱們從多個層面保障了總體服務的高可用：

4. go-zero近期開發計劃

• 自動生成API mock server，便於客戶端開發
• 自動生成服務端功能測試

5. Installation

在項目目錄下經過以下命令安裝：

go get -u github.com/tal-tech/go-zero

6. Quick Start

1. 編譯goctl工具

   go build tools/goctl/goctl.go

   把goctl放到$PATH的目錄下，確保goctl可執行

2. 定義API文件，好比greet.api，能夠在vs code裏安裝goctl插件，支持api語法

   type Request struct {
     Name string `path:"name,options=you|me"` // 框架自動驗證請求參數是否合法
   }
   
   type Response struct {
     Message string `json:"message"`
   }
   
   service greet-api {
     @server(
       handler: GreetHandler
     )
     get /greet/from/:name(Request) returns (Response);
   }

   也能夠經過goctl生成api模本文件，命令以下：

   goctl api -o greet.api

3. 生成go服務端代碼

   goctl api go -api greet.api -dir greet

   生成的文件結構以下：

   ├── greet
   │   ├── etc
   │   │   └── greet-api.json        // 配置文件
   │   ├── greet.go                  // main文件
   │   └── internal
   │       ├── config
   │       │   └── config.go         // 配置定義
   │       ├── handler
   │       │   ├── greethandler.go   // get/put/post/delete等路由定義文件
   │       │   └── routes.go         // 路由列表
   │       ├── logic
   │       │   └── greetlogic.go     // 請求邏輯處理文件
   │       ├── svc
   │       │   └── servicecontext.go // 請求上下文，能夠傳入mysql, redis等依賴
   │       └── types
   │           └── types.go          // 請求、返回等類型定義
   └── greet.api                     // api描述文件

   生成的代碼能夠直接運行：

cd greet
   go run greet.go -f etc/greet-api.json

默認偵聽在8888端口（能夠在配置文件裏修改），能夠經過curl請求：

➜  go-zero git:(master) curl -w "\ncode: %{http_code}\n" http://localhost:8888/greet/from/kevin
   {"code":0}
   code: 200

編寫業務代碼：

• 能夠在servicecontext.go裏面傳遞依賴給logic，好比mysql, redis等
  • 在api定義的get/post/put/delete等請求對應的logic裏增長業務處理邏輯

4. 能夠根據api文件生成前端須要的Java, TypeScript, Dart, JavaScript代碼

   goctl api java -api greet.api -dir greet
   goctl api dart -api greet.api -dir greet
   ...

7. Benchmark

測試代碼見這裏

8. 項目地址

https://github.com/tal-tech/go-zero

好將來技術