> ## 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.

# 使用 KubeConfig 访问 CKS 集群

> 获取 CKS 集群的 KubeConfig，并在本地终端或运维环境中使用 kubectl 访问集群。

KubeConfig 保存访问 CKS 集群所需的集群地址和身份验证信息。获取并配置 KubeConfig 后，可以在本地终端或运维环境中使用 kubectl 连接集群。

## 何时需要 KubeConfig

KubeConfig 用于告诉 kubectl 要连接哪个集群，以及使用什么身份访问集群。常见用途包括：

* 使用 kubectl 查看和管理集群资源。
* 为需要连接集群的运维脚本或自动化流程提供访问凭据。

<Warning>
  KubeConfig 属于访问凭据。请勿将其写入公开仓库或公开文档，也不要共享给无关人员。
</Warning>

## 选择获取方式

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

### 从集群工作台获取

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

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

3. 切换到 **KubeConfig 管理** 页签。

4. 找到目标用户，并根据需要生成或查看 KubeConfig。

### 从集群详情获取

1. 在 **集群** 页面找到目标集群，单击 **详情**。

2. 切换到 **Connect Info** 页签。

3. 根据访问方式选择 **Intranet Access** 或 **Public Access**。

4. 单击 **Copy** 复制 KubeConfig 内容，或单击下载图标下载配置文件。

## 在访问环境中配置 KubeConfig

使用 KubeConfig 前，请先在访问环境中安装 kubectl。

将 KubeConfig 内容保存到 `$HOME/.kube/config`，然后运行以下命令确认 kubectl 可以读取集群节点：

```bash theme={null}
kubectl get nodes
```

如果配置文件保存在其他路径，请通过 `--kubeconfig` 指定文件：

```bash theme={null}
kubectl --kubeconfig <KUBECONFIG_FILE> get nodes
```

## 续期 KubeConfig

KubeConfig 临近到期且仍需继续使用时，可以在到期前延长有效期，避免依赖该凭据的客户端、运维脚本或自动化流程因凭据过期而无法访问集群。

1. 在 **权限** 页面的 **KubeConfig 管理** 页签中，找到需要续期的 KubeConfig。

2. 在 **操作** 列中单击 **续期**。

3. 在弹出的对话框中，选择续期天数。

4. 单击 **OK**。

5. 返回 **KubeConfig 管理** 页签，确认 KubeConfig 的过期时间已更新。

## 停止使用 KubeConfig

<Warning>
  删除 KubeConfig 后，使用该 KubeConfig 的客户端将无法继续访问集群。删除前，请确认没有自动化任务、运维脚本或业务流程仍在使用该凭据。
</Warning>

1. 在 **权限** 页面的 **KubeConfig 管理** 页签中，找到目标 KubeConfig。

2. 单击 **删除**，并按提示确认。


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