操作场景
本文通过一个 demo 进行 gRPC-Java 应用接入微服务引擎托管的 PolarisMesh 治理中心的全流程操作演示,帮助您快速了解如何使用北极星网格。
前提条件
已创建 PolarisMesh 北极星网格,请参见 创建 PolarisMesh 治理中心。
下载 Github 的 Demo 源码 到本地并解压。
本地编译构建打包机器环境已安装了Java JDK、Maven,并且能够访问 Maven 中央库。
根据您自身的业务,已准备好业务部署的资源,虚拟机部署和容器化部署选择其中一种方式即可。
虚拟机部署已创建 CVM 虚拟机,请参见 创建 CVM 虚拟机。
容器化部署已创建 TKE 容器集群,请参见 创建 TKE 集群。
操作步骤
1. 登录 TSE 控制台。
2. 在服务管理中心下的实例列表页面,单击页面左上方下拉列表,选择目标地域。
3. 单击目标引擎的“ID”,进入基本信息页面。
4. 查看访问地址,Spring Cloud 应用访问使用 gRPC 端口(8091):
![](https://qcloudimg.tencent-cloud.cn/image/document/5200fccacf78009a143516dea0a98110.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/5200fccacf78009a143516dea0a98110.png)
5. 修改 demo 中的注册中心地址。
5.1 在下载到本地的 demo 源码 目录下,分别找到
\\grpc-java-polaris-examples\\quickstart-example\\provider\\src\\main\\resources\\polaris.yml
和\\grpc-java-polaris-examples\\quickstart-example\\consumer\\src\\main\\resources\\polaris.yml
两个文件。5.2 添加微服务引擎北极星网格地址到项目配置文件中(以
\\grpc-java-polaris-examples\\quickstart-example\\provider\\src\\main\\resources\\polaris.yml
为例)。global:serverConnector:addresses:- 10.0.4.6:8091
6. 将源码编译成可执行程序。
6.1 在 quickstart-example 源码根目录下,打开 cmd 命令,执行 mvn clean package 命令,对项目进行打包编译。
6.2 编译成功后,生成如下表所示的2个二进制包。
软件包所在目录 | 软件包名称 | 说明 |
\\grpc-java-polaris-examples\\quickstart-example\\provider\\target | quickstart-provider-${version}.jar | 服务生产者 |
\\grpc-java-polaris-examples\\quickstart-example\\consumer\\target | quickstart-consumer-${version}.jar | 服务消费者 |
7. 部署 provider 和 consumer 微服务应用,根据您业务实际选择虚拟机部署、容器化部署中的一种部署方式即可。
7.1 虚拟机部署
上传 Jar 包至 CVM 实例。
执行启动命令进行启动:
nohup java -Djava.security.egd=file:/dev/./urandom -jar [jar包名称] &
7.2 容器化部署
编写 dockerfile 生成镜像,参考:
FROM java:8ADD quickstart-provider-${version}-SNAPSHOT.jar /root/app.jarENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/root/app.jar"]
通过 TKE 部署并运行镜像。
8. 确认部署结果。
8.1 进入前面提到的微北极星网格实例页面。
8.2 选择服务管理 > 服务列表,查看微服务 EchoServerGRPCJava 的实例数量:
若实例数量值不为0,则表示已经成功接入微服务引擎。
若实例数量为0,或者找不到 EchoServerGRPCJava 服务名,则表示微服务应用接入微服务引擎失败。
![](https://qcloudimg.tencent-cloud.cn/image/document/bafd0f3ab322dda345869236ce495efa.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/bafd0f3ab322dda345869236ce495efa.png)
8.3 调用 consumer 的 HTTP 接口:执行 http 调用,其中
${app.port}
替换为 consumer 的监听端口(默认为40041),${add.address}
则替换为 consumer 暴露的地址。curl -L -X GET 'http://${add.address}:${app.port}/polaris/grpc/quickstart/consumer?value="hello-polaris'预期返回值:hello-polaris