Red Hat Satellite で Puppet インテグレーションを使用した設定の管理

1. Puppet インテグレーションを有効化 します。
2. Puppet エージェントパッケージを Satellite にインポートします。Puppet エージェントパッケージは、Red Hat リポジトリーを有効にし、アクティベーションキー と コンテンツビュー を使用して、Satellite の他のコンテンツと同様に管理できます。
3. プロビジョニング 時、登録時、あるいは 手動で、またはリモートジョブの実行により、ホストに Puppet エージェントをインストールする。

手順

1. Puppet インテグレーションを有効化し、Satellite Server に Puppet サーバーをインストールします。

   # satellite-installer --enable-foreman-plugin-puppet \
   --enable-foreman-cli-puppet \
   --foreman-proxy-puppet true \
   --foreman-proxy-puppetca true \
   --foreman-proxy-content-puppet true \
   --enable-puppet \
   --puppet-server true \
   --puppet-server-foreman-ssl-ca /etc/pki/katello/puppet/puppet_client_ca.crt \
   --puppet-server-foreman-ssl-cert /etc/pki/katello/puppet/puppet_client.crt \
   --puppet-server-foreman-ssl-key /etc/pki/katello/puppet/puppet_client.key

   Copy to Clipboard

2. Capsule で Puppet インテグレーションを使用する場合は、Puppet インテグレーションを有効化して、Capsule に Puppet サーバーをインストールします。

   # satellite-installer --foreman-proxy-puppet true \
   --foreman-proxy-puppetca true \
   --foreman-proxy-content-puppet true \
   --enable-puppet \
   --puppet-server true \
   --puppet-server-foreman-ssl-ca /etc/pki/katello/puppet/puppet_client_ca.crt \
   --puppet-server-foreman-ssl-cert /etc/pki/katello/puppet/puppet_client.crt \
   --puppet-server-foreman-ssl-key /etc/pki/katello/puppet/puppet_client.key \
   --puppet-server-foreman-url "https://satellite.example.com"

   Copy to Clipboard

   --puppet-server-foreman-url 引数の値として Satellite Server の URL を入力します。

手順

1. Hosts > Provisioning Templates の順に移動します。
2. ホストのプロビジョニング方法に応じて、プロビジョニングテンプレートを選択します。詳細は、プロビジョニングガイド の プロビジョニングテンプレートのタイプ を参照してください。

3. puppet_setup スニペットが以下のように含まれていることを確認します。

   <%= snippet 'puppet_setup' %>

   Copy to Clipboard

4. 単一ホストまたはホストグループのホストパラメーターを使用して Puppet を有効にします。

   タイプブール値を true に設定し、Puppet 7 の enable-puppet7 という名前のホストパラメーターを追加します。

5. オプション:yum.puppet.com から直接 Puppet エージェントをインストールするには、タイプブール値を true に設定し、Puppet 7 の enable-puppetlabs-puppet7-repo という名前のホストパラメーターを追加します。アクティベーションキーを使ってホストに Puppet エージェントを提供しない場合にのみこれを使用します。

手順

1. root ユーザーで、ホストにログインします。

2. Puppet エージェントパッケージをインストールします。

   • Red Hat Enterprise Linux 8 以降を実行しているホストの場合:

     # dnf install puppet-agent

     Copy to Clipboard

   • Red Hat Enterprise Linux 7 以前を実行しているホストの場合:

     # yum install puppet-agent

     Copy to Clipboard

3. 次のスクリプトを使用して、Puppet エージェントを現在のシェルの PATH に追加します。

   . /etc/profile.d/puppet-agent.sh

   Copy to Clipboard

4. Puppet エージェントを設定します。ホストの所属先の Puppet 環境名に environment パラメーターを設定します。

   # puppet config set server satellite.example.com --section agent
   # puppet config set environment My_Puppet_Environment --section agent

   Copy to Clipboard

5. Puppet エージェントサービスを開始します。

   # puppet resource service puppet ensure=running enable=true

   Copy to Clipboard

6. ホストの証明書を作成します。

   # puppet ssl bootstrap

   Copy to Clipboard
