升级 Kf

本文档介绍如何升级现有 Kf 安装及其依赖项。

在升级过程中，您需要确保 Kf 安装使用最新版本的 Kf operator：

  • 确认当前的 Kf 版本可升级到 Kf v2.5.4。
  • 升级到 Kf v2.5.4。
  • 升级依赖项（如果需要）。

准备工作

您需要有：

  • 安装了 Kf 的现有集群。
  • 对安装了 gcloud、kf、kubectl 的机器的访问权限。

准备升级

连接到目标集群

gcloud container clusters get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

确认当前的 Kf CLI 与服务器版本匹配

运行 kf debug 并验证 Kf CLI 与 Kf 服务器版本是否匹配。

  • CLI 版本列在 Kf Client 下。
  • Kf 服务器版本列在 kf["app.kubernetes.io/version"] 下。
$ kf debug
...
Version:
  Kf Client:                        v2.4.1
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.4.1
...

如果 Kf 客户端与 Kf 服务器值不一致，但服务器版本为 v2.4.x，请先安装 Kf v2.5.4 CLI，然后再继续操作。

如果 Kf 服务器值低于 v2.4.x，您必须先逐步升级到 Kf v2.4.x，然后才能继续。

在升级之前，确认 Kf 运行状况良好

运行 kf doctor 以检查集群的状态。确保所有测试均已通过，然后再继续。

$ kf doctor
...
=== RUN doctor/user
=== RUN doctor/user/ContainerRegistry
--- PASS: doctor/user
   --- PASS: doctor/user/ContainerRegistry
...

如果您看到任何 FAIL 或 Error: environment failed checks 消息，请按照 kf doctor 输出中的指导操作或者查看问题排查指南以解决问题，并重试该命令直到成功为止。

升级 operator

Kf operator 会为您执行升级。

  1. 应用 operator yaml：

    kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.5.4/operator.yaml"

升级 Kf 依赖项

  1. 升级 Tekton：

  2. 升级到最新的 Anthos Service Mesh：

    1. 按照 Anthos Service Mesh 升级指南中的步骤操作。

  3. 升级 Config Connector。

升级到 Kf v2.5.4 CLI

  1. 安装 CLI：

    Linux

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

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

    Mac

    此命令会为系统上的所有用户安装 kf。

    gsutil cp gs://kf-releases/v2.5.4/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
gsutil cp gs://kf-releases/v2.5.4/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    此命令会将 kf 下载到当前目录。如果要从当前目录以外的任何位置调用，请将其添加到路径中。

    gsutil cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe

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

    • CLI 版本列在 Kf Client 下。
    • Kf 服务器版本列在 kf["app.kubernetes.io/version"] 下。
    $ kf debug
...
Version:
  Kf Client:                        v2.5.4
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.5.4
...

验证 Kf 已成功升级

  1. 运行 doctor 以确保新安装的版本运行状况良好：

    kf doctor --retries=20

    该命令会多次运行集群检查。在新控制器启动时，有几次尝试失败是正常的。

    如果命令失败并显示消息 Error: environment failed checks，请按照 doctor 输出中的指导操作来解决问题，并重试该命令直到成功为止。

如果验证步骤通过，那么您的集群已成功升级！ 如果您有任何问题，请查看支持页面获取指导。