6.5.2. リファレンス設定へのパッチ適用

手順

1. 次のコマンドを実行して、テンプレートのパッチを生成します。

   $ oc cluster-compare -r <path_to_reference_config>/metadata.yaml -o 'generate-patches' --override-reason "A valid reason for the override" --generate-override-for "<template1_path>" --generate-override-for "<template2_path>" > <path_to_patches_file>

   • -r は、リファレンス設定の metadata.yaml ファイルへのパスを指定します。
   • -o は、出力形式を指定します。パッチ出力を生成するには、generate-patches 値を使用する必要があります。
   • --override-reason は、パッチの理由を説明します。

   • --generate-override-for は、パッチが必要なテンプレートへのパスを指定します。

     注記

     metadata.yaml ファイルを基準とした対象テンプレートのファイルパスを使用する必要があります。たとえば、metadata.yaml ファイルのファイルパスが ./compare/metadata.yaml の場合、テンプレートの相対ファイルパスは optional/my-template.yaml です。

   • <path_to_patches_file> は、パッチのファイル名とパスを指定します。

2. オプション: リファレンス設定に適用する前にパッチファイルを確認します。

   patch-config ファイルの例

   - apiVersion: storage.k8s.io/v1
     kind: StorageClass
     name: crc-csi-hostpath-provisioner
     patch: '{"provisioner":"kubevirt.io.hostpath-provisioner"}' 

   1

   
     reason: A valid reason for the override
     templatePath: optional/local-storage-operator/StorageClass.yaml 

   2

   
     type: mergepatch 

   3

   1

   プラグインは、CR と一致するようにテンプレート内のフィールドを修正します。

   2

   テンプレートへのパス。

   3

   mergepath オプションは、JSON を対象テンプレートにマージします。指定されていないフィールドは変更されません。

3. 次のコマンドを実行して、リファレンス設定にパッチを適用します。

   $ oc cluster-compare -r <referenceConfigurationDirectory> -p <path_to_patches_file>

   • -r は、リファレンス設定の metadata.yaml ファイルへのパスを指定します。

   • -p は、パッチファイルへのパスを指定します。

     出力例

     ...
     
     Cluster CR: storage.k8s.io/v1_StorageClass_crc-csi-hostpath-provisioner
     Reference File: optional/local-storage-operator/StorageClass.yaml
     Description: Component description
     Diff Output: None
     Patched with patch
     Patch Reasons:
     - A valid reason for the override
     
     ...
     
     No CRs are unmatched to reference CRs
     Metadata Hash: bb2165004c496b32e0c8509428fb99c653c3cf4fba41196ea6821bd05c3083ab
     Cluster CRs with patches applied: 1