啟動輕量級配置及注冊中心EDAS

開發者可以在本地使用輕量級配置及注冊中心實現應用的注冊、發現和配置管理，完成應用的開發和測試。在將應用部署到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，有些用戶初次使用輕量級配置及注冊中心，所以驗證分為原有用戶和新用戶兩種場景。

  • 原有用戶在下載、啟動輕量級配置及注冊中心之后，可以根據業務邏輯直接驗證功能可用性。
  • 新用戶在下載、啟動輕量級配置及注冊中心之后，還需要在應用中增加、修改配置，建議參考具體功能的應用開發文檔驗證功能可用性。