AI 助理
备案控制台
开发者社区 云原生 文章 正文

使用kubectl连接远程Kubernetes(k8s)集群

2023-10-09 1592
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
本文涉及的产品
任务调度 XXL-JOB 版免费试用，400 元额度，开发版规格
可观测可视化 Grafana 版，10个用户账号 1个月
可观测监控 Prometheus 版，每月50GB免费额度
简介： 在自己本机当中安装kubectl并远程连接Kubernetes（k8s）集群。覆盖了Windows、MacOS和Linux操作系统，步骤超详细，在后面还有关于MacOS和Linux命令自动补全

环境准备

你需要准备一个Kubernetes集群，你要记下你安装Kubernetes的版本。如图我已经准备好了一个版本号为 v1.21.14 的集群：
image-20231008103058334.png

下载kubectl

下载地址

注意下载的版本号最好与你安装的Kubernetes版本对应上，各个版本的下载地址（⚠️注意修改url中的版本号）：

  • Windows:

    • x86_64:
    https://dl.k8s.io/release/版本号/bin/windows/amd64/kubectl.exe
    • arm64:
    https://dl.k8s.io/release/版本号/bin/windows/arm64/kubectl.exe

  • MacOS:

    • Intel:
    https://dl.k8s.io/release/版本号/bin/darwin/amd64/kubectl
    • Apple Silicon:
    https://dl.k8s.io/release/版本号/bin/darwin/arm64/kubectl

  • Linux:

    • x86_64:
    https://dl.k8s.io/release/版本号/bin/linux/amd64/kubectl
    • arm64:
    https://dl.k8s.io/release/版本号/bin/linux/arm64/kubectl

以 v1.21.14 的 MacOS M1芯片的电脑为例，我的下载地址就为（注意修改版本号）：

https://dl.k8s.io/release/v1.21.14/bin/darwin/arm64/kubectl

安装kubectl并处理配置文件

本次会以MacOS、Windows、Linux三个系统为例为大家讲解。你可以在目录中快速点击你的操作系统，只看你自己的操作系统的内容即可。

Windows的安装配置

安装kubectl

因为我的Windows电脑是x86_64架构的，所以我的下载地址为(注意修改自己的版本)：

https://dl.k8s.io/release/v1.21.14/bin/windows/amd64/kubectl.exe

然后我们创建一个目录去安装kubectl，如图：
image-20231008121919575.png

每个目录的作用：

  • bin: 装kubectl可执行未见的目录
  • config: 配置文件的目录

接下来我们将kubectl下载到bin目录下：
image-20231008122312701.png

然后我们可以执行下面命令查看帮助：

.\kubectl.exe --help

执行如图：
image-20231008122555253.png

接下来我们需要配置一下环境变量，来到设置点击系统：
image-20231008123133371.png

然后点击关于之后点击高级系统设置：
image-20231008123229164.png

然后点击环境变量：
image-20231008123306277.png

在环境变量下点击新建：
image-20231008123345426.png

配置一个名为 KUBERNETES_HOME 的环境变量，值为你Kubernetes安装的根目录：
image-20231008123539025.png

然后找到path之后将这行配置添加到最后：

%KUBERNETES_HOME%\bin

如图：
image-20231008123837121.png

最后我们重启PowerShell就可以在任何地方执行kubectl了：
image-20231008124026463.png

拉取配置文件

现在仅仅只是安装了kubectl，但是还没有指定kubectl去连接哪个集群。我们需要在Kubernetes主节点当中去拉取下来配置文件，这个配置文件当中一般还包含着认证信息。这个文件一般存放于主节点的 /etc/kubernetes/admin.conf 处，我们直接使用这行命令来拉取：

# 来到kubernetes的配置文件目录
cd E:\Software\Developer\Tools\Kubernetes\conf\
# 拉取配置文件，为了区分多个集群的配置文件，我们给其从新命名
scp root@192.168.1.160:/etc/kubernetes/admin.conf ./192.168.1.160.conf

拉取后如图：
image-20231008124333533.png

然后我们需要配置一个 KUBECONFIG 环境变量名字去指向这个配置文件：
image-20231008125150086.png

然后我们重启PowerShell就能远程工作apiserver为192.168.1.160的这台主机了：
image-20231008124854488.png

MacOS的安装配置

安装kubectl

因为我的Mac电脑是M1芯片的，所以我的下载地址为（注意修改自己的版本）：

https://dl.k8s.io/release/v1.21.14/bin/darwin/arm64/kubectl

然后我们创建一个目录去安装kubectl，如图：
image-20231008105717526.png

每个目录的作用：

  • bin: 装kubectl可执行未见的目录
  • config: 配置文件的目录

接下来我们将kubectl下载到bin目录下：
image-20231008110043949.png

然后我们还需要执行以下命令来为它赋予执行权限：

