应用管理与运维平台 ServiceStage应用管理与运维平台 ServiceStage

更新时间:2021/08/03 GMT+08:00
分享

如何进行本地开发和测试?

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

概念阐述

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

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

前提条件

  • 已经安装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函数首末添加如下代码:

    1
    2
    3
    4
    5
    6
    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. 开发服务消费者,启动微服务进行本地测试。

进入开发模式

下载“本地轻量化服务中心”在本地做测试开发时,发现每次改动代码后,要么重启“本地轻量化服务中心”,要么升级版本号,不然运行就会报错。

在microservice.yaml文件里加入如下配置,就可以进入开发状态,免去上述操作。

service_description.environment: development
分享:

Java SDK问题 所有常见问题

more