全部产品

启动轻量级配置及注册中心

更新时间:2019-08-15 12:43:04

开发者可以在本地使用轻量级配置及注册中心实现应用的注册、发现和配置管理,完成应用的开发和测试。在将应用部署到 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解压压缩包。

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

  1. 进入目录edas-lightweight\bin

  2. 启动轻量级配置及注册中心。

    • Windows:双击startup.bat
    • Unix:执行sh startup.sh
  3. 查看启动结果。

    出现下图中所示的信息,说明启动成功。

    • Windows:

      启动结果-Win

    • Unix:

      1. /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.201.b09-2.el7_6.x86_64/bin/java -server -Xms1g -Xmx1g -Xmn512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320 m -XX:-OmitStackTraceInFastThrow -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/root/edas-lightweight/logs/java_heapdump.hprof -XX:-UseLargePages -Djava.ext.dirs=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.201.b09-2.el7_6.x86_64/jre/lib/ext:/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.201.b09-2.el7_6.x86_64 /lib/ext:/root/edas-lightweight/plugins/cmdb:/root/edas-lightweight/plugins/mysql -Xloggc:/root/edas-lightweight/logs/nacos_gc.log -verbose:gc -XX:+P rintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dnacos.home=/ root/edas-lightweight -Dnacos.standalone=true -jar /root/edas-lightweight/target/edas-lightweight.jar --spring.config.location=classpath:/,classpath :/config/,file:./,file:./config/,file:/root/edas-lightweight/conf/ --logging.config=/root/edas-lightweight/conf/nacos-logback.xml --server.max-http-h eader-size=524288
      2. edas lightweight is starting with standalone
      3. edas lightweight is startingyou can check the /root/edas-lightweight/logs/start.out

    说明:如果需要调整启动的 JVM 参数,根据您本地的环境在启动脚本中设置合适的 JVM 参数。

  4. (可选)检查轻量级配置及注册中心的启动监听端口。

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

    • 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。

hosts 文件的路径如下:

  • Windows 操作系统:C:\Windows\System32\drivers\etc\hosts

  • Unix 操作系统:/etc/hosts

如果在 IP 为 192.168.1.100 的机器上启动了轻量级配置及注册中心,则需要在 hosts 文件里加入配置:192.168.1.100 jmenv.tbsite.net

如果在本地启动轻量级配置及注册中心,则将上面的 IP 改为 172.0.0.1

结果验证

轻量级配置及注册中心的验证包含两部分:

  • 轻量级配置及注册中心可用性。
  • 功能可用性,包括配置管理、服务注册和命名空间(仅适用于之前使用 Nacos 的用户)。

验证轻量级配置及注册中心可用性

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

  • 本机

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

  • 独立机器

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

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

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

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

  • 首页正常显示,说明轻量级配置及注册中心可正常使用。
  • 首页不能正常显示,可以查看安装目录下的启动日志文件logs/start.log定位启动失败的原因,并修复。

验证功能可用性

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

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

  • 原有用户在下载、启动轻量级配置及注册中心之后,可以直接验证功能可用性。

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

相关文档

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