一、kubectl

Kubernetes 命令行工具 kubectl， 讓你可以對 Kubernetes 集群運(yùn)行命令。 你可以使用 kubectl 來部署應(yīng)用、監(jiān)測和管理集群資源以及查看日志。

二、在 Linux 系統(tǒng)中安裝并設(shè)置 kubectl

1.準(zhǔn)備工作

kubectl 版本和集群版本之間的差異必須在一個(gè)小版本號內(nèi)。 例如：v1.27 版本的客戶端能與 v1.26、 v1.27 和 v1.28 版本的控制面通信。 用最新兼容版的 kubectl 有助于避免不可預(yù)見的問題。

2.用 curl 在 Linux 系統(tǒng)中安裝 kubectl

用以下命令下載最新發(fā)行版：

x86-64

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"

說明：
如需下載某個(gè)指定的版本，請用指定版本號替換該命令的這一部分： $(curl -L -s https://dl.k8s.io/release/stable.txt)。

例如，要在 Linux x86-64 中下載 1.27.4 版本，請輸入：

curl -LO https://dl.k8s.io/release/v1.27.4/bin/linux/amd64/kubectl

下載 kubectl 校驗(yàn)和文件：

curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"

基于校驗(yàn)和文件，驗(yàn)證 kubectl 的可執(zhí)行文件：

echo "$(cat kubectl.sha256)  kubectl" | sha256sum --check

驗(yàn)證通過時(shí)，輸出為：

kubectl: OK

驗(yàn)證失敗時(shí)，sha256 將以非零值退出，并打印如下輸出：

kubectl: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match

3.安裝 kubectl

sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

說明：
即使你沒有目標(biāo)系統(tǒng)的 root 權(quán)限，仍然可以將 kubectl 安裝到目錄 ~/.local/bin 中：

chmod +x kubectl
mkdir -p ~/.local/bin
mv ./kubectl ~/.local/bin/kubectl
# 之后將 ~/.local/bin 附加（或前置）到 $PATH

4.執(zhí)行測試，以保障你安裝的版本是最新的：

kubectl version --client

說明：
上面的命令會產(chǎn)生一個(gè)警告：

WARNING: This version information is deprecated and will be replaced with the output from kubectl version --short.

你可以忽略這個(gè)警告。你只檢查你所安裝的 kubectl 的版本。

或者使用如下命令來查看版本的詳細(xì)信息：

kubectl version --client --output=yaml

3.用原生包管理工具安裝

cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-\$basearch
enabled=1
gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
sudo yum install -y kubectl

三、驗(yàn)證 kubectl 配置

為了讓 kubectl 能發(fā)現(xiàn)并訪問 Kubernetes 集群，你需要一個(gè) kubeconfig 文件， 該文件在 kube-up.sh 創(chuàng)建集群時(shí)，或成功部署一個(gè) Minikube 集群時(shí)，均會自動生成。 通常，kubectl 的配置信息存放于文件 ~/.kube/config 中。

通過獲取集群狀態(tài)的方法，檢查是否已恰當(dāng)?shù)嘏渲昧?kubectl：

kubectl cluster-info

如果返回一個(gè) URL，則意味著 kubectl 成功地訪問到了你的集群。

如果你看到如下所示的消息，則代表 kubectl 配置出了問題，或無法連接到 Kubernetes 集群。

The connection to the server <server-name:port> was refused - did you specify the right host or port?
（訪問 <server-name:port> 被拒絕 - 你指定的主機(jī)和端口是否有誤？）

例如，如果你想在自己的筆記本上（本地）運(yùn)行 Kubernetes 集群，你需要先安裝一個(gè) Minikube 這樣的工具，然后再重新運(yùn)行上面的命令。

如果命令 kubectl cluster-info 返回了 URL，但你還不能訪問集群，那可以用以下命令來檢查配置是否妥當(dāng)：

kubectl cluster-info dump

四、kubectl 的可選配置和插件

1.啟用 shell 自動補(bǔ)全功能

kubectl 的 Bash 補(bǔ)全腳本可以用命令 kubectl completion bash 生成。 在 Shell 中導(dǎo)入（Sourcing）補(bǔ)全腳本，將啟用 kubectl 自動補(bǔ)全功能。

然而，補(bǔ)全腳本依賴于工具 bash-completion， 所以要先安裝它（可以用命令 type _init_completion 檢查 bash-completion 是否已安裝）。

安裝 bash-completion
很多包管理工具均支持 bash-completion（參見這里）。 可以通過 apt-get install bash-completion 或 yum install bash-completion 等命令來安裝它。

上述命令將創(chuàng)建文件 /usr/share/bash-completion/bash_completion，它是 bash-completion 的主腳本。 依據(jù)包管理工具的實(shí)際情況，你需要在 ~/.bashrc 文件中手工導(dǎo)入此文件。

要查看結(jié)果，請重新加載你的 Shell，并運(yùn)行命令 type _init_completion。 如果命令執(zhí)行成功，則設(shè)置完成，否則將下面內(nèi)容添加到文件 ~/.bashrc 中：

source /usr/share/bash-completion/bash_completion

重新加載 Shell，再輸入命令 type _init_completion 來驗(yàn)證 bash-completion 的安裝狀態(tài)。

啟動 kubectl 自動補(bǔ)全功能
Bash
你現(xiàn)在需要確保一點(diǎn)：kubectl 補(bǔ)全腳本已經(jīng)導(dǎo)入（sourced）到 Shell 會話中。 可以通過以下兩種方法進(jìn)行設(shè)置：

當(dāng)前用戶

echo 'source <(kubectl completion bash)' >>~/.bashrc

系統(tǒng)全局

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

如果 kubectl 有關(guān)聯(lián)的別名，你可以擴(kuò)展 Shell 補(bǔ)全來適配此別名：

echo 'alias k=kubectl' >>~/.bashrc
echo 'complete -o default -F __start_kubectl k' >>~/.bashrc

說明：
bash-completion 負(fù)責(zé)導(dǎo)入 /etc/bash_completion.d 目錄中的所有補(bǔ)全腳本。

兩種方式的效果相同。重新加載 Shell 后，kubectl 自動補(bǔ)全功能即可生效。 若要在當(dāng)前 Shell 會話中啟用 Bash 補(bǔ)全功能，源引 ~/.bashrc 文件：

source ~/.bashrc

2.安裝 kubectl convert 插件

一個(gè) Kubernetes 命令行工具 kubectl 的插件，允許你將清單在不同 API 版本間轉(zhuǎn)換。 這對于將清單遷移到新的 Kubernetes 發(fā)行版上未被廢棄的 API 版本時(shí)尤其有幫助。

1.用以下命令下載最新發(fā)行版：

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"

2.驗(yàn)證該可執(zhí)行文件（可選步驟）

下載 kubectl-convert 校驗(yàn)和文件：

curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256"

基于校驗(yàn)和，驗(yàn)證 kubectl-convert 的可執(zhí)行文件：

echo "$(cat kubectl-convert.sha256) kubectl-convert" | sha256sum --check

驗(yàn)證通過時(shí)，輸出為：

kubectl-convert: OK

驗(yàn)證失敗時(shí)，sha256 將以非零值退出，并打印輸出類似于：

kubectl-convert: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match

3.安裝 kubectl-convert

sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert

4.驗(yàn)證插件是否安裝成功

kubectl convert --help

如果你沒有看到任何錯(cuò)誤就代表插件安裝成功了。

5.安裝插件后，清理安裝文件：

rm kubectl-convert kubectl-convert.sha256