切断モードで実行される Anthos のアップグレード

このページでは、切断モードで実行される Anthos をアップグレードする方法について説明します。

管理クラスタと Anthos Management Center のアップグレード

インフラストラクチャオペレータは、管理クラスタと Management Center、およびそのコンポーネントをアップグレードできます。

バージョンのサポート状況

切断モードで動作する Anthos は、Anthos Config Management と Anthos Service Mesh のバージョンの非推奨ポリシーに従うようになりました。各バージョンは次の 4 つの状態のいずれかに分類されます。

サポート対象: このバージョンは、切断モードで実行中の Anthos によって認識され、インストールできます。切断モードのクラスタバージョンで実行されている現在の Anthos で動作します。サポートされているバージョンは、切断モードのリリースで動作する Anthos の次のマイナーリリースで非推奨になります。
非推奨: このバージョンは、切断モードで動作する Anthos によって認識され、インストールできます。切断モードのクラスタバージョンで実行されている現在の Anthos で動作します。非推奨のバージョンは、非接続モードのリリースの Anthos の次のマイナーリリースではサポートされません。
サポート対象外: このバージョンは、切断モードのインストールで実行されている Anthos によって認識されますが、インストールはできません。切断モードのクラスタバージョンで実行されている現在の Anthos では動作しない場合があります。サポートされていないバージョンを削除したり、新しいバージョンにアップグレードしたりすることは可能です。サポートされていないバージョンは、切断モードのリリースで動作する Anthos の次のマイナーリリースで削除されます。
削除済み: このバージョンは、切断モードのインストールで実行されている Anthos によって認識されません。新しいバージョンにアップグレードすることはできません。また、自動的にアンインストールすることもできません。

Anthos Config Management と Anthos Service Mesh の各バージョンのライフサイクルは、サポート対象から非推奨、サポート対象外、削除への移行のパターンとなります。

次の表は、Anthos Config Management と Anthos Service Mesh のバージョンの非推奨ポリシーを示しています。

切断モード 1.11 で動作する Anthos	サポート対象	非推奨	サポート対象外	削除済み
Anthos Config Management	1.11.1	なし	1.8.、1.9.	1.7.*
Anthos Service Mesh	1.11.8-asm.1	1.10.*	1.9.*	なし

環境の準備

次のコマンドを実行して、新しいリリースをダウンロードし、実行権限を設定します。

cd ~/
# Download the script which helps download all the latest components
export VERSION=UPGRADE_VERSION

# Please use official 'INSTALLER_DIGEST' value from https://cloud.google.com/anthos/private-mode/docs/1.9/installing/infrastructure#download
export INSTALLER_DIGEST=
export INSTALLER=get-anthos-private-mode-$VERSION.sh
gsutil cp gs://anthos-private-mode-release/$VERSION/$INSTALLER .
if [[ -n "$INSTALLER_DIGEST" ]]; then echo "$INSTALLER_DIGEST $INSTALLER" | sha256sum -c; fi && chmod +x $INSTALLER && ./$INSTALLER

# Note: ~/anthos-baremetal-private-mode should point to the new version.
ls -al anthos-baremetal-private-mode
cd ~/anthos-baremetal-private-mode

UPGRADE_VERSION は、アップグレード後の新しいバージョンに置き換えます。

次のコマンドを使用して、新しいイメージをプライベートレジストリにアップロードします。必ずバージョン UPGRADE_VERSION の actl を使用してください。
```
actl images push --private-registry=${PRIVATE_REGISTRY} \
  --images ~/anthos-baremetal-private-mode
```
アップロードプロセスにより、レジストリにすでに存在しているイメージは自動的にスキップされます。
Helm チャートを Container Registry にアップロードします。

管理クラスタのアップグレード

管理クラスタをアップグレードするには、管理クラスタ構成ファイルに対して次の変更のみを行ってから、actl clusters baremetal upgrade コマンドを実行してアップグレードを完了します。

クラスタ構成管理 YAML ファイルで、バージョン文字列を更新し、baremetal.cluster.gke.io/private-mode: "true" アノテーションを追加します。
```
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: admin
  namespace: cluster-admin
  annotations:
    baremetal.cluster.gke.io/private-mode: "true"
spec:
  anthosBareMetalVersion: VERSION
```
VERSION は、新しいベアメタル版 Anthos のバージョン番号に置き換えます。
次のコマンドを実行して、管理クラスタを更新します。必ずバージョン UPGRADE_VERSION の actl を使用してください。
```
actl clusters baremetal upgrade admin --kubeconfig=ADMIN_KUBECONFIG
```

アップグレードの完了には約 15～20 分かかりますが、クラスタのサイズによってはさらに時間がかかる場合があります。

Management Center のアップグレード

インフラストラクチャオペレータは、Management Center 全体をアップグレードすることも、個々のサブコンポーネントをアップグレードすることもできます。

オプション 1: Management Center 全体をアップグレードする

