操作场景
本文通过一个 demo 进行 dubbo-go 应用接入微服务引擎托管的 PolarisMesh 治理中心的全流程操作演示,帮助您快速了解如何使用北极星网格。
前提条件
已创建 PolarisMesh 北极星网格,请参见 创建 PolarisMesh 治理中心。
下载 Github 的 demo 源码 到本地并解压。
本地编译构建打包机器环境已安装了 golang 环境,并且能够访问 Github。
当前仅支持 dubbo-go 的接口注册模型。
根据您自身的业务,已准备好业务部署的资源,虚拟机部署和容器化部署选择其中一种方式即可。
虚拟机部署已创建 CVM 虚拟机,请参见 创建 CVM 虚拟机。
容器化部署已创建 TKE 容器集群,请参见 创建 TKE 集群。
操作步骤
1. 登录 TSE 控制台。
2. 在北极星网格下的 polarismesh 页面,单击页面左上方下拉列表,选择目标地域。
3. 单击目标引擎的“ID”,进入基本信息页面。
4. 查看访问地址,Dubbo-Go 应用访问使用 gRPC 端口(8091):
5. 修改 demo 中的注册中心地址
5.1 在下载到本地的 demo 源码 目录下,分别找到
dubbo\\dubbo-go\\providerdubbo-goo.yaml
以及dubbdubbo-gogo\\consumdubbo-googo.yaml
文件。5.2 添加微服务引擎北极星网格地址到项目配置文件中(这里以
dubbo\\dubbo-go\\provider\\dubbo-go.yaml
为例)。dubbo:registries:polarisMesh:protocol: polarisaddress: '10.0.4.6:8091'namespace: defaultconsumer:references:UserProvider:protocol: dubbointerface: org.apache.dubbo.UserProvider.TestUserProviderWithCustomGroupAndVersion:protocol: dubbointerface: org.apache.dubbo.UserProvider.Test2version: myInterfaceVersion
6. 将源码编译成可执行程序。
6.1 分别在 consumer 和 provider 这2个目录下,打开 cmd 命令,执行以下命令,对项目进行编译:
编译 consumer:
CGO_ENABLED=0 go build -ldflags "-s -w" -o consumer
编译 provider:
CGO_ENABLED=0 go build -ldflags "-s -w" -o provider
6.2 编译成功后,生成如表1所示的2个二进制包。
软件包所在目录 | 软件包名称 | 说明 |
dubbo3\\dubbo-go\\provider | provider | 服务生产者 |
dubbo3\\dubbo-go\\consumer | consumer | 服务消费者 |
7. 部署 provider 和 consumer 微服务应用,根据您业务实际选择虚拟机部署、容器化部署中的一种部署方式即可。
7.1 虚拟机部署
上传二进制包至 CVM 实例。
执行启动命令进行启动:
# 进入provider目录cd /data/polaris/dubbogo_examples/provider# 设置配置文件目录export DUBBO_GO_CONFIG_PATH="./dubbogo.yml"# 运行 provider./provider
7.2 容器化部署
编写dockerfile生成镜像,参考:
FROM golang:alpineWORKDIR /rootADD . /rootENTRYPOINT ./[二进制名称] [启动参数命令]
通过 TKE 部署并运行镜像
8. 确认部署结果
8.1 进入前面提到的微北极星网格实例页面。
8.2 选择服务管理 > 服务列表,查看服务的实例数量:
若实例数量值不为0,则表示已经成功接入微服务引擎。
若实例数量为0,或者找不到上述服务名,则表示
Dubbo-Go
应用接入微服务引擎失败。
8.3 调用 consumer 的 HTTP 接口。执行 http 调用,其中
${app.port}
替换为 consumer 的监听端口(默认为18080),${add.address}
则替换为 consumer 暴露的地址。curl -L -X GET 'http://${add.address}:${app.port}/echo'预期返回值:{"UserProvider":{"id":"A001","name":"Alex Stocks","age":18,"time":"2021-12-16T16:57:27.945+08:00"},"UserProviderWithCustomGroupAndVersion":{"id":"A001","name":"Alex Stocks from UserProviderWithCustomGroupAndVersion","age":18,"time":"2021-12-16T16:57:27.946+08:00"}}