9.2. パラメーター

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

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

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

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

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

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

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

       Copy to Clipboard Toggle word wrap

       で、監視 ファクト に移動します。
11. 送信 をクリックして変更を保存します。

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

1. Satellite Web UI で、コンテキストメニューの Any Organization および Any Location を選択します。
2. Configure Puppet Classes をクリックします。
3. Import from Host Name をクリックして、Puppet マスターからパラメーター化されたクラスをインポートします。
4. Puppet Classes ページが新規クラスのリストと共に表示されます。

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

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

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

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

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

       Copy to Clipboard Toggle word wrap

       で、監視 ファクト に移動します。
13. 送信 をクリックして変更を保存します。