本文分享自华为云社区《kube-apiserver限流机制原理》，作者：可以交个朋友。

背景

apiserver是kubernetes中最重要的组件，一旦遇到恶意刷接口或请求量超过承载范围，apiserver服务可能会崩溃，导致整个kubernetes集群不可用。所以我们需要对apiserver做限流处理来提升kubernetes的健壮性。

k8s-apiserver限流能力发展过程

apiserver限流能力的发展分为两个阶段：

kubernetes 1.18版本之前kube-apiserver只是将请求分成了变更类型(create、update、delete、patch)和非变更类型(get、list、watch)，并通过启动参数设置了两种类型的最大并发数。

--max-requests-inflight ## 限制同时运行的非变更类型请求的个数上限，0表示无限制。 --max-mutating-requests-inflight ## 限制同时运行的变更类型请求的个数上限。0 表示无限制。

此时的apiserver限流能力较弱，若某个客户端错误的向kube-apiserver发起大量的请求时，必然会阻塞kube-apiserver，影响其他客户端的请求，因此高阶的限流APF就诞生了。

kubernetes1.18版本之后APF（ APIPriorityAndFairness ）成为kubernetes的默认限流方式。 APF以更细粒度的方式对请求进行分类和隔离，根据优先级和公平性进行处理。

--enable-priority-and-fairness ## 该值作为APF特性开关，默认为true --max-requests-inflight、--max-mutating-requests-inflight ## 当开启APF时，俩值相加确定kube-apiserver的总并发上限

两个阶段限流能力对比

限流能力	1.18版本前	1.18版本后(APF)
颗粒度	仅根据是否变更做分类	可以根据请求对象、请求者身份、命名空间等做分类
隔离性	一个坏用户可能堵塞整个系统	为请求分配固定队列，坏请求只能撑爆其使用的队列
公平性	会出现饿死	用公平性算法从队列中取出请求
优先级	无	有特权级别，可让重要请求不被限制

APF关键资源介绍

APF通过FlowSchema 和 PriorityLevelConfiguration两个资源配置限流策略。

FlowSchema：解决老版本分类颗粒度粗的问题。根据rules字段匹配请求，匹配规则包含：请求对象、执行操作、请求者身份和命名空间

apiVersion: flowcontrol.apiserver.k8s.io/v1beta2 kind: FlowSchema # 一个kubernetes集群中可以定义多个FlowSchema metadata: name: myfl spec: distinguisherMethod: # 可选值为：ByNamespace或ByUser，用于把请求分组。属于同组的请求会分配到固定的queue中，如果省略该参数，则该FlowSchema匹配的所有请求都将视为同一个分组。 type: ByUser matchingPrecedence: 90 # 数字越小代表FlowSchema的匹配顺序越在前，取值范围：1~10000。 priorityLevelConfiguration: # FlowSchema关联的priorityLevelConfiguration name: mypl rules: - nonResourceRules: # 匹配非资源型：匹配接口URL - nonResourceURLs: - '*' resourceRules: # 匹配资源型：匹配apigroup、namespace、resources、verbs - apiGroups: - '*' namespaces: - '*' resources: - '*' verbs: - get - create - list - update subjects: # 匹配请求者主体：可选Group、User、ServiceAccount - group: name: '*' kind: Group - kind: User user: name: '*' - kind: ServiceAccount serviceAccount: name: myserviceaccount namespace: demo

PriorityLevelConfiguration：解决老版本隔离性差的问题和优先级问题，并定义了限流细节（总队列数、队列长度、是否可排队）。当请求与某个FlowSchema匹配后，该请求会关联FlowSchema中指定的PriorityLevelConfiguration资源，每个PriorityLevelConfiguration相互隔离，且能承受的并发请求数也不一样

