3.5. ブートストラップ登録用の Puppet 環境の作成
ホストグループを Production 環境内に作成した Puppet 環境に関連付けると、Puppet はホストグループからホストを登録する時に Puppet CA 証明書の取得に失敗します。ホストグループに関連付ける適切な Puppet 環境を作成する必要があります。
手順
ディレクトリーを手動で作成します。
mkdir /etc/puppetlabs/code/environments/example_environment
# mkdir /etc/puppetlabs/code/environments/example_environmentCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Satellite Web UI で、Configure > Puppet ENC > Environments に移動します。
- Import environment from をクリックします。
- Capsule を選択してください。
- 作成したディレクトリーを選択し、Update をクリックします。
3.5.1. Satellite Web UI を使用してブートストラップスクリプトの権限を設定する リンクのコピーリンクがクリップボードにコピーされました!
この手順を使用して、Satellite Web UI からブートストラップスクリプトを実行するために必要な権限を持つ Satellite ユーザーを設定します。
手順
- Satellite Web UI で、Administer > Users に移動します。
- 必要な ユーザー名 をクリックして既存のユーザーを選択すると、選択したユーザーの情報を変更するタブが含まれる、新しいペインが表示されます。または、このスクリプトの実行専用に新規ユーザーを作成します。
- ロール タブをクリックします。
ロール リストから ホストの編集 および ビューワー を選択します。
重要ホストの編集 ロールを割り当てると、ユーザーは、ホストの編集や削除、ホストの追加が可能です。セキュリティーポリシーの関係上、この方法を使用できない場合は、以下のパーミッションを割り当てた新しいロールを作成して、このロールをユーザーに割り当ててください。
-
view_organizations -
view_locations -
view_domains -
view_hostgroups -
view_hosts -
view_architectures -
view_ptables -
view_operatingsystems -
create_hosts
-
- Submit をクリックします。
3.5.2. Hammer CLI を使用してブートストラップスクリプトの権限を設定する リンクのコピーリンクがクリップボードにコピーされました!
Hammer CLI を使用して、以下の手順で Satellite ユーザーにブートストラップスクリプトの実行に必要なパーミッションを設定します。
手順
ブートストラップスクリプトで最低限必要なパーミッションを持つロールを作成します。この例は、Bootstrap という名前のロールを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 既存のユーザーに新しいロールを割り当てます。
hammer user add-role --id user_id --role Bootstrap
$ hammer user add-role --id user_id --role BootstrapCopy to Clipboard Copied! Toggle word wrap Toggle overflow または、新規ユーザーを作成して、新しいロールを新規ユーザーに割り当てることもできます。Hammer を使用してユーザーを作成する方法の詳細は、Red Hat Satellite の管理 の ユーザーとロールの管理 を参照してください。
3.5.3. 詳細なブートストラップスクリプトの設定 リンクのコピーリンクがクリップボードにコピーされました!
以下のセクションでは、ブートストラップスクリプトを使用してホストを登録したり、移行したりする例をさらに紹介します。
以下の例では、admin Satellite ユーザーを指定します。セキュリティーポリシーの関係上、この要件を満たせない場合には、新しいロールを作成してブートストラップスクリプトで最小限必要なパーミッションを割り当ててください。
3.5.3.1. Satellite から別の Satellite へのホストの移行 リンクのコピーリンクがクリップボードにコピーされました!
--force を指定してこのスクリプトを使用し、以前の Satellite から katello-ca-consumer-* パッケージを削除し、新しい Satellite で katello-ca-consumer-* パッケージをインストールします。
手順
Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3.2. Red Hat Network (RHN) または Satellite 5 から Satellite へのホストの移行 リンクのコピーリンクがクリップボードにコピーされました!
ブートストラップスクリプトは、システムがレガシープラットフォームに登録済みであることの指標として、/etc/syconfig/rhn/systemid が存在し、RHN の接続が有効であることを検出します。次にこのスクリプトは、rhn-classic-migrate-to-rhsm を呼び出して RHN からシステムを移行します。このスクリプトでは監査上の理由で、システムのレガシープロファイルはデフォルトで削除されません。レガシープロファイルを削除するには、--legacy-purge を使用してから、--legacy-login を使用して適切なパーミッションのあるユーザーアカウントを指定し、プロファイルを削除します。
プロンプトが表示されたらユーザーアカウントのパスワードを入力します。
手順
Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3.3. Puppet を使用しない Satellite へのホストの登録 リンクのコピーリンクがクリップボードにコピーされました!
デフォルトでは、ブートストラップスクリプトを使用して、コンテンツ管理および設定管理に対してホストを設定します。既存の設定管理システムがあり、ホストに Puppet をインストールしない場合は --skip-puppet を使用します。
手順
Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3.4. コンテンツ管理専用としてホストを Satellite に登録する手順 リンクのコピーリンクがクリップボードにコピーされました!
システムをコンテンツホストとして登録し、プロビジョニングおよび設定管理機能を除外するには、--skip-foreman を使用します。
手順
Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
/usr/libexec/platform-python bootstrap.py \ --server satellite.example.com \ --organization="My_Organization" \ --activationkey="My_Activation_Key" \ --skip-foreman
# /usr/libexec/platform-python bootstrap.py \ --server satellite.example.com \ --organization="My_Organization" \ --activationkey="My_Activation_Key" \ --skip-foremanCopy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
bootstrap.py --server satellite.example.com \ --organization="My_Organization" \ --activationkey="My_Activation_Key" \ --skip-foreman
# bootstrap.py --server satellite.example.com \ --organization="My_Organization" \ --activationkey="My_Activation_Key" \ --skip-foremanCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3.5. ブートストラップスクリプトがコンシューマー RPM のダウンロードに使用する方法の変更 リンクのコピーリンクがクリップボードにコピーされました!
デフォルトでは、ブートストラップスクリプトは HTTP を使用して http://satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm からコンシューマー RPM をダウンロードします。環境によっては、ホストと Satellite との間のみ HTTPS を許可する場合があります。--download-method を使用して、ダウンロードメソッドを HTTP から HTTPS へ変更します。
手順
Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3.6. ホストの IP アドレスの Satellite への指定 リンクのコピーリンクがクリップボードにコピーされました!
インターフェイスが複数あるホスト、または 1 つのインターフェイスに IP アドレスが複数あるホストでは、IP アドレスの自動検出設定を無効にして、特定の IP アドレスを Satellite に指定する必要がでてくる場合があります。--ip を使用してください。
手順
Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3.7. ホストでのリモート実行の有効化 リンクのコピーリンクがクリップボードにコピーされました!
--rex および --rex-user を使用して、リモート実行を有効にし、指定したユーザーに必要な SSH 鍵を追加します。
手順
Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3.8. 登録時のホストのドメイン作成 リンクのコピーリンクがクリップボードにコピーされました!
ホストレコードを作成するには、スクリプトを実行する前に、ホストの DNS ドメインが Satellite に存在している必要があります。ドメインが存在しない場合は、--add-domain を使用して追加します。
手順
Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3.9. ホストへの別の FQDN の指定 リンクのコピーリンクがクリップボードにコピーされました!
ホストのホスト名が FQDN でない場合や、RFC に準拠していない場合 (アンダースコアなどの文字が含まれている) には、ホスト名の検証の段階で、スクリプトが失敗します。Satellite で使用可能な FQDN を使用するようにホストを更新できない場合は、ブートストラップスクリプトを使用して別の FQDN を指定してください。
手順
Hammer を使用して
create_new_host_when_facts_are_uploadedとcreate_new_host_when_report_is_uploadedを false に設定します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow --fqdnを使用して、Satellite にレポートする FQDN を指定します。Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow