dubbo-go 3.0 示例倉庫

為了方便 Dubbo-go 框架用戶的使用，我們提供了 Samples 倉庫以供用戶參考：

【Dubbo-go-samples 倉庫地址】

1. Samples 倉庫包含的例子

• config-api: 使用 API 進行配置初始化
• configcenter: 使用不同的配置中心，目前支持三種：zookeeper、apollo、和 nacos
• context: 如何使用上下文傳遞 attachment
• direct: 直連模式
• game: 游戲服務(wù)例子
• generic: 泛化調(diào)用
• rpc: RPC 調(diào)用例子, 包含 Triple、Dubbo等協(xié)議以及跨語言/gRPC互通示例
• helloworld: RPC調(diào)用入門例子
• logger: 日志例子
• registry: 展示與不同注冊中心的對接，包含了 zk、nacos、etcd
• metrics: 數(shù)據(jù)上報
• filter: 使用提供filter和自定義filter的例子
• registry/servicediscovery：應(yīng)用級服務(wù)發(fā)現(xiàn)例子
• router: 路由例子
• tracing: 鏈路追蹤例子

2. 如何運行

目前有三種方式來運行 dubbo-go 的示例:

1. 通過 bash 命令快速開始: 通過簡單的命令行啟動樣例以及進行單元測試
2. 在 IDE 中快速開始，這也是推薦的方式: 在工程 “.run” 子目錄下，提供了所有示例的 GoLand 運行配置文件，因此用戶可以簡單在 IDE 中單擊運行所有的示例。
3. 在 IDE 中手工配置并運行: 為了完整性的目的，也為了萬一您不使用 GoLand 而使用其他的 IDE，這里也提供了如何一步一步的配置的指南，幫助用戶理解如何在 IDE 中配置，運行或者調(diào)試 dubbo-go 的示例。

2.1 通過 命令行 快速開始

前置條件：需要 docker 環(huán)境就緒

下面我們將使用 “helloworld” 作為示例:

1. 啟動注冊中心（比如 zookeeper）
   

   make -f build/Makefile docker-up 
   

   當看到類似下面的輸出信息時，就表明 zookeeper server 啟動就緒了。

   >  Starting dependency services with ./integrate_test/dockercompose/docker-compose.yml
   Docker Compose is now in the Docker CLI, try `docker compose up`
   
   Creating network "dockercompose_default" with the default driver
   Creating dockercompose_zookeeper_1 ... done
   Creating etcd                      ... done
   Creating nacos-standalone          ... done
   

   如果要停掉注冊中心，可以通過運行以下的命令完成:

   make -f build/Makefile docker-down

2. 啟動服務(wù)提供方
   

   cd helloworld/go-server/cmd
   export DUBBO_GO_CONFIG_PATH="../conf/dubbogo.yml"
   go run .
   

   當看到類似下面的輸出信息時，就表明服務(wù)提供方啟動就緒了。

   2021/10/27 00:33:10 Connected to 127.0.0.1:2181
   2021/10/27 00:33:10 Authenticated: id=72057926938066944, timeout=10000
   2021/10/27 00:33:10 Re-submitting `0` credentials after reconnect

3. 運行服務(wù)調(diào)用方
   

   cd helloworld/go-client/cmd
   export DUBBO_GO_CONFIG_PATH="../conf/dubbogo.yml"
   go run .

   當以下的信息輸出時，說明 go-client 調(diào)用 go-server 成功。

   2021-10-27T00:40:44.879+0800    DEBUG   triple/dubbo3_client.go:106     TripleClient.Invoke: get reply = name:"Hello laurence" id:"12345" age:21 
   2021-10-27T00:40:44.879+0800    DEBUG   proxy/proxy.go:218      [makeDubboCallProxy] result: name:"Hello laurence" id:"12345" age:21 , err: <nil>
   2021-10-27T00:40:44.879+0800    INFO    cmd/client.go:51        client response result: name:"Hello laurence" id:"12345" age:21

