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

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

手順

1. Puppet 統合を有効にし、Satellite Server に Puppet サーバーをインストールします。

   # satellite-installer \
   --enable-foreman-cli-puppet \
   --enable-foreman-plugin-puppet \
   --enable-puppet \
   --foreman-proxy-puppet true \
   --foreman-proxy-puppetca true \
   --puppet-server true

2. Capsule Server で Puppet 統合を使用する場合は、Puppet 統合を有効にし、Capsule Server に Puppet サーバーをインストールします。

   # satellite-installer \
   --enable-puppet \
   --foreman-proxy-puppet true \
   --foreman-proxy-puppetca true \
   --puppet-server true \
   --puppet-server-foreman-url "https://satellite.example.com"

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

手順

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

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

   <%= snippet 'puppet_setup' %>

   このスニペットは、Satellite に同梱されているテンプレート (Kickstart default や Preseed default など) にすでに含まれている点に注意してください。

4. グローバルパラメーター、ホストグループ、または単一ホストのホストパラメーターを使用して、Puppet エージェントを有効化します。Enable-puppet7 という名前のホストパラメーターを追加し、boolean タイプを選択して、値を true に設定します。

5. Puppet エージェントの設定を指定します。

   • 統合された Puppet サーバーを使用する場合は、ホストの作成時に Puppet Capsule、Puppet CA Capsule、および Puppet 環境を必ず選択してください。

   • 非統合 Puppet サーバーを使用する場合は、グローバルパラメーターまたはホストグループで次のホストパラメーターを設定するか、ホストの作成時に次のホストパラメーターを設定します。

     • puppet_server という名前のホストパラメーターを追加し、string タイプを選択して、値を Puppet サーバーのホスト名 (puppet.example.com など) に設定します。
     • オプション: puppet_ca_server という名前のホストパラメーターを追加し、string タイプを選択して、値を Puppet CA サーバーのホスト名 (puppet-ca.example.com など) に設定します。puppet_ca_server が設定されていない場合、Puppet エージェントは puppet_server と同じサーバーを使用します。
     • オプション: puppet_environment という名前のホストパラメーターを追加し、string タイプを選択して、ホストで使用する Puppet 環境に値を設定します。
6. 適切なアクティベーションキーを使用して、ホストが Satellite Server から Puppet エージェントパッケージにアクセスできることを確認します。

手順

1. Satellite Web UI で、 Configure > Global Parameters に移動して、ホストパラメーターをグローバルに追加します。あるいは、Configure > Host Groups に移動し、ホストグループを編集または作成して、ホストパラメーターをホストグループにのみ追加することもできます。
2. グローバルパラメーターまたはホストグループのホストパラメーターを使用して、Puppet エージェントを有効化します。Enable-puppet7 という名前のホストパラメーターを追加し、boolean タイプを選択して、値を true に設定します。

3. グローバルパラメーターまたはホストグループで次のホストパラメーターを使用して、Puppet エージェントの設定を指定します。

   • puppet_server という名前のホストパラメーターを追加し、string タイプを選択して、値を Puppet サーバーのホスト名 (puppet.example.com など) に設定します。
   • オプション: puppet_ca_server という名前のホストパラメーターを追加し、string タイプを選択して、値を Puppet CA サーバーのホスト名 (puppet-ca.example.com など) に設定します。puppet_ca_server が設定されていない場合、Puppet エージェントは puppet_server と同じサーバーを使用します。
   • オプション: puppet_environment という名前のホストパラメーターを追加し、string タイプを選択して、ホストで使用する Puppet 環境に値を設定します。

   BZ2177730 が解決されるまでは、Puppet サーバーが Capsule Server となっている統合セットアップでも、ホストパラメーターを使用して Puppet エージェント設定を指定する必要があります。

4. Hosts > Register Host に移動し、適切なアクティベーションキーを使用してホストを登録します。詳細は、ホストの管理 の ホストの登録 を参照してください。
5. Infrastructure > Capsules に移動します。
6. 必要な Capsule Server の Actions コラムの一覧から、Certificates を選択します。
7. 必要なホストの右にある Sign をクリックして、Puppet エージェントの SSL 証明書に署名します。

手順

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

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

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

     # dnf install puppet-agent

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

     # yum install puppet-agent

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

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

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

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

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

   # puppet resource service puppet ensure=running enable=true

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

   # puppet ssl bootstrap

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

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

    # puppet ssl bootstrap

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

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

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

手順

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

   -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]

手順

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

   # puppet config print modulepath

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

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

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

   # puppet module upgrade module name

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"]

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

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

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 をクリックします。