cloudnativedata/apache-geode-config-server

Apache Geode配置服务器Docker镜像文档

镜像概述

本镜像提供基于Apache Geode的配置服务器功能，用于集中管理应用配置数据。通过Geode的分布式缓存能力实现配置的持久化存储和高可用性，支持客户端通过标准HTTP API或Spring Cloud Config规范访问配置信息，适用于微服务架构中的配置集中管理需求。

核心功能与特性

• 分布式存储：基于Geode定位器(Locator)和缓存服务器(Server)实现配置数据的分布式管理
• 持久化与冗余：支持创建分区冗余持久化区域(PARTITION_REDUNDANT_PERSISTENT)，确保配置数据可靠性
• PDX序列化：启用PDX序列化支持，优化对象存储性能
• HTTP API：提供HTTP接口用于配置数据的提交与查询
• Spring集成：支持Spring Cloud Config客户端无缝集成

使用场景

• 微服务架构中多应用实例的配置集中管理
• 需要配置数据持久化和高可用性的场景
• 基于Spring Cloud生态的应用配置管理
• 动态配置更新与分发需求

使用方法与配置说明

服务器端设置

启动定位器与缓存服务器

shell
# 启动定位器
start locator --name=locator

# 配置PDX序列化
configure pdx --read-serialized=true --disk-store=DEFAULT

# 启动缓存服务器
start server --name=server1 

创建配置存储区域

shell
# 创建分区冗余持久化区域用于存储配置
create region --name=Properties --type=PARTITION_REDUNDANT_PERSISTENT

测试方法

提交配置数据

通过HTTP API提交配置数据：

shell
curl -d '{"propertySources": [{"name" : "name", "source" : {"prop1" : "value1" } }]}' -H 'Content-Type: application/json' http://localhost:8888/environment/bank-acct-cdc-source/default/null

访问配置数据

通过浏览器或HTTP客户端访问配置：

shell
open http://localhost:8888/bank-acct-cdc-source/default

客户端配置

添加依赖

Maven

xml
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-config</artifactId>
</dependency>

Gradle

kotlin
dependencies {
  implementation 'org.springframework.cloud:spring-cloud-starter-config'
}

配置客户端属性

在Spring应用配置文件中设置配置服务器地址：

properties
spring.cloud.config.uri=http://localhost:8888 

Docker构建与部署

构建镜像

shell
gradle clean build :applications:geode-config-server:bootBuildImage

标记与推送镜像

shell
docker tag geode-config-server:0.0.1-SNAPSHOT cloudnativedata/apache-geode-config-server:0.0.1-SNAPSHOT 
docker login
docker push cloudnativedata/apache-geode-config-server:0.0.1-SNAPSHOT

加载属性配置

通过命令行参数加载多应用配置：

shell
java -jar applications/geode-config-server/build/libs/geode-config-server-0.0.1-SNAPSHOT.jar  --environment.json.array='[{ "name": "geode-config-server1", "propertySources": [ {"name" :  "application.properties", "source" : { "server.port" : 8888, "spring.application.name" : "geode-config-server" } } ], "profiles": ["profiles"] }, { "name": "atm-rest-service", "propertySources": [ {"name" :  "application.properties", "source" : { "server.port" : 4002, "spring.data.gemfire.pool.locators" : "localhost[10334]" } } ], "profiles": ["default"] }, { "name": "atm-geode-sink", "propertySources": [ {"name" :  "application.properties", "source" : { "server.port" : 0, "spring.data.gemfire.pool.locators" : "localhost[10334]", "spring.rabbitmq.stream.host" : "localhost", "spring.rabbitmq.host" : "localhost", "spring.rabbitmq.username" : "guest", "spring.rabbitmq.password" : "guest", "spring.cloud.stream.bindings.atmConsumer-in-0.consumer.declareExchange" : "false" } } ], "profiles": ["default"] } ]'

密钥库配置

生成JKS密钥库用于安全配置：

shell
keytool -genkeypair -alias changemekey -keyalg RSA \
  -dname "CN=Web Server,OU=Unit,O=Organization,L=City,S=State,C=US" \
  -keypass changeme -keystore server.jks -storepass changeme

开发配置示例

JSON格式的配置示例：

json
{
  "id": "***",
  "propertySources": [
    {"name" :  "application.properties",
      "source" : {
        "server.port" : 8888,
        "spring.application.name" : "geode-config-server"
        
      }
    }
  ],
  "profiles": ["profiles"],
  "name": "geode-config-server"
}