gigaspaces/smart-cache-enterprise

Smart Cache 企业版

!InsightEdge logo

什么是Smart Cache企业版？

Smart Cache是最快、最具可扩展性的分布式缓存层，可运行于任何操作型数据源，用于加速数字应用并支持实时报告与BI。Smart Cache针对快速变化的数据和多条件查询进行了优化，且完全兼容SQL。

优势与特性：

• 原生多条件查询，实现极致性能 - 与键值解决方案不同，Smart Cache支持无限数量的高级索引（如范围索引、复合索引、文本索引等），实现最佳性能，同时完全符合SQL标准。
• 业务驱动的缓存策略，优化成本与性能平衡 - 掌控数据，将最重要的数据保留在内存中。借助高级业务驱动策略，不再受限于LRU分层逻辑。
• AIOps自主扩展 - 针对事务和分析工作负载，通过Kubernetes、OpenShift或GigaSpaces ElasticGrid自动触发横向或纵向扩展。扩展以滚动方式进行，无停机时间或性能影响。
• 无代码一键式数据库集成 - 只需一键，平台即可扫描数据库及其元数据，将其数据模型映射到GigaSpaces存储，并定义索引和分区架构，消除数周的手动工作和人为错误。
• 快速服务器端聚合 - Smart Cache在服务器端分布式内存中执行整个聚合操作，避免将数据检索回客户端。聚合仅对相关数据执行，与总数据量无关。
• 永不丢失写入 - 实现强数据一致性。与最终一致性缓存解决方案不同，Smart Cache确保完全的数据完整性，意味着数据永不丢失，无论在何种负载或环境下。

要了解更多GigaSpaces产品信息，请访问官网。

目录

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

快速开始

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

docker run gigaspaces/smart-cache-enterprise --help

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

docker run gigaspaces/smart-cache-enterprise version

如何使用此镜像

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

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

运行第一个容器

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

要在本地机器上运行单个主机：

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

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

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

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

连接客户端

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

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

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

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

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

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

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

使用主机网络

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

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

配置公共主机

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

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

在多主机上运行生产集群

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

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

高级配置

配置GigaSpaces Manager服务器IP地址

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

端口

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

运行其他CLI命令

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

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

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

使用不同Java版本

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

docker build --build-arg JAVA_TAG=9 -t gigaspaces/smart-cache-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 .