容器与云原生 / 系统课时
RoleBinding 与 ClusterRoleBinding
RoleBinding 与 ClusterRoleBinding
本课解决“角色已经定义,但谁能使用这些权限”的问题。你将完成命名空间级与集群级绑定,验证用户、用户组和 ServiceAccount 的实际授权结果,并避免因绑定范围选错而造成权限过大。
学习目标
- 区分 RoleBinding 与 ClusterRoleBinding 的授权范围
- 使用 subjects 将权限授予用户、用户组和 ServiceAccount
- 通过
kubectl auth can-i验证最终权限
绑定解决的核心问题
Role 和 ClusterRole 只描述“允许执行什么操作”,不会自动授予任何主体。绑定对象负责把角色与主体连接起来,其中 subjects 指定被授权者,roleRef 指定被引用的角色。

两种绑定的作用域
| 绑定对象 | 可引用角色 | 权限生效范围 | 常见用途 |
|---|---|---|---|
| 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验证最终权限。
按自己的节奏,确认真正理解。