계층 구조 컨트롤러에서 계층적 네임스페이스 컨트롤러(HNC)로 마이그레이션

이 페이지에서는 계층 구조 컨트롤러(2024년 12월부터 사용 불가)에서 오픈소스 Kubernetes 계층적 네임스페이스 컨트롤러(HNC)로 마이그레이션하는 방법을 설명합니다.

HNC로 마이그레이션하는 방법을 확인하려면 kubectl ConfigManagement 객체 또는 gcloud apply spec 파일을 검사하고 다음 필드의 값에 해당하는 작업을 실행합니다.

hierarchyController.enablePodTreeLabels: true이고 계층적 관측 가능성을 사용하는 경우 이 페이지의 단계를 진행하지 마세요. 대신 Cloud Customer Care에 문의하여 대체 방법으로 마이그레이션하는 데 도움을 받으세요.
hierarchyController.enabled:가 true인 경우 다음을 수행합니다.
1. 계층 구조 컨트롤러를 사용 중지합니다.
2. HNC를 설치합니다.
3. 원하는 경우 계층적 리소스 할당량을 HNC로 마이그레이션합니다.

계층 구조 컨트롤러 사용 중지

계층 구조 컨트롤러를 사용 중지하면 클러스터에서 계층 구조 컨트롤러 구성요소가 삭제됩니다. 계층 구조 컨트롤러 커스텀 리소스 정의(CRD)는 삭제되지 않습니다.

계층 구조 컨트롤러 필드를 삭제하려면 계층 구조 컨트롤러를 설치하는 데 사용한 방법에 관한 안내를 검토하세요.

Google Cloud CLI apply spec 파일에서 hierarchyController 블록을 삭제합니다.

Terraform 리소스에서 hierarchyController 블록을 삭제합니다.

GKEHubFeatureMembership 리소스에서 계층 구조 컨트롤러 필드를 false로 설정합니다.

ConfigManagement 객체에서 hierarchyController 블록을 삭제합니다.

계층적 리소스 할당량을 사용하는 경우 HNC 버전 1.1.0 이상을 설치해야 합니다.

hierarchyController.enableHierarchicalResourceQuota를 true로 설정하여 계층 구조 컨트롤러에 계층적 리소스 할당량을 사용한 경우 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
```
계층적 리소스 할당량 리소스를 다시 적용합니다.

계층 구조 컨트롤러에서 계층적 리소스 할당량의 CRD를 삭제합니다.

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