连接注册集群

聚焦模式

字号

最后更新时间： 2025-04-17 19:48:14

除了通过 容器服务控制台 在集群管理页面查看和管理 TKE 集群和第三方集群的方式外，还可以通过 Kubernetes 命令行工具 Kubectl 从本地客户端机器连接访问注册集群。
前提条件
已安装 curl 软件。
请根据操作系统的类型，选择获取 Kubectl 工具的方式：
注意：
请对应您实际使用版本，将命令行中的 v1.8.13 替换成业务所需的 Kubectl 版本。
MacOS 系统
Linux 系统
Windows 系统
执行以下命令，获取 Kubectl 工具：
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.8.13/bin/darwin/amd64/kubectl
执行以下命令，获取 Kubectl 工具：
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.8.13/bin/linux/amd64/kubectl
执行以下命令，获取 Kubectl 工具：
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.8.13/bin/windows/amd64/kubectl.exe
操作步骤
安装 Kubectl 工具
1. 参考 Installing and Setting up kubectl，安装 Kubectl 工具。
说明：
如果您已经安装 Kubectl 工具，请忽略本步骤。
此步骤以 Linux 系统为例。
2. 依次执行以下命令，添加执行权限。
chmod +x ./kubectl
sudo mv ./kubectl /usr/local/bin/kubectl
3. 执行以下命令，测试安装结果。
kubectl version
如若输出类似以下版本信息，即表示安装成功。
Client Version: version.Info{Major:"1", Minor:"5", GitVersion:"v1.5.2", GitCommit:"08e099554f3c31f6e6f07b448ab3ed78d0520507", GitTreeState:"clean", BuildDate:"2017-01-12T04:57:25Z", GoVersion:"go1.7.4", Compiler:"gc", Platform:"linux/amd64"}
配置 Kubeconfig
1. 登录 容器服务控制台，选择左侧导航栏中的 集群。
2. 在集群列表页面，单击需连接的注册集群 ID，进入该集群的基本信息页面。
3. 在集群 APIServer 信息中，获取对应的公网访问或内网访问的 kubeconfig，可以复制或者下载。
4. 根据实际情况进行集群凭据配置。详情请参见控制台内通过 Kubectl 连接 Kubernetes 集群操作说明。
访问 Kubernetes 集群
1. 完成 Kubeconfig 配置后，依次执行以下命令查看并切换 context 以访问本集群。
kubectl config get-contexts
kubectl config use-context cls-3jju4zdc-context-default
2. 执行以下命令，测试是否可正常访问集群。
kubectl get pod
如果无法连接请查看是否已经开启公网访问或内网访问入口，并确保访问客户端在指定的网络环境内。
Kubectl 命令行介绍
Kubectl 是一个用于 Kubernetes 集群操作的命令行工具。本文涵盖 Kubectl 语法、常见命令操作并提供常见示例。有关每个命令（包括所有主命令和子命令）的详细信息，请参见 Kubectl 参考文档 或使用 kubectl help 命令查看详细帮助。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

云原生分布式云中心

连接注册集群

前提条件

操作步骤

安装 Kubectl 工具

配置 Kubeconfig

访问 Kubernetes 集群

Kubectl 命令行介绍

帮助和支持