9.2. パラメーター

手順9.2 グローバルな単純パラメーターを作成するには、以下を実行します。

1. 設定 → グローバルパラメーター をクリックします。
2. 新規パラメーター をクリックします。
3. パラメーターのキーの 名前 を入力します。
4. パラメーターの 値 を入力します。
5. オプションで、値をWeb UI で非表示にするかどうかを選択します。
6. 送信 をクリックします。

手順9.3 スマート変数を設定するには、以下を実行します。

1. 設定 → Puppet クラス をクリックします。
2. 一覧からクラスを選択します。
3. スマート変数 タブをクリックします。これにより、新規の画面が表示されます。左側のセクションには、クラスがサポートする使用可能なパラメーターの一覧が含まれます。右側のセクションには、選択したパラメーターの設定オプションが含まれます。変数の追加 をクリックして新規パラメーターを追加します。または、左側の一覧からパラメーターを選択します。
4. キー フィールドに名前を入力します。
5. 詳細 テキストボックスを編集して、プレーンテキストのメモを追加します。
6. 渡すデータの キータイプ を選択します。最も一般的なタイプは文字列ですが、他のデータタイプもサポートされています。
7. ホストが一致しない場合に Puppet Master に送信されるパラメーターの Default Value を入力します。
8. フィールドに作業中に表示したくないデータがが含まれる場合、オプションで 非表示の値 を選択します。
9. Optional Input Validator セクションを使用してパラメーターに許可される値を制限します。バリデータータイプ (コンマ区切り値の list か、または正規表現の regexp のいずれか) を選択し、許可される値または正規表現コードを バリデータールール フィールドに入力します。
10. Prioritize attribute order セクションは、条件付き引数に基づいて特定ホストの値を上書きするオプションを提供します。属性タイプおよびその値は matcher として知られています。
    1. エントリーを一覧に配置して、ホスト属性またはファクトが Matcher に対して評価される優先順位の 順序 を設定します。デフォルト一覧に追加することができます。Matcher 間で論理 AND 条件を作成するには、それらをコンマ区切りの一覧として一行に配置します。
    2. Matcher の追加 をクリックして条件付き引数を追加します。一致する属性は 順序 一覧のエントリーに対応するはずです。Matcher が設定されていない場合、デフォルト値のみが上書き機能として使用されます。
       たとえば、Puppet マスターに指定する必要のあるパラメーターの値が server1.example.com の完全修飾ドメイン名を持つホストの test の場合、Matcher を fqdn=server1.example.com として、値 を test に設定します。
       一致の手順は以下のとおりです。

       1. マッチャーがホスト属性の場合はそれを使用します。
       2. 該当する名前を持つ属性がない場合は、一致するホストパラメーター (パラメーターの階層に基づいて継承される) を探します。
       3. それでも一致しなければホストのファクトをチェックします。

       Facter にある属性で、ホストの属性と混同しない属性を使用することが推奨されています。ホスト属性はホストパラメーターか、またはホストグループ、ドメイン、および組織などのホストの関連付けを使用することができます。マッチャーはいずれかのホストで固有である必要があります。たとえば、ホストが複数の config グループに属する可能性があるものの、ホストには 1 つのロケーションのみが設定され、ロケーションのファクトは有効なマッチャーとなるため、 config グループのファクトを使用することはできません。
       動的なデータは、Embedded Ruby (ERB) テンプレート構文の 値 フィールドでパラメーターおよび Puppet ファクトを使用すると利用できます。たとえば、Puppet ファクトを値の一部として使用するには、以下を実行します。

       <%= @host.facts['network_eth0'] %>

       利用可能な Puppet ファクトを一覧表示するには、モニター → ファクト に移動します。
11. 送信 をクリックして変更を保存します。

手順9.4 パラメーター化されたクラスをインポートするには、以下を実行します。

1. Satellite web UI では、コンテキストメニューから 組織 および ロケーション を選択します。
2. 設定 → Puppet クラス をクリックします。
3. ホスト名からインポート をクリックして、Puppet マスターからパラメーター化されたクラスをインポートします。
4. Puppet クラス ページが新規クラスの一覧と共に表示されます。

手順9.5 スマートクラスパラメーターを設定するには、以下を実行します。

1. 設定 → Puppet クラス をクリックします。
2. パラメーター 列に示されるパラメーターを含むクラスを一覧から選択します。
3. スマートクラスパラメーター タブをクリックします。これにより新しい画面が表示されます。左側のセクションには、クラスがサポートする使用可能なパラメーターの一覧が含まれます。右側のセクションには、選択したパラメーターの設定オプションが含まれます。
4. 左側の一覧からパラメーターを選択します。
5. 詳細 テキストボックスを編集して、プレーンテキストのメモを追加します。
6. 上書き を選択してこの変数に対する Satellite のコントロールを許可します。チェックボックスが選択されていない場合、Satellite は新規の変数を Puppet に渡しません。
7. 渡すデータの キータイプ を選択します。最も一般的なタイプは文字列ですが、他のデータタイプもサポートされています。
8. ホストが一致しない場合に Puppet Master に送信されるパラメーターの Default Value を入力します。
9. 上書きの一致がない場合、値を Puppet Master に送信 しない ようにするには、オプションで Puppet デフォルトの使用 を選択します。
10. フィールドに作業中に表示したくないデータがが含まれる場合、オプションで 非表示の値 を選択します。
11. Optional Input Validator セクションを使用してパラメーターに許可される値を制限します。バリデータータイプ (コンマ区切り値の list か、または正規表現の regexp のいずれか) を選択し、許可される値または正規表現コードを バリデータールール フィールドに入力します。
12. 上書き オプションが選択されていると 属性の優先度付け セクションが表示されます。これは条件付き引数に基づいて特定ホストの値を無効にするオプションを提供します。この属性タイプおよびその値は Matcher として知られています。
    1. エントリーを一覧に配置して、ホスト属性またはファクトが Matcher に対して評価される優先順位の 順序 を設定します。デフォルト一覧に追加することができます。Matcher 間で論理 AND 条件を作成するには、それらをコンマ区切りの一覧として一行に配置します。
    2. Matcher の追加 をクリックして条件付き引数を追加します。一致する属性は 順序 一覧のエントリーに対応するはずです。Matcher が設定されていない場合、デフォルト値のみが上書き機能として使用されます。
       たとえば、Puppet マスターに指定する必要のあるパラメーターの値が server1.example.com の完全修飾ドメイン名を持つホストの test の場合、Matcher を fqdn=server1.example.com として、値 を test に設定します。
       マッチングの優先順位は以下のとおりです。

       1. マッチャーがホスト属性の場合はそれを使用します。
       2. 該当する名前を持つ属性がない場合は、一致するホストパラメーター (パラメーターの階層に基づいて継承される) を探します。
       3. それでも一致しなければホストのファクトをチェックします。

       Facter にある属性で、ホストの属性と混同しない属性を使用することが推奨されています。
       動的なデータは、Embedded Ruby (ERB) テンプレート構文の 値 フィールドでパラメーターおよび Puppet ファクトを使用すると利用できます。たとえば、Puppet ファクトを値の一部として使用するには、以下を実行します。

       <%= @host.facts['network_eth0'] %>

       利用可能な Puppet ファクトを一覧表示するには、モニター → ファクト に移動します。
13. 送信 をクリックして変更を保存します。