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

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

概念阐述

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

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

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

前提条件

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

启动本地服务中心

1. 进入“微服务开发 > 工具下载”页面下载本地轻量化服务中心安装包。
2. 安装服务中心。

    

   • 软件包安装：解压缩安装包到安装目录。
   • 镜像包安装：执行以下命令安装服务中心。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

3. 启动服务中心。
   • 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

4. 在浏览器中输入http://127.0.0.1:30103，访问服务中心前台界面。
5. 启动服务中心后，在存放sdk配置信息的microservice.yaml文件中配置服务中心地址，如下。

   cse:
     service:
       registry:
         address: http://127.0.0.1:30100      # 服务中心后台地址及端口

    说明：
   • 服务中心为提高易用性，默认监听本机0.0.0.0地址，但从安全性考虑，建议用户自行修改配置监听127.0.0.1。
   • 如果使用服务中心时自定义设置了IP地址和端口，则需根据实际情况修改address的值。
   • 若不使用配置中心和仪表盘，请将相应配置删除。

   微服务应用开发完毕后，运行服务端MainServer，启动服务进程，可以向服务中心注册服务。

6. 开发服务提供/消费者，启动微服务进行本地测试。

Mock机制启动服务中心

1. 新建本地服务中心定义文件registry.yaml，内容如下：

   springmvctest:
     - id: "001"
       version: "1.0"
       appid: myapp                        #调试的服务id
       instances:
         - endpoints:
           - rest://127.0.0.1:8080

    说明：

   mock机制需要自己准备契约，并且当前只支持在本地进行服务消费端(consumer)侧的调试，不支持服务提供者(provider)

2. 在服务消费者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在磁盘中的系统绝对路径，注意区分在不同系统下使用对应的路径分隔符。

3. 开发服务消费者，启动微服务进行本地测试。