Dubbo-Admin 容器化部署指南：基于 Docker Stack 的实践

前言

Dubbo-Admin 是 Apache Dubbo 生态中重要的服务治理平台，为开发者提供了可视化的服务管理界面。本文将深入解析如何使用 Docker Stack 部署 Dubbo-Admin 及其依赖的 ZooKeeper 服务，帮助开发者快速搭建完整的 Dubbo 服务治理环境。

环境准备

在开始部署前，请确保已安装以下组件：

• Docker Engine 18.06.0 或更高版本
• Docker Compose 1.25.0 或更高版本

核心组件解析

1. ZooKeeper 服务

zookeeper:
  image: zookeeper
  ports:
    - 2181:2181

ZooKeeper 作为 Dubbo 的注册中心和配置中心，提供了分布式协调服务。此配置：

• 使用官方 ZooKeeper 镜像
• 暴露标准端口 2181 供其他服务访问

2. Dubbo-Admin 服务

admin:
  image: apache/dubbo-admin:0.3.0
  depends_on:
    - zookeeper
  ports:
    - 38080:38080

Dubbo-Admin 是核心治理组件，关键配置包括：

• 指定版本为 0.3.0 的官方镜像
• 声明依赖 ZooKeeper 服务
• 将容器 38080 端口映射到主机

数据库配置详解

配置文件提供了两种数据库方案：

方案一：MySQL 数据库（推荐生产环境使用）

environment:
  - spring.datasource.driver-class-name=com.mysql.jdbc.Driver
  - spring.datasource.url=jdbc:mysql://xxx:3306/dubbo-admin?characterEncoding=utf8&connectTimeout=1000&socketTimeout=10000&autoReconnect=true
  - spring.datasource.username=root
  - spring.datasource.password=mysql

关键参数说明：

• characterEncoding=utf8：确保正确处理中文
• connectTimeout=1000：连接超时设为1秒
• autoReconnect=true：启用自动重连机制

注意：需要提前创建名为 dubbo-admin 的数据库，并确保网络可达。

方案二：H2 内存数据库（适合测试环境）

# use internal h2 as database
# - spring.datasource.url=jdbc:h2:mem:~/dubbo-admin;
# - spring.datasource.username=sa

特点：

• 无需额外安装数据库
• 数据不持久化，重启后丢失
• 用户名固定为 sa，无密码

高级配置项

注册中心配置

- admin.registry.address=zookeeper://zookeeper:2181
- admin.config-center=zookeeper://zookeeper:2181
- admin.metadata-report.address=zookeeper://zookeeper:2181

这三项配置统一指向 ZooKeeper 服务，分别用于：

1. 服务注册发现
2. 动态配置管理
3. 元数据上报

MyBatis-Plus 配置

- mybatis-plus.global-config.db-config.id-type=none

此配置禁用 MyBatis-Plus 的主键自动生成策略，适合已有明确主键设计的数据库表。

部署实践

1. 保存配置文件为 stack.yml
2. 执行部署命令：

   docker stack deploy -c stack.yml dubbo
   

3. 验证服务：

   docker service ls
   

常见问题排查

1. 数据库连接失败：

   • 检查 MySQL 服务是否正常运行
   • 验证网络连通性
   • 确认数据库用户名密码正确

2. ZooKeeper 连接问题：

   • 确保 ZooKeeper 容器正常启动
   • 检查 depends_on 是否生效

3. 端口冲突：

   • 38080 或 2181 端口被占用时，可修改映射端口

最佳实践建议

1. 生产环境建议：

   • 使用 MySQL 持久化数据
   • 配置适当的数据库连接池参数
   • 启用 ZooKeeper 集群模式

2. 安全建议：

   • 修改默认数据库密码
   • 限制管理端口访问权限
   • 定期备份数据库

通过本文的详细解析，开发者可以全面掌握 Dubbo-Admin 的容器化部署方法，根据实际需求选择合适的数据库方案，构建稳定可靠的 Dubbo 服务治理平台。