go-zero 簡介

縮短從需求到上線的距離

go-zero 是一個集成了各種工程實踐的 web 和 rpc 框架。通過彈性設計保障了大并發(fā)服務端的穩(wěn)定性，經受了充分的實戰(zhàn)檢驗。

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

使用 go-zero 的好處：

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

1. go-zero 框架背景

18 年初，我們決定從 ?Java+MongoDB? 的單體架構遷移到微服務架構，經過仔細思考和對比，我們決定：

• 基于 Go 語言
• 高效的性能
• 簡潔的語法
• 廣泛驗證的工程效率
• 極致的部署體驗
• 極低的服務端資源成本
• 自研微服務框架
• 有過很多微服務框架自研經驗
• 需要有更快速的問題定位能力
• 更便捷的增加新特性

2. go-zero 框架設計思考

對于微服務框架的設計，我們期望保障微服務穩(wěn)定性的同時，也要特別注重研發(fā)效率。所以設計之初，我們就有如下一些準則：

• 保持簡單，第一原則
• 彈性設計，面向故障編程
• 工具大于約定和文檔
• 高可用
• 高并發(fā)
• 易擴展
• 對業(yè)務開發(fā)友好，封裝復雜度
• 約束做一件事只有一種方式

我們經歷不到半年時間，徹底完成了從 ?Java+MongoDB? 到 ?Golang+MySQL? 為主的微服務體系遷移，并于 18 年 8 月底完全上線，穩(wěn)定保障了業(yè)務后續(xù)迅速增長，確保了整個服務的高可用。

3. go-zero 項目實現(xiàn)和特點

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

• 強大的工具支持，盡可能少的代碼編寫
• 極簡的接口
• 完全兼容 net/http
• 支持中間件，方便擴展
• 高性能
• 面向故障編程，彈性設計
• 內建服務發(fā)現(xiàn)、負載均衡
• 內建限流、熔斷、降載，且自動觸發(fā)，自動恢復
• API 參數自動校驗
• 超時級聯(lián)控制
• 自動緩存控制
• 鏈路跟蹤、統(tǒng)計報警等
• 高并發(fā)支撐，穩(wěn)定保障了疫情期間每天的流量洪峰

4. Installation

在項目目錄下通過如下命令安裝：

GO111MODULE=on GOPROXY=https://goproxy.cn/,direct go get -u github.com/zeromicro/go-zero

5. Quick Start

1、完整示例請查看

快速構建高并發(fā)微服務

快速構建高并發(fā)微服務 - 多 RPC 版

2、安裝 goctl 工具

goctl 讀作 go control，不要讀成 go C-T-L。goctl 的意思是不要被代碼控制，而是要去控制它。其中的 go 不是指 golang。

 GO111MODULE=on GOPROXY=https://goproxy.cn/,direct go get -u github.com/zeromicro/go-zero/tools/goctl

如果使用 go1.16 版本, 可以使用 ?go install? 命令安裝

 GOPROXY=https://goproxy.cn/,direct go install github.com/zeromicro/go-zero/tools/goctl@latest

確保 goctl 可執(zhí)行

3、快速生成 api 服務

 goctl api new greet
 cd greet
 go mod init
 go mod tidy
 go run greet.go -f etc/greet-api.yaml

默認偵聽在 8888 端口（可以在配置文件里修改），可以通過 curl 請求：

 curl -i http://localhost:8888/from/you

返回如下：

 HTTP/1.1 200 OK
 Content-Type: application/json
 Date: Thu, 22 Oct 2020 14:03:18 GMT
 Content-Length: 14

 {"message":""}

編寫業(yè)務代碼：

• api 文件定義了服務對外暴露的路由，可參考 api 規(guī)范
• 可以在 ?servicecontext.go? 里面?zhèn)鬟f依賴給 ?logic?，比如 mysql, redis 等
• 在 api 定義的 ?get/post/put/delete? 等請求對應的 ?logic ?里增加業(yè)務處理邏輯

4、可以根據 api 文件生成前端需要的 Java, TypeScript, Dart, JavaScript 代碼

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