gigaspaces/xap-enterprise

XAP 内存数据网格

!XAP logo

什么是XAP企业版？

XAP企业版是一种云原生、高吞吐量且低延迟的应用架构，支持实时、事件驱动的微服务和分布式应用，助力互联网规模创新。XAP企业版可根据业务需求扩展，从简单数据处理到复杂事务工作负载，再到利用混合存储和数据中心层级。

XAP企业版提供以下优势：

• 支持完整应用在单一平台上运行，所有层级整合到一个容器中。
• 通过将所有数据存储在内存中实现快速数据访问，并通过每个容器内的内存备份确保高可用性。
• 自动且按需扩展应用。

要了解更多GigaSpaces产品，请访问官方网站。

目录

• 快速开始
• 如何使用此镜像
• 运行第一个容器
• 连接到客户端
• 使用Docker桥接网络运行客户端
• 在另一个Docker容器中运行客户端
• 使用主机网络
• 配置XAP公共主机
• 在多主机上运行生产集群
• 高级配置
  • 配置XAP管理器服务器IP地址
  • 端口
  • 运行其他CLI命令
  • 使用不同Java版本
  • 访问日志

快速开始

要测试XAP企业版Docker镜像，在命令行中运行以下命令以显示包含所有可用命令的帮助屏幕：

docker run gigaspaces/xap-enterprise --help

例如，version命令打印版本信息：

docker run gigaspaces/xap-enterprise version

如何使用此镜像

XAP企业版Docker镜像使用GigaSpaces的命令行界面（CLI）。要了解更多关于命令行界面的信息，请参阅CLI文档，或使用--help选项。

XAP企业版镜像运行需要许可证密钥，可通过GS_LICENSE环境变量提供。您可以使用tryme许可证（允许24小时内使用完整XAP产品，之后镜像将终止），或获取更长时间的评估许可证。

运行第一个容器

开始使用XAP企业版最简单快速的方法是在本地机器上启动单个实例。实例启动后，您可以开始探索可用功能和能力。

要在本地运行单个主机：

docker run --name test -it -e GS_LICENSE=tryme -p 8090:8090 -p 8099:8099 gigaspaces/xap-enterprise

运行XAP企业版Docker镜像时不带参数，将自动启动包含以下组件的主机：

• 平台管理器（映射到端口8090）了解更多
• Web管理控制台（映射到端口8099）了解更多

注意：这些端口已映射到您的主机，因此您可以访问它们。

连接到客户端

Docker默认在桥接网络中运行容器。您可以使用以下任一选项使客户端能够连接到空间（Space）。

使用Docker桥接网络运行客户端

默认情况下，客户端使用主机网络接口。您可以配置客户端使用Docker桥接网络接口（IP地址通常为172.17.0.x）。使用GS_NIC_ADDRESS环境变量使客户端能够联系并与空间交互。

注意：这仅适用于与空间位于同一主机上的客户端。Docker桥接网络对其他主机不可访问。

在另一个Docker容器中运行客户端

位于同一主机上的Docker容器使用相同的桥接网络。如果客户端在处理单元（Processing Unit）中，您可以通过另一个Docker容器使用pu run命令运行它。

注意：这仅适用于与空间位于同一主机上的客户端。其他主机上的Docker容器将使用不同的桥接网络。

使用主机网络

Docker可以使用docker run命令的--net=host选项在主机网络上运行容器。在这种情况下，客户端无需额外配置即可连接并与空间交互。

注意：Docker仅在Linux主机上支持--net=host选项。

配置XAP公共主机

默认情况下，XAP通信协议（LRMI）使用相同的网络接口进行绑定和发布。您可以使用GS_PUBLIC_HOST环境变量修改此设置，指示XAP企业版使用不同的网络地址（例如主机的网络地址）发布自身。在这种情况下，您需要将端口部分列出的端口从Docker容器暴露到主机。例如：

docker run --name test -it -e GS_LICENSE=tryme -e GS_PUBLIC_HOST=<您的主机IP或名称> -p 4174:4174 -p 8200-8300:8200-8300 gigaspaces/xap-enterprise

在多主机上运行生产集群

在多主机上的Docker容器中运行XAP企业版时，您需要配置GS_PUBLIC_HOST或使用上述--net=host选项，以便不同主机上的容器能够相互交互。

GS_PUBLIC_HOST环境变量符合Docker使用的常见实践，并保持镜像隔离。然而，根据Docker文档，为获得最佳性能，建议使用--net=host选项，该选项使用主机网络并消除额外的网络跳转。XAP Docker镜像支持这两种选项，因此请选择最适合您需求的选项。

高级配置

配置XAP管理器服务器IP地址

在多主机上运行XAP企业版时，您可以在网络中配置XAP管理器服务器IP地址。GS_MANAGER_SERVERS=host1,host2,host3默认是本地管理器。

端口

XAP企业版Docker镜像使用下表中描述的端口。您可以使用相应的环境变量更改每个端口，或使用docker run中的-p选项将其映射到不同端口。例如，-p 5174:4174将查找发现端口映射到不同端口，但在容器内保持相同端口。

运行其他CLI命令

XAP企业版Docker镜像使用GigaSpaces的命令行界面（CLI）。镜像名称后的任何参数都将传递给命令行。

如果镜像后未指定参数，将运行默认的host run-agent --auto命令。

要了解更多关于命令行界面的信息，请参阅CLI文档，或使用--help选项。

使用不同Java版本

此XAP企业版Docker镜像基于官方https://hub.docker.com/_/openjdk/%E9%95%9C%E5%83%8F%EF%BC%8C%E5%B9%B6%E4%BD%BF%E7%94%A8Java 8版本。要使用不同的Java版本，您必须使用JAVA_TAG构建参数构建新镜像。例如：

docker build --build-arg JAVA_TAG=9 -t gigaspaces/xap-enterprise:openjdk-9 .

如果不确定可用版本，请参阅https://hub.docker.com/r/library/openjdk/tags/%E9%A1%B5%E9%9D%A2%E3%80%82

您还可以使用JAVA_IMAGE构建参数（例如--build-arg JAVA_IMAGE=...）从不同的基础镜像构建，甚至创建自己的镜像。

访问日志

所有日志存储在容器内的opt/gigaspaces/logs中。要访问日志，您可以执行以下任一操作：

• 在docker run命令中使用-v选项将此目录映射到主机上的文件夹。
• 使用docker cp命令将文件从Docker实例复制到主机上的位置。

要挂载目录以获取日志，请使用以下命令：

 -v c:/gigaspaces/test/logs:/opt/gigaspaces/logs

要从运行中的实例复制日志，请使用以下命令：

docker cp containerId:/opt/gigaspaces/logs .