apiVersion: flowcontrol.apiserver.k8s.io/v1beta2 kind: PriorityLevelConfiguration ## 每个PriorityLevelConfiguration有自己独立的限流配置， PriorityLevelConfiguration之间是完全隔离的。 metadata: name: mypl spec: type: Limited # 设置是否为特权级别，如果为Exempt则不进行限流，如果为Limited则进行限流 limited: assuredConcurrencyShares: 2 # 值越大，PriorityLevelConfiguration的并发上限越高。若当前并发执行数未达到并发上限，则PL处于空闲状态。 limitResponse: # 定义如何处理当前无法被处理的请求 type: Queue # 类型，Queue或者Reject，Reject直接返回429并拒绝，Queue将请求加入队列 queuing: handSize: 1 # 根据ByNamespace或ByUser对请求分组，每个分组对应queues的数量， queueLengthLimit: 20 # 此PriorityLevelConfiguration中每个队列的长度 queues: 2 # 此PriorityLevelConfiguration中的队列数

 

一个FlowSchema只能关联一个priorityLevelConfiguration，多个FlowSchema可以关联同一个priorityLevelConfiguration

PriorityLevelConfiguration并发上限 = assuredConcurrencyShares / 所有assuredConcurrencyShares之和 * apiserver总并发数

 

APF处理过程

请求与集群中的FlowSchema列表按照顺序依次匹配，每个FlowSchema的matchingPrecedence字段决定其在列表中的顺序，matchingPrecedence字段值越小，越靠前，越先进行匹配请求。

根据FlowSchema资源中的rules规则进行匹配，匹配方式可以是 “请求的资源类型”、“请求的动作类型”、“请求者的身份”、“请求的命名空间” 等多个维度。

若请求与某个FlowSchema成功匹配，匹配就会结束。FlowSchema关联着一个PriorityLevelConfiguration，每个PriorityLevelConfiguration中包含许多queue，根据FlowSchema.spec.Distinguisher字段将请求进行"分组"，根据分组来分配queue，分配queue数量由PriorityLevelConfiguration资源的handSize字段决定，如果省略该参数，则该FlowSchema匹配的所有请求都将视为同一个"分组"。

每个PriorityLevelConfiguration资源都有独立的并发上限，assuredConcurrencyShares字段为apiserver总并发数的权重占比，值越大分配的并发上限就越高，当PriorityLevelConfiguration达到并发上限后，请求会根据所属的"分组"写入固定的queue中，请求被阻塞等待。请求与queue的固定关联可以让恶意用户只影响其使用的queue，而不会影响同PriorityLevelConfiguration中的其他queue。

当PriorityLevelConfiguration未达到并发上限时，fair queuing算法从所有queue中选择一个合适的queue取出请求，解除请求的阻塞，执行这个请求。fair queuing算法能保证同一个 PriorityLevelConfiguration 中的所有queue被处理机会平等。

APF实战

kubernetes原生自带了一些FlowSchema和PriorityLevelConfiguration规则，我们选择一个查看，如下图：

下面我们创建新的APF规则：当请求对象是apf命名空间中的deployment，则进行"apfpl"限流规则。

apiVersion: flowcontrol.apiserver.k8s.io/v1beta2 kind: FlowSchema metadata: name: apffl spec: matchingPrecedence: 150 priorityLevelConfiguration: name: apfpl ## 关联名为apfpl的PriorityLevelConfiguration rules: - resourceRules: - apiGroups: - apps clusterScope: true namespaces: - apf ## 匹配apf命名空间 resources: - deployments ## 匹配操作deployment的请求 verbs: - '*' ## 匹配任意操作类型 subjects: - kind: Group group: name: '*' ## 匹配任意组身份 --- apiVersion: flowcontrol.apiserver.k8s.io/v1beta2 kind: PriorityLevelConfiguration metadata: name: apfpl spec: limited: assuredConcurrencyShares: 2 limitResponse: ## 设置限流处理细节 queuing: handSize: 1 queueLengthLimit: 20 queues: 2 type: Queue type: Limited ## 对请求做限流处理

接着在apf命名空间和default命名空间分别创建deployment进行测试。apf_fs为请求被分类到的 FlowSchema 的名称，apf_pl为该请求的优先级名称。查看apiserver日志信息，见下图：

循环操作deployment，我们可以使用命令查看是否触发限流等待

kubectl get --raw /debug/api_priority_and_fairness/dump_priority_levels

返回waitingRequests非0，则代表触发最大并发数，有请求被限流进入等待队列。PriorityLevelConfiguration资源不为空闲表示已达到并发上限

 

点击关注，第一时间了解华为云新鲜技术~