7. Satellite Web UI で、Infrastructure > Capsules に移動します。
8. 必要な Capsule Server の Actions コラムの一覧から、Certificates を選択します。
9. 必要なホストの右にある Sign をクリックして、Puppet エージェントの SSL 証明書に署名します。

10. ホスト上で、Puppet エージェントを再度実行します。

    # puppet ssl bootstrap

    Copy to Clipboard

1. Puppet モジュールを Puppet サーバーで管理する (インストールおよび更新)。
2. Puppet クラスおよび環境を Puppet モジュールから Satellite にインポートする。
3. オプション: Puppet クラスから設定グループを作成する。
4. さまざまなレベルでスマートクラスパラメーターのオーバーライドを設定する。
5. ホストグループまたは個別ホストに Puppet クラスまたは設定グループを割り当てる。
6. ホストで Puppet エージェントを実行する間隔および Puppet サーバーの設定を適用する間隔を設定する。
7. Satellite Web UI でレポートを使用して設定管理を監視する。詳細は、Red Hat Satellite の管理 の リソースの監視 を参照してください。
8. メール通知を設定する。詳細は、Red Hat Satellite の管理 の 電子メール通知の設定 を参照してください。

手順

1. いずれかの Capsule で Puppet サーバーを使用している場合は、すべての Capsule で Puppet サーバーを無効化します。

   # satellite-maintain plugin purge-puppet --remove-all-data

   Copy to Clipboard

2. Satellite Server で Puppet サーバーを無効化します。

   # satellite-maintain plugin purge-puppet --remove-all-data

   Copy to Clipboard

手順

1. forge.puppet.com に移動し、ntp を検索します。最初のモジュールの 1 つは puppetlabs/ntp です。

2. SSH を使用して Satellite Server に接続し、Puppet モジュールをインストールします。

   # puppet module install puppetlabs-ntp -i /etc/puppetlabs/code/environments/production/modules

   Copy to Clipboard

   -i パラメーターを使用してパスおよび Puppet 環境を指定します (例:production)。

   インストールが完了すると、出力は以下のようになります。

   Notice: Preparing to install into /etc/puppetlabs/code/environments/production/modules ...
   Notice: Created target directory /etc/puppetlabs/code/environments/production/modules
   Notice: Downloading from https://forgeapi.puppet.com ...
   Notice: Installing -- do not interrupt ...
   /etc/puppetlabs/code/environments/production/modules
   |-| puppetlabs-ntp (v8.3.0)
     |-- puppetlabs-stdlib (v4.25.1) [/etc/puppetlabs/code/environments/production/modules]

   Copy to Clipboard

手順

1. SSH を使用して Puppet サーバーに接続し、Puppet モジュールの場所を探します。

   # puppet config print modulepath

   Copy to Clipboard

   これにより、以下のような出力が返されます。

   /etc/puppetlabs/code/environments/production/modules:/etc/puppetlabs/code/environments/common:/etc/puppetlabs/code/modules:/opt/puppetlabs/puppet/modules:/usr/share/puppet/modules

   Copy to Clipboard

2. モジュールが上記のパスにある場合、以下のコマンドによりモジュールが更新されます。

   # puppet module upgrade module name

   Copy to Clipboard

1. グローバルパラメーター
2. 組織パラメーター
3. ロケーションパラメーター
4. ホストグループパラメーター
5. ホストパラメーター

手順

1. Satellite Web UI で、Configure > Classes に移動します。
2. 設定を変更するntp Puppet クラスを選択します。
3. Smart Class Parameter タブを選択し、servers を検索します。
4. Override チェックボックスが選択されていることを確認します。
5. Parameter Type ドロップダウンメニューを array に設定します。

6. Default Value として ntp サーバーのリストを挿入します。

   ["0.de.pool.ntp.org","1.de.pool.ntp.org","2.de.pool.ntp.org","3.de.pool.ntp.org"]

   Copy to Clipboard

   配列を記述する別の方法は、yaml 構文です。

   - 0.de.pool.ntp.org
   - 1.de.pool.ntp.org
   - 2.de.pool.ntp.org
   - 3.de.pool.ntp.org

   Copy to Clipboard
