dubbo实战之四：管理控制台dubbo-admin

川长思鸟来 2022-12-18 01:58 110阅读 0赞

### 欢迎访问我的GitHub ###

> 这里分类和汇总了欣宸的全部原创(含配套源码)：[https://github.com/zq2599/blog\_demos][https_github.com_zq2599_blog_demos]

### 《dubbo实战》系列导航 ###

1.  [准备和初体验][Link 1]
2.  [与SpringBoot集成][SpringBoot]
3.  [使用Zookeeper注册中心][Zookeeper]
4.  [管理控制台dubbo-admin][dubbo-admin]

### 本篇概览 ###

*  本文是《dubbo实战》系列的第四篇，内容是部署和启动dubbo管理控制台服务，该服务在开发、测试、生产等环节都非常重要，接下来一起通过实战学习和了解它，官方GitHub地址：https://github.com/apache/dubbo-admin
 *  整篇文章由以下内容构成：

1.  准备工作（注册中心、服务提供者、服务消费者）；
2.  准备工作（配置信息）；
3.  体验docker版；
4.  下载源码自行构建；

### 准备工作(注册中心、服务提供者、服务消费者) ###

1.  所谓准备工作，就是准备一个相对完整的dubbo环境，里面有注册中心、服务提供者、服务消费者；
2.  在上一篇《dubbo实战之三：使用Zookeeper注册中心》，咱们已经创建和验证了服务提供者和消费者，并且以zookeeper作为注册中心，现在请把这些服务全部启动起来，我这边的服务情况如下所示：

<table> 
 <thead> 
  <tr> 
   <th>服务</th> 
   <th>IP</th> 
   <th>端口</th> 
   <th>项目名称</th> 
   <th>作用</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>zookeeper</td> 
   <td>192.168.50.43</td> 
   <td>2181</td> 
   <td>注册中心、配置中心</td> 
   <td>作用</td> 
  </tr> 
  <tr> 
   <td>springboot-zk-provider</td> 
   <td>192.168.50.12</td> 
   <td>8080</td> 
   <td>springbootzkprovider</td> 
   <td>服务提供者</td> 
  </tr> 
  <tr> 
   <td>springboot-zk-consumer</td> 
   <td>192.168.50.12</td> 
   <td>8081</td> 
   <td>springbootzkconsumer</td> 
   <td>服务消费者</td> 
  </tr> 
 </tbody> 
</table>

1.  确保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

1.  简单地说，就是只有配置中心的地址放在本地配置文件中，等到dubbo-admin连接到配置中心后，从配置中心取得其他配置信息，画了个简图辅助理解，如下：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center]
2.  基于上述分析，咱们要先在zookeeper中创建好节点/dubbo/config/dubbo/dubbo.properties，以便dubbo-admin使用，请登录zookeeper所在服务器，进入zookeeper的bin目录；
3.  由于前面的文章已经使用过zookeeper作为注册中心，因此"/dubbo/config/"目录已经存在，下面的命令会创建/dubbo/config/dubbo节点：

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

1.  再创建/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"

1.  最后，查看是否创建成功，输入和响应如下所示，可见节点创建成功，值也是预期的：

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

1.  至此，准备工作全部完成，可以部署和尝试dubbo-admin了，先从官方推荐的快速体验方式开始，即docker版；

### 体验docker版 ###

1.  请确保docker已部署并正常运行；
2.  [官方Github][Github]建议通过docker镜像快速体验管理控制台，如下图，咱们就按照官方的建议先用docker镜像试试：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 1]
3.  下载镜像（此步骤可以不执行，我这是想看看下载镜像要多久）：

docker pull apache/dubbo-admin

1.  执行以下命令启动docker容器：

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

1.  用上述命令启动的容器是一次性的，如果用Ctrl+C中断控制台，容器就会自动销毁，另外容器的8080端口被映射到了宿主机的8083端口；
2.  用浏览器访问宿主机的8083端口，如下图所示，dubbo-admin已经启动了：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 2]
3.  点击下图红框1中的服务查询菜单，即可看到整个分布式环境中所有已经暴露的服务（即红框2），此时点击右侧的DETAIL按钮，就能看到此服务的详情：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 3]
4.  服务详情如下图，基础信息、提供者、消费者都有，但遗憾的是元数据无法正常展示：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 4]
5.  以上就是官方提供的体验版，算是让咱们对管理控制台有了基本了解，但这仅是用于体验的镜像，实际生产环境中，首先未必会用docker，并且可能需要有对应的源码以便学习和分析问题，甚至有可能用源码做进一步定制，因此这个docker版本就不适合了，接下来一起下载dubbo-admin源码自行编译构建；
6.  在启动docker容器的控制台执行Ctrl+C，刚才创建的容器就会自动销毁；

### 下载源码自行构建 ###

1.  下载官方源码：

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

1.  修改配置文件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

1.  在dubbo-admin目录执行以下命令，开始编译：

mvn clean compile -U

1.  不出意外的话会编译成功，如下：

[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.

1.  启动服务：

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

1.  启动成功后，在浏览器访问登录页面：http://localhost:8083/\#/login ，（一定要先登录），如下图，账号密码都是root，这是application.properties文件中配置的：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 5]
2.  登录后可见主页，如下图，和之前的docker体验版还是有些不同的：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 6]
3.  点击上图的测试按钮，可以在页面上测试该服务的方法：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 7]
4.  再次进入服务详情页，可见元数据也能正常显示了：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 8]

### 小结 ###

至此，管理控制台dubbo-admin的编译、部署、基本操作都实战完成了，网页上更多功能您可以自行尝试，（建议部署更多的服务和实例），回顾整个过程其实都很简单，唯一要注意的就是服务的配置那里，本地只有配置中心的地址，其他信息都放在配置中心；

### 欢迎关注公众号：程序员欣宸 ###

> 微信搜索「程序员欣宸」，我是欣宸，期待与您一同畅游Java世界…

[https_github.com_zq2599_blog_demos]: https://github.com/zq2599/blog_demos
[Link 1]: https://xinchen.blog.csdn.net/article/details/109096867
[SpringBoot]: https://xinchen.blog.csdn.net/article/details/109142783
[Zookeeper]: https://xinchen.blog.csdn.net/article/details/109147843
[dubbo-admin]: https://xinchen.blog.csdn.net/article/details/109267151
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center]: /images/20221122/37df0217a4e44641a6f911b153b4844c.png
[Github]: https://github.com/apache/dubbo-admin/blob/develop/README_ZH.md
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221122/d6cb6d56fc3644a3afcb77517b4a2ae3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221122/765359f268e841fa9ee27f01b71e0870.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221122/3f3d305bd50f4ae994269ff6278825d3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221122/fe076992c02b42e4a4f75c85e472220f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221122/2d64095ebaa14fc398007e914b243418.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20221122/5c79f03824a448f783d3e4c2d57e1daf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20221122/19da900cd30b457781a433751f66746a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20221122/31b00f32921445299c5fd221f723914e.png