Apollo配置中心轻量级部署快速上手指南

准备阶段：环境就绪与资源检查

环境预检清单

在开始部署前，请确保您的系统满足以下条件：

检查项	最低要求	推荐配置
操作系统	Linux/macOS	Ubuntu 20.04+/macOS 12+
Docker版本	19.03+	20.10+
内存	4GB	8GB
磁盘空间	10GB	20GB
网络	可访问互联网	配置国内镜像源

执行以下命令验证Docker环境：

docker -v && docker-compose -v

预期结果：显示Docker和Docker Compose版本信息，无错误提示。

部署决策树：选择适合您的部署方案

根据您的环境选择合适的部署文件：

是否为ARM架构设备?
├─ 是 → 使用 docker-compose-arm64.yml
└─ 否 → 使用 docker-compose.yml

💡 提示：Mac M1/M2用户必须使用ARM架构专用配置文件，否则会出现兼容性问题。

部署阶段：三步完成Apollo安装

🔧 第一步：获取部署资源

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/apoll/apollo
cd apollo

项目结构说明：

• docker-compose.yml：标准部署配置文件
• docker-compose-arm64.yml：ARM架构专用配置
• scripts/sql：数据库初始化脚本

🔧 第二步：启动服务集群

根据架构选择对应命令：

x86架构：

docker-compose up -d

ARM架构：

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

首次启动将自动下载所需镜像，等待约5-10分钟，直到看到以下日志：

apollo-quick-start | Config service started. You may visit http://localhost:8080 for service status now!
apollo-quick-start | Portal started. You can visit http://localhost:8070 now!

🔧 第三步：验证容器状态

docker ps --filter "name=apollo"

预期结果：至少三个容器处于运行状态（configservice、adminservice、portal）。

图1：Apollo配置中心分布式部署架构图

验证阶段：服务可用性与功能测试

服务访问验证

打开浏览器访问Apollo管理界面：

http://localhost:8070

使用默认账号登录：

• 用户名：apollo
• 密码：admin

成功登录后将看到配置管理控制台：

图2：Apollo配置中心管理界面

功能测试：创建并发布配置

创建示例配置：

1. 点击"创建项目"，填写项目信息
2. 在项目中添加配置项：demo.key=hello-apollo
3. 点击"发布"按钮，填写发布说明

验证配置生效：

# 进入容器查看配置
docker exec -it apollo-quick-start bash
cat /apollo-quick-start/service/configs/application/default/application.properties

预期结果：文件中包含刚创建的配置项。

进阶使用：从测试到生产的无缝过渡

资源占用评估

Apollo各组件资源消耗参考：

组件	CPU占用	内存占用	建议配置
Config Service	5-10%	256-512MB	单实例
Admin Service	5-10%	256-512MB	单实例
Portal	10-15%	512-1024MB	单实例
数据库	10-20%	512-1024MB	建议独立部署

多环境配置方案

通过修改docker-compose.yml可实现多环境隔离部署：

# 示例：添加测试环境配置
services:
  apollo-configservice-test:
    image: apolloconfig/apollo-configservice:latest
    ports:
      - "8081:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=test

💡 最佳实践：为开发、测试、生产环境分别配置独立的数据库和服务实例。

生产环境适配指南

数据持久化配置

# 在docker-compose.yml中添加数据卷配置
volumes:
  mysql-data:
    driver: local

services:
  mysql:
    volumes:
      - mysql-data:/var/lib/mysql

性能优化参数

# 启动时添加JVM参数优化
JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC"

高可用部署架构

图3：Apollo配置中心基础架构

生产环境建议：

• 配置服务至少2个实例
• 使用独立的MySQL集群
• 启用服务注册与发现
• 配置负载均衡

故障排查流程图

服务启动失败?
├─ 检查容器日志 → docker logs [容器ID]
├─ 检查端口占用 → netstat -tulpn | grep 8080
├─ 检查数据库连接 → docker exec -it [mysql容器] mysql -u root
└─ 检查资源使用 → docker stats

常见问题解决：

• 端口冲突：修改docker-compose.yml中的端口映射
• 内存不足：增加Docker分配的内存资源
• 数据库初始化失败：检查sql脚本是否正确挂载

总结

通过本文介绍的轻量级部署方案，您已在5分钟内完成了Apollo配置中心的搭建。这种方式特别适合开发测试环境和小型应用场景。对于生产环境，建议参考官方分布式部署文档，实现高可用架构。

Apollo配置中心的核心优势在于：

• 配置实时更新，无需重启应用
• 完整的权限管理和发布流程
• 多环境、多集群配置隔离
• 完善的配置变更审计功能

现在，您可以开始探索Apollo的更多高级特性，如灰度发布、配置回滚和权限管理等功能。