使用Docker快速部署Apollo配置中心指南

前言

Apollo是一款开源的分布式配置中心，能够集中化管理应用在不同环境、不同集群的配置。本文将详细介绍如何使用Docker容器技术快速部署Apollo配置中心，适合想要快速体验Apollo功能的开发者。

适用场景说明

本文介绍的Docker快速部署方式主要适用于以下场景：

• 开发者本地快速搭建Apollo环境进行体验
• 快速了解Apollo的基本功能和使用方式
• 测试环境快速部署验证

需要注意的是，生产环境部署请参考官方分布式部署指南，以获得更好的性能和可靠性保障。

环境准备

Docker环境安装

在开始之前，请确保您的系统已经安装了Docker引擎。可以通过以下命令验证Docker是否安装成功：

docker -v

如果尚未安装，请根据您的操作系统参考Docker官方文档进行安装。对于国内用户，建议配置Docker镜像源以提升镜像下载速度。

系统架构注意事项

• 对于x86架构的机器，使用标准配置文件
• 对于ARM架构的机器（如Mac M1/M2），需要使用专门的ARM64配置文件

部署步骤

1. 获取部署文件

首先需要获取Apollo的Docker部署配置文件，主要包括：

• docker-compose.yml（标准x86架构）
• docker-compose-arm64.yml（ARM64架构）
• SQL初始化脚本目录

建议创建一个专门的工作目录（如docker-quick-start）来存放这些文件。

2. 启动Apollo服务

在包含配置文件的目录下执行以下命令启动服务：

# 标准x86架构
docker-compose up

# ARM架构
docker-compose -f docker-compose-arm64.yml up

首次执行时，Docker会自动下载所需的镜像并启动容器，这可能需要一些时间。

3. 验证服务启动

服务启动完成后，您应该能在日志中看到类似以下输出：

Config service started. You may visit http://localhost:8080 for service status now!
Portal started. You can visit http://localhost:8070 now!

这表示Apollo的配置服务和门户服务都已成功启动。

服务访问与使用

访问Apollo Portal

通过浏览器访问 http://localhost:8070 即可进入Apollo配置中心的管理界面。

默认登录账号：

• 用户名：apollo
• 密码：admin

数据库访问

Docker容器中已经配置了MySQL数据库，如果需要直接访问数据库：

• 主机：localhost
• 端口：13306
• 用户名：root
• 密码：无

运行示例客户端

在Docker环境下运行示例客户端的命令如下：

docker exec -i apollo-quick-start /apollo-quick-start/demo.sh client

常见问题处理

网络访问问题

默认情况下，Apollo配置服务只会注册容器内网IP。如果需要让外部客户端访问，需要调整网络策略配置。

日志查看

如果需要查看更详细的日志信息，可以通过以下命令进入容器查看：

docker exec -it apollo-quick-start bash

日志文件位于：

• 服务日志：/apollo-quick-start/service/apollo-service.log
• 门户日志：/apollo-quick-start/portal/apollo-portal.log

注意事项

1. Windows环境下Docker支持有限，不建议使用此方式部署
2. 此快速部署方式不适合生产环境使用
3. 所有服务都运行在单个容器中，仅用于演示目的
4. 容器重启后数据会丢失，如需持久化需要额外配置

总结

通过本文介绍的Docker快速部署方式，开发者可以在几分钟内搭建起一个完整的Apollo配置中心环境，快速体验Apollo的核心功能。这为后续在生产环境中部署和使用Apollo打下了良好的基础。