Apollo配置中心快速入门指南

Apollo配置中心快速入门指南

apollo apolloconfig/apollo: 是一个分布式配置管理平台，可以方便地实现配置的统一管理和发布。该项目提供了一个简单易用的配置管理平台，可以方便地实现配置的统一管理和发布，同时支持多种配置格式和部署方式。 项目地址: https://gitcode.com/gh_mirrors/apoll/apollo

前言

Apollo配置中心是一款功能强大的分布式配置管理系统，能够帮助开发者高效管理应用配置。本文将详细介绍如何在本地环境中快速部署和启动Apollo配置中心，适合初次接触Apollo的开发者快速上手体验。

环境准备

Java环境要求

Apollo对Java版本有明确要求：

• 服务端：Java 1.8+
• 客户端：Java 1.8+
  • 如需在Java 1.7环境下运行客户端，请使用1.x版本的Apollo客户端

验证Java版本命令：

java -version

MySQL数据库要求

如果选择使用MySQL作为存储数据库：

• 版本要求：5.6.5+
• 原因：Apollo表结构使用了多个timestamp的default声明，需要MySQL 5.6.5+支持

验证MySQL版本命令：

SHOW VARIABLES WHERE Variable_name = 'version';

安装包获取

Apollo提供了Quick Start安装包，免去了编译打包过程：

1. 直接下载预编译包（约50MB）
2. 安装包包含所有依赖jar包和内置Tomcat容器

数据库初始化与启动

Apollo支持多种数据库存储方案，开发者可根据需求选择：

1. H2内存数据库（测试用）

特点：

• 无需额外配置
• 进程重启后数据丢失

启动命令：

export SPRING_PROFILES_ACTIVE="github,database-discovery,auth"
java -jar apollo-all-in-one.jar

2. H2文件数据库

特点：

• 数据持久化到文件
• 首次启动需初始化

首次启动：

export SPRING_PROFILES_ACTIVE="github,database-discovery,auth"
export SPRING_SQL_CONFIG_INIT_MODE="always"
export SPRING_CONFIG_DATASOURCE_URL="jdbc:h2:file:~/apollo/apollo-config-db;..."
export SPRING_SQL_PORTAL_INIT_MODE="always"
export SPRING_PORTAL_DATASOURCE_URL="jdbc:h2:file:~/apollo/apollo-portal-db;..."
java -jar apollo-all-in-one.jar

后续启动：

unset SPRING_SQL_CONFIG_INIT_MODE
unset SPRING_SQL_PORTAL_INIT_MODE
# 其他配置同上

3. MySQL数据库（生产推荐）

特点：

• 适合生产环境
• 支持分布式部署

首次启动：

export SPRING_PROFILES_ACTIVE="github,database-discovery,auth"
export SPRING_SQL_CONFIG_INIT_MODE="always"
export SPRING_CONFIG_DATASOURCE_URL="jdbc:mysql://your-mysql-server:3306/ApolloConfigDB..."
export SPRING_CONFIG_DATASOURCE_USERNAME="your-username"
export SPRING_CONFIG_DATASOURCE_PASSWORD="your-password"
# Portal DB配置类似
java -jar apollo-all-in-one.jar

后续启动：

unset SPRING_SQL_CONFIG_INIT_MODE
unset SPRING_SQL_PORTAL_INIT_MODE
# 其他配置同上

使用Apollo配置中心

1. 初始化样例配置

1. 访问 http://localhost:8070
2. 使用默认账号登录（用户名：apollo，密码：admin）
3. 创建SampleApp应用
4. 添加timeout配置项（值设为1000）
5. 发布配置

2. 运行客户端程序

Apollo提供了简单的Demo客户端演示配置获取：

1. 运行./demo.sh client启动客户端
2. 输入timeout查看配置值（应显示1000）

3. 修改配置并发布

1. 返回配置界面，修改timeout值为2000
2. 发布配置
3. 客户端将自动收到配置变更通知

4. 接入新项目

1. 参考Java应用接入指南
2. 修改client/META-INF/app.properties中的app.id
3. 重新启动客户端

注意事项

1. Quick Start仅适用于本地测试，生产环境请参考分布式部署指南
2. 默认占用端口：8070、8080、8090，请确保这些端口可用
3. 使用H2内存数据库时，重启会导致数据丢失
4. 如需增加环境，必须通过分布式部署实现

总结

通过本文的Quick Start指南，开发者可以快速搭建Apollo配置中心本地测试环境，体验配置管理的基本功能。Apollo提供了灵活的存储方案和强大的配置管理能力，是现代化应用配置管理的优秀解决方案。

apollo apolloconfig/apollo: 是一个分布式配置管理平台，可以方便地实现配置的统一管理和发布。该项目提供了一个简单易用的配置管理平台，可以方便地实现配置的统一管理和发布，同时支持多种配置格式和部署方式。 项目地址: https://gitcode.com/gh_mirrors/apoll/apollo