3.4. 高度な Clair 設定

手順

1. 以下のコマンドを入力して、Clair デプロイメント用の clairctl プログラムを OpenShift Container Platform クラスターにインストールします。

   $ oc -n quay-enterprise exec example-registry-clair-app-64dd48f866-6ptgw -- cat /usr/bin/clairctl > clairctl

   注記

   非公式ですが、clairctl ツールをダウンロードできます。

2. clairctl ファイルの権限を設定して、ユーザーが実行できるようにします。次に例を示します。

   $ chmod u+x ./clairctl

手順

1. 次のコマンドを入力して、設定シークレットを取得してデコードし、それを Clair 設定 YAML に保存します。

   $ oc get secret -n quay-enterprise example-registry-clair-config-secret  -o "jsonpath={$.data['config\.yaml']}" | base64 -d > clair-config.yaml

2. disable_updaters および airgap パラメーターが true に設定されるように、clair-config.yaml ファイルを更新します。次に例を示します。

   ---
   indexer:
     airgap: true
   ---
   matcher:
     disable_updaters: true
   ---

手順

1. CLI ツール oc を使用して、Clair データベースサービスを特定します。次に例を示します。

   $ oc get svc -n quay-enterprise

   出力例

   NAME                                  TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)                             AGE
   example-registry-clair-app            ClusterIP      172.30.224.93    <none>        80/TCP,8089/TCP                     4d21h
   example-registry-clair-postgres       ClusterIP      172.30.246.88    <none>        5432/TCP                            4d21h
   ...

2. Clair データベースポートを転送して、ローカルマシンからアクセスできるようにします。以下に例を示します。

   $ oc port-forward -n quay-enterprise service/example-registry-clair-postgres 5432:5432

3. Clair の config.yaml ファイルを更新します。次に例を示します。

   indexer:
       connstring: host=localhost port=5432 dbname=postgres user=postgres password=postgres sslmode=disable 1
       scanlock_retry: 10
       layer_scan_concurrency: 5
       migrations: true
       scanner:
         repo:
           rhel-repository-scanner: 2
             repo2cpe_mapping_file: /data/cpe-map.json
         package:
           rhel_containerscanner: 3
             name2repos_mapping_file: /data/repo-map.json

   1

   複数の connstring フィールドの host の値を localhost に置き換えます。

   2

   rhel-repository-scanner パラメーターの詳細は、「Common Product Enumeration 情報へのリポジトリーのマッピング」を参照してください。

   3

   rhel_containersscanner パラメーターの詳細は、「Common Product Enumeration へのリポジトリーのマッピング」を参照してください。

手順

1. podman cp コマンドを使用して、自己管理の Clair デプロイメント用の clairctl プログラムをインストールします。以下に例を示します。

   $ sudo podman cp clairv4:/usr/bin/clairctl ./clairctl

2. clairctl ファイルの権限を設定して、ユーザーが実行できるようにします。次に例を示します。

   $ chmod u+x ./clairctl

手順

1. Clair 設定ファイル用のフォルダーを作成します。次に例を示します。

   $ mkdir /etc/clairv4/config/

2. disable_updaters パラメーターを true に設定して Clair 設定ファイルを作成します。次に例を示します。

   ---
   indexer:
     airgap: true
   ---
   matcher:
     disable_updaters: true
   ---

3. コンテナーイメージを使用して Clair を起動し、作成したファイルから設定にマウントします。

   $ sudo podman run -it --rm --name clairv4 \
   -p 8081:8081 -p 8088:8088 \
   -e CLAIR_CONF=/clair/config.yaml \
   -e CLAIR_MODE=combo \
   -v /etc/clairv4/config:/clair:Z \
   registry.redhat.io/quay/clair-rhel8:v3.12.3

手順

1. CLI ツール oc を使用して、Clair データベースサービスを特定します。次に例を示します。

   $ oc get svc -n quay-enterprise

   出力例

   NAME                                  TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)                             AGE
   example-registry-clair-app            ClusterIP      172.30.224.93    <none>        80/TCP,8089/TCP                     4d21h
   example-registry-clair-postgres       ClusterIP      172.30.246.88    <none>        5432/TCP                            4d21h
   ...

2. Clair データベースポートを転送して、ローカルマシンからアクセスできるようにします。以下に例を示します。

   $ oc port-forward -n quay-enterprise service/example-registry-clair-postgres 5432:5432

3. Clair の config.yaml ファイルを更新します。次に例を示します。

   indexer:
       connstring: host=localhost port=5432 dbname=postgres user=postgres password=postgres sslmode=disable 1
       scanlock_retry: 10
       layer_scan_concurrency: 5
       migrations: true
       scanner:
         repo:
           rhel-repository-scanner: 2
             repo2cpe_mapping_file: /data/cpe-map.json
         package:
           rhel_containerscanner: 3
             name2repos_mapping_file: /data/repo-map.json

   1

   複数の connstring フィールドの host の値を localhost に置き換えます。

   2

   rhel-repository-scanner パラメーターの詳細は、「Common Product Enumeration 情報へのリポジトリーのマッピング」を参照してください。

   3

   rhel_containersscanner パラメーターの詳細は、「Common Product Enumeration へのリポジトリーのマッピング」を参照してください。