georchestra/gateway

georchestra/gateway 镜像文档

基本信息

镜像概述和主要用途

georchestra/gateway 是 geOrchestra 空间数据基础设施（SDI）的网关模块，作为 geOrchestra 架构中的关键组件，负责处理认证授权、协议转换等核心网关功能，保障整个 SDI 系统的安全访问和高效通信。

核心功能和特性

• 认证与授权：支持 OAuth2 和 OpenID Connect 协议，同时提供 LDAP 认证授权机制，实现统一身份管理
• 协议支持：兼容 HTTP/2，提升网络传输效率
• 实时通信：支持 Websockets，满足实时数据交互需求

使用场景和适用范围

适用于基于 geOrchestra SDI 构建的地理信息系统环境，主要用于：

• 统一管理用户认证与授权流程
• 提供安全的 API 访问入口
• 支持现代 Web 应用的 HTTP/2 和 Websockets 通信需求
• 整合 LDAP 或 OAuth2/OpenID Connect 身份提供商的场景

使用方法和配置说明

配置目录

该镜像的配置文件存储在 geOrchestra 数据目录（https://github.com/georchestra/datadir%EF%BC%89%E7%9A%84 gateway 子目录中，通常路径为 /etc/georchestra/gateway。需确保该目录包含正确的配置文件（如 application.properties 等）。

推荐部署方式

建议通过 geOrchestra 官方 Docker 组合部署，具体参考 https://github.com/georchestra/docker 仓库。该仓库中的 docker-compose.yml 文件包含 gateway 组件的完整配置，示例片段如下：

yaml
# 来自 https://github.com/georchestra/docker/blob/master/docker-compose.yml 的 gateway 部分示例
gateway:
  image: georchestra/gateway:latest
  volumes:
    - ${GEORCHESTRA_DATADIR}:/etc/georchestra:ro
  ports:
    - "443:443"
  depends_on:
    - ldap
    - postgres
  environment:
    - SPRING_PROFILES_ACTIVE=docker

镜像构建

使用 Maven 构建

在 geOrchestra 源码仓库根目录执行：

bash
./mvnw package -f gateway/ -Pdocker

使用 Make 构建

在源码仓库根目录执行：

bash
make docker

测试方法

使用 Maven 运行测试

在源码仓库根目录执行：

bash
./mvnw verify -pl :georchestra-gateway -ntp

使用 Make 运行测试

在源码仓库根目录执行：

bash
make test

许可证信息

镜像中软件的许可证信息详见 geOrchestra 软件许可。
与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础系统的 Bash 等），这些软件可能受其他许可证约束。用户需自行确保使用本镜像符合所有包含软件的许可证要求。