arm64v8/kaazing-gateway

arm64v8/kaazing-gateway Docker镜像文档

废弃通知（DEPRECATION NOTICE）

此镜像因缺乏维护已废弃（最后更新于2018年7月；https://github.com/docker-library/official-images/pull/4575%EF%BC%89%E3%80%82

镜像概述

arm64v8/kaazing-gateway是https://hub.docker.com/_/kaazing-gateway%E7%9A%84%60arm64v8%60%E6%9E%B6%E6%9E%84%E4%B8%93%E7%94%A8%E4%BB%93%E5%BA%93%E3%80%82Kaazing Gateway是一个网络网关，旨在为实时Web协议提供单一访问点，支持负载均衡、集群和安全管理，设计用于在各种平台、浏览器和设备上提供可扩展且安全的双向事件通信。

镜像概述和主要用途

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

核心功能和特性

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

使用场景和适用范围

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

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

详细使用方法和配置说明

基本运行（Up and Running）

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

console
$ 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）

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

console
$ 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

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

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

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

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

构建并运行：

console
$ 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链接

• https://github.com/kaazing/gateway.docker/blob/a40c8da9d2c2925bdd78b9a6d1b6da3fe89322d1/Dockerfile

支持的架构

• amd64：https://hub.docker.com/r/amd64/kaazing-gateway/
• arm64v8：https://hub.docker.com/r/arm64v8/kaazing-gateway/

其他信息

维护者

https://github.com/kaazing/gateway.docker

获取帮助

• Docker社区论坛：https://forums.docker.com/
• Docker社区Slack：https://dockr.ly/slack
• Stack Overflow：https://stackoverflow.com/search?tab=newest&q=docker

问题反馈

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

镜像更新

• 官方镜像仓库标签：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fkaazing-gateway
• 官方镜像配置文件：https://github.com/docker-library/official-images/blob/master/library/kaazing-gateway%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/kaazing-gateway%EF%BC%89

许可证

软件许可证信息详见https://github.com/kaazing/gateway/blob/master/LICENSE.txt%E3%80%82%E9%95%9C%E5%83%8F%E5%8F%AF%E8%83%BD%E5%8C%85%E5%90%AB%E5%85%B6%E4%BB%96%E8%BD%AF%E4%BB%B6%E7%BB%84%E4%BB%B6%EF%BC%8C%E5%85%B6%E8%AE%B8%E5%8F%AF%E8%AF%81%E9%9C%80%E5%8F%82%E8%80%83%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E5%8F%8A%E4%BE%9D%E8%B5%96%E9%A1%B9%E3%80%82

注意：此镜像为arm64v8架构专用构建，基于https://hub.docker.com/_/kaazing-gateway%E3%80%82%E6%9B%B4%E5%A4%9A%E6%9E%B6%E6%9E%84%E7%9B%B8%E5%85%B3%E4%BF%A1%E6%81%AF%E8%A7%81https://github.com/docker-library/official-images#architectures-other-than-amd64%E3%80%82