Express Gateway Docker镜像文档

弃用通知

该项目已不再维护。详情或有意接管项目请参见此处。

镜像概述

Express Gateway是一个API网关，位于任何微服务架构的核心位置，无论使用何种语言或平台。它使用Node.js、ExpressJS和Express中间件来保护微服务并通过API公开它们。开发、编排和管理微服务现在可以在一个无缝平台上快速完成，无需引入额外的基础设施。

注意：该Docker镜像已被官方标记为DEPRECATED（弃用）状态。

核心功能和特性

• 完全基于Express和Express中间件构建
• 动态集中式配置
• API消费者和凭据管理
• 插件和插件框架
• 分布式数据存储
• 命令行界面(CLI)
• 管理API

!logo

使用场景和适用范围

Express Gateway适用于构建和管理微服务架构中的API网关层，主要应用场景包括：

• API请求路由和负载均衡
• 身份验证和授权
• 请求/响应转换
• API速率限制和流量控制
• 监控和日志记录
• 微服务架构的安全边界

使用方法和配置说明

基本要求

• 除非使用身份功能（如users、applications和credentials），否则Express Gateway不需要任何数据存储
• 需要挂载包含配置文件的卷才能使Express Gateway正确启动

与Redis集成（如需身份功能）

1. 启动Redis容器

$ docker run -d --name express-gateway-data-store \
                -p 6379:6379 \
                redis:alpine

2. 启动Express-Gateway实例

$ docker run -d --name express-gateway \
    --link express-gateway-data-store:redis \
    -v /my/own/datadir:/var/lib/eg \
    -p 8080:8080 \
    -p 9876:9876 \
    express-gateway

注意：如果通过HTTPS提供API，可能需要将其他端口暴露给主机。 注意：必须挂载包含配置文件的卷才能使Express-Gateway正确启动。

安装自定义插件

可以通过创建新的Dockerfile来为Express Gateway镜像安装自定义插件，使用express-gateway作为基础镜像，然后将所需插件安装为全局yarn包：

FROM express-gateway
RUN yarn global add express-gateway-plugin-name

快速参考

• 维护者：Express Gateway团队
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow
• 提交问题：[***]
• 支持的架构：无
• 发布的镜像工件详情：repo-info仓库的repos/express-gateway/目录（包含镜像元数据、传输大小等）
• 镜像更新：official-images仓库的library/express-gateway标签
• 本文档来源：docs仓库的express-gateway/目录

许可证

有关此镜像中包含的软件的许可信息，请查看许可信息。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可证约束（例如基础发行版中的Bash等，以及包含的主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可信息可能会在repo-info仓库的express-gateway/目录中找到。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用都符合其中包含的所有软件的相关许可。

官方文档

有关Express-Gateway的更多信息和配置方法，请参阅官方文档：express-gateway.io/docs