使用ServiceComb/CSE如何进行本地开发和测试？

最新推荐文章于 2022-12-04 17:23:30 发布

原创最新推荐文章于 2022-12-04 17:23:30 发布 · 3.4k 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#cse #servicecomb

技术剖析专栏收录该内容

82 篇文章

订阅专栏

本文档详细介绍了如何在本地使用ServiceComb/CSE进行服务的开发和调试，包括启动本地服务中心、Mock机制启动服务中心的方法，以及配置和注意事项，旨在帮助开发者高效地进行微服务测试。

轻量服务中心给开发者提供开发、调试、测试过程中的服务发现、注册和查询功能。

概念阐述

本小节介绍如何在开发者本地进行消费者/提供者应用的开发调试。服务提供者和消费者均需要连接到在远程的服务中心，为了本地微服务的开发和调试，本小节介绍了两种搭建本地服务中心的方法进行本地微服务调试：

启动本地服务中心；
通过local file模拟启动服务中心(Mock机制)。

服务中心是微服务框架中的重要组件，用于服务元数据以及服务实例元数据的管理和处理注册、发现。服务中心与微服务提供/消费者的逻辑关系下图所示：

前提条件

已经安装1.8版本的JDK，并且正确配置JAVA_HOME环境变量。
由于启动本地服务中心将会占用此台机器的30100和30103端口，其分别表示服务中心的后台和前台服务端口。请确认以上端口未被使用。

启动本地服务中心

进入“微服务开发 > 工具下载”页面下载本地轻量化服务中心安装包。
安装服务中心。
- 软件包安装：解压缩安装包到安装目录。
- 镜像包安装：执行以下命令安装服务中心。docker load -i local-service-center-{version}-docker.tar 说明：
  1. 只支持64位的操作系统。
  2. 通过下载软件包方式安装服务中心时，如果需要修改IP地址和端口，请修改/../conf/app.conf文件，其中frontend_host_ip和frontend_host_port为服务中心前台服务监听的IP地址和端口配置，httpaddr和httpport为服务中心后台服务监听的IP地址和端口配置。以修改服务中心后台服务为例，修改方法如下所示。当httpaddr配置为127.0.0.1时，服务中心只能被本机进程访问。若希望服务中心可以被远程访问，请配置httpaddr为外部IP地址或者0.0.0.0。
```
# listen address
httpaddr = 127.0.0.1
httpport = 30100
```
启动服务中心。
- windows系统：单击服务中心安装包里的start.bat脚本启动服务中心。
- linux系统：执行start.sh脚本启动服务中心。说明：
  执行start.sh脚本前请执行以下命令修改文件权限。
  
  chmod -R 550 /../bin
- docker容器：执行以下命令启动服务中心。
  docker rm -f sc
  
  docker run -d --name sc -p 30100:30100 -p 30103:30103 local-service-center:latest
在浏览器中输入http://127.0.0.1:30103，访问服务中心前台界面。
启动服务中心后，在存放sdk配置信息的microservice.yaml文件中配置服务中心地址，如下。
```
cse:
  service:
    registry:
      address: http://127.0.0.1:30100      # 服务中心后台地址及端口
```
说明：
- 服务中心为提高易用性，默认监听本机0.0.0.0地址，但从安全性考虑，建议用户自行修改配置监听127.0.0.1。
- 如果使用服务中心时自定义设置了IP地址和端口，则需根据实际情况修改address的值。
- 若不使用配置中心和仪表盘，请将相应配置删除。
微服务应用开发完毕后，运行服务端MainServer，启动服务进程，可以向服务中心注册服务。
开发服务提供/消费者，启动微服务进行本地测试。

Mock机制启动服务中心

新建本地服务中心定义文件registry.yaml，内容如下：
```
springmvctest:
  - id: "001"
    version: "1.0"
    appid: myapp                        #调试的服务id
    instances:
      - endpoints:
        - rest://127.0.0.1:8080
```
说明：
mock机制需要自己准备契约，并且当前只支持在本地进行服务消费端(consumer)侧的调试，不支持服务提供者(provider)
在服务消费者Main函数首末添加如下代码：
```
public class xxxClient {
public static void main(String[] args) {
    System.setProperty("local.registry.file", "/path/registry.yaml");
    //your code
    System.clearProperty("local.registry.file");
}
```
说明：
setProperty第二个参数填写registry.yaml在磁盘中的系统绝对路径，注意区分在不同系统下使用对应的路径分隔符。
开发服务消费者，启动微服务进行本地测试。