安裝 Kf CLI

本文件說明如何安裝 Kf CLI。您通常會在已存取到執行 Kf 的 GKE 叢集時，安裝 Kf CLI。也就是說，您可以開始使用 Kf 指令，而無須先自行建立 GKE 叢集。

安裝 Kf CLI 並連線至 Kf 叢集後，您就可以執行任何 Kf 指令。如需可用 Kf 指令的完整清單，請參閱 Kf 指令參考資料。

事前準備

您必須先存取執行完整 Kf 安裝作業的 GKE 叢集，才能使用 Kf CLI。這表示您已執行下列指令，連線至叢集：

gcloud container clusters get-credentials CLUSTER_NAME \
    --project=CLUSTER_PROJECT_ID \
    --zone=CLUSTER_LOCATION

安裝 CLI

  1. 安裝 Kf CLI：

    Linux

    這項指令會為系統上的所有使用者安裝 Kf CLI。請按照 Cloud Shell 分頁中的操作說明，為自己安裝這個擴充功能。

    gcloud storage cp gs://kf-releases/v2.6.1/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Mac

    這項指令會為系統上的所有使用者安裝 kf。

    gcloud storage cp gs://kf-releases/v2.6.1/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    如果您使用 bash，這個指令會在 Cloud Shell 執行個體上安裝 kf。如果您使用其他殼層，可能需要修改指令。

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.6.1/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    這個指令會將 kf 下載至目前目錄。如果您想從目前目錄以外的任何位置呼叫，請將該路徑新增至路徑。

    gcloud storage cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe

升級 CLI

如果您已安裝 Kf CLI，可以使用下列程序將其升級至目前版本。

  1. 安裝 CLI：

    Linux

    這項指令會為系統上的所有使用者安裝 Kf CLI。請按照 Cloud Shell 分頁中的操作說明，為自己安裝這個擴充功能。

    gcloud storage cp gs://kf-releases/v2.6.1/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Mac

    這項指令會為系統上的所有使用者安裝 kf。

    gcloud storage cp gs://kf-releases/v2.6.1/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    如果您使用 bash，這個指令會在 Cloud Shell 執行個體上安裝 kf。如果您使用其他殼層，可能需要修改指令。

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.6.1/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    這會將 kf 下載到目前的目錄。如果您想從目前目錄以外的任何位置呼叫，請將該路徑新增至路徑。

    gcloud storage cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe

  2. 驗證 Kf CLI 和 Kf 伺服器版本是否相符：

    • CLI 版本會列在 Kf Client 下方。
    • Kf 伺服器版本會列在 kf["app.kubernetes.io/version"] 下方。
    $ kf debug
...
Version:
  Kf Client:                        v2.6.1
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.6.1
...