安装 Kf CLI

本文档介绍如何安装 Kf CLI。通常，如果您已能够访问运行 Kf 的 GKE 集群，便可以安装 Kf CLI。这意味着您无需先创建自己的 GKE 集群，便可以开始使用 Kf 命令。

安装 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.11.28/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.11.28/kf-darwin /tmp/kf
   chmod a+x /tmp/kf
   sudo mv /tmp/kf /usr/local/bin/kf

   Cloud Shell

   如果您使用 bash，此命令会在 Cloud Shell 实例上安装 kf；您可能需要为其他 Shell 修改说明。

   mkdir -p ~/bin
   gcloud storage cp gs://kf-releases/v2.11.28/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.11.28/kf-windows.exe kf.exe

升级 CLI

如果您已安装 Kf CLI，则可以按照以下步骤将其升级到当前版本。

1. 安装 CLI：

   Linux

   此命令会为系统上的所有用户安装 Kf CLI。请按照 Cloud Shell 标签页中的说明自行安装。

   gcloud storage cp gs://kf-releases/v2.11.28/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.11.28/kf-darwin /tmp/kf
   chmod a+x /tmp/kf
   sudo mv /tmp/kf /usr/local/bin/kf

   Cloud Shell

   如果您使用 bash，此命令会在 Cloud Shell 实例上安装 kf；您可能需要为其他 Shell 修改说明。

   mkdir -p ~/bin
   gcloud storage cp gs://kf-releases/v2.11.28/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.11.28/kf-windows.exe kf.exe

2. 验证 Kf CLI 和 Kf 服务器版本匹配：

   • CLI 版本列在 Kf Client 下。
   • Kf 服务器版本列在 kf["app.kubernetes.io/version"] 下。

   $ kf debug
   ...
   Version:
     Kf Client:                        v2.11.28
     Server version:                   v1.31.1-gke.2105000
     kf["app.kubernetes.io/version"]:  v2.11.28
   ...