6.6. Clair セキュリティースキャナー
6.6.1. Clair の問題のトラブルシューティング
Clair のトラブルシューティングを行うには、次の手順を使用します。
6.6.1.1. イメージの互換性を確認する
Clair を使用している場合は、スキャンしようとしているイメージが Clair でサポートされていることを確認してください。Clair には特定の要件があり、すべてのイメージ形式や設定をサポートしているわけではありません。
詳細は、Clair 脆弱性データベース を参照してください。
6.6.1.2. Clair アップデーターの許可リストへの登録
プロキシー設定の背後で Clair を使用している場合は、プロキシーまたはファイアウォール設定でアップデータを許可リストに登録する必要があります。アップデーター URL の詳細は、Clair アップデーター URL を参照してください。
6.6.1.3. Clair スキャナーとその依存関係の更新
最新バージョンの Clair セキュリティースキャナーを使用していることを確認してください。古いバージョンには、新しいイメージ形式のサポートがないか、既知の問題が存在する可能性があります。
Clair のバージョンを確認するには、次の手順を使用します。
Clair ログの確認は、Clair ログにアップデータマイクロサービスからのエラーがあるかどうかを確認するためにも使用できます。デフォルトでは、Clair は脆弱性データベースを 30 分ごとに更新します。
手順
Clair のバージョンを確認してください。
Red Hat Quay on OpenShift Container Platform で Clair を実行している場合は、次のコマンドを入力します。
$ oc logs clair-pod
Red Hat Quay のスタンドアロンデプロイメントを実行し、Clair コンテナーを使用している場合は、次のコマンドを入力します。
$ podman logs clair-container
出力例
"level":"info", "component":"main", "version":"v4.5.1",
6.6.1.4. Clair のデバッグモードの有効化
デフォルトでは、Clair のデバッグモードは無効になっています。clair-config.yaml
ファイルを更新することで、Clair のデバッグモードを有効にできます。
前提条件
- OpenShift Container Platform のデプロイメントにある Red Hat Quay の Clair の場合、マネージド Clair データベースを使用してカスタム Clair 設定を実行する 必要があります。
Clair のデバッグモードを有効にするには、次の手順を使用します。
手順
Clair-config.yaml
ファイルを更新してデバッグオプションを含めます。スタンドアロン Red Hat Quay デプロイメントで、以下を行います。
次の設定フィールドを
clair-config.yaml
ファイルに追加します。log_level: debug
次のコマンドを入力して、Clair デプロイメントを再起動します。
$ podman restart <clair_container_name>
OpenShift Container Platform デプロイメントの Red Hat Quay で以下を実行します。
-
OpenShift Container Platform Web コンソールで、Operator
Installed Operator Quay Registry をクリックします。 - レジストリーの名前 (例: Example Registry) をクリックします。レジストリーの Details ページにリダイレクトされます。
- Config Bundle Secret (例: example-registry-config-bundle-xncls) をクリックします。
-
シークレットの Details ページの Data セクションの下にある
Clair-config.yaml
ファイルを探して、カスタム Clair 設定が実行されていることを確認します。 -
clair-config.yaml
ファイルがある場合は、ActionsEdit Secret をクリックします。そうでない場合は、「マネージド Clair データベースを使用したカスタム Clair 設定の実行」を参照してください。 clair-config.yaml
ファイルを更新して、log_level: debug
設定変数を含めます。以下に例を示します。log_level: debug
- Save をクリックします。
-
Workloads
Pods をクリックして、Clair デプロイメントのステータスを確認できます。 clair-app
Pod は、Ready カテゴリーで1/1
を報告するはずです。 -
準備が整った clair-app Pod
Logs をクリックすると、Clair がデバッグ情報を返していることを確認できます。
-
OpenShift Container Platform Web コンソールで、Operator
6.6.1.5. Clair 設定の確認
Clair config.yaml
ファイルをチェックして、問題を引き起こす可能性のある設定ミスや不一致がないことを確認します。詳細は、Clair 設定の概要 を参照してください。
6.6.1.6. イメージメタデータを検査する
場合によっては、Unsupported メッセージが表示されることがあります。これは、スキャナーがイメージから必要なメタデータを抽出できないことを示している可能性があります。イメージメタデータが適切にフォーマットされており、アクセス可能であるかどうかを確認してください。
関連情報
詳細は、Clair のトラブルシューティング を参照してください。