4. 集成測試 
   

    本項目 dubbo-go-samples 除了用來展示如何使用 dubbo-go 中的功能和特性之外，還被用于 apache/dubbo-go 的集成測試?？梢园凑找韵碌牟襟E來運行針對 go-server 設(shè)計的集成測試:

   首先啟動服務(wù)方

   cd helloworld/go-server/cmd
   export DUBBO_GO_CONFIG_PATH="../conf/dubbogo.yml"
   go run .
   

   然后切換到單測目錄， 設(shè)置環(huán)境變量，然后執(zhí)行單測

   cd integrate_test/helloworld/tests/integration
   export DUBBO_GO_CONFIG_PATH="../../../../helloworld/go-client/conf/dubbogo.yml"
   go test -v
   

   當以下信息輸出時，說明集成測試通過。

   >  Running integration test for application go-server
   ...
   --- PASS: TestSayHello (0.01s)
   PASS
   ok      github.com/apache/dubbo-go-samples/integrate_test/helloworld/tests/integration  0.119s

5. 關(guān)閉并清理

   make -f build/Makefile clean docker-down

以下的兩種運行方式都與 IDE 有關(guān)。這里我們以 Intellij GoLand 為例來討論。

2.2 在 IDE 中快速開始

一旦在 GoLand 中打開本項目，可以發(fā)現(xiàn)，在 “Run Configuration” 彈出菜單中已經(jīng)存在了一系列事先配置好了的用來運行相關(guān)服務(wù)提供方和調(diào)用方的選項，例如：“helloworld-go-server” 和 “helloworld-go-client”。

可以選擇其中的任意一個快速啟動相關(guān)示例。當然在運行之前，假設(shè)需要的注冊中心已經(jīng)事先啟動了，不然用例將會失敗。您可以選擇手動自行啟動的方式，也可以利用工程中提供的 “docker-compose.yml” 在啟動注冊中心的 docker 實例。選擇后者的話，可以參考第三種方式中的細節(jié)。

2.3.在 IDE 中手工運行

這里以 Intellij GoLand 為例。在 GoLand 中打開 dubbo-go-samples 工程之后，按照以下的步驟來運行/調(diào)試本示例:

1. 啟動 zookeeper 服務(wù)器打開 “integrate_test/dockercompose/docker-compose.yml” 這個文件，然后點擊位于編輯器左邊 gutter 欄位中的 ???? 圖標運行，“Service” Tab 應(yīng)當會彈出并輸出類似下面的文本信息:

   Deploying 'Compose: docker'...
   /usr/local/bin/docker-compose -f ...integrate_test/dockercompose/docker-compose.yml up -d
   Creating network "docker_default" with the default driver
   Creating docker_zookeeper_1 ...
   'Compose: docker' has been deployed successfully.

2. 啟動服務(wù)提供方打開 “helloworld/go-server/cmd/server.go” 文件，然后點擊左邊 gutter 欄位中緊挨著 “main” 函數(shù)的 ?? 圖標，并從彈出的菜單中選擇 “Modify Run Configuration…"，并確保以下配置的準確:
   Working Directory: “helloworld/go-server” 目錄的絕對路徑，比如： /home/dubbo-go-samples/helloworld/go-server
   Environment: DUBBO_GO_CONFIG_PATH=”../conf/dubbogo.yml"
   這樣示例中的服務(wù)端就準備就緒，隨時可以運行了。
3. 運行服務(wù)消費方打開 “helloworld/go-client/cmd/client.go” 這個文件，然后從左邊 gutter 欄位中點擊緊挨著 “main” 函數(shù)的 ?? 圖標，然后從彈出的菜單中選擇 “Modify Run Configuration…"，并確保以下配置的準確:
   Working Directory: “helloworld/go-client” 目錄的絕對路徑，比如： /home/dubbo-go-samples/helloworld/go-client
   Environment: DUBBO_GO_CONFIG_PATH=”../conf/dubbogo.yml"
   然后就可以運行并調(diào)用遠端的服務(wù)了，如果調(diào)用成功，將會有以下的輸出:

   [2021-02-03/16:19:30 main.main: client.go: 66] response result: &{A001 Alex Stocks 18 2020-02-04 16:19:30.422 +0800 CST}

如果需要調(diào)試該示例或者 dubbo-go 框架，可以在 IDE 中從 “Run” 切換到 “Debug”。如果要結(jié)束的話，直接點擊 ?? 就好了。