轻量服务中心给开发者提供开发、调试、测试过程中的服务发现、注册和查询功能。
概念阐述
本小节介绍如何在开发者本地进行消费者/提供者应用的开发调试。服务提供者和消费者均需要连接到在远程的服务中心,为了本地微服务的开发和调试,本小节介绍了两种搭建本地服务中心的方法进行本地微服务调试:
服务中心是微服务框架中的重要组件,用于服务元数据以及服务实例元数据的管理和处理注册、发现。服务中心与微服务提供/消费者的逻辑关系下图所示:
前提条件
- 已经安装1.8版本的JDK,并且正确配置JAVA_HOME环境变量。
- 由于启动本地服务中心将会占用此台机器的30100和30103端口,其分别表示服务中心的后台和前台服务端口。请确认以上端口未被使用。
启动本地服务中心
- 进入“微服务开发 > 工具下载”页面下载本地轻量化服务中心安装包。
- 安装服务中心。
- 软件包安装:解压缩安装包到安装目录。
- 镜像包安装:执行以下命令安装服务中心。docker load -i local-service-center-{version}-docker.tar 说明:
- 只支持64位的操作系统。
- 通过下载软件包方式安装服务中心时,如果需要修改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在磁盘中的系统绝对路径,注意区分在不同系统下使用对应的路径分隔符。
- 开发服务消费者,启动微服务进行本地测试。