使用节点授权
节点授权是一种特殊的授权模式,专门授权由 kubelet 发出的 API 请求。
概述
节点授权器允许 kubelet 执行 API 操作。这包括:
读取操作
- 服务
- 端点
- 节点
- Pod
- 与绑定到 kubelet 节点的 Pod 相关的密钥、配置映射、持久卷声明和持久卷
Kubernetes v1.32 [beta]
(默认启用:true)当 AuthorizeNodeWithSelectors
功能启用后(以及先决条件 AuthorizeWithSelectors
功能),kubelet 仅允许读取自己的 Node 对象,并且仅允许读取绑定到其节点的 Pod。
写入操作
- 节点和节点状态(启用
NodeRestriction
准入插件,以限制 kubelet 修改其自身的节点) - Pod 和 Pod 状态(启用
NodeRestriction
准入插件,以限制 kubelet 修改绑定到自身的 Pod) - 事件
认证相关操作
- 对 CertificateSigningRequests API 的读/写访问权限,用于 TLS 引导
- 创建 TokenReviews 和 SubjectAccessReviews 的能力,用于委托身份验证/授权检查
在未来的版本中,节点授权器可能会添加或删除权限,以确保 kubelet 拥有正确操作所需的最小权限集。
为了通过节点授权器进行授权,kubelet 必须使用将其标识为属于 system:nodes
组的凭据,且用户名为 system:node:<nodeName>
。此组和用户名格式与为每个 kubelet 创建的身份匹配,作为 kubelet TLS 引导的一部分。
<nodeName>
的值必须与 kubelet 注册的节点名称精确匹配。默认情况下,这是由 hostname
提供的或通过 kubelet 选项 --hostname-override
覆盖的主机名。但是,当使用 --cloud-provider
kubelet 选项时,特定的主机名可能由云提供商确定,从而忽略本地 hostname
和 --hostname-override
选项。有关 kubelet 如何确定主机名的具体信息,请参阅 kubelet 选项参考。
要启用节点授权器,请使用设置为包含 Node
授权器的文件的 --authorization-config
标志启动 API 服务器;例如
apiVersion: apiserver.config.k8s.io/v1
kind: AuthorizationConfiguration
authorizers:
...
- type: Node
...
或者,使用设置为包含 Node
的逗号分隔列表的 --authorization-mode
标志启动 API 服务器;例如
kube-apiserver --authorization-mode=...,Node --other-options --more-options
要限制 kubelet 可以写入的 API 对象,请通过使用 --enable-admission-plugins=...,NodeRestriction,...
启动 apiserver 来启用 NodeRestriction 准入插件
迁移注意事项
system:nodes
组外的 kubelet
system:nodes
组外的 kubelet 不会被 Node
授权模式授权,并且需要继续通过当前授权它们的任何机制进行授权。节点准入插件不会限制来自这些 kubelet 的请求。
具有未区分的用户名的 kubelet
在某些部署中,kubelet 具有将其放置在 system:nodes
组中的凭据,但由于它们的用户名不采用 system:node:...
格式,因此无法识别它们关联的特定节点。这些 kubelet 不会被 Node
授权模式授权,并且需要继续通过当前授权它们的任何机制进行授权。
NodeRestriction
准入插件会忽略来自这些 kubelet 的请求,因为默认的节点标识符实现不会认为这是一个节点身份。