Apollo配置中心本地开发环境搭建指南

杜月锴Elise

于 2025-06-01 09:02:24 发布

阅读量219

点赞数 3

本文链接：https://blog.youkuaiyun.com/gitblog_00525/article/details/148360365

版权

Apollo配置中心本地开发环境搭建指南

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

前言

Apollo配置中心作为一款成熟的分布式配置管理平台，其本地开发环境的搭建对于开发者理解系统架构、进行二次开发具有重要意义。本文将详细介绍如何在本地环境中编译、运行Apollo配置中心，帮助开发者快速搭建开发环境。

环境准备

基础软件要求

Java环境：需要JDK 1.8或更高版本
数据库：
- MySQL 5.6.5+（生产环境推荐）
- H2内存数据库（开发测试环境可选）
开发工具：推荐使用IntelliJ IDEA或Eclipse等主流Java IDE

数据库初始化

对于MySQL数据库，需要执行以下初始化操作：

创建ApolloConfigDB和ApolloPortalDB两个数据库
执行官方提供的SQL脚本初始化表结构
导入基础数据

项目结构与模块

Apollo采用模块化设计，主要包含以下几个核心模块：

apollo-configservice：配置服务，提供配置获取、推送等功能
apollo-adminservice：管理服务，提供配置修改、发布等功能
apollo-portal：门户服务，提供用户界面和管理功能
apollo-assembly：聚合模块，可同时启动所有服务

本地启动配置

使用apollo-assembly启动

在IntelliJ IDEA中配置运行参数：

Main Class：com.ctrip.framework.apollo.assembly.ApolloApplication

VM Options：

-Dapollo_profile=github,auth
-Dlogging.file.name=/your-path/apollo-assembly.log

MySQL数据库配置

如需使用MySQL数据库，需添加以下参数：

-Dspring.config-datasource.url=jdbc:mysql://your-mysql-server:3306/ApolloConfigDB
-Dspring.config-datasource.username=your-username
-Dspring.config-datasource.password=your-password

-Dspring.portal-datasource.url=jdbc:mysql://your-mysql-server:3306/ApolloPortalDB
-Dspring.portal-datasource.username=your-username
-Dspring.portal-datasource.password=your-password

独立服务启动

也可以选择独立启动各服务：

ConfigService：
- Main Class: com.ctrip.framework.apollo.configservice.ConfigServiceApplication
AdminService：
- Main Class: com.ctrip.framework.apollo.adminservice.AdminServiceApplication
Portal：
- Main Class: com.ctrip.framework.apollo.portal.PortalApplication

服务验证

启动完成后，可通过以下方式验证服务状态：

Eureka服务注册中心：访问http://localhost:8080查看服务注册情况
健康检查接口：
- AdminService: http://localhost:8090/health
- ConfigService: http://localhost:8080/health
Portal界面：访问http://localhost:8070进入管理界面