Linux系統中HOME目錄未設置導致kubectl執行報錯

一、問題描述

在Kubernets Master節點中，執行 kubectl get nodes時，報如下錯誤：

root@master:/# pwd
/
root@master:/# kubectl get nodes
The connection to the server localhost:8080 was refused - did you specify the right host or port?
root@master:/#

二、問題分析

執行kubectl命令時，會讀取本地的.kube/config文件，并使用其中的配置信息來連接到Kubernetes API Server。.kube/config文件內容如下：

apiVersion: v1
clusters:
- cluster:
certificate-authority-data: ...... # 此處省略
server: https://30.*.*.*:6443  # API Server地址
name: kubernetes
contexts:
- context:
cluster: kubernetes
user: kubernetes-admin
name: kubernetes-admin@kubernetes
current-context: kubernetes-admin@kubernetes
kind: Config
preferences: {}
users:
- name: kubernetes-admin
user:
client-certificate-data: 
...
client-key-data: 
...

查看當前用戶的HOME目錄下，是否存在.kube目錄。

# cd ~
# ls -a
.
..
.bash_history
.bashrc
.cache
.config
.dbus
.kube
.local
.profile
......

kube目錄和config文件都存在。此時，再執行kubectl命令不再報錯，可查詢出結果。

# kubectl get nodes
NAME     STATUS   ROLES                  AGE    VERSION
master   Ready    control-plane,master   114d   v1.23.1
node2    Ready    < none >                 114d   v1.23.1

此時，在當前命令窗口，使用export命令配置HOME目錄:

export HOME=/root

有關環境變量，可參閱Linux shell：變量

再次切換目錄到/下，執行kubectl get nodes可查詢到結果。

所以，執行kubectl命令報錯的原因為未設置HOME環境變量。

另外，新建一個命令窗口，執行su root命令，也可以正常執行kubectl命令。

root@master:/# pwd
/
root@master:/# kubectl get nodes
The connection to the server localhost:8080 was refused - did you specify the right host or port?
root@master:/# 
root@master:/# 
root@master:/# su root
root@master:/# pwd
/
root@master:/# kubectl get nodes
NAME     STATUS   ROLES                  AGE    VERSION
master   Ready    control-plane,master   114d   v1.23.1
node2    Ready    < none >                 114d   v1.23.1

其背后的技術原理為：

在Linux中，每個用戶都有一個主目錄，它是用戶登錄時的默認工作目錄。當用戶切換到另一個用戶時，其主目錄也會隨之切換。這是通過設置環境變量HOME來實現的。執行su root命令時，便會自動設置HOME環境變量為/root。