华为云 CCE 集群 kubectl 配置文件下载与配置

一、通过 CCE 控制台下载配置文件

1. 登录华为云控制台

   访问 华为云官网，使用您的账号登录后，进入 云容器引擎 CCE 服务。

2. 进入集群详情页

   在 CCE 控制台左侧导航栏选择 集群管理，找到目标集群并点击其名称进入集群详情页。

3. 获取 kubectl 配置文件

   在集群详情页的 连接信息 区域，找到 kubectl 访问 模块，点击 配置 按钮。
   

   下载的文件默认命名为 kubeconfig.json，包含集群 API 地址、认证 Token 等关键信息。

• 公网访问：若集群已绑定弹性公网 IP（EIP），选择 公网访问，并确认 EIP 地址正确后点击 下载。

• 内网访问：若客户端与集群位于同一 VPC 内，选择 内网访问，直接点击 下载。
  

二、配置 kubectl 工具

1. 安装 kubectl（若未安装）

   根据您的操作系统下载对应版本的 kubectl 工具：

\# Linux/macOS

curl -LO "https://dl.k8s.io/release/\$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"

chmod +x ./kubectl

sudo mv ./kubectl /usr/local/bin/kubectl

\# Windows

从 https://kubernetes.io/docs/tasks/tools/install-kubectl-windows/ 下载可执行文件

1. 保存配置文件

   将下载的 kubeconfig.json 保存到本地路径（如 ~/.kube/config）。若已存在其他配置文件，可通过以下命令合并：

export KUBECONFIG=\~/.kube/config:\~/path/to/kubeconfig.json

kubectl config view --merge --flatten > \~/.kube/merged\_config

mv \~/.kube/merged\_config \~/.kube/config

1. 验证连接

   执行以下命令检查是否成功连接集群：

kubectl get nodes

若返回节点列表且状态为 Ready，则说明配置成功。

三、关键注意事项

1. 权限与安全

• 配置文件包含认证 Token，需妥善保管，避免泄露。

• 若下载后无法操作集群资源，需检查 IAM 权限（如是否授予 CCE FullAccess 策略）和 Kubernetes RBAC 授权。

1. 公网地址变更

   若集群的 EIP 或自定义域名发生变化，需重新下载配置文件以同步最新证书信息。

2. 环境变量优先级

   kubectl 会优先读取 KUBECONFIG 环境变量指定的配置文件。若需临时使用特定配置，可执行：

export KUBECONFIG=\~/path/to/kubeconfig.json

四、故障排除

1. 权限不足

• 确保 IAM 用户拥有 CCE FullAccess 策略，并在集群中配置了对应的 Kubernetes 命名空间权限。

• 若提示 Unauthorized，尝试重新下载配置文件或检查 Token 有效性。

1. 证书验证失败

• 若使用公网访问且开启双向认证，需确保下载的配置文件包含正确的 CA 证书。

• 执行 kubectl config use-context externalTLSVerify 切换到启用双向认证的上下文。

1. 网络连通性

• 公网访问需确保客户端能访问集群的 EIP 地址（端口 6443）。

• 内网访问需检查客户端与集群是否在同一 VPC 内，且安全组规则允许 6443 端口通信。