API网关Kong学习笔记(十五):KongIngress的定义细节

作者:李佶澳  更新时间:2019-03-05 14:59:09 +0800

  项目    kong    刷新

目录

说明

API网关Kong(二):Kong与Kubernetes集成的方法中提到过KongIngress的定义,这里详细展开。

相关笔记

2019-05-06 16:28:56:kong 1.1.x有了一个重大变换,实现了db-less模式,可以不使用数据库了,见笔记二十六:查看全部笔记如果是刚开始学习kong,直接从1.x开始,0.x已经不再维护,0.15是0.x的最后一个版本。

前19篇笔记是刚开始接触kong时记录的,使用的版本是0.14.1,当时对kong一知半解,笔记比较杂乱。第二十篇开始是再次折腾时的笔记,使用的版本是1.0.3,笔记相对条理一些。

从0.x到1.x需要关注的变化有:

  1. 插件全部使用pdk
  2. 0.x中不鼓励使用的特性都被移除了;
  3. 全部使用kong.db,以前独立的dao彻底清除,代码简洁清晰了。

定义

KongIngress在代码文件github.com/kong/kubernetes-ingress-controller/internal/apis/configuration/v1/types.go中定义:

// github.com/kong/kubernetes-ingress-controller/internal/apis/configuration/v1/types.go中定义
type KongIngress struct {
	metav1.TypeMeta `json:",inline"`
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Upstream *Upstream `json:"upstream,omitempty"`
	Proxy    *Proxy    `json:"proxy,omitempty"`
	Route    *Route    `json:"route,omitempty"`
}

可以看到由三部分组成UpstreamProxyRoute

type Upstream struct {
	HashOn       string        `json:"hash_on"`
	HashOnHeader string        `json:"hash_on_header"`
	HashFallback string        `json:"hash_fallback"`
	Healthchecks *Healthchecks `json:"healthchecks,omitempty"`
	Slots        int           `json:"slots"`
}

type Proxy struct {
	Protocol       string `json:"protocol"`
	Path           string `json:"path"`
	ConnectTimeout int    `json:"connect_timeout"`
	Retries        int    `json:"retries"`
	ReadTimeout    int    `json:"read_timeout"`
	WriteTimeout   int    `json:"write_timeout"`
}

type Route struct {
	Methods       []string `json:"methods"`
	RegexPriority int      `json:"regex_priority"`
	StripPath     bool     `json:"strip_path"`
	PreserveHost  bool     `json:"preserve_host"`
	Protocols     []string `json:"protocols"`
}

需要注意的是,这里的Upstream、Proxy、Route中都是一些配置参数,不是Kong中的对应对象的完整定义,譬如说,这里明显缺失了Name、Host、以及Path等。这和KongIngress定位是匹配的,KongIngress只是对Kubernetes中原生的Ingress的补充,包含了一些Kong支持的参数。

Upstream中设置的是转发时使用的哈希算法,以及slot和健康检查。

Proxy中配置的是将请求转发给Upstream对应的Target时的参数,Kong中是没有Proxy这个对象的,这里的Proxy是Service的配置项的一部分:转发时使用的协议、转发目标路径、超时时间以及重试次数。

Route中设置路由的请求方法、用正则描述的Path的优先级、是否修改Path和Host,和支持的协议等。

API网关Kong(十六):Kong转发请求的工作过程

参考

  1. API网关Kong(十六):Kong转发请求的工作过程

关注加微信,一般不闲聊(直接说事)

相关页面,推荐阅读

Copyright @2011-2019 All rights reserved. 转载请添加原文连接,合作请加微信lijiaocn或者发送邮件: [email protected],备注网站合作

友情链接:  微信公众号精选文章  发现知识星球