> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建 CKS 集群访问角色

> 根据用户需要管理的 Kubernetes 资源范围，创建普通角色或集群角色。

访问角色用于定义用户可以管理的 Kubernetes 资源和可以执行的操作。创建角色前，应先根据业务所需的权限范围选择普通角色或集群角色。

## 选择角色类型

| 角色类型 | 权限范围 | 适用场景 |
| - | - | - |
| 普通角色（`Role`） | 指定命名空间内的资源。 | 用户只需要管理某个命名空间中的工作负载、配置或存储资源。 |
| 集群角色（`Cluster Role`） | 集群级资源，或跨命名空间的资源。 | 用户需要管理节点、命名空间等集群级资源，或在多个命名空间中执行相同操作。 |

<Warning>
  集群角色的权限范围可能覆盖整个集群。请根据用户完成任务所需的最小权限配置角色，避免授予无关资源的操作权限。
</Warning>

## 创建角色

1. 登录 [GPU 云服务控制台](https://console.siflow.cn/gpu-cloud/home)，进入 **集群** 页面。

2. 单击目标集群名称，进入集群工作台。

3. 在左侧导航中进入 **权限** 页面。

4. 切换到 **自定义角色** 页签，单击 **创建**。

5. 在 **Create Custom Role** 对话框中配置角色。

   | 配置项 | 说明 |
   | - | - |
   | **Name** | 输入便于识别角色用途的显示名称。 |
   | **Role Type** | 选择 **Role** 创建普通角色，或选择 **Cluster Role** 创建集群角色。 |
   | **YAML** | 填写角色的 Kubernetes YAML。YAML 中的 `kind` 应与所选角色类型一致。 |

   <Tabs>
     <Tab title="普通角色示例">
       以下示例允许查看 `default` 命名空间中的 Pod、Pod 日志和 Deployment。请按实际需要修改角色名称、命名空间、资源和操作。

       ```yaml theme={null}
       apiVersion: rbac.authorization.k8s.io/v1
       kind: Role
       metadata:
         name: workload-reader
         namespace: default
       rules:
         - apiGroups: [""]
           resources: ["pods", "pods/log"]
           verbs: ["get", "list", "watch"]
         - apiGroups: ["apps"]
           resources: ["deployments"]
           verbs: ["get", "list", "watch"]
       ```
     </Tab>

     <Tab title="集群角色示例">
       以下示例允许查看集群中的节点和命名空间。请按实际需要修改角色名称、资源和操作。`ClusterRole` 不需要设置命名空间。

       ```yaml theme={null}
       apiVersion: rbac.authorization.k8s.io/v1
       kind: ClusterRole
       metadata:
         name: cluster-resource-reader
       rules:
         - apiGroups: [""]
           resources: ["nodes", "namespaces"]
           verbs: ["get", "list", "watch"]
       ```
     </Tab>
   </Tabs>

6. 单击 **OK**。

创建完成后，在 **自定义角色** 页签确认角色已显示。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.