Dubbo-ops项目Docker Compose测试环境部署指南

概述

本文主要介绍如何使用Docker Compose快速搭建Dubbo-ops项目的测试环境。Dubbo-ops是Dubbo生态中的重要组成部分，提供了服务治理、配置管理等核心功能。通过Docker Compose可以方便地在本地构建和测试整个系统。

环境组成

测试环境由三个核心组件构成：

1. ZooKeeper服务：作为Dubbo的注册中心和配置中心
2. Admin服务：Dubbo-ops的管理控制台
3. SUT服务：系统测试组件(System Under Test)

详细配置解析

ZooKeeper服务配置

zookeeper:
  image: zookeeper:3.5

• 使用官方ZooKeeper 3.5版本的Docker镜像
• 作为Dubbo服务的注册中心和配置存储
• 默认会启动在2181端口

Admin服务配置

admin:
  build: .
  dockerfile: Dockerfile
  links:
    - zookeeper
  environment:
    - admin.registry.address=zookeeper://zookeeper:2181
    - admin.config-center=zookeeper://zookeeper:2181
    - admin.metadata-report.address=zookeeper://zookeeper:2181
  ports: 
    - 8080

• 使用当前目录下的Dockerfile构建镜像
• 通过links与ZooKeeper服务建立连接
• 关键环境变量配置：
  • admin.registry.address：注册中心地址
  • admin.config-center：配置中心地址
  • admin.metadata-report.address：元数据上报地址
• 暴露8080端口供外部访问管理控制台

SUT服务配置

sut:
  build: .
  dockerfile: Dockerfile.test
  links:
    - admin

• 使用专门的Dockerfile.test构建测试镜像
• 连接到admin服务进行集成测试
• 通常包含测试用例和测试框架

部署流程

1. 准备环境：

   • 确保已安装Docker和Docker Compose
   • 克隆项目代码到本地

2. 启动服务：

   docker-compose -f docker-compose.test.yml up -d
   

3. 验证服务：

   • 访问http://localhost:8080确认admin控制台是否正常
   • 检查日志确认各服务启动无报错

4. 运行测试：

   docker-compose -f docker-compose.test.yml run sut
   

常见问题解决

1. 端口冲突：

   • 如果8080端口被占用，可以修改ports配置为- "自定义端口:8080"

2. 构建失败：

   • 确保Dockerfile和Dockerfile.test文件存在
   • 检查网络连接，确保能正常拉取基础镜像

3. 连接问题：

   • 确认ZooKeeper服务正常启动
   • 检查admin服务日志中的连接信息

最佳实践

1. 版本控制：

   • 建议固定ZooKeeper镜像版本，避免因版本升级导致兼容性问题

2. 资源限制：

   • 在生产环境中，应为各服务配置合理的资源限制

3. 网络配置：

   • 考虑使用自定义网络替代links(已逐渐被淘汰)

4. 数据持久化：

   • 对于ZooKeeper应考虑添加volume配置以持久化数据

通过这套Docker Compose配置，开发者可以快速搭建Dubbo-ops的测试环境，方便进行功能验证和集成测试。这种容器化的部署方式大大简化了环境准备的工作量，提高了开发效率。