Config Sync のアップグレード

このページでは、クラスタにインストールされている Config Sync のバージョンをアップグレードする方法について説明します。

Config Sync を手動でアップグレードする

サポート期間を維持するには、少なくとも 9 か月ごとにアップグレードすることをおすすめします。ただし、より頻繁にアップグレードして、最新の機能やセキュリティアップデートを入手することもできます。

Config Sync のバージョンがサポートされていない場合は、次のいずれかのオプションを使用してアップグレードを試せます。

（推奨）一度に 2 つ以下のマイナーバージョンずつ段階的にアップグレードを実行します。たとえば、バージョン N-4（サポートされていないバージョン）を使用している場合は、N-2（サポートされているバージョン）にアップグレードしてから、N（サポートされているバージョン）にアップグレードする必要があります。このアプローチは最も安全なアップグレード方法ですが、最初の増分アップグレードがサポートされているバージョンである場合にのみ機能します。
サポートされているバージョンに直接アップグレードします。段階的なアップグレードを実行できない場合は、サポートされているバージョンに直接アップグレードしてみてください。たとえば、バージョン N-6（サポートされていないバージョン）を使用している場合、N-4（サポートされていないバージョン）に増分アップグレードしようとしても、機能しません。このシナリオでは、N-2（サポートされている最も古いバージョン）に直接アップグレードしてみてください。
Config Sync のバージョンがかなり古く、前述のオプションが機能しない場合は、Config Sync をアンインストールして再インストールできます。

Config Sync をアップグレードする前に、リリースノートでバージョン間での変更点の詳細を確認してください。

Config Sync をアップグレードするには、次の手順を実施します。

（省略可）アップグレードする前にクラスタに Config Sync のどのバージョンがインストールされているかを確認する場合は、次のコマンドを実行します。
```
gcloud beta container fleet config-management version
```
次のコマンドを実行します。
```
gcloud beta container fleet config-management upgrade \
    --version=VERSION \
    --membership=MEMBERSHIP_NAME
```
次のように置き換えます。
- VERSION: アップグレード先のバージョン。
- MEMBERSHIP_NAME: クラスタの登録時に選択したフリートのメンバーシップ名。メンバーシップ名を確認するには、gcloud container fleet memberships list を実行します。

Config Sync の自動アップグレードを無効にするには、次の操作を行います。

Google Cloud CLI apply spec ファイルから upgrades フィールドを削除します。

google_gke_hub_feature_membership リソースで configmanagement.management フィールドを MANAGEMENT_MANUAL に設定します。

GKEHubFeatureMembership リソースで configmanagement.management フィールドを MANAGEMENT_MANUAL に設定します。