Kong代理配置(二)

1、简介

在本文中,我们将通过详细解释Kong的路由功能和内部工作机制来介绍它的代理功能。
可以通过修改Kong的两个配置来处理它暴露的接口:

  • proxy_listen:定义一个地址/端口列表,Kong将在这些地址/端口上接受来自客户端的公共流量,并将其代理到您的上游服务(默认为8000个)。
  • admin_listen:定义了地址和端口的列表,但是这些应该被限制为只能由管理员访问,因为它们暴露了Kong的配置功能:Admin API(默认为8001)。

2、术语

  • client:请求访问Kong的代理端口的下游客户端。
  • upstream service:Kong后端的API或service,提供给client访问。
  • Service:对upstream service的抽象。
  • Route:对应Kong中的Route组件。是kong的访问的,匹配改Route规则的请求将被路由到后端的Service。
  • Plugin:对应Kong中的Plugin组件,属于业务逻辑的一部分将运行在整个代理过程的生命周期中。

3、如何配置service(回顾)

在Kong中注册服务需要使用Admin API进行处理,及访问8001端口的RestFul接口。

3.1、创建服务

curl -i -X POST http://localhost:8001/services/ \
    -d 'name=foo-service' \
    -d 'url=http://foo-service.com'

3.2、配置路由

curl -i -X POST http://localhost:8001/routes/ \
    -d 'hosts[]=example.com' \
    -d 'paths[]=/foo' \
    -d 'service.id=d54da06c-d69f-4910-8896-915c63c270cd' # 上一条命令执行之后访问的服务的id

4、路由和匹配能力

Kong支持Http/https、TCL/TLS和GRPC/GRPCS协议的代理;每种协议具有不同的路由属性:

  • http: methods, hosts, headers, paths (and snis, if https)
  • tcp: sources, destinations (and snis, if tls)
  • grpc: hosts, headers, paths (and snis, if grpcs)

以上三个属性都是可选的,但是至少需要设置一个属性。
路由匹配规则:

  1. 请求必须包含在添加路由时设置的所有属性
  2. 请求中所包含的属性值至少得有一个和配置得属性值相同,如果请求中包含所有配置得属性则必须和配置得属性值相同才标识为匹配上。

如:

  1. 定义一个路由
{
    "hosts": ["example.com", "foo-service.com"],
    "paths": ["/foo", "/bar"],
    "methods": ["GET"]
}
  1. 匹配的请求
# 携带有所有配置的属性,则值必须和对应的属性匹配上才能说明满足该Route
GET /foo HTTP/1.1
Host: example.com
  1. 不匹配的请求
POST /foo HTTP/1.1    # 请求的类型不匹配
Host: example.com

4.1、路由匹配模式

  1. 请求头
    从1.3开始,kong提供了对任意Http请求头的支持。不过一般都是使用Host请求头进行处理。通过Kong提供的hosts属性可以轻松的实现使用基于Host请求头的路由配置。

hosts属性可以接受多个值,多个值采用","分隔,如下使用Admin API来进行配置:

curl -i -X POST http://localhost:8001/routes/ \
    -H 'Content-Type: application/json' \
    -d '{"hosts":["example.com", "foo-service.com"]}'

或者采用表单的方式:

curl -i -X POST http://localhost:8001/routes/ \
    -d 'hosts[]=example.com' \
    -d 'hosts[]=foo-service.com'

除了使用确定的值进行配置意外,Kong还提供了使用通配符的方式进行配置,通配符主机名在域的最左边或最右边的标签上只能包含一个星号。例子:

  • *.example.com:即以example.com结尾的host都将匹配该路由
  • example.*:即以example开头的都将匹配该路由
  1. 路径
    kong也支持通过请求路由的匹配规则,即请求路径的前缀必须至少一个匹配添加路由时设置的paths属性值。例子:
{
    "paths": ["/service", "/hello/world"]
}
# 请求的前缀为/service,匹配
GET /service/resource?param=value HTTP/1.1
Host: example.com

# 请求的前缀为/hello,不匹配
GET /hello/world/resource HTTP/1.1
Host: anything.com

除了等值的匹配意外,基于path的模式也支持正则表达式的方式,例子:

{
    "paths": ["/users/\d+/profile", "/following"]   # \d+ 标识匹配一个或多个数字
}
GET /users/123/profile HTTP/1.1
Host: ...

基于请求前缀的匹配模式,Kong通过前缀的长度来处理匹配的优先级:即长度越长的先进行匹配。并且也可以在添加路由的时候通过设置regex_priority属性来设置优先级(数字越大优先级越高),同时正则表达的优先级高于前缀。例子:

[
    {
        "paths": ["/status/\d+"],
        "regex_priority": 0
    },
    {
        "paths": ["/version/\d+/status/\d+"],
        "regex_priority": 6
    },
    {
        "paths": ["/version"],
    },
    {
        "paths": ["/version/any/"],
    }
]

匹配顺序:

  1. /version/\d+/status/\d+
  2. /status/\d+
  3. /version/any/
  4. /version

4.2、优先级

路由可以根据其标头、主机、路径和方法(加上安全路由的snis——“https”、“grpcs”、“tls”)字段定义匹配规则。要使传入请求与路由匹配,必须满足所有现有字段。但是,Kong允许使用包含相同值的字段来配置两个或多个路由,从而提供了相当大的灵活性——在这种情况下,Kong应用优先级规则。

  1. 在评估请求时,Kong将首先尝试匹配具有最多规则的路由,例子:
{
    "hosts": ["example.com"],
    "service": {
        "id": "..."
    }
},
{
    "hosts": ["example.com"],
    "methods": ["POST"],
    "service": {
        "id": "..."
    }
}

因为第二个路由的规则比较多,所有kong优先选择该路由进行匹配。

  1. 加入两个路由的规则数量相同,满足一下规则是将优先选择A:
  • A只有“普通”主机报头,B有一个或多个“通配符”主机报头
  • A的非主机头信息比B多
  • A至少有一个“regex”路径,而B只有“plain”路径。
  • A的路径比B的路径长
  • A.created_at < B.created_at
最后编辑于
?著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,172评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,346评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,788评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,299评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,409评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,467评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,476评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,262评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,699评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,994评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,167评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,827评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,499评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,149评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,387评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,028评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,055评论 2 352

推荐阅读更多精彩内容

  • 简介 在这篇文档中,我们会通过详细介绍Kong的路由功能和内部工作原理来涵盖其代理功能,Kong通过两个配置项对外...
    fossilman阅读 5,151评论 0 1
  • Kong 是 Mashape 开源的高性能高可用 API 网关和 API 管理服务层。它基于 OpenResty ...
    meng_philip123阅读 9,048评论 0 6
  • 配置加载 Kong的默认配置在 /etc/kong/kong.conf.default 。如果你通过一个官方的安装...
    DreamsonMa阅读 54,931评论 0 16
  • 简介 Kong在v0.13.x版本之前通过接口来管理用户接入的API,但是在v0.13.x版本之后,官方不建议使用...
    君致阅读 1,871评论 0 4
  • 花褪残红青杏小。燕子飞时,绿水人家绕。枝上柳绵吹又少。天涯何处无芳草---苏轼《蝶恋花.春景》 我...
    洛尘_杨阅读 512评论 6 5