ベアメタル版 Anthos クラスタのアップグレード

ベアメタル版 Anthos クラスタのアップグレード

新しいバージョンの bmctl をインストールすると、以前のバージョンで作成した既存のクラスタをアップグレードできます。クラスタを Anthos clusters on bare metal の最新バージョンにアップグレードすると、クラスタに追加機能と修正が適用されます。また、引き続きクラスタのサポートを保証します。管理者、ハイブリッド、スタンドアロン、ユーザー クラスタは、bmctl upgrade cluster コマンドを使用してアップグレードできます。

クラスタ アップグレードの前にプリフライト チェックが実行され、クラスタのステータスとノードの健全性が検証されます。

以下の例では、ベアメタル版 Anthos クラスタのバージョン 1.6.2 から 1.7.7 へのアップグレード プロセスを示します。

任意のバージョンを次に利用可能なバージョン(たとえば 1.6.1 から 1.6.2)に同じ方法でアップグレードできます。また、1.6.1 から 1.7.7 などのスキップ アップグレードにも対応しています。

ベアメタル版 Anthos クラスタの 1.7.0 以降のバージョンでは、ノードあたり最大 250 Pod の構成をサポートしています。この構成は、クラスタの作成時にのみ行うことができ、既存のクラスタを更新して構成することはできません。これは、前のバージョンから 1.7.0 にアップグレードした場合でも、新しい 1.7.7 のクラスタでも同様です。

ベアメタル版 Anthos クラスタの、管理、スタンドアロン、ハイブリッド、ユーザー クラスタをアップグレードする

新しいバージョンの bmctl をダウンロードしてインストールすると、以前のバージョンで作成した管理クラスタ、ハイブリッド クラスタ、スタンドアロン クラスタ、ユーザー クラスタをアップグレードできます。特定のバージョンの bmctl の場合は、クラスタを同じバージョンにのみアップグレードできます。

まず、最新の bmctl をダウンロードしてから、適切なクラスタ構成ファイルを変更し、bmctl upgrade cluster コマンドを発行してアップグレードを完了します。

  1. 最新の bmctlCloud Storage バケットからダウンロードし、chmod を使用してすべてのユーザーに bmctl の実行権限を付与します。

    gsutil cp gs://anthos-baremetal-release/bmctl/1.7.7/linux-amd64/bmctl bmctl
    chmod a+x bmctl
    
  2. クラスタの構成ファイルを修正して、ベアメタル版 Anthos クラスタのクラスタ バージョンを 1.6.2 から 1.7.7 に変更します。管理クラスタの構成ファイルの例を次に示します。

    ---
    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: cluster1
      namespace: cluster-cluster1
    spec:
      # Cluster type. This can be:
      #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
      #   2) user:   to create a user cluster. Requires an existing admin cluster.
      #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
      #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
      type: admin
      # Anthos cluster version.
      # Change the following line from 1.6.2 to 1.7.7, shown below
      anthosBareMetalVersion: 1.7.7
    
  3. クラスタを 1.7.7 にアップグレードする場合は、プロジェクトのフリートに対するコネクトにクラスタを登録する必要があります(未実施の場合)。

    1. サービス アカウントを手動で作成して JSON キーファイルを取得する方法については、Google サービスとサービス アカウントの有効化に関するページの Connect に使用するサービス アカウントを構成するをご覧ください。
    2. ダウンロードした JSON キーを、クラスタ構成ファイルの gkeConnectAgentServiceAccountKeyPath および gkeConnectRegisterServiceAccountKeyPath フィールドで参照します。
  4. bmctl upgrade cluster コマンドを使用してアップグレードを完了します。

    bmctl upgrade cluster -c CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG
    

    以下を置き換えます。

    • CLUSTER_NAME: アップグレードするクラスタの名前。
    • ADMIN_KUBECONFIG: 管理クラスタの kubeconfig ファイルのパス。