6.2. Validation サービスのカスタムルールの作成

手順

1. Validation Pod のターミナルに接続します。

   $ oc rsh <validation_pod>

2. プロバイダーの OPA ポリシーディレクトリーに移動します。

   $ cd /usr/share/opa/policies/io/konveyor/forklift/<provider> 

   1

   1

   vmware または ovirt を指定します。

3. デフォルトポリシーを検索します。

   $ grep -R "default" *

手順

1. 以下の例に従って設定マップ CR を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: <forklift-validation-config>
     namespace: openshift-mtv
   data:
     vmware_multiple_disks.rego: |-
       package <provider_package> 

   1

   
   
       has_multiple_disks { 

   2

   
         count(input.disks) > 1
       }
   
       concerns[flag] {
         has_multiple_disks 

   3

   
           flag := {
             "category": "<Information>", 

   4

   
             "label": "Multiple disks detected",
             "assessment": "Multiple disks detected on this VM."
           }
       }
   EOF

   1

   プロバイダーパッケージ名を指定します。使用できる値は、VMware の場合が io.konveyor.forklift.vmware、Red Hat Virtualization の場合が io.konveyor.forklift.ovirt です。

   2

   concerns の名前と Rego クエリーを指定します。

   3

   concerns の名前と flag パラメーターの値を指定します。

   4

   使用できる値は Critical、Warning、および Information です。

2. forklift-controller デプロイメントを 0 にスケーリングして、Validation Pod を停止します。

   $ oc scale -n openshift-mtv --replicas=0 deployment/forklift-controller

3. forklift-controller デプロイメントを 1 にスケーリングして、Validation Pod を起動します。

   $ oc scale -n openshift-mtv --replicas=1 deployment/forklift-controller

4. Validation Pod ログをチェックして、Pod が起動したことを確認します。

   $ oc logs -f <validation_pod>

   カスタムルールがデフォルトのルールと競合する場合、Validation Pod は起動しません。

5. 移行元プロバイダーを削除します。

   $ oc delete provider <provider> -n openshift-mtv

6. 移行元プロバイダーを追加して、新規ルールを適用します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <provider>
     namespace: openshift-mtv
   spec:
     type: <provider_type> 

   1

   
     url: <api_end_point> 

   2

   
     secret:
       name: <secret> 

   3

   
       namespace: openshift-mtv
   EOF

   1

   使用できる値は、ovirt、vsphere、および openstack です。

   2

   API エンドポイント URL を指定します。たとえば、vSphere の場合は https://<vCenter_host>/sdk、RHV の場合は https://<engine_host>/ovirt-engine/api、OpenStack の場合は https://<identity_service>/v3 です。

   3

   プロバイダーの Secret CR の名前を指定します。

手順

1. 現在のルールバージョンを取得します。

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 

   1

   出力例

   {
      "result": {
          "rules_version": 5
      }
   }

2. Validation Pod のターミナルに接続します。

   $ oc rsh <validation_pod>

3. /usr/share/opa/policies/io/konveyor/forklift/<provider>/rules_version.rego ファイルでルールバージョンを更新します。
4. Validation Pod ターミナルからログアウトします。

5. 更新されたルールバージョンを検証します。

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 

   1

   出力例

   {
      "result": {
          "rules_version": 6
      }
   }