开发者可以在本地使用轻量级配置及注册中心实现应用的注册、发现和配置管理,完成应用的开发和测试。在将应用部署到EDAS后,这些功能仍然可以正常使用。本文介绍如何下载、启动和验证轻量级配置及注册中心。

升级说明

原轻量级配置中心已升级为轻量级配置及注册中心。轻量级配置及注册中心兼容轻量级配置中心的使用场景,同时,增加了对Nacos的支持。

升级前后的功能对比如下:
功能 轻量级配置中心 轻量级配置及注册中心
使用ACM实现配置管理 支持 支持
使用ANS实现服务注册发现 支持 支持
HSF应用的服务注册发现和配置管理 支持 支持
使用Nacos实现服务注册发现和配置管理 不支持 支持
说明 原来使用轻量级配置中心的用户,可以直接使用轻量级配置及注册中心。

前提条件

在使用轻量级配置及注册中心前,请完成以下工作:
  • 下载1.8及以上版本的JDK,并设置环境变量JAVA_HOME
  • 确认8080、8848和9600端口未被使用。
    说明 由于轻量级配置及注册中心将占用8080、8848和9600端口,因此建议使用专门的机器安装并启动轻量级配置及注册中心。如果在本机上使用,请将应用的端口修改为其它端口。

步骤一:下载轻量级配置及注册中心

  • Windows:
    1. 下载轻量级配置及注册中心压缩包
    2. 在本地解压压缩包。
  • Unix:
    1. 执行命令wget http://edas.oss-cn-hangzhou.aliyuncs.com/edas-res/edas-lightweight-server-1.0.0.tar.gz 下载轻量级配置及注册中心压缩包。
    2. 执行命令 tar -zvxf edas-lightweight-server-1.0.0.tar.gz解压压缩包。
    注意 轻量级配置及注册中心仅用于本地开发、测试,请勿用于生产环境。如果需要暴露到公网,请控制好IP访问策略。

步骤二:启动轻量级配置及注册中心

  1. 进入目录edas-lightweight\bin
  2. 启动轻量级配置及注册中心,并查看启动结果。
    • Windows:双击startup.bat启动轻量级配置及注册中心
    • Unix:执行sh startup.sh
      1. /usr/java/jdk1.8.0/bin/java -server -Xms1g -Xmx1g -Xmn512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m -XX:-OmitStackTraceInFastThrow -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/root/service/edas-lightweight/logs/java_heapdump.hprof -XX:-UseLargePages -Djava.ext.dirs=/usr/java/jdk1.8.0/jre/lib/ext:/usr/java/jdk1.8.0/lib/ext:/root/service/edas-lightweight/plugins/cmdb:/root/service/edas-lightweight/plugins/mysql -Xloggc:/root/service/edas-lightweight/logs/nacos_gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dnacos.home=/root/service/edas-lightweight -Dnacos.standalone=true -jar /root/service/edas-lightweight/target/edas-lightweight.jar --spring.config.location=classpath:/,classpath :/config/,file:./,file:./config/,file:/root/service/edas-lightweight/conf/ --logging.config=/root/service/edas-lightweight/conf/nacos-logback.xml --server.max-http-header-size=524288
      2. edas lightweight is starting with standalone
      3. edas lightweight is starting,you can check the /root/edas-lightweight/logs/start.out
      说明 如果需要调整启动的JVM参数,根据您本地的环境在启动脚本中设置合适的JVM参数。
  3. 可选:检查轻量级配置及注册中心的启动监听端口。

    正常启动后,会在本节点上监听以下三个端口:

    • 8848:用来支持基于Nacos应用的配置管理及服务注册。
    • 9600:HSF或Dubbo的服务注册及订阅。
    • 8080:支持服务注册以及配置管理。

    Linux和macOS操作系统环境,可使用netstat -an | grep -E "8080|8848|9600" | grep -i listen命令查看上述三个端口是否处在监听状态( Linux操作系统还可以使用netstat -nltp | grep -E "8080|8848|9600" 来检查这三个端口的打开情况以及是否是轻量级配置及注册中心的进程打开的)。

步骤三:在本地开发环境中配置hosts

在需要使用轻量级配置及注册中心开发、测试应用的机器上配置轻量级配置及注册中心的hosts,即在DNS(hosts文件)中将jmenv.tbsite.net域名指向启动了轻量级配置及注册中心的机器IP。

  1. 打开hosts文件。
    • Windows操作系统:C:\Windows\System32\drivers\etc\hosts
    • Unix操作系统:/etc/hosts
  2. 添加轻量级配置及注册中心配置。
    • 如果在IP为192.168.1.100的机器上启动了轻量级配置及注册中心,则需要在hosts文件里加入配置:192.168.1.100 jmenv.tbsite.net
    • 如果在本地启动轻量级配置及注册中心,则在hosts文件中配置将上面的IP改为127.0.0.1 jmenv.tbsite.net

结果验证

轻量级配置及注册中心的验证包含两部分。
  • 验证轻量级配置及注册中心可用性。

    轻量级配置及注册中心可以在本机或独立机器上启动,所以访问会有两种方式。

    • 本机

      在浏览器中输入轻量级配置及注册中心地址http://127.0.0.1:8080并回车。

    • 独立机器

      在浏览器中输入轻量级配置及注册中心地址http://机器IP地址:8080并回车。

    说明 绑定hosts之后,可以直接访问轻量级配置及注册中心域名 + 端口jmenv.tbsite.net:8080

    轻量级配置及注册中心首页如下图所示。

    轻量级配置及注册中心首页

    如果首页不能正常显示,可以查看安装目录下的启动日志文件logs/start.log定位启动失败的原因,并修复。

  • 验证功能可用性。

    轻量级配置及注册中心提供了服务注册、发现、配置管理和命名空间功能(仅适用于原有Nacos用户)。

    有些用户之前使用了轻量级配置中心或Nacos,有些用户初次使用轻量级配置及注册中心,所以验证分为原有用户和新用户两种场景。

    • 原有用户在下载、启动轻量级配置及注册中心之后,可以根据业务逻辑直接验证功能可用性。
    • 新用户在下载、启动轻量级配置及注册中心之后,还需要在应用中增加、修改配置,建议参考具体功能的应用开发文档验证功能可用性。

相关文档

在您使用轻量级配置及注册中心的过程中,如果遇到问题,请参见轻量级配置及注册中心常见问题