7. 値を追加した後に Submit ボタンをクリックします。これにより、Puppet モジュール ntp のデフォルト設定が変更されます。

手順

1. Satellite Web UI で、Configure > Classes に移動します。
2. クラス名をクリックしてクラスを選択します。
3. Smart Class Parameter タブで、パラメーターを選択します。
4. Order リストを使用して Puppet パラメーターの階層を定義します。個々のホスト (fqdn) は最も関連性が強いとマークし、組織コンテキスト (organization) は最も関連性が弱いとマークします。
5. 最初のマッチが検索された後、それ以降のマッチするパラメーターをすべて追加する場合は、Merge Overrides をチェックします。
6. より具体的な値が定義されている場合でもデフォルト値も含める場合は、Merge Default をオンにします。
7. 選択したパラメーターの一意の値のリストを作成する場合は、Avoid Duplicates をオンにします。
8. matcher フィールドには、order リストからの attribute タイプ が必要です。
9. Add Matcher ボタンを使用して、マッチャーをさらに追加します。
10. Submit をクリックして変更を保存します。

手順

1. Satellite Web UI で、Configure > Classes に移動します。
2. クラス名をクリックしてクラスを選択します。
3. Smart Class Parameter タブで、パラメーターを選択します。
4. Order リストを使用して Puppet パラメーターの階層を定義します。個々のホスト (fqdn) は最も関連性が強いとマークし、ロケーションコンテキスト (location) は最も関連性が弱いとマークします。
5. 最初のマッチが検索された後、それ以降のマッチするパラメーターをすべて追加する場合は、Merge Overrides をチェックします。
6. より具体的な値が定義されている場合でもデフォルト値も含める場合は、Merge Default をオンにします。
7. 選択したパラメーターの一意の値のリストを作成する場合は、Avoid Duplicates をオンにします。
8. matcher フィールドには、order リストからの attribute タイプ が必要です。たとえば、場所 のコンテキストとして Paris を選択し、値をフランスの ntp サーバーに設定できます。
9. Add Matcher ボタンを使用して、マッチャーをさらに追加します。
10. Submit をクリックして変更を保存します。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. ホスト名をクリックしてホストを選択します。
3. Edit をクリックします。
4. Host タブで、Puppet 環境 を選択します。
5. Puppet ENC タブを選択します。
6. Override ボタンをクリックして Puppet パラメーターを編集します。
7. Submit をクリックして変更を保存します。

手順

1. Satellite Web UI で、Administer > Remote Execution Features に移動します。
2. puppet_run_host リモート実行機能を選択します。
3. Run Puppet Once - SSH Default ジョブテンプレートを割り当てます。

手順

1. SSH を使用してマネージドホストに接続します。
2. Puppet エージェントの実行間隔を /etc/puppetlabs/puppet/puppet.conf に追加します (例:runinterval = 1h)。

手順

1. Satellite Web UI で、Administer > Settings に移動します。

2. General タブで、Out of sync interval を編集します。ホストが同期されていないと見なされるまでの期間を分単位で設定します。

   outofsync_interval パラメーターを追加して、ホストグループ または 個々のホスト でこの間隔を上書きすることもできます。

手順

1. Satellite Web UI で、Administer > Settings に移動して、Config Management タブをクリックします。
2. Puppet interval フィールドで、Puppet を使用して報告するホストが同期されていないと見なされるまでの期間に分単位の値を設定します。

手順

1. Satellite Web UI で、Configure > Host Groups に移動します。
2. ホストグループを選択します。
3. Parameters タブで Add Parameter をクリックします。
4. Name フィールドに outofsync_interval を入力します。
5. Type ドロップダウンメニューから、integer を選択します。
6. Value フィールドに新しい間隔を分単位で入力します。
7. Submit ボタンをクリックします。

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 選択したホストの Edit をクリックします。
3. Parameters タブで Add Parameter をクリックします。
4. Name フィールドに outofsync_interval を入力します。
5. Type ドロップダウンメニューから、integer を選択します。
6. Value フィールドに新しい間隔を分単位で入力します。
7. Submit ボタンをクリックします。