インフラストラクチャオペレータは、Management Center そのものを含め、Management Center のすべてのコンポーネントをアップグレードできます。

Management Center のバージョンを確認して、古いバージョンであることを確認します。
```
kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```
ADMIN_KUBECONFIG は、管理クラスタ用 kubeconfig ファイルのパスに置き換えます。
省略可: アップグレードに関するプリフライトチェックを実行します。
```
actl platform management-center upgrade --preflight-check-only --kubeconfig=ADMIN_KUBECONFIG
```
アップグレードを開始します（完了するまでに通常 10～15 分ほどかかります）。
```
actl platform management-center upgrade --kubeconfig=ADMIN_KUBECONFIG
```
Management Center のバージョンを確認して、バージョンが更新されていることを確認します。
```
kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```

オプション 2: 個別のコンポーネントをアップグレードする

インフラストラクチャオペレータは、Management Center で実行される特定のコンポーネントのアップグレードを管理できます。バージョン 1.9 以降では、Anthos Config Management オペレータ、Anthos Service Mesh オペレータ、ベアメタル版 Anthos の 3 つのコンポーネントを個別にアップグレードできます。

コンテナレジストリにイメージをアップロードしたら、新しいリリースで配送されたパッケージの仕様を公開する必要があります。たとえば、Anthos Config Management 演算子と Anthos Service Mesh 演算子のパッケージ仕様については、services/ をご覧ください。

新しい Anthos Config Management 演算子のパッケージ仕様を適用します。

kubectl apply -f ~/anthos-baremetal-private-mode/services/anthos-config-management/package-spec.yaml \
--kubeconfig=ADMIN_KUBECONFIG

Anthos Config Management オペレータの現在のコンポーネントステータスを確認します。
```
kubectl get adminoperator admin-operator \
  --kubeconfig=ADMIN_KUBECONFIG \
  -ojsonpath='{.status.components[?(@.name=="anthos-config-management")]}'
```
このコマンドにより、現在のバージョンに 1.9.X、現在のバージョン制約に <=1.9.X が得られるとします。
```
{"name":"anthos-config-management","version":"1.9.X","versionConstraint":"<=1.9.X"}
```
新しいバージョンを有効にするには、Admin Operator オブジェクトでバージョンの制約を編集します。
```
kubectl edit AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```
エディタで、spec.updateConfigOverride.policies の下にある更新ポリシーを見つけて、それに応じてコンポーネントのバージョンを上げます。spec.updateConfigOverride が省略されているか、構造体値（{}）が空の場合は、次のようにポリシーを追加します。
```
spec:
  updateConfigOverride:
    policies:
    - name: anthos-config-management
      versionConstraint: <=1.9.Y
```

オーバーライドを追加すると、Management Center により、変更がロールアウトされ、新しいバージョンの Anthos Config Management オペレーターが反映されます。

次のコマンドを実行して、新しいバージョンのロールアウトをモニタリングします。新しいバージョンは、以前の 1.9.X から 1.9.Y に変更されます。

kubectl get adminoperator admin-operator \
  --kubeconfig=ADMIN_KUBECONFIG \
  -ojsonpath='{.status.components[?(@.name=="anthos-config-management")].version}' \
  --watch

ロールアウトが完了すると、プラットフォーム管理者が Management Center を通じて新しい Anthos Config Management 演算子を使用できるようになります。

ユーザークラスタのアップグレード

プラットフォーム管理者は、actl コマンドラインツール、Management Centerを使用、または API を通してユーザークラスタを更新できます。

actl

次のコマンドを実行して、ユーザークラスタを更新します。

actl clusters baremetal upgrade CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

Console

Management Center コンソールで、[ダッシュボード] メニューに移動します。
[Upgrades] タブをクリックして、利用可能なすべてのアップグレードを表示します。
アップグレードするクラスタの [View Upgrades] をクリックします。
[Upgrade] をクリックして、バージョン、説明、リリースノートへのリンクなど、アップグレードの詳細を確認します。
[次へ] をクリックして確定します。
[Upgrade] をクリックして、クラスタのアップグレードを開始します。

アップグレードが完了するまでは、アップグレードリストのエントリに Upgrade in progress と表示されます。

API

ユーザークラスタは、Cluster リソースのバージョン文字列を変更することでアップグレードできます。

次のコマンドを実行して、ユーザークラスタの Cluster リソースを編集します。
```
kubectl edit cluster CLUSTER_NAME -n cluster-CLUSTER_NAME --kubeconfig=ADMIN_KUBECONFIG
```

spec.anthosBareMetalVersion のバージョン文字列を更新すると、コントローラがアップグレードで機能します。

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: CLUSTER_NAME
  namespace: cluster-CLUSTER_NAME
  annotations:
    baremetal.cluster.gke.io/private-mode: "true"
spec:
  type: user
  anthosBareMetalVersion: VERSION

VERSION は、新しいベアメタル版 Anthos のバージョン番号に置き換えます。

次のステップ

Anthos Management Center のインストールについて学習する。