/gateway

an http api gateway

Primary LanguageGoApache License 2.0Apache-2.0

Gitter Build Status Go Report Card

Gateway

Gateway 是一个基于HTTP协议的restful的API网关。可以作为统一的API接入层。

Features

  • 流量控制(Server或API级别)
  • 熔断(Server或API级别)
  • 负载均衡
  • 服务发现
  • 插件机制
  • 路由(分流,复制流量)
  • API 聚合
  • API 参数校验
  • API 访问控制(黑白名单)
  • API 默认返回值
  • API 定制返回值
  • API 结果Cache
  • JWT Authorization
  • API Metric导入Prometheus
  • API 失败重试
  • 后端server的健康检查
  • 开放管理API(GRPC、Restful)
  • 支持websocket
  • 支持在线迁移数据

Docker

快速开始

使用 docker pull fagongzi/gateway 命令下载Docker镜像, 使用 docker run -d -p 9093:9093 -p 80:80 -p 9092:9092 fagongzi/gateway 运行镜像. 镜像启动后export 3个端口:

  • 80

    Proxy的http端口,这个端口就是直接为终端用户服务的

  • 9092

    APIServer的对外GRPC的端口

  • 9093

    APIServer的对外HTTP Restful的端口,访问 http://127.0.0.1:9093/ui/index.html访问WEBUI

可用的docker镜像

  • fagongzi/gateway

    镜像是一个quickstart镜像,包含了3个组件:etcd,proxy,apiserver, 仅限于快速体验,不能使用在生产

  • fagongzi/proxy

    proxy组件,生产可用

  • fagongzi/apiserver

    apiserver组件,生产可用

架构

WebUI

可用的Gateway的WebUI的项目:

组件

Gateway由proxy, apiserver组成

Proxy

Proxy是Gateway对终端用户提供服务的组件,Proxy是一个无状态的节点,可以部署多个来支撑更大的流量,更多

ApiServer

ApiServer对外提供GRPC和Restful来管理元信息,ApiServer同时集成了官方的WebUI,更多

Gateway中的概念

Server

Server是一个真实的后端服务,更多

Cluster

Cluster是一个逻辑概念,它由一组提供相同服务的Server组成。会依据负载均衡策略选择一个可用的Server,更多

API

API是Gateway的核心概念,我们可以在Gateway的中维护对外的API,以及API的分发规则,聚合规则以及URL匹配规则,更多

Routing

Routing是一个路由策略,根据HTTP Request中的Cookie,Querystring、Header、Path中的一些信息把流量分发到或者复制到指定的Cluster,通过这个功能,我们可以实现AB Test和线上引流,更多

参与开发

更多

交流方式-微信