infinispan/server-native

Infinispan Server原生Docker镜像文档

镜像概述和主要用途

Infinispan Server原生Docker镜像提供快速部署Infinispan服务器的方式。Infinispan是开源数据网格平台和高可扩展NoSQL云数据存储，支持分布式缓存、数据持久化及集群功能。该镜像内置认证机制，暴露HotRod和REST端点，支持通过环境变量、批处理文件或自定义配置实现灵活部署，适用于开发、测试及生产环境的数据网格部署。

核心功能和特性

• 多协议支持：默认暴露HotRod和REST端点，端口***
• 认证机制：支持自动生成管理员凭证、环境变量配置及批处理文件定义多用户角色
• 灵活配置：支持自定义服务器配置文件、Java系统属性及JVM选项
• 集群兼容：适配Kubernetes/OpenShift环境，支持DNS_PING协议实现节点发现
• 扩展能力：可部署外部artifacts（如JDBC驱动）至服务器lib目录
• 调试支持：提供镜像配置调试、服务器运行时调试及基础系统工具

使用场景和适用范围

• 开发环境：快速启动Infinispan实例验证数据网格功能
• 测试环境：配置多用户角色和集群拓扑进行集成测试
• Kubernetes集群：部署高可用数据网格，作为分布式缓存或NoSQL存储服务

使用方法和配置说明

快速启动

通过以下命令快速启动Infinispan Server容器：

bash
# Docker
docker run -p 11222:11222 infinispan/server-native

# Podman（非sudo用户需添加--net=host）
podman run --net=host -p 11222:11222 infinispan/server-native

默认行为：

• 自动生成带"admin"角色的用户名/密码，输出至stdout
• 暴露认证后的HotRod和REST端点，端口***
• 客户端需使用输出的凭证访问端点

配置管理员用户

通过环境变量USER和PASS自定义管理员凭证：

bash
docker run -p 11222:11222 -e USER="admin" -e PASS="changeme" infinispan/server-native

注意：环境变量配置建议仅用于初始开发，生产环境推荐使用Identities Batch文件实现细粒度用户控制。

HotRod客户端配置

连接HotRod客户端时需配置以下SASL属性（替换实际用户名密码）：

properties
infinispan.client.hotrod.auth_username=admin
infinispan.client.hotrod.auth_password=changeme
infinispan.client.hotrod.sasl_mechanism=DIGEST-MD5

Identities Batch文件

通过IDENTITIES_BATCH环境变量指定批处理文件，定义用户身份及角色。批处理文件支持user create命令创建用户并分配角色。

示例批处理文件（identities.batch）

bash
# 创建带admin角色的用户
user create "Alan Shearer" -p "striker9" -g admin
# 创建无特定角色用户
user create "observer" -p "secret1" 
# 创建部署者用户
user create "deployer" -p "secret2" 
# 创建带monitor角色的用户
user create "Rigoberta Baldini" -p "secret3" -g monitor

挂载批处理文件运行

bash
docker run -v $(pwd):/user-config -e IDENTITIES_BATCH="/user-config/identities.batch" -p 11222:11222 infinispan/server-native

参考：了解更多用户角色配置请查阅Infinispan默认用户角色文档

服务器配置

自定义配置文件

通过-c参数指定自定义配置文件（需挂载本地目录）：

bash
docker run -v $(pwd):/user-config -e IDENTITIES_BATCH="/user-config/identities.batch" -p 11222:11222 infinispan/server-native -c /user-config/my-infinispan-config.xml

Kubernetes/OpenShift集群配置

Kubernetes环境中需禁用多播，使用JGroups DNS_PING协议发现节点：

bash
docker run -v $(pwd):/user-config infinispan/server-native \
  --bind-address=0.0.0.0 \
  -Dinfinispan.cluster.stack=kubernetes \
  -Djgroups.dns.query="infinispan-dns-ping.myproject.svc.cluster.local"

Java属性和JVM选项

通过JAVA_OPTIONS环境变量传递Java系统属性和JVM选项：

bash
# 示例：配置CORS
docker run -e JAVA_OPTIONS="-Dinfinispan.cors.enableAll=https://host.domain:port" infinispan/server-native

部署Artifacts至服务器lib目录

通过SERVER_LIBS环境变量部署artifacts（支持Maven坐标或URL）：

bash
# 示例：部署PostgreSQL JDBC驱动
docker run -e SERVER_LIBS="org.postgresql:postgresql:42.3.1" infinispan/server-native

说明：SERVER_LIBS支持空格分隔的多个artifacts，tar/gz/zip格式会自动解压。更多细节见InfinispanCLI install命令文档。

调试

镜像配置调试

设置DEBUG=TRUE环境变量调试镜像配置脚本：

bash
docker run -e DEBUG=true infinispan/server-native

Infinispan Server调试

设置DEBUG_PORT环境变量开启服务器调试（暴露调试端口）：

bash
docker run -e DEBUG_PORT="*:8787" -p 8787:8787 infinispan/server-native

镜像工具

该镜像基于ubi-minimal构建，包含以下常用调试工具：

Kubernetes配置

存活和就绪探针

推荐使用REST端点配置Kubernetes探针，检查服务器状态：

yaml
livenessProbe:
  httpGet:
    path: /rest/v2/cache-managers/default/health/status
    port: ***
  failureThreshold: 5
  initialDelaySeconds: 10
  successThreshold: 1
  timeoutSeconds: 10
readinessProbe:
  httpGet:
    path: /rest/v2/cache-managers/default/health/status
    port: ***
  failureThreshold: 5
  initialDelaySeconds: 10
  successThreshold: 1
  timeoutSeconds: 10