クラスタを更新または高度なクラスタにアップグレードする

このドキュメントでは、クラスタをバージョン 1.32 から高度なクラスタに更新またはアップグレードする方法について説明します。

前提条件

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

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

  • 更新またはアップグレードを開始する前に、クラスタで高度なクラスタでサポートされていない機能が使用されていないことを確認します。サポートされていない機能が有効になっている場合は、まず update を使用して無効にします。

    • 高度なクラスタでは高可用性（HA）ユーザー クラスタが必要ですが、このガイドに沿って HA 以外のユーザー クラスタを HA の高度なクラスタに更新またはアップグレードすることが可能です。

  • ユーザー クラスタを更新またはアップグレードする前に、管理クラスタを高度なクラスタに更新またはアップグレードしておく必要があります。

管理クラスタを高度なクラスタに更新またはアップグレードする

更新

  1. 高度なクラスタの準備をします。

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

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

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz

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

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

  3. 管理クラスタを高度なクラスタに更新します。

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

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

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

    このコマンドは、管理クラスタ内のすべてのノードを再作成します。

アップグレード

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

  2. 高度なクラスタの準備をします。

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

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

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz

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

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

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

  5. 管理クラスタを高度なクラスタにアップグレードします。

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

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

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

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

管理クラスタが更新または高度なクラスタに更新またはアップグレードされた後:

  • 既存の非高度なユーザー クラスタは引き続き正常に機能します。

  • 作成できるのは、高度な管理クラスタによって管理される高度なユーザー クラスタのみです。

すべてのユーザー クラスタを早めに高度なクラスタにアップグレードすることをおすすめします。これは、一貫性があり、機能が充実した環境を維持するためです。

ユーザー クラスタを高度なクラスタに更新またはアップグレードする

更新

  1. ユーザー クラスタ コントロール プレーンが高可用性（HA）でない場合:

    1. masterNode.replicas を 1 から 3 に変更します。

    2. ユーザー クラスタ コントロール プレーン ノードの静的 IP アドレスを network.controlPlaneIPBlock.ips セクションに追加します。

  2. 高度なクラスタの準備をします。

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

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

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz

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

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

  4. ユーザー クラスタを高度なクラスタに更新します。

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

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

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

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

アップグレード

  1. ユーザー クラスタ コントロール プレーンが高可用性（HA）でない場合:

    1. masterNode.replicas を 1 から 3 に変更します。

    2. ユーザー クラスタ コントロール プレーン ノードの静的 IP アドレスを network.controlPlaneIPBlock.ips セクションに追加します。

  2. 高度なクラスタの準備をします。

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

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

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz

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

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

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

  5. ユーザー クラスタを高度なクラスタにアップグレードします。

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

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

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

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