chmod +x kubectl

然后我们执行它（可能会被MacOS拦截，因为这个可执行文件不是来自受信任的开发者，这个问题请点击帮助按照苹果给出的文档解决）：

./kubectl --help

执行如图：
image-20231008110223402.png

这个文件我们目前还只能在本目录下执行，而我们还需要在任何位置都能执行，所以要配置环境变量。配置如下内容（注意修改你自己的安装目录）：

# Set Kubernetes environment
KUBERNETES_HOME=/Users/xiaohh/Software/kubernetes
PATH=$PATH:$KUBERNETES_HOME/bin
export PATH KUBERNETES_HOME

再执行下面命令使其生效：

source /etc/profile

配置后如图，可以看到在命令行的任何位置都能使用kubectl了：
image-20231008110842185.png

拉取配置文件

现在仅仅只是安装了kubectl，但是还没有指定kubectl去连接哪个集群。我们需要在Kubernetes主节点当中去拉取下来配置文件，这个配置文件当中一般还包含着认证信息。这个文件一般存放于主节点的 /etc/kubernetes/admin.conf 处，我们直接使用这行命令来拉取：

# 来到kubernetes的配置文件目录
cd ~/Software/kubernetes/config
# 拉取配置文件，为了区分多个集群的配置文件，我们给其从新命名
scp root@192.168.1.160:/etc/kubernetes/admin.conf ./192.168.1.160.conf

拉取后如图：
image-20231008112010465.png

接下来我们还需要配置一个 KUBECONFIG 环境变量去指定kubectl使用哪个配置文件，在上一步的基础上优化环境变量：

# Set Kubernetes environment
KUBERNETES_HOME=/Users/xiaohh/Software/kubernetes
# 指定使用哪个配置文件的环境变量，注意后面的地址
KUBECONFIG=$KUBERNETES_HOME/config/192.168.1.160.conf
PATH=$PATH:$KUBERNETES_HOME/bin
export PATH KUBERNETES_HOME KUBECONFIG

修改后如图：
image-20231008112556538.png

使这个文件生效，执行这行命令：

source /etc/profile

然后就可以直接在本地操作远程集群了：
image-20231008115805450.png

kubectl命令自动补全

将下面三行添加到 /etc/profile 文件末尾：

autoload -Uz compinit
compinit
source <(kubectl completion zsh)

如图：
image-20231008121015381.png

直接执行下面命令使其生效：

source /etc/profile

然后我们就可以使用命令补全了。

Linux的安装配置

安装kubectl

因为我的Linux虚拟机是x86_64架构的，所以我的下载地址为(注意修改自己的版本)：

https://dl.k8s.io/release/v1.21.14/bin/linux/amd64/kubectl

然后我们创建一个目录去安装kubectl，如图：
image-20231008125834152.png

每个目录的作用：

  • bin: 装kubectl可执行未见的目录
  • config: 配置文件的目录

接下来我们将kubectl下载到bin目录下：
image-20231008130007363.png

然后我们还需要执行以下命令来为它赋予执行权限：

chmod +x kubectl

然后我们执行它：

./kubectl --help

执行如图：
image-20231008130059510.png

这个文件我们目前还只能在本目录下执行，而我们还需要在任何位置都能执行，所以要配置环境变量。配置如下内容（注意修改你自己的安装目录）：

# Set Kubernetes environment
KUBERNETES_HOME=/opt/environment/kubernetes
PATH=$PATH:$KUBERNETES_HOME/bin
export PATH KUBERNETES_HOME

再执行下面命令使其生效：

source /etc/profile

配置后如图，可以看到在命令行的任何位置都能使用kubectl了：
image-20231008130252788.png

拉取配置文件

现在仅仅只是安装了kubectl，但是还没有指定kubectl去连接哪个集群。我们需要在Kubernetes主节点当中去拉取下来配置文件，这个配置文件当中一般还包含着认证信息。这个文件一般存放于主节点的 /etc/kubernetes/admin.conf 处，我们直接使用这行命令来拉取：

# 来到kubernetes的配置文件目录
cd /opt/environment/kubernetes/config/
# 拉取配置文件，为了区分多个集群的配置文件，我们给其从新命名
scp root@192.168.1.160:/etc/kubernetes/admin.conf ./192.168.1.160.conf

拉取后如图（里面有集群的apiserver地址，还有一些集群的证书和认证信息）：
image-20231008130633092.png

接下来我们还需要配置一个 KUBECONFIG 环境变量去指定kubectl使用哪个配置文件，在上一步的基础上优化环境变量：

# Set Kubernetes environment
KUBERNETES_HOME=/opt/environment/kubernetes
# 指定使用哪个配置文件的环境变量，注意后面的地址
KUBECONFIG=$KUBERNETES_HOME/config/192.168.1.160.conf
PATH=$PATH:$KUBERNETES_HOME/bin
export PATH KUBERNETES_HOME KUBECONFIG

修改后如图：
image-20231008131000366.png

使这个文件生效，执行这行命令：

source /etc/profile

然后就可以直接在本地操作远程集群了：
image-20231008131206519.png

kubectl命令自动补全

首先我们需要安装bash-completion，使用以下命令安装：

# ubuntu
apt-get install bash-completion
# centos
yum install -y bash-completion

然后执行bash-completion的主脚本：

source /usr/share/bash-completion/bash_completion

生成kubectl补全脚本，并执行它：

kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null
sudo chmod a+r /etc/bash_completion.d/kubectl
source /etc/bash_completion.d/kubectl

然后我们就可以使用kubectl的命令自动补全了：
image-20231008132029261.png

文章标签：
容器服务Kubernetes版
容器
Kubernetes
iOS开发
MacOS
Linux
关键词：
容器服务Kubernetes版集群
容器服务Kubernetes版k8s
kubectl容器服务Kubernetes版
容器服务Kubernetes版kubectl
容器服务Kubernetes版连接
相关实践学习
深入解析Docker容器化技术
Docker是一个开源的应用容器引擎，让开发者可以打包他们的应用以及依赖包到一个可移植的容器中，然后发布到任何流行的Linux机器上，也可以实现虚拟化，容器是完全使用沙箱机制，相互之间不会有任何接口。Docker是世界领先的软件容器平台。开发人员利用Docker可以消除协作编码时“在我的机器上可正常工作”的问题。运维人员利用Docker可以在隔离容器中并行运行和管理应用，获得更好的计算密度。企业利用Docker可以构建敏捷的软件交付管道，以更快的速度、更高的安全性和可靠的信誉为Linux和Windows Server应用发布新功能。 在本套课程中，我们将全面的讲解Docker技术栈，从环境安装到容器、镜像操作以及生产环境如何部署开发的微服务应用。本课程由黑马程序员提供。 &nbsp; &nbsp; 相关的阿里云产品：容器服务 ACK 容器服务 Kubernetes 版（简称 ACK）提供高性能可伸缩的容器应用管理能力，支持企业级容器化应用的全生命周期管理。整合阿里云虚拟化、存储、网络和安全能力，打造云端最佳容器化应用运行环境。 了解产品详情: https://www.aliyun.com/product/kubernetes
XiaoHHSuperme
目录
相关文章
容器小师妹
|
4月前
|
资源调度 Kubernetes 调度
从单集群到多集群的快速无损转型：ACK One 多集群应用分发
ACK One 的多集群应用分发，可以最小成本地结合您已有的单集群 CD 系统，无需对原先应用资源 YAML 进行修改，即可快速构建成多集群的 CD 系统，并同时获得强大的多集群资源调度和分发的能力。
容器小师妹
169 9
阿里云云原生
|
4月前
|
资源调度 Kubernetes 调度
从单集群到多集群的快速无损转型：ACK One 多集群应用分发
本文介绍如何利用阿里云的分布式云容器平台ACK One的多集群应用分发功能，结合云效CD能力，快速将单集群CD系统升级为多集群CD系统。通过增加分发策略（PropagationPolicy）和差异化策略（OverridePolicy），并修改单集群kubeconfig为舰队kubeconfig，可实现无损改造。该方案具备多地域多集群智能资源调度、重调度及故障迁移等能力，帮助用户提升业务效率与可靠性。
阿里云云原生
190 7
南瓜佬
|
19天前
|
存储 Kubernetes 网络安全
关于阿里云 Kubernetes 容器服务（ACK）添加镜像仓库的快速说明
本文介绍了在中国大陆地区因网络限制无法正常拉取 Docker 镜像的解决方案。作者所在的阿里云 Kubernetes 集群使用的是较旧版本的 containerd（1.2x），且无法直接通过 SSH 修改节点配置，因此采用了一种无需更改 Kubernetes 配置文件的方法。通过为 `docker.io` 添加 containerd 的镜像源，并使用脚本自动修改 containerd 配置文件中的路径错误（将错误的 `cert.d` 改为 `certs.d`），最终实现了通过多个镜像站点拉取镜像。作者还提供了一个可重复运行的脚本，用于动态配置镜像源。虽然该方案能缓解镜像拉取问题，
南瓜佬
168 2
蓝易云
|
6月前
|
存储 Kubernetes 监控
K8s集群实战：使用kubeadm和kuboard部署Kubernetes集群
总之，使用kubeadm和kuboard部署K8s集群就像回归童年一样，简单又有趣。不要忘记，技术是为人服务的，用K8s集群操控云端资源，我们不过是想在复杂的世界找寻简单。尽管部署过程可能遇到困难，但朝着简化复杂的目标，我们就能找到意义和乐趣。希望你也能利用这些工具，找到你的乐趣，满足你的需求。
蓝易云
630 33
蓝易云
|
6月前
|
Kubernetes 开发者 Docker
集群部署：使用Rancher部署Kubernetes集群。
以上就是使用 Rancher 部署 Kubernetes 集群的流程。使用 Rancher 和 Kubernetes，开发者可以受益于灵活性和可扩展性，允许他们在多种环境中运行多种应用，同时利用自动化工具使工作负载更加高效。
蓝易云
364 19
蓝易云
|
6月前
|
Kubernetes API 网络安全
当node节点kubectl 命令无法连接到 Kubernetes API 服务器
当Node节点上的 `kubectl`无法连接到Kubernetes API服务器时，可以通过以上步骤逐步排查和解决问题。首先确保网络连接正常，验证 `kubeconfig`文件配置正确，检查API服务器和Node节点的状态，最后排除防火墙或网络策略的干扰，并通过重启服务恢复正常连接。通过这些措施，可以有效解决与Kubernetes API服务器通信的常见问题，从而保障集群的正常运行。
蓝易云
428 17
阿里云基础设施.
|
6月前
|
存储 运维 Kubernetes
容器数据保护：基于容器服务 Kubernetes 版(ACK)备份中心实现K8s存储卷一键备份与恢复
阿里云ACK备份中心提供一站式容器化业务灾备及迁移方案，减少数据丢失风险，确保业务稳定运行。
阿里云基础设施.
234 0
statmoon
|
Kubernetes 容器 Perl
Kubernetes-kubectl命令出现错误【The connection to the server localhost:8080 was refused - did you specif...
  今天在Kubernetes的从节点上运行命令【kubectl】出现了如下错误 [root@k8snode1 kubernetes]# kubectl get pod The connection to the server localhost:80...
statmoon
38699 0
店家小二
|
Kubernetes Shell API
kubernetes-kubectl命令说明
本文基于kubernetes 1.5.2版本编写 kubectl kubectl controls the K8S cluster manager. Find more information at https://github.
店家小二
1299 0
阿里云基础设施.
|
6月前
|
人工智能 分布式计算 调度
打破资源边界、告别资源浪费：ACK One 多集群Spark和AI作业调度
ACK One多集群Spark作业调度，可以帮助您在不影响集群中正在运行的在线业务的前提下，打破资源边界，根据各集群实际剩余资源来进行调度，最大化您多集群中闲置资源的利用率。
阿里云基础设施.
251 26

云原生

热门文章

最新文章

  • 1
    Docker CE 镜像源站
  • 2
    Minikube - Kubernetes本地实验环境
  • 3
    重塑云上的 Java 语言
  • 4
    微服务架构的理论基础 - 康威定律
  • 5
    微服务（Microservice）那点事
  • 6
    Docker的Windows容器初体验
  • 7
    3分钟，了解阿里云热门开发者工具 Cloud Toolkit
  • 8
    Docker学习路线图 (持续更新中)
  • 9
    利用Zipkin对Spring Cloud应用进行服务追踪分析
  • 10
    基于Docker容器的，Jenkins、GitLab构建持续集成CI
  • 1
    基于Electron38+Vite7.1+Vue3+Pinia3+ElementPlus电脑端admin后台管理模板
    74
  • 2
    基于springboot的美食文化和旅游推广系统
    30
  • 3
    Qoder 重磅升级，推出 Quest Remote 功能，像发邮件一样将任务委派到云端
    63
  • 4
    聚焦 AI 应用基础设施，云栖大会 Serverless AI 全回顾
    43
  • 5
    让每次语音唤醒都可靠，公牛沐光重构可观测体系
    20
  • 6
    解读阿里云刚发布的《AI 原生应用架构白皮书》
    93
  • 7
    阿里云函数计算 AgentRun 全新发布，构筑智能体时代的基础设施
    18
  • 8
    云栖热词：AI 原生
    28
  • 9
    【Azure APIM】APIM在上传文件的时候，请求的Payload是否有文件大小的限制呢？
    26
  • 10
    新手如何创建网站，网站建设6个阶段
    87

    • 相关产品

  • 容器服务Kubernetes版
    文档详情 产品详情

    • 相关课程

    更多
  • 阿里云 EMR on ACK 实战
  • 阿里云K8S微服务部署案例
  • Kubernetes极速入门
  • Serverless 容器从入门到精通: - Serverless Kubernetes
  • Kubernetes云原生管理实践
  • Kubernetes入门

    • 相关电子书

    更多
  • ACK 云原生弹性方案—云原生时代的加速器
  • ACK集群类型选择最佳实践
  • 企业运维之云原生和Kubernetes 实战

    • 推荐镜像

    更多
  • kubernetes
    • 下一篇
    2025云栖大会，阿里云百炼邀请您的参与和见证