容器与云原生 / 系统课时

RoleBinding 与 ClusterRoleBinding

RoleBinding 与 ClusterRoleBinding

本课解决“角色已经定义,但谁能使用这些权限”的问题。你将完成命名空间级与集群级绑定,验证用户、用户组和 ServiceAccount 的实际授权结果,并避免因绑定范围选错而造成权限过大。

学习目标

  • 区分 RoleBinding 与 ClusterRoleBinding 的授权范围
  • 使用 subjects 将权限授予用户、用户组和 ServiceAccount
  • 通过 kubectl auth can-i 验证最终权限

绑定解决的核心问题

Role 和 ClusterRole 只描述“允许执行什么操作”,不会自动授予任何主体。绑定对象负责把角色与主体连接起来,其中 subjects 指定被授权者,roleRef 指定被引用的角色。

RoleBinding 与 ClusterRoleBinding 的授权关系

两种绑定的作用域

绑定对象 可引用角色 权限生效范围 常见用途
RoleBinding Role 或 ClusterRole 单个命名空间 为项目成员授予本命名空间权限
ClusterRoleBinding ClusterRole 整个集群 授予节点、命名空间等集群级资源权限

RoleBinding 即使引用 ClusterRole,也只会把该 ClusterRole 中可用于命名空间的规则限制在当前命名空间。ClusterRoleBinding 没有 metadata.namespace,一旦创建,权限会覆盖整个集群。

roleRef 创建后不可修改。需要更换角色时,应删除并重新创建绑定,或使用新的绑定名称完成切换。

完整配置示例

下面的清单创建 demo 命名空间、一个只读 Pod 的 Role、一个命名空间查询 ClusterRole,并分别完成命名空间级和集群级绑定。

yaml
apiVersion: v1
kind: Namespace
metadata:
  name: demo
---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: reader
  namespace: demo
---
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: pod-reader
  namespace: demo
rules:
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: read-pods
  namespace: demo
subjects:
  - kind: User
    name: alice
    apiGroup: rbac.authorization.k8s.io
  - kind: Group
    name: qa-team
    apiGroup: rbac.authorization.k8s.io
  - kind: ServiceAccount
    name: reader
    namespace: demo
roleRef:
  kind: Role
  name: pod-reader
  apiGroup: rbac.authorization.k8s.io
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: namespace-reader
rules:
  - apiGroups: [""]
    resources: ["namespaces"]
    verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: read-namespaces
subjects:
  - kind: Group
    name: platform-auditors
    apiGroup: rbac.authorization.k8s.io
roleRef:
  kind: ClusterRole
  name: namespace-reader
  apiGroup: rbac.authorization.k8s.io

将内容保存为 rbac-bindings.yaml。该配置生效后,alice、qa-team 和 demo/reader 只能读取 demo 中的 Pod;platform-auditors 组可以读取整个集群的 Namespace。

应用并验证权限

先使用具备 RBAC 管理权限的账号应用配置。

bash
kubectl apply -f rbac-bindings.yaml

预期输出:

text
namespace/demo created
serviceaccount/reader created
role.rbac.authorization.k8s.io/pod-reader created
rolebinding.rbac.authorization.k8s.io/read-pods created
clusterrole.rbac.authorization.k8s.io/namespace-reader created
clusterrolebinding.rbac.authorization.k8s.io/read-namespaces created

再以具有模拟用户权限的管理员身份检查授权结果。

bash
kubectl auth can-i list pods -n demo --as=alice
kubectl auth can-i list pods -n kube-system --as=alice
kubectl auth can-i get pods -n demo --as=system:serviceaccount:demo:reader
kubectl auth can-i list namespaces --as=auditor --as-group=platform-auditors

预期输出按命令顺序为:

text
yes
no
yes
yes

如果执行模拟检查时报 forbidden,通常不是被测主体没有权限,而是当前管理员缺少 impersonate 权限,需要换用集群管理员账号验证。

常见配置错误

  • 把命名空间内权限误用 ClusterRoleBinding 授予,导致同一权限扩展到所有命名空间。
  • ServiceAccount 主体遗漏 namespace,造成绑定对象无法准确定位。
  • roleRef.kind、roleRef.name 与实际角色不一致,绑定可以创建但授权结果不符合预期。
  • 只检查 YAML 是否成功创建,不使用 kubectl auth can-i 验证最终权限。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

RoleBinding 与 ClusterRoleBinding

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通