arm64v8/kaazing-gateway Docker镜像文档

废弃通知（DEPRECATION NOTICE）

此镜像因缺乏维护已废弃（最后更新于2018年7月；docker-library/official-images#4575）。

镜像概述

arm64v8/kaazing-gateway是kaazing-gateway官方镜像的arm64v8架构专用仓库。Kaazing Gateway是一个网络网关，旨在为实时Web协议提供单一访问点，支持负载均衡、集群和安全管理，设计用于在各种平台、浏览器和设备上提供可扩展且安全的双向事件通信。

镜像概述和主要用途

Kaazing Gateway是一个网络网关，主要用途是为实时Web协议提供单一访问点，支持负载均衡、集群和安全管理。它专为在Web上提供可扩展、安全的双向事件通信而设计，适用于各种平台、浏览器和设备。

核心功能和特性

• 单一访问点：为实时Web协议提供统一的接入入口
• 负载均衡：支持对后端服务的负载分发
• 集群支持：支持集群部署以提升可用性和扩展性
• 安全管理：提供安全相关功能，保障通信安全
• 双向通信：设计用于基于Web的双向事件通信
• 跨平台支持：兼容多种平台、浏览器和设备

使用场景和适用范围

适用于需要实时双向通信的Web应用场景，例如：

• WebSocket服务部署（如实时消息推送、实时数据更新）
• 实时Web应用的接入层（统一入口、负载均衡）
• 需要跨平台实时通信支持的系统

详细使用方法和配置说明

基本运行（Up and Running）

默认情况下，网关运行WebSocket回显服务（类似websocket.org）。运行容器时需指定主机名，并通过环境变量GATEWAY_OPTS传递配置参数：

$ docker run --name some-kaazing-gateway -h somehostname -e GATEWAY_OPTS="-Dgateway.hostname=somehostname -Xmx512m -Djava.security.egd=file:/dev/urandom" -d -p 8000:8000 arm64v8/kaazing-gateway

参数说明：

• -h somehostname：指定容器主机名
• -e GATEWAY_OPTS="..."：设置JVM参数和网关配置，包括：
  • -Dgateway.hostname=somehostname：指定网关主机名
  • -Xmx512m：设置JVM最大堆内存为512MB
  • -Djava.security.egd=file:/dev/urandom：加速VM环境下的启动速度
• -p 8000:8000：映射容器8000端口到主机，用于WebSocket通信

测试连接： 启动后，可通过WebSocket回显测试工具连接ws://somehostname:8000。需确保somehostname可从浏览器解析（可能需要在/etc/hosts中添加dockerhost ip somehostname条目）。

自定义配置（Custom Configuration）

如需使用自定义配置文件，可通过挂载本地配置文件到容器：

$ docker run --name some-kaazing-gateway -h somehostname -e GATEWAY_OPTS="-Dgateway.hostname=somehostname -Xmx512m -Djava.security.egd=file:/dev/urandom" -v /some/gateway-config.xml:/kaazing-gateway/conf/gateway-config.xml:ro -d arm64v8/kaazing-gateway

获取默认配置文件： 如需基于默认配置修改，可从运行中的容器复制配置文件：

$ docker cp some-kaazing-gateway:/kaazing-gateway/conf/gateway-config-minimal.xml /some/gateway-config.xml

通过Dockerfile自定义： 也可通过Dockerfile构建包含自定义配置的镜像：

FROM arm64v8/kaazing-gateway
COPY gateway-config.xml conf/gateway-config.xml

构建并运行：

$ docker build -t some-custom-kaazing-gateway .
$ docker run --name some-kaazing-gateway -d some-custom-kaazing-gateway

配置文件语法参考：详见官方文档的“管理员指南”部分。

环境变量：GATEWAY_OPTS

GATEWAY_OPTS用于传递JVM参数和网关配置选项，详细说明见官方文档。常用选项包括：

• -Dgateway.hostname=<hostname>：指定网关主机名（必须与容器主机名一致）
• -Xmx<size>：设置JVM最大堆内存（如-Xmx512m）
• -Djava.security.egd=file:/dev/urandom：优化随机数生成，加速启动

支持的标签和架构

支持的标签及Dockerfile链接

• 5.6.0, 5.6, 5, latest

支持的架构

• amd64：amd64/kaazing-gateway
• arm64v8：arm64v8/kaazing-gateway

其他信息

维护者

Kaazing Docker Maintainers

获取帮助

• Docker社区论坛：forums.docker.com
• Docker社区Slack：dockr.ly/slack
• Stack Overflow：stackoverflow.com

问题反馈

提交issue至：github.com/kaazing/gateway.docker/issues

镜像更新

• 官方镜像仓库标签：library/kaazing-gateway
• 官方镜像配置文件：library/kaazing-gateway（历史记录）

许可证

软件许可证信息详见github.com/kaazing/gateway/LICENSE.txt。镜像可能包含其他软件组件，其许可证需参考基础镜像及依赖项。

注意：此镜像为arm64v8架构专用构建，基于kaazing-gateway官方镜像。更多架构相关信息见官方镜像文档。