dubbo實戰之四：管理控制臺dubbo-admin

歡迎訪問我的GitHub

這里分類和匯總了欣宸的全部原創(含配套原始碼)：https://github.com/zq2599/blog_demos

《dubbo實戰》系列導航

1. 準備和初體驗
2. 與SpringBoot集成
3. 使用Zookeeper注冊中心
4. 管理控制臺dubbo-admin

本篇概覽

• 本文是《dubbo實戰》系列的第四篇，內容是部署和啟動dubbo管理控制臺服務，該服務在開發、測驗、生產等環節都非常重要，接下來一起通過實戰學習和了解它，官方GitHub地址：https://github.com/apache/dubbo-admin
• 整篇文章由以下內容構成：

1. 準備作業（注冊中心、服務提供者、服務消費者）；
2. 準備作業（配置資訊）；
3. 體驗docker版；
4. 下載原始碼自行構建；

準備作業(注冊中心、服務提供者、服務消費者)

1. 所謂準備作業，就是準備一個相對完整的dubbo環境，里面有注冊中心、服務提供者、服務消費者；
2. 在上一篇《dubbo實戰之三：使用Zookeeper注冊中心》，咱們已經創建和驗證了服務提供者和消費者，并且以zookeeper作為注冊中心，現在請把這些服務全部啟動起來，我這邊的服務情況如下所示：

3. 確保zookeeper、服務提供者、服務消費者全部啟動且功能正常；

準備作業（配置資訊）

1. 接下來要準備配置資訊，首選要強調的是dubbo-admin有三個重要的配置項：admin.config-center（配置中心），admin.registry.address（注冊中心）、admin.metadata-report.address（元資料中心）；
2. 如果在組態檔中只有admin.registry.address(舊版本的做法)，此時dubbo-admin會將admin.registry.address的值作為注冊中心和配置中心使用，元資料中心將無法使用，因此官方不推薦這樣的配置；
3. 官方推薦的做法：在組態檔中只有admin.config-center，此配置的值是zookeeper地址，在zookeeper服務中有個節點，路徑是/dubbo/config/dubbo/dubbo.properties，內容是admin.registry.address和admin.metadata-report.address的配置，如下所示：

dubbo.registry.address=zookeeper://127.0.0.1:2181
dubbo.metadata-report.address=zookeeper://127.0.0.1:2181

4. 簡單地說，就是只有配置中心的地址放在本地組態檔中，等到dubbo-admin連接到配置中心后，從配置中心取得其他配置資訊，畫了個簡圖輔助理解，如下：
   
5. 基于上述分析，咱們要先在zookeeper中創建好節點/dubbo/config/dubbo/dubbo.properties，以便dubbo-admin使用，請登錄zookeeper所在服務器，進入zookeeper的bin目錄；
6. 由于前面的文章已經使用過zookeeper作為注冊中心，因此"/dubbo/config/"目錄已經存在，下面的命令會創建/dubbo/config/dubbo節點：

./zkCli.sh create /dubbo/config/dubbo ""

7. 再創建/dubbo/config/dubbo/dubbo.properties節點：

./zkCli.sh create /dubbo/config/dubbo/dubbo.properties "dubbo.registry.address=zookeeper://192.168.50.43:2181
dubbo.metadata-report.address=zookeeper://192.168.50.43:2181"

8. 最后，查看是否創建成功，輸入和回應如下所示，可見節點創建成功，值也是預期的：

root@zookeeper:/opt/zookeeper-3.4.13/bin# ./zkCli.sh get /dubbo/config/dubbo/dubbo.properties
Connecting to localhost:2181
2020-10-25 03:47:50,512 [myid:] - INFO  [main:Environment@100] - Client environment:zookeeper.version=3.4.13-2d71af4dbe22557fda74f9a9b4309b15a7487f03, built on 06/29/2018 04:05 GMT
environment:user.home=/root
2020-10-25 03:47:50,526 [myid:] - INFO  [main:Environment@100] - Client environment:user.dir=/opt/zookeeper-3.4.13/bin
2020-10-25 03:47:50,529 [myid:] - INFO  [main:ZooKeeper@442] - Initiating client connection, connectString=localhost:2181 sessionTimeout=30000 watcher=org.apache.zookeeper.ZooKeeperMain$MyWatcher@674e5e21
2020-10-25 03:47:50,584 [myid:] - INFO  [main-SendThread(localhost:2181):ClientCnxn$SendThread@1029] - Opening socket connection to server localhost/127.0.0.1:2181. Will not attempt to authenticate using SASL (unknown error)
WATCHER::

WatchedEvent state:SyncConnected type:None path:null
dubbo.registry.address=zookeeper://192.168.50.43:2181
dubbo.metadata-report.address=zookeeper://192.168.50.43:2181
cZxid = 0x6b5
ctime = Sun Oct 25 03:47:30 UTC 2020
mZxid = 0x6b5
mtime = Sun Oct 25 03:47:30 UTC 2020
pZxid = 0x6b5
cversion = 0
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 114
numChildren = 0

