Backup for GKE のシステム エラーのトラブルシューティング

Autopilot Standard

このページでは、Backup for GKE の使用時に発生する可能性のあるシステム関連のエラー、リソースのバックアップ時に考慮すべき事項、問題のトラブルシューティングの手順について説明します。

エラー 100020102: 厳密な許可モード - CRD のバックアップに失敗しました - サポートされていない v1beta1 API バージョン

エラー 100020102 は、元々 apiextensions.k8s.io/v1beta1 バージョンとして適用された CustomResourceDefinition のバックアップを試みたときに、apiextensions.k8s.io/v1 API バージョンで必要な構造スキーマがないために失敗した場合に発生します。このエラーが発生すると、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 削除をご覧ください。

非 permissive モードでのバックアップ オペレーションの動作

制約なしモード以外の場合、または厳密なバックアップ プランの場合、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 マニフェストをクラスタに適用します。

      注: 構造スキーマのない以前に作成した CustomResourceDefinition を削除し、v1 バージョンを再適用して、API サーバーがリソース規約を正しく処理できるようにする必要がある場合があります。

4. アップグレードが成功したら、バックアップ オペレーションを再試行します。それ以外の場合は、次のいずれかの方法で問題を解決します。

   • クラスタで CustomResourceDefinition が使用されていない場合は、kubectl delete crd コマンドを実行して CustomResourceDefinition を削除します。

     注: クラスタ内の既存のカスタム リソースをアクティブに提供している CustomResourceDefinition を削除しようとしないでください。CustomResourceDefinition を v1 API バージョンにアップグレードするか、制限なしモードを有効にする必要があります。

     kubectl delete crd CRD_NAME
     

     CRD_NAME は、削除する CustomResourceDefinition の名前に置き換えます。

   • バックアップ プランで Permissive モードを有効にします。これにより、Backup for GKE はリソース（v1beta1 API バージョンの CustomResourceDefinitions を含む）をスキップし、残りのバックアップ オペレーションを続行できます。制約なしモードを有効にする方法の詳細については、バックアップ プランで制約なしモードを有効にするをご覧ください。

     警告: 問題のある CustomResourceDefinition とその関連するカスタム リソースはバックアップされず、復元時に含まれません。このようなバックアップを正常に復元するには、CustomResourceDefinition によって提供されるリソースを復元から除外するか、復元を開始する前にターゲット クラスタに CustomResourceDefinition を作成する必要があります。

5. バックアップ オペレーションを再試行します。オペレーションが引き続き失敗する場合は、Cloud カスタマーケアにお問い合わせください。

次のステップ

• Backup for GKE のエラーコードの概要ページを読む。