4.16.5. ポリシーコマンドラインツール


policytools コマンドラインツールを使用すると、ポリシーをローカルで操作して、作成とデバッグを支援できます。policytools コマンドラインツールは、ハブクラスターコンソールからダウンロードできます。コマンドラインツール を参照してください。

template-resolver

template-resolver はポリシーに埋め込まれているマネージドクラスターとハブクラスターテンプレートを解決する policytools のサブコマンドです。template-resolver は、ファイルまたは標準入力から読み取ります。

ハブクラスターテンプレートを使用してポリシーを解決するには、Red Hat Advanced Cluster Management にインポートされるマネージドクラスターの名前を --cluster-name 引数に指定する必要があります。また、ハブクラスターを参照する kubeconfig ファイルへのパスを --hub-kubeconfig 引数に指定する必要があります。

入力ポリシーで .ObjectName または .ObjectNamespace テンプレート変数が使用されている場合は、--object-name および --object-namespace 引数を使用して値を設定する必要があります。

template-resolver サブコマンドは、マネージドクラスターとハブクラスターに接続して、テンプレートを解決するために必要な情報を取得します。--save-resources および --save-hub-resources 引数を使用してパスを指定し、template-resolver が取得するリソースを保存します。保存されたファイルは、dryrun サブコマンドの入力として使用できます。

テクノロジープレビュー: policytools コマンドラインインターフェイスでは、template-resolver サブコマンドに --lint 引数が導入され、入力ポリシーから解決された Go テンプレートとともに、リンティングの問題がすべて出力されます。リンターの実行結果を Static Analysis Results Interchange Format (SARIF) レポートとして生成するには、--sarif 引数でファイルパスを指定します。

dryrun

dryrun は、クラスターの状態の静的入力リソースを使用して、ConfigurationPolicy リソースをローカルで評価する policytools のサブコマンドです。

ポリシーを実行するには、--policy フラグを使用して ConfigurationPolicy YAML にパスを追加します。現在のクラスターの状態として使用される追加のリソース YAML ファイルを提供できます。たとえば、ポリシーで namespace の特定の設定を定義する場合は、現在の namespace の状態を指定して、ポリシーが何を行うかを確認します。同じリソースファイル内に複数のリソースを含めることができます。

ライブクラスターの現在の状態に対してポリシーを評価するには、--from-cluster フラグを使用するか、DRYRUN_FROM_CLUSTER 環境変数を true に設定します。

dryrun サブコマンドは、kubeconfig ファイルで設定したクラスター、または KUBECONFIG 環境変数で指定されたクラスターから、リソースの現在の状態を直接読み取ります。どちらのシナリオでも、dryun サブコマンドは、リソースファイルから情報を収集しません。

--from-cluster フラグを有効にすると、入力として提供された YAML リソースファイルはすべて無視されます。--from-cluster フラグを有効にすると、リソースファイルを手動でエクスポートしてサポートすることなく、実際のクラスターの状態に対してポリシーをテストできます。

+ デフォルトでは、dryrun は、ポリシーで定義されたオブジェクトの望ましい状態とそれらのリソースの現在の状態の違い、および ConfigurationPolicy によって作成されるコンプライアンスメッセージを出力します。

コンプライアンスメッセージを別のファイルに保存するには、--messages-path 引数を使用します。関連オブジェクトに関する追加情報を含む完全なポリシーステータスを保存するには、--status-path 引数を使用します。

+ 入力に基づいてポリシーが NonCompliant の場合、ツールはゼロ以外の終了コードを返します。結果のステータスを既知のステータスと比較するには、--desired-status 引数を使用します。たとえば、ポリシーが不足しているリソースを報告していることを確認するには、不足しているリソースを .relatedObjects リスト内に含める YAML ファイルを提供します。ポリシーが NonCompliant であることを確認するには、compliant: NonCompliant 行を含む YAML ファイルを作成します。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

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

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

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

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

Legal Notice

Theme

© 2026 Red Hat
トップに戻る