9. 至此，準備作業全部完成，可以部署和嘗試dubbo-admin了，先從官方推薦的快速體驗方式開始，即docker版；

體驗docker版

1. 請確保docker已部署并正常運行；
2. 官方Github建議通過docker鏡像快速體驗管理控制臺，如下圖，咱們就按照官方的建議先用docker鏡像試試：
   
3. 下載鏡像（此步驟可以不執行，我這是想看看下載鏡像要多久）：

docker pull apache/dubbo-admin

4. 執行以下命令啟動docker容器：

docker run \
-p 8083:8080 \
-e admin.config-center=zookeeper://192.168.50.43:2181 \
--rm \
apache/dubbo-admin

5. 用上述命令啟動的容器是一次性的，如果用Ctrl+C中斷控制臺，容器就會自動銷毀，另外容器的8080埠被映射到了宿主機的8083埠；

6. 用瀏覽器訪問宿主機的8083埠，如下圖所示，dubbo-admin已經啟動了：
   

7. 點擊下圖紅框1中的服務查詢選單，即可看到整個分布式環境中所有已經暴露的服務（即紅框2），此時點擊右側的DETAIL按鈕，就能看到此服務的詳情：
   

8. 服務詳情如下圖，基礎資訊、提供者、消費者都有，但遺憾的是元資料無法正常展示：
   

9. 以上就是官方提供的體驗版，算是讓咱們對管理控制臺有了基本了解，但這僅是用于體驗的鏡像，實際生產環境中，首先未必會用docker，并且可能需要有對應的原始碼以便學習和分析問題，甚至有可能用原始碼做進一步定制，因此這個docker版本就不適合了，接下來一起下載dubbo-admin原始碼自行編譯構建；

10. 在啟動docker容器的控制臺執行Ctrl+C，剛才創建的容器就會自動銷毀；

下載原始碼自行構建

1. 下載官方原始碼：

git clone https://github.com/apache/dubbo-admin.git

2. 修改組態檔dubbo-admin/dubbo-admin-server/src/main/resources/application.properties ，如下所示，只配置admin.registry.address的值，將admin.registry.address和admin.metadata-report.address注釋掉，如果要修改埠，也在此添加server.port的配置，我這里配置的是8083埠：

server.port=8083
# centers in dubbo2.7
#admin.registry.address=zookeeper://127.0.0.1:2181
admin.config-center=zookeeper://192.168.50.43:2181
#admin.metadata-report.address=zookeeper://127.0.0.1:2181

admin.root.user.name=root
admin.root.user.password=root
#group
admin.registry.group=dubbo
admin.config-center.group=dubbo
admin.metadata-report.group=dubbo

admin.apollo.token=e16e5cd903fd0c97a116c873b448544b9d086de9
admin.apollo.appId=test
admin.apollo.env=dev
admin.apollo.cluster=default
admin.apollo.namespace=dubbo

#compress
server.compression.enabled=true
server.compression.mime-types=text/css,text/javascript,application/javascript
server.compression.min-response-size=10240

3. 在dubbo-admin目錄執行以下命令，開始編譯：

mvn clean compile -U

4. 不出意外的話會編譯成功，如下：

[INFO] --- maven-compiler-plugin:3.7.0:compile (default-compile) @ dubbo-admin-test ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 6 source files to /Users/zhaoqin/temp/202010/24/dubbo-admin/dubbo-admin-test/target/classes
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for dubbo-admin 0.2.0-SNAPSHOT:
[INFO]
[INFO] dubbo-admin ........................................ SUCCESS [  1.997 s]
[INFO] dubbo-admin-ui ..................................... SUCCESS [ 44.322 s]
[INFO] dubbo-admin-server ................................. SUCCESS [  4.731 s]
[INFO] dubbo-admin-distribution ........................... SUCCESS [  0.850 s]
[INFO] dubbo-admin-test ................................... SUCCESS [  0.815 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  53.105 s
[INFO] Finished at: 2020-10-25T16:24:27+08:00
[INFO] ------------------------------------------------------------------------
[WARNING] The requested profile "nexus" could not be activated because it does not exist.

5. 啟動服務：

mvn --projects dubbo-admin-server spring-boot:run

6. 啟動成功后，在瀏覽器訪問登錄頁面：http://localhost:8083/#/login ，（一定要先登錄），如下圖，賬號密碼都是root，這是application.properties檔案中配置的：
   
7. 登錄后可見主頁，如下圖，和之前的docker體驗版還是有些不同的：
   
8. 點擊上圖的測驗按鈕，可以在頁面上測驗該服務的方法：
   
9. 再次進入服務詳情頁，可見元資料也能正常顯示了：
   

小結

至此，管理控制臺dubbo-admin的編譯、部署、基本操作都實戰完成了，網頁上更多功能您可以自行嘗試，（建議部署更多的服務和實體），回顧整個程序其實都很簡單，唯一要注意的就是服務的配置那里，本地只有配置中心的地址，其他資訊都放在配置中心；

歡迎關注公眾號：程式員欣宸

微信搜索「程式員欣宸」，我是欣宸，期待與您一同暢游Java世界…