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

升级说明

原轻量级配置中心已升级为轻量级配置及注册中心。轻量级配置及注册中心兼容轻量级配置中心的使用场景，同时，增加了对 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：支持 ANS 的服务注册以及 ACM 的配置管理。

    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。

结果验证

轻量级配置及注册中心的验证包含两部分：
  • 轻量级配置及注册中心可用性。
  • 功能可用性，包括配置管理、服务注册和命名空间（仅适用于之前使用 Nacos 的用户）。
验证轻量级配置及注册中心可用性
轻量级配置及注册中心可以在本机或独立机器上启动，所以访问会有两种方式。
  • 本机

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

  • 独立机器

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

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

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

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

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

验证功能可用性

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

有些用户之前使用了轻量级配置中心或 Nacos，有些用户初次使用轻量级配置及注册中心，所以验证分为原有用户和新用户两种场景。
  • 原有用户在下载、启动轻量级配置及注册中心之后，可以根据业务逻辑直接验证功能可用性。
  • 新用户在下载、启动轻量级配置及注册中心之后，还需要在应用中增加、修改配置，建议参考具体功能的应用开发文档验证功能可用性。

相关文档

在您使用轻量级配置及注册中心的过程中，如果遇到问题，可以参考轻量级配置及注册中心。