Hierarchy Controller から Hierarchical Namespace Controller（HNC）に移行する

このページでは、Hierarchy Controller（2024 年 12 月以降は使用できなくなります）からオープンソースの Kubernetes Hierarchical Namespace Controller（HNC）に移行する方法について説明します。

HNC への移行方法を決定するには、kubectl ConfigManagement オブジェクトまたは gcloud apply spec ファイルを調べ、次のフィールドの値に対応するアクションを実行します。

hierarchyController.enablePodTreeLabels: true で、階層オブザーバビリティを使用している場合は、このページの手順は実施しないでください。代わりに、Cloud カスタマーケアにお問い合わせいただき、代替手段への移行についてご相談ください。
hierarchyController.enabled:: true の場合は、次の操作を行います。
1. Hierarchy Controller を無効にします。
2. HNC をインストールします。
3. 必要に応じて、階層型リソース割り当てを HNC に移行します。

Hierarchy Controller を無効にする

Hierarchy Controller を無効にすると、クラスタ内の Hierarchy Controller コンポーネントが削除されます。Hierarchy Controller カスタムリソース定義（CRD）は削除されません。

Hierarchy Controller のフィールドを削除するには、Hierarchy Controller のインストールに使用した方法の手順を確認してください。

Google Cloud CLI apply spec ファイルから hierarchyController ブロックを削除します。

Terraform リソースから hierarchyController ブロックを削除します。

GKEHubFeatureMembership リソースで、Hierarchy Controller フィールドを false に設定します。

ConfigManagement オブジェクトから hierarchyController ブロックを削除します。

階層型リソース割り当てを使用している場合は、HNC バージョン 1.1.0 以降をインストールする必要があります。

hierarchyController.enableHierarchicalResourceQuota を true に設定して Hierarchy Controller で階層型リソース割り当てを使用している場合は、HNC への移行を完了するために次の操作を行います。

[Releases] > [Assets] に移動して hrq.yaml ファイルをインストールして、HNC 階層型リソース割り当てをインストールします。
既存の階層型リソース割り当てのカスタムリソースを移行するには、apiVersion フィールドを hierarchycontroller.configmanagement.gke.io/v1alpha1 から hnc.x-k8s.io/v1alpha2 に変更します。クラスタのカスタムリソースを確認するには、次のコマンドを実行します。
```
kubectl get hierarchicalresourcequota.hierarchycontroller.configmanagement.gke.io --all-namespaces
```
階層型リソース割り当てのリソースを再適用します。

Hierarchy Controller から階層型リソース割り当ての CRD を削除します。

kubectl delete crd hierarchicalresourcequotas.hierarchycontroller.configmanagement.gke.io