找一台Linux 上安装 kubectl
以下是通过国内镜像源快速安装 kubectl
的方法,适合国内网络环境。
1. 下载 kubectl
通过国内镜像源下载指定版本的 kubectl
:
-
使用阿里云镜像源下载:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
-
为文件赋予执行权限:
chmod +x ./kubectl
-
将 kubectl****移动到系统路径:
sudo mv ./kubectl /usr/local/bin/kubectl
2. 验证安装
验证 kubectl
是否安装成功:
kubectl version --client
输出类似以下内容则说明安装成功:
Client Version: version.Info{Major:"1", Minor:"27", GitVersion:"v1.27.0", GitCommit:"abc123", GitTreeState:"clean", BuildDate:"2025-01-01T12:00:00Z", GoVersion:"go1.20", Compiler:"gc", Platform:"linux/amd64"}
安装成功如下

3. 配置 Kubernetes 集群
kubectl
需要配置访问 Kubernetes 集群的上下文:
-
确认 Kubernetes 配置文件( ~/.kube/config**)存在:** 检查配置文件:
ls ~/.kube/config
-
如无配置文件,可以从集群导出 kubeconfig: 在集群主节点执行以下命令并传输到客户端:
cat /etc/kubernetes/admin.conf > ~/.kube/config
-
测试连接 Kubernetes 集群:
kubectl get nodes
4. 配置 Kubernetes 集群(多个集群)
-
确认 Kubernetes 配置文件( ~/.kube**)目录存在:**
mkdiv ~/.kube
-
上传 Kubernetes 配置文件
-
- ~/.kube/bt-cloud-prod.yaml
- ~/.kube/bt-cloud-test.yaml
- 结果如下图


-
如无配置文件,可以从集群导出 kubeconfig: 在集群主节点执行以下命令并传输到客户端:
bt-cloud-prod.yaml 如下
contexts:
- name: "bt-cloud-prod"
context:
user: "bt-cloud-prod"
cluster: "bt-cloud-prod"
bt-cloud-test.yaml 如下
contexts:
- name: "bt-cloud-test"
context:
user: "bt-cloud-test"
cluster: "bt-cloud-test"
- name: "bt-cloud-prod"
-
配置文件写入环境变量:
vim ~/.bash_profile
export KUBECONFIG=HOME/.kube/bt-cloud-prod.yaml:HOME/.kube/bt-cloud-test.yaml
source ~/.bash_profile
echo $KUBECONFIG
kubectl config get-contexts #或取全局上下文
#输出
CURRENT NAME CLUSTER AUTHINFO NAMESPACE-
bt-cloud-prod bt-cloud-prod bt-cloud-prod bt-cloud-test bt-cloud-test bt-cloud-test
kubectl config current-context #获取当前K8S上下文
#输出:bt-cloud-prod
kubectl config use-context bt-cloud-test #切换当前K8S上下文
#输出:Switched to context "bt-cloud-test". -
-
测试连接 Kubernetes 集群:
kubectl get nodes #当前集群查看nodes
kubectl --context=bt-cloud-test get nodes #指定bt-cloud-test集群,查看nodes
5. 安装指定版本(可选)
如果需要特定版本的 kubectl
,可以通过以下方式下载:
-
查看 Kubernetes 版本:
kubectl version --short
-
从阿里云镜像下载指定版本: 替换
v1.27.0
为所需版本:curl -LO https://mirrors.aliyun.com/kubernetes/cli/v1.27.0/bin/linux/amd64/kubectl
chmod +x kubectl
sudo mv kubectl /usr/local/bin/
6. 国内网络问题解决
如果仍然存在网络问题,可以通过以下方式处理:
-
使用 HTTP/HTTPS 代理:
export http_proxy=http://proxy.example.com:port
export https_proxy=http://proxy.example.com:port -
手动下载二进制文件后,直接复制到
/usr/local/bin/
目录中。
完成后,你可以顺利使用 kubectl
管理 Kubernetes 集群!