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

欢迎访问我的GitHub

github.com/zq2599/blog_demos

本篇概览

• 本文是《dubbo实战》系列的第四篇，内容是部署和启动dubbo管理控制台服务，该服务在开发、测试、生产等环节都非常重要，接下来一起通过实战学习和了解它，官方GitHub地址：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世界…