lhstack/apollo

Apollo配置中心Docker镜像文档

镜像概述

本镜像基于携程开源的Apollo配置中心项目构建，提供高可用的配置管理解决方案。包含configservice、adminservice和portal三大核心组件，支持通过Docker Compose快速部署，适用于分布式系统中配置的集中管理、动态更新和版本控制。

核心功能与特性

• 完整组件支持：包含Apollo核心服务组件（configservice配置服务、adminservice管理服务、portal管理界面）
• 灵活配置：通过环境变量自定义JVM参数、数据库连接、Eureka注册等关键配置
• 高可用部署：支持内嵌Eureka或外部Eureka注册中心，满足高可用架构需求
• 便捷部署：提供docker-compose一键部署方案，简化搭建流程
• 健康检查：内置服务健康检查机制，确保服务可用性

使用场景与适用范围

适用于需要集中管理配置的分布式系统，包括：

• 微服务架构中的配置统一管理
• 多环境（开发、测试、生产）配置隔离与切换
• 需要动态更新配置而无需重启服务的应用
• 对配置变更审计和版本控制有需求的场景

使用方法与配置说明

环境变量说明

通用环境变量

shell
JVM_XMX: "默认: 256m"  # JVM最大堆内存
JVM_XMS: "默认: 256m"  # JVM初始堆内存
JVM_OPTS: "默认: -XX:MaxMetaspaceSize=128m -XX:MetaspaceSize=128m"  # 额外JVM参数
DB_HOST: "数据库host地址"  # 数据库主机地址
DB_PORT: "数据库端口,默认3306"  # 数据库端口
DB_NAME: "数据库名称，configservice/adminservice默认ApolloConfigDB，portal默认ApolloPortalDB"  # 数据库名称
DB_USERNAME: "数据库用户名,默认root"  # 数据库用户名
DB_PASSWORD: "数据库密码,默认123456"  # 数据库密码
MAX_LIFETIME: "hikari连接池max-lifetime,默认600000"  # 连接最大生存时间(毫秒)
MAX_POOL_SIZE: "hikari连接池maximum-pool-size,默认2"  # 最大连接数
MIN_IDLE_SIZE: "hikari连接池minimum-idle,默认1"  # 最小空闲连接数
IDLE_TIMEOUT: "hikari连接池idle-timeout,默认60000"  # 连接空闲超时(毫秒)
CONNECTION_TIMEOUT: "hikari连接池connection-timeout,默认10000"  # 连接超时(毫秒)
LOGFILE_PATH: "日志文件存储地址,默认/app/app.log"  # 日志文件路径

configservice 环境变量

shell
EUREKA_SERVER_ENABLE: "默认值: false，如果为true，则启动内嵌eureka，并使用默认方式连接内置eureka，不启用ServerConfig中的eureka.service.url"  # 是否启用内嵌Eureka

adminservice 环境变量

shell
EUREKA_SERVER_ENABLE: "默认值: false,如果为true，则使用EUREKA_URLS作为eureka注册中心连接地址；如果为false，则使用ApolloConfigDB中ServerConfig表的eureka.service.url"  # Eureka注册方式开关
EUREKA_URLS: "EUREKA_SERVER_ENABLE为true时，作为eureka注册中心连接地址"  # Eureka服务地址列表

单机docker-compose一键搭建

前置准备

1. 安装Docker和Docker Compose
2. 准备Apollo数据库脚本：从Apollo官方仓库获取apolloconfigdb.sql和apolloportaldb.sql，放置于./script目录

docker-compose.yml配置

yaml
version: '3'
services:
  portal:
    image: lhstack/apollo:portal-2.0.0
    container_name: portal
    restart: always
    environment:
      DB_HOST: "apollo-mysql"
      DB_PASSWORD: "654321"
    depends_on:
      mysql:
        condition: service_healthy
      configservice:
        condition: service_healthy
    ports:
    - '8070:8080'
    deploy:
      resources:
        limits:
          memory: "384M"
          cpus: '50m'
    logging:
      options:
        max-file: '2'
        max-size: '32k'
  adminservice:
    image: lhstack/apollo:adminservice-2.0.0
    container_name: adminservice
    restart: always
    ports:
    - '8090:8080'
    environment:
      EUREKA_SERVER_ENABLE: "true"
      EUREKA_URLS: "http://configservice:8080/eureka"
      DB_HOST: "apollo-mysql"
      DB_PASSWORD: "654321"
    depends_on:
      mysql:
        condition: service_healthy
      configservice:
        condition: service_healthy
    deploy:
      resources:
        limits:
          memory: "384M"
          cpus: '50m'
    logging:
      options:
        max-file: '2'
        max-size: '32k'
  configservice:
    image: lhstack/apollo:configservice-2.0.0
    container_name: configservice
    restart: always
    ports:
    - '8080:8080'
    environment:
      EUREKA_SERVER_ENABLE: "true"
      DB_HOST: "apollo-mysql"
      DB_PASSWORD: "654321"
    depends_on:
      mysql:
        condition: service_healthy
    healthcheck:
      test: ["CMD-SHELL","wget --no-cache --spider 'http://localhost:8080/health' || exit 1"]
      timeout: "2s"
      interval: "10s"
      retries: 5
      start_period: "15s"
    deploy:
      resources:
        limits:
          memory: "384M"
          cpus: '50m'
    logging:
      options:
        max-file: '2'
        max-size: '32k'
  mysql:
    image: mysql:5.7.28
    container_name: apollo-mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: "654321"
    healthcheck:
      test: ["CMD","mysqladmin","-uroot","-p${MYSQL_ROOT_PASSWORD}","ping","-h","localhost"]
      timeout: "2s"
      interval: "10s"
      retries: 5
      start_period: "5s"
    volumes:
    - ./data:/var/lib/mysql
    - ./script:/docker-entrypoint-initdb.d/
    deploy:
      resources:
        limits:
          memory: "256M"
          cpus: "50m"

启动与初始配置流程

1. 在docker-compose.yml所在目录执行命令启动服务：

   bash
   docker-compose up -d
   

2. 服务启动后，进行初始配置：

   • 访问Apollo Portal：http://localhost:8070
   • 点击右上角导航菜单：管理员工具
   • 在弹出菜单中点击：系统参数
   • 在key输入框填写：apollo.portal.meta.servers，点击查询
   • 将返回的内容替换为以下JSON，点击更新：

     json
     {
         "dev":"http://configservice:8080"
     }
     

   • 等待片刻后刷新页面，点击创建应用即可看到dev环境
   • 新增其他环境请参考Apollo官方文档

参考链接

• 携程Apollo Gitee地址
• https://github.com/ctripcorp/apollo
• 携程Apollo官方网站
• 使用docker-compose搭建高可用Apollo配置中心