gigaspaces/insightedge-enterprise

InsightEdge Enterprise

!InsightEdge logo

什么是InsightEdge Enterprise？

InsightEdge平台是XAP内存数据网格与开源分析生态系统的组合，是一款内存洞察平台，支持快速数据分析、人工智能和实时应用。客户可基于此平台开发系统，以亚秒级分析响应提供即时数据驱动洞察。InsightEdge还支持通过Apache Spark实现从SQL、流处理到机器学习的超大规模分析。

InsightEdge Enterprise具有以下优势：

• 支持完整应用在单一平台上运行，所有层级整合到一个容器中
• 通过将所有数据存储在内存中实现快速数据访问，并通过容器内的内存备份确保高可用性
• 支持应用自动按需扩展
• 因应用与分析协同定位，实现超低延迟、高吞吐量事务和流处理的极致性能。所有功能均支持云原生、基础设施无关的部署，适用于混合云和本地环境

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

目录

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

入门

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

docker run gigaspaces/insightedge-enterprise --help

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

docker run gigaspaces/insightedge-enterprise version

如何使用此镜像

InsightEdge Enterprise Docker镜像使用GigaSpaces命令行界面(CLI)。要了解更多命令行界面信息，请参阅CLI文档，或使用--help选项。

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

运行第一个容器

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

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

docker run --name test -it -e GS_LICENSE=tryme gigaspaces/insightedge-enterprise

运行InsightEdge Enterprise Docker镜像时若不带参数，将自动启动包含以下组件的主机：

• 平台管理器（映射到端口8090）了解更多
• Web管理控制台（映射到端口8099）了解更多
• Spark主节点（映射到端口8080）
• Spark工作节点（映射到端口8081）
• Apache Zeppelin（映射到端口9090）

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

连接客户端

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选项。

配置公共主机

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

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

在多主机上运行生产集群

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

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

高级配置

配置GS_MANAGER_SERVERS IP地址

在多主机上运行InsightEdge Enterprise时，您可以在GS_MANAGER_SERVERS环境变量中配置网络中平台管理器的IP地址。默认GS_MANAGER_SERVERS=host1,host2,host3为本地管理器。

端口

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

运行其他CLI命令

InsightEdge Enterprise Docker镜像使用GigaSpaces命令行界面(CLI)。镜像名称后的任何参数都将传递给命令行。

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

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

使用不同Java版本

此InsightEdge Enterprise 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/insightedge-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 .