5.6. カスタムリソース定義 (CRD) アップグレードの安全性


クラスター拡張によって提供されるカスタムリソース定義(CRD)を更新すると、Operator Lifecycle Manager (OLM) v1 は CRD アップグレード安全プリフライトチェックを実行して、以前のバージョンとの互換性を確保します。

CRD 更新は、クラスター上で変更が進行する前にその検証に合格する必要があります。

5.6.1. 禁止されている CRD アップグレード変更

検証しない変更を回避するには、アップグレード安全のプリフライトチェックによってブロックされているカスタムリソース定義(CRD)の変更を確認します。

CRD のアップグレード安全のプレフライトチェックは、既存の CRD への次の変更のいずれかを検出すると、アップグレードをブロックします。

  • 既存のバージョンへの新規必須フィールドの追加
  • 既存バージョンからの既存のフィールドの削除
  • 既存バージョンでの既存のフィールドタイプの変更
  • まだデフォルト値がないフィールドへのデフォルト値の追加
  • 既存フィールドのデフォルト値の変更
  • 既存フィールドのデフォルト値の削除
  • まだ持っていなかったフィールドに列挙制限を追加する
  • 既存のフィールドからの既存の列挙値の削除
  • 既存バージョンの既存フィールドの最小値を増やす
  • 既存バージョンの既存フィールドの最大値を減らす
  • 以前は持っていなかったフィールドに最小値または上限を追加する
注記

最小値と最大値のルールは、最小、minLength、minProperties、minItems、maxItems、maxLength、maxProperties、および maxItems の制約に適用されます。

プリフライトチェックにより、Kubernetes API サーバーで処理される次の構造の変更のアップグレードもブロックされます。

  • クラスター と namespace間の CRD スコープの変更
  • 保存された既存の CRD バージョンを削除する

CRD アップグレードの安全プレフライトチェックで禁止された変更が検出されると、違反ごとにエラーがログに記録されます。

ヒント

CRD の変更が明示的に許可も、禁止されている変更として分類されていない場合、プリフライトチェックはアップグレードをブロックし、unknown change エラーをログに記録します。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る