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

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

2023-10-09 1169
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
本文涉及的产品
注册配置 MSE Nacos/ZooKeeper，118元/月
应用实时监控服务-可观测链路OpenTelemetry版，每月50GB免费额度
任务调度 XXL-JOB 版免费试用，400 元额度，开发版规格
简介： 在自己本机当中安装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
容器服务Kubernetes版kubectl
容器服务Kubernetes版连接
连接容器服务Kubernetes版
相关实践学习
通过Ingress进行灰度发布
本场景您将运行一个简单的应用，部署一个新的应用用于新的发布，并通过Ingress能力实现灰度发布。
容器应用与集群管理
欢迎来到《容器应用与集群管理》课程，本课程是“云原生容器Clouder认证“系列中的第二阶段。课程将向您介绍与容器集群相关的概念和技术，这些概念和技术可以帮助您了解阿里云容器服务ACK/ACK Serverless的使用。同时，本课程也会向您介绍可以采取的工具、方法和可操作步骤，以帮助您了解如何基于容器服务ACK Serverless构建和管理企业级应用。 学习完本课程后，您将能够： 掌握容器集群、容器编排的基本概念 掌握Kubernetes的基础概念及核心思想 掌握阿里云容器服务ACK/ACK Serverless概念及使用方法 基于容器服务ACK Serverless搭建和管理企业级网站应用
XiaoHHSuperme
目录
相关文章
阿里云基础设施.
|
1月前
|
缓存 容灾 网络协议
ACK One多集群网关：实现高效容灾方案
ACK One多集群网关可以帮助您快速构建同城跨AZ多活容灾系统、混合云同城跨AZ多活容灾系统，以及异地容灾系统。
阿里云基础设施.
96 19
蓝易云
|
2月前
|
Kubernetes Ubuntu 网络安全
ubuntu使用kubeadm搭建k8s集群
通过以上步骤，您可以在 Ubuntu 系统上使用 kubeadm 成功搭建一个 Kubernetes 集群。本文详细介绍了从环境准备、安装 Kubernetes 组件、初始化集群到管理和使用集群的完整过程，希望对您有所帮助。在实际应用中，您可以根据具体需求调整配置，进一步优化集群性能和安全性。
蓝易云
148 12
蓝易云
|
2月前
|
存储 Kubernetes Docker
Kubernetes（k8s）和Docker Compose本质区别
理解它们的区别和各自的优势，有助于选择合适的工具来满足特定的项目需求。
蓝易云
232 19
阿里云基础设施.
|
2月前
|
Prometheus Kubernetes 监控
OpenAI故障复盘 - 阿里云容器服务与可观测产品如何保障大规模K8s集群稳定性
聚焦近日OpenAI的大规模K8s集群故障，介绍阿里云容器服务与可观测团队在大规模K8s场景下我们的建设与沉淀。以及分享对类似故障问题的应对方案：包括在K8s和Prometheus的高可用架构设计方面、事前事后的稳定性保障体系方面。
阿里云基础设施.
153 15
栈江湖
|
2月前
|
Kubernetes 网络协议 应用服务中间件
Kubernetes Ingress：灵活的集群外部网络访问的利器
《Kubernetes Ingress：集群外部访问的利器-打造灵活的集群网络》介绍了如何通过Ingress实现Kubernetes集群的外部访问。前提条件是已拥有Kubernetes集群并安装了kubectl工具。文章详细讲解了Ingress的基本组成（Ingress Controller和资源对象），选择合适的版本，以及具体的安装步骤，如下载配置文件、部署Nginx Ingress Controller等。此外，还提供了常见问题的解决方案，例如镜像下载失败的应对措施。最后，通过部署示例应用展示了Ingress的实际使用方法。
栈江湖
87 2
小陈运维
|
2月前
|
Kubernetes 应用服务中间件 nginx
二进制安装Kubernetes（k8s）v1.32.0
本指南提供了一个详细的步骤，用于在Linux系统上通过二进制文件安装Kubernetes（k8s）v1.32.0，支持IPv4+IPv6双栈。具体步骤包括环境准备、系统配置、组件安装和配置等。
小陈运维
686 10
弹性计算-百晓生
|
2月前
|
存储 Kubernetes 关系型数据库
阿里云ACK备份中心，K8s集群业务应用数据的一站式灾备方案
本文源自2024云栖大会苏雅诗的演讲，探讨了K8s集群业务为何需要灾备及其重要性。文中强调了集群与业务高可用配置对稳定性的重要性，并指出人为误操作等风险，建议实施周期性和特定情况下的灾备措施。针对容器化业务，提出了灾备的新特性与需求，包括工作负载为核心、云资源信息的备份，以及有状态应用的数据保护。介绍了ACK推出的备份中心解决方案，支持命名空间、标签、资源类型等维度的备份，并具备存储卷数据保护功能，能够满足GitOps流程企业的特定需求。此外，还详细描述了备份中心的使用流程、控制台展示、灾备难点及解决方案等内容，展示了备份中心如何有效应对K8s集群资源和存储卷数据的灾备挑战。
弹性计算-百晓生
101 5
Java时光
|
3月前
|
Kubernetes 监控 Cloud Native
Kubernetes集群的高可用性与伸缩性实践
Kubernetes集群的高可用性与伸缩性实践
Java时光
99 1
阿里云基础设施.
|
4月前
|
JSON Kubernetes 容灾
ACK One应用分发上线：高效管理多集群应用
ACK One应用分发上线，主要介绍了新能力的使用场景
阿里云基础设施.
83 9
阿里云基础设施.
|
4月前
|
Kubernetes 持续交付 开发工具
ACK One GitOps：ApplicationSet UI简化多集群GitOps应用管理
ACK One GitOps新发布了多集群应用控制台，支持管理Argo CD ApplicationSet，提升大规模应用和集群的多集群GitOps应用分发管理体验。
阿里云基础设施.
83 1

云原生

热门文章

最新文章

  • 1
    Docker 镜像加速器
  • 2
    Docker CE 镜像源站
  • 3
    Docker的Windows容器初体验
  • 4
    Docker学习路线图 (持续更新中)
  • 5
    Docker Engine 镜像源站
  • 6
    阿里云容器服务-高可用Kubernetes部署指南
  • 7
    如何使用 Buildah 构建容器镜像
  • 8
    阿里云亮相2019云原生产业大会，积极共建云原生生态
  • 9
    容器内日志收集方案示例
  • 10
    微服务架构下的事务一致性保证
  • 1
    新一代 Cron-Job分布式任务调度平台 部署指南
    25
  • 2
    如何在通义灵码里用上DeepSeek-V3 和 DeepSeek-R1 满血版671B模型？
    19
  • 3
    【Azure Kafka】使用Spring Cloud Stream Binder Kafka 发送并接收 Event Hub 消息及解决并发报错
    10
  • 4
    开箱即用的GO后台管理系统 Kratos Admin - 列表查询规则
    8
  • 5
    有哪些CAD软件支持（国产操作系统）麒麟操作系统
    8
  • 6
    如何选择适合的CMS搭建网站？
    20
  • 7
    新一代 Cron-Job 分布式任务调度平台 正式发布！
    35
  • 8
    设计模式3：代理、适配器、装饰器模式
    19
  • 9
    3D/XR线上展厅实时云渲染平台搭建方案
    22
  • 10
    0 代码！2 种方式，一键部署 DeepSeek 系列模型
    152

    • 相关产品

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

    • 相关课程

    更多
  • 使用ASK容器化部署大语言模型FastChat
  • 如何在 ACK 中使用 MSE Ingress
  • 从概念、部署到优化，Kubernetes Ingress 网关的落地实践
  • 使用Kubernetes监控定位Pod状态异常根因
  • 如何使用Kubernetes监控定位慢调用
  • 使用Kubernetes监控发现资源使用，流量分布不均匀的问题

    • 相关电子书

    更多
  • 智算时代，基于 Kubernetes 落地云原生 AI
  • 容器服务 ACK 加速企业应用现代化升级
  • 容器服务 ACK – 智算时代的现代化应用平台

    • 相关实验场景

    更多
  • 容器服务Serverless版ACK Serverless 快速入门：在线魔方应用部署和监控
  • 容器管理命令
  • 通过Helm CLI部署wordpress到ACK集群
  • 基于MSE实现K8s集群内多服务的灰度发布
  • 使用 Fleet 管理 Elastic Agent 监控应用
  • 基于ACK Serverless轻松部署企业级Stable Diffusion

    • 推荐镜像

    更多
  • kubernetes
  • docker-ce
  • CloudFoundry
    • 下一篇
    阿里云oss简介和如何对接使用