如何配置本地kubectl远程访问Ubuntu VM上的Kubernetes集群
本地kubectl远程访问K8s集群的操作方案
整个操作不需要你熟悉复杂的Linux Shell,也不用反复SSH登录master节点传文件,最终能实现和老师Minikube环境完全一致的操作体验:本地编写YAML、本地执行命令直接把配置提交给集群。
核心操作步骤
- 第一步:从master节点获取集群访问凭证
K8s集群的所有kubectl访问凭证,默认自动存在master节点的~/.kube/config文件里,这是本地客户端和集群apiserver通信的必要配置,获取过程没有复杂操作:- 通过SSH登录你的master节点,执行
cat ~/.kube/config,终端会输出完整的配置文本 - 把终端输出的所有文本完整复制,在本地电脑上新建一个空白文件,把内容粘贴进去保存,比如命名为
my-k8s-config,全程不需要碰其他Linux命令
这里明确:YAML配置文件不能、也不需要推送到Docker Hub——Docker Hub是专门存储容器镜像的平台,不是配置文件的存储载体,之前尝试用GitHub、Google Drive传文件的思路,本质上是为了解决“把YAML传到master节点”的问题,但这个环节本身就是完全没必要的。
- 通过SSH登录你的master节点,执行
- 第二步:本地安装kubectl命令行工具
根据你本地电脑的操作系统,安装和集群版本匹配的kubectl客户端,安装完成后在本地终端执行kubectl version --client,能正常输出版本信息就说明安装合格。 - 第三步:关联本地kubectl和远程集群
- 先确认本地网络可以正常访问master节点的K8s apiserver端口:只要你平时能正常SSH连上master,这个连通性基本都是满足的
- 把刚才保存好的
my-k8s-config文件,放到本地kubectl的默认读取路径下即可:- 本地为macOS/Linux系统:放到本地用户目录下的
~/.kube/config路径,没有.kube文件夹就手动新建 - 本地为Windows系统:放到本地用户目录下的
.kube文件夹里,命名为config(无文件后缀)
- 本地为macOS/Linux系统:放到本地用户目录下的
- 手动核对配置内容:如果你从master节点复制的config里,apiserver地址写的是
127.0.0.1,需要把这个地址替换成你平时SSH连接master用的实际IP,格式为https://<master节点IP>:6443
- 第四步:验证连通性并正常使用
在本地终端执行kubectl cluster-info,如果能正常输出集群核心组件的运行状态,就说明配置完成。之后你完全可以脱离master节点的SSH终端操作:- 直接读取本地写好的YAML文件执行
kubectl apply -f <你本地的yaml文件名>,根本不需要把YAML文件传到master服务器上 - 所有日常kubectl操作(查看Pod状态、排查问题、删除资源等)都可以在本地终端完成,不用每次登录远程服务器
- 直接读取本地写好的YAML文件执行
零Linux门槛的替代取件方式
如果你觉得逐字复制终端文本太麻烦,可以用带可视化SSH文件传输功能的工具(比如FinalShell、WinSCP),连上master节点后,直接在可视化文件浏览器里找到master上/root/.kube/路径下的config文件,拖拽到本地电脑即可,全程不需要记任何Shell命令。
注意事项
- 这个config文件自带集群的最高管理权限,不要把文件传到公开的GitHub、Google Drive这类公开平台,避免集群被未授权访问
- 如果执行kubectl命令提示证书校验错误,检查本地系统时间是否和master节点的系统时间差超过10分钟,K8s的证书机制对时间偏差非常敏感
内容的提问来源于stack exchange,提问作者Lucas
相关产品推荐
相关产品推荐

