Backup for GKE의 시스템 오류 문제 해결

이 페이지에서는 GKE용 백업을 사용할 때 발생할 수 있는 시스템 관련 오류, 리소스를 백업할 때 고려해야 할 사항, 문제를 해결하는 단계를 설명합니다.

오류 100020102: 엄격한 허용 모드 - CRD 백업 실패 - 지원되지 않는 v1beta1 API 버전

원래 apiextensions.k8s.io/v1beta1 버전으로 적용된 CustomResourceDefinition을 백업하려고 시도할 때 apiextensions.k8s.io/v1 API 버전에 필요한 구조적 스키마가 없기 때문에 오류 100020102가 발생합니다. 이 오류로 인해 Strict permissive mode - Failed to backup CRD - Unsupported v1beta1 API Version 오류 메시지가 표시됩니다.

이 오류는 Google Kubernetes Engine 버전 1.22에서 apiextensions.k8s.io/v1 API 버전이 삭제되었기 때문에 발생합니다. GKE 버전 1.22의 API 삭제에 대한 자세한 내용은 GKE v1.22의 API 삭제를 참고하세요.

허용 모드가 아닌 경우의 백업 작업 동작

허용 모드가 아니거나 엄격한 백업 계획에서는 v1beta1 API로 생성된 CustomResourceDefinition와 같이 백업할 수 없는 리소스가 발견되면 백업 작업이 실패합니다. 이 오류는 리소스에 v1 API에 필요한 구조적 스키마가 없기 때문에 발생합니다. 이 CustomResourceDefinition가 있으면 최신 클러스터로 올바르게 복원되지 않을 수 있으므로 심각한 오류로 간주됩니다.

이 오류를 해결하려면 다음 안내를 따르세요.

  1. kubectl get crd 명령어를 실행하여 문제가 있는 CustomResourceDefinition를 식별합니다.

    kubectl get crd CRD_NAME

    CRD_NAME을 오류 메시지의 CustomResourceDefinition 이름으로 바꿉니다.

  2. YAML 출력에서 다음 조건을 찾아 CustomResourceDefinition가 vbeta1 API에서 v1 API로 올바르게 변환되었는지 확인합니다.

    1. spec.versions: spec.versions 필드에 나열된 각 버전을 살펴 spec.versions 조건을 찾습니다. spec.versions에 schema.openAIV3Schema 필드가 누락된 경우 CustomResourceDefinition에 해당 버전에 대해 정의된 구조적 스키마가 없습니다.

    2. status.conditions: type:NonStructuralSchema 조건을 찾아 status.conditions 조건을 찾습니다. status.conditions의 status이 true인 경우 스키마가 구조적이지 않음을 명시적으로 확인합니다.

  3. 다음 단계를 사용하여 CustomResourceDefinition에서 v1 API 버전으로 업그레이드합니다.

    1. 커스텀 리소스 내의 모든 필드와 그 유형을 정의하는 구조적 스키마를 추가하여 기존 CustomResourceDefinition이 v1 표준과 호환되도록 수정합니다. 구조적 스키마를 추가하는 방법에 관한 자세한 내용은 구조적 스키마 지정을 참고하세요.

    2. 호환되는 v1 매니페스트를 클러스터에 적용합니다.

  4. 업그레이드가 성공하면 백업 작업을 다시 시도합니다. 그렇지 않은 경우 다음 방법 중 하나를 사용하여 문제를 해결하세요.

    • 클러스터에서 CustomResourceDefinition을 사용하지 않는 경우 kubectl delete crd 명령어를 실행하여 CustomResourceDefinition을 삭제합니다.

      kubectl delete crd CRD_NAME

      CRD_NAME을 삭제할 CustomResourceDefinition의 이름으로 바꿉니다.

    • 백업 계획에서 허용 모드를 사용 설정합니다. 그러면 Backup for GKE가 v1beta1 API 버전의 CustomResourceDefinitions를 비롯한 리소스를 건너뛰고 나머지 백업 작업을 계속할 수 있습니다. 허용 모드를 사용 설정하는 방법에 관한 자세한 내용은 백업 계획에서 허용 모드 사용 설정을 참고하세요.

  5. 백업 작업을 다시 시도합니다. 작업이 계속 실패하면 추가 지원을 위해 Cloud Customer Care에 문의하세요.

다음 단계