第7章 動的グループの使用


動的グループは、インベントリーの検索に使用する検索用語を指定し、グループに属する一致するリソースを特定します。検索結果は、結果が追加および削除されると自動的に変更されるため、グループメンバーシップは常に変更され、常に最新の状態になります。動的グループを使用すると、大規模な履歴の管理タスクを自動化できます。
注記
動的グループは、ニックネーム Dynagroups によって参照され ます
エンタープライズリソースは、クラスター ID、ブロードキャストグループ、論理サービス層、地理的な場所、セキュリティードメイン、またはその他の論理グループを使用してグループ化できます。
個別のリソースは複数のグループに属する可能性がありますが、大規模な資料では、複数のグループ定義が企業リソースにどのように影響するかを知ることが重要です。

7.1. 動的グループ構文

動的グループは、グループ定義 で設定されます。グループ定義は、リソースの検索を定義する と、再計算の間隔などのグループに関するその他の情報を定義します。
動的グループには、動的検索(「動的検索構文について」)に使用される式構文と非常に似ています。

7.1.1. 一般的な式構文

は、属性の特定の値によって、特定のリソース属性を中心とするか、単に属性が存在するだけで特定のリソース属性を中心とした検索条件です。
式は、リソースをグループ化する方法を定義します。
  • 特定のリソース属性または値( 簡単 な式)
  • リソースタイプ(ピボットテーブル
  • 別のグループのメンバー別( 絞り込む 式)
1 つのグループ定義は複数の式を持つことができます。グループ定義の式の順序は問題ありません。たとえば、グループメンバーの計算時に、両方の式が全く同じ解釈されます。
expression 1
exprA1 
exprA2 
groupby exprB1 
groupby exprB2

expression 2
exprA2 
exprA1 
groupby exprB2 
groupby exprB1
Copy to Clipboard Toggle word wrap
注記
複数の式がグループ定義で使用される場合、それらは論理 AND 表現として扱われ、リソースはそのグループに属するすべての基準と一致する必要があります。
dynagroup 定義の式の間の空の行は無視されます。
設定可能なリソースプロパティーは、リソース名、タイプ、プラグイン、バージョン、設定プロパティー、インベントリー ID 番号などのリソース情報を対象とします。
Expand
表7.1 動的グループプロパティー
type サポートされる属性
リソース自体に関連する
resource
id
Name
version
parent
grandparent
リソースタイプに関連する
resourceType
plug-in
Name
カテゴリー(プラットフォーム、サーバー、サービス)
リソース設定に関連する
plug-inConfiguration
プラグイン設定プロパティー
resourceConfiguration
すべてのリソース設定プロパティー
リソースモニタリングデータに関連する
traits
任意の監視特性
可用性
UP または DOWN のいずれかの現在の状態
式に structure resource.属性 がある場合、これはグループのメンバーとなるリソースに適用されます。ただし、先祖エントリーまたは子エントリーの属性を使用して、グループメンバーを再帰的に特定することが可能です。
たとえば、リソースをインベントリー ID 10001 としてメンバーとして追加するには、式は以下のようになります。
resource.id = 10001
Copy to Clipboard Toggle word wrap
ID が 10001 のリソースの をすべてグループメンバーとして追加するには、プレフィックスを使用し resource.parentます。
resource.parent.id = 10001
Copy to Clipboard Toggle word wrap
には、表7.1「動的グループプロパティー」 以下のすべてのリソース属性の接頭辞が 4 つあります。
  • resource
  • resource.child
  • resource.parent
  • resource.grandParent
定義が制限され、フィルターに一致するリソースがない場合は、グループは作成されません。JBoss ON は、実際にグループ定義により作成されないようにするため、空のグループになります。空のグループがないため、インベントリーにリストされている余分なグループがないため、実際のインフラストラクチャーを反映して管理が容易になります。

7.1.2. 単純な式: 値の検索

単純な式は、属性と値のペアまたはこの形式でトリドを使用します。
resource.attribute[string-expression] = value
Copy to Clipboard Toggle word wrap
例:
resource.parent.type.category = Platform
Copy to Clipboard Toggle word wrap
リソース属性にはすべて string-expression が追加されているわけではありません。string-expression は基本的にサブ属性です。たとえば、resource.trait は 汎用リソース属性で、partitionName などのサブ属性は実際のパラメーターを 特定 します。
単純な式は通常明示的な値に基づいてリソースを検索しますが、リソースには null 値を持つ属性があり、これらの null 値は単純な式で返されません。empty キーワードは、null 値を持つ特定の属性を持つリソースを検索します。
empty resource.attribute[string-expression]
Copy to Clipboard Toggle word wrap
empty キーワードを使用する場合は、式で指定される はありません。
simple 式は、null ではない限り、属性の値に関係なく、その属性を持つすべてのリソースを検索する not empty キーワードも使用できます。empty キーワードと同様に、すべての値が式と一致するため、式に を指定する理由はありません。
not empty resource.attribute[string-expression]
Copy to Clipboard Toggle word wrap

7.1.3. ピボットテーブル: 属性によるグループ化

簡単な式は検索の特定の結果に基づいて、1 つのグループを作成します。ピボットテーブルは複数のグループを作成 します。これは、属性が存在するかどうかに基づいてグループに属するリソースを特定し、値に基づいてサブグループを作成します。ピボットテーブル式では groupby キーワードを使用します。
groupby resource.attribute
Copy to Clipboard Toggle word wrap
ピボットテーブルの式は、属性値の一意の出現に基づいてグループを作成します。たとえば、parent.name 属性はすべての親リソースに基づいて一意のグループを作成します。
groupby resource.parent.name
Copy to Clipboard Toggle word wrap
のリソースについて 図7.1「リソースおよび親」、ピボットテーブルはリソース階層内で ResourceParentA、ResourceParentB、および✓A2 の 3 つの固有のグループを作成します。

図7.1 リソースおよび親

グループ定義全体に null 値を持つリソースが含まれる場合、ピボットテーブル式はこれらのリソースが含まれる特別なサブグループを作成します。

7.1.4. 式の絞り込み: グループのメンバー

式は通常、インベントリー 全体 で評価されます。たとえば、JBoss AS 7 Server リソースタイプのピボットテーブル式を設定すると、EAP 6 または AS 7 インスタンスごとにインベントリーがチェックされます。
特に、アクセス制御またはバンドル管理用に粒度の細かいグループを作成しようとすると、同じタイプのリソースのサブセットを取得するために複雑な式を作成しようとするより、既存のグループのメンバーに対して実行する式を定義する方が簡単です。
これは、memberof キーワードを指定して行われます。これは、グループ名(互換性のあるグループ、複数のグループ、自動グループ、再帰グループ、別の dynagroup であっても)を指定し、そのグループのメンバーのみが他の一致式に対して評価されます。
注記
memberof キーワードはグループ名を指定します。グループが再帰グループの場合、評価のためにすべての再帰メンバーがグループの一部として組み込まれます。
たとえば、管理者は開発チーム、QE、および実稼働チーム向けのアプリケーション開発関連リソースに異なるグループを作成します。これらは、プラットフォーム、Postgre データベース、EAP 6 サーバー、および Web コンテキストの混合グループです。新しいリソースがデプロイされると、CLI スクリプトを実行してリソースをインポートし、リソースグループを自動的に更新します。アクセス制御ルールとロールは、リソースタイプに基づいて、Dev Stack Resource Group、複数のグループ内のサブグループおよび リソースタイプに基づいてメイングループの両方を使用する必要があります。複数のグループおよびロールは、リソースがデプロイまたは削除されるたびに作成および更新するの はなく、まず指定のチームリソースグループに式の範囲を絞り込み、リソースタイプ別にピボットします。Dynagroup の定義は一度だけ設定する必要があります。また、グループが再計算されるたびに、インベントリーの変更で動的に更新されます。
memberof = "Dev Resource Group"
groupby resource.type.name
Copy to Clipboard Toggle word wrap
注記
グループメンバーシップは、他の式と同様に、dynagroup が再計算される時にのみ memberof 変更で更新されます。
グループ定義では複数の memberof 式が許可され、1 つのグループを参照する各 memberof 式を使用できます。複数の memberof 式が使用される場合、それらは AND 式として扱われます。一致するリソースは すべて指定されたすべて のグループのメンバーである必要があります。

7.1.5. 複合式

複数の式を 1 つの dynagroup 定義で使用できます。これらは 複雑な 式です。
複数の式がグループ定義で使用される場合、それらは論理 AND 表現として扱われ、リソースはそのグループに属するすべての基準と一致する必要があります。(Dynagroup 定義の式間の空の行は無視されます。)
たとえば、この基本的な式は、プラットフォームを親として持つすべてのリソースを検索します。
resource.parent.type.category = Platform
Copy to Clipboard Toggle word wrap
これにより、サーバーおよびサービスの非常に長いリストが返されます。その初期リストは、名前でフィルターする別の簡単な式を追加して、さらに絞り込むことができます。
resource.parent.type.category = Platform
resource.name.contains = JBossAS
Copy to Clipboard Toggle word wrap
プラットフォームが親として、JBossAS が名前に指定 リソースのみがグループに追加されます。
ピボットテーブルの式は複合式でも使用することができます。すべての行には groupby キーワードを含める必要があります。最初の行だけでなく、groupby キーワードが必要です。
groupby resource.type.plugin
groupby resource.type.name 
groupby resource.parent.name
Copy to Clipboard Toggle word wrap
複合式には、単純な式とピボットテーブルの両方を含めることができます。これにより、プラットフォーム上の一意のサーバータイプごとに互換性のあるグループが作成されます。
resource.type.category = server 
groupby resource.type.plugin 
groupby resource.type.name 
groupby resource.parent.name
Copy to Clipboard Toggle word wrap
最後に、複合式には空のキーワードを含めることができ、空のキーワードは含まれません。たとえば、簡単な式を使用して、リソースタイプと名前を基にして JBoss サーバーを特定できます。その後、どの JBoss サーバーがセキュアであるかを特定するために、式は空のプリンシパル接続プロパティーで JBoss サーバーのフィルターを実行できます。
resource.type.plugin = JBossAS
resource.type.name = JBossAS Server
empty resource.pluginConfiguration[principal]
Copy to Clipboard Toggle word wrap

7.1.6. サポートされない式

複数の式を一緒に使用する方法には制限があります。

すべての式が同じ設定エリアにある必要があります。

式のすべての設定プロパティーはリソース設定からのみ、またはプラグイン設定のみである必要があります。両方から式を取ることはできません。

各プロパティーは一度だけ使用する必要があります。

プロパティーは、dynagroup 定義で 1 回のみ使用できます。

valid
resource.trait[x] = foo

not valid
resource.trait[x] = foo
resource.trait[y] = bar
Copy to Clipboard Toggle word wrap
たとえば、resource.trait 式は定義で 1 回だけ発生するだけです。
resource.grandParent.trait[Trait.hostname].contains = stage
resource.parent.type.plugin = JBossAS5
resource.type.name = Web Application (WAR)
Copy to Clipboard Toggle word wrap
1 秒未満の時間(またはそれ以上)を使用すると、後続の使用に失敗し、定義が解析されません。
resource.grandParent.trait[Trait.hostname].contains = stage
resource.parent.type.plugin = JBossAS5
resource.type.name = Web Application (WAR)
resource.trait[contextRoot] = jmx-console
Copy to Clipboard Toggle word wrap
これにより、計算エラーが発生します。
There was a problem calculating the results: java.lang.IllegalArgumentException: org.hibernate.QueryParameterException: could not locate named parameter [arg2]
Copy to Clipboard Toggle word wrap
[arg2] エラーは、同じ型の複数の式が使用されており、2 つ目の式によって計算に失敗するという記号です。
これは、プロパティータイプが 異なる リソースコンテキストで使用される場合でも true になります。
resource.parent.trait[x] = foo
resource.grandParent.trait[y] = bar
Copy to Clipboard Toggle word wrap
この例では、グランド親リソースに適用された 1 つの特性と、リソース自体に 1 つの特性が適用されていました。trait プロパティーが異なるリソースであっても 2 回使用されたため、これは失敗しました。

7.1.7. Dynagroup 式の例

1 つのグループ定義には複数の式を含めることができ、1 つの定義で単純な式とピボットされた式を混在させることもできます。これらの例の多くは、定義を完了するために複数の式が必要です。

例7.1 JBoss クラスター

resource.type.plugin = JBossAS 
resource.type.name = JBossAS Server 
groupby resource.trait[partitionName]
Copy to Clipboard Toggle word wrap

例7.2 各プラットフォームタイプのグループ

resource.type.plugin = Platforms 
resource.type.category = PLATFORM 
groupby resource.type.name
Copy to Clipboard Toggle word wrap

例7.3 autogroups

groupby resource.type.plugin 
groupby resource.type.name 
groupby resource.parent.name
Copy to Clipboard Toggle word wrap
注記
これにより、多数のグループが大量に作成される可能性があります。

例7.4 未加工の測定テーブル

resource.type.plugin= Postgres 
resource.type.name = Table 
resource.parent.name = rhq Database 
resource.name.contains = rhq_meas_data_num_
Copy to Clipboard Toggle word wrap

例7.5 マルチキャスト検出のエージェントのみ

resource.type.plugin= RHQAgent 
resource.type.name = RHQ Agent 
resource.resourceConfiguration[rhq.communications.multicast-detector.enabled] =  true
Copy to Clipboard Toggle word wrap

例7.6 イベント追跡を含む Windows プラットフォームのみ

resource.type.plugin= Platforms 
resource.type.name = Windows 
resource.pluginConfiguration[eventTrackingEnabled] =  true
Copy to Clipboard Toggle word wrap

例7.7 マシン別に JBoss AS サーバー

groupby resource.parent.trait[Trait.hostname] 
resource.type.plugin = JBossAS 
resource.type.name = JBossAS Server
Copy to Clipboard Toggle word wrap
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

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

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

会社概要

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

Theme

© 2025 Red Hat