此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅最新版本。
为了方便 Dubbo-go 框架用户的使用,我们提供了 Samples 仓库以供用户参考:
目前有三种方式来运行 dubbo-go 的示例:
前置条件:需要 docker 环境就绪
下面我们将使用 “helloworld” 作为示例:
启动注册中心(比如 zookeeper)
当看到类似下面的输出信息时,就表明 zookeeper server 启动就绪了。
如果要停掉注册中心,可以通过运行以下的命令完成:
启动服务提供方
当看到类似下面的输出信息时,就表明服务提供方启动就绪了。
运行服务调用方
当以下的信息输出时,说明 go-client
调用 go-server
成功。
集成测试
本项目 dubbo-go-samples 除了用来展示如何使用 dubbo-go 中的功能和特性之外,还被用于 apache/dubbo-go 的集成测试。可以按照以下的步骤来运行针对 go-server
设计的集成测试:
首先启动服务方
然后切换到单测目录, 设置环境变量,然后执行单测
当以下信息输出时,说明集成测试通过。
关闭并清理
以下的两种运行方式都与 IDE 有关。这里我们以 Intellij GoLand 为例来讨论。
一旦在 GoLand 中打开本项目,可以发现,在 “Run Configuration” 弹出菜单中已经存在了一系列事先配置好了的用来运行相关服务提供方和调用方的选项,例如:“helloworld-go-server” 和 “helloworld-go-client”。
可以选择其中的任意一个快速启动相关示例。当然在运行之前,假设需要的注册中心已经事先启动了,不然用例将会失败。您可以选择手动自行启动的方式,也可以利用工程中提供的 “docker-compose.yml” 在启动注册中心的 docker 实例。
这里以 Intellij GoLand 为例。在 GoLand 中打开 dubbo-go-samples 工程之后,按照以下的步骤来运行/调试本示例:
启动 zookeeper 服务器
打开 “integrate_test/dockercompose/docker-compose.yml” 这个文件,然后点击位于编辑器左边 gutter 栏位中的 ▶︎▶︎ 图标运行,“Service” Tab 应当会弹出并输出类似下面的文本信息:
启动服务提供方
打开 “helloworld/go-server/cmd/server.go” 文件,然后点击左边 gutter 栏位中紧挨着 “main” 函数的 ▶︎ 图标,并从弹出的菜单中选择 “Modify Run Configuration…",并确保以下配置的准确:
这样示例中的服务端就准备就绪,随时可以运行了。
运行服务消费方
打开 “helloworld/go-client/cmd/client.go” 这个文件,然后从左边 gutter 栏位中点击紧挨着 “main” 函数的 ▶︎ 图标,然后从弹出的菜单中选择 “Modify Run Configuration…",并确保以下配置的准确:
然后就可以运行并调用远端的服务了,如果调用成功,将会有以下的输出:
如果需要调试该示例或者 dubbo-go 框架,可以在 IDE 中从 “Run” 切换到 “Debug”。如果要结束的话,直接点击 ◼︎ 就好了。