高度なクラスタ以外のクラスタをアップグレードして、高度なクラスタ以外の状態を維持する

デフォルトでは、バージョン 1.33 にアップグレードすると、高度なクラスタ以外のクラスタは自動的に高度なクラスタにアップグレードされます。高度なクラスタ以外のクラスタを高度なクラスタにアップグレードすることをおすすめしますが、1.32 から 1.33 にアップグレードして、クラスタを高度なクラスタ以外のままにする必要がある場合は、このドキュメントの手順に沿って操作してください。

詳しくは以下をご覧ください。

前提条件

  • gkectl のバージョンは、ターゲット クラスタのバージョンと同じである必要があります。

  • 更新またはアップグレードする前に、必ずクラスタを診断してください。

  • クラスタが推奨機能のみを使用していることを確認します。

  • ユーザー クラスタをアップグレードする前に、管理クラスタをアップグレードする必要があります。

管理クラスタをアップグレードする

  1. 必要に応じて、管理ワークステーションをアップグレードします。

  2. OS イメージを vSphere にインポートします。

    gkectl prepare \
    --bundle-path BUNDLE_PATH \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --advanced-cluster=false

    次のように置き換えます。

    • BUNDLE_PATH: バンドル ファイルのパス。このファイルは管理ワークステーションの /var/lib/gke/bundles/ にあります。次に例を示します。

      /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz

    • ADMIN_CLUSTER_KUBECONFIG: 管理クラスタの kubeconfig ファイルのパス

  3. 管理クラスタ構成ファイルで、enableAdvancedCluster を false に設定します。

  4. 管理クラスタ構成ファイルの bundlepath フィールドが、アップグレード先のバンドルのパスと一致していることを確認します。

  5. 管理クラスタをアップグレードし、高度なクラスタ以外のクラスタとして維持します。

    gkectl upgrade admin \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config ADMIN_CLUSTER_CONFIG

    次のように置き換えます。

    • ADMIN_CLUSTER_KUBECONFIG: 管理クラスタの kubeconfig ファイルのパス
    • ADMIN_CLUSTER_CONFIG: 管理クラスタの構成ファイルのパス。

    このコマンドによって、管理クラスタ内のすべてのノードが再作成されます。

ユーザー クラスタをアップグレードする

  1. OS イメージを vSphere にインポートします。

    gkectl prepare \
    --bundle-path BUNDLE_PATH \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --advanced-cluster=false

    次のように置き換えます。

    • BUNDLE_PATH: バンドル ファイルのパス。このファイルは管理ワークステーションの /var/lib/gke/bundles/ にあります。次に例を示します。

      /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz

    • ADMIN_CLUSTER_KUBECONFIG: 管理クラスタの kubeconfig ファイルのパス

  2. ユーザー クラスタの構成ファイルで、enableAdvancedCluster を false に設定します。

  3. ユーザー クラスタの構成ファイルの gkeOnPremVersion フィールドが、アップグレードのターゲット バージョンと一致することを確認します。

  4. ユーザー クラスタをアップグレードし、高度なクラスタ以外のクラスタとして維持します。

    gkectl upgrade cluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config USER_CLUSTER_CONFIG

    次のように置き換えます。

    • ADMIN_CLUSTER_KUBECONFIG: 管理クラスタの kubeconfig ファイルのパス
    • USER_CLUSTER_CONFIG: ユーザー クラスタの構成ファイルのパス

    このコマンドを実行すると、ユーザー クラスタ内のすべてのノードが再作成されます。