3.4. ブートストラップスクリプトを使用したホストの登録
ブートストラップスクリプトを使用して、コンテンツの登録と Puppet の設定を自動化します。
ブートストラップスクリプトは非推奨の機能です。非推奨の機能は Satellite に引き続き含まれており、サポートが継続されます。ただし、この製品の今後のリリースで削除されるため、新しいデプロイメントには推奨されません。
代わりに 「グローバル登録を使用したホストの登録」 を使用してください。
Satellite で非推奨または削除された主要機能の最新リストは、Satellite リリースノートの 非推奨の機能 セクションを参照してください。
ブートストラップスクリプトを使用して、新しいホストを登録したり、RHN、SAM、RHSM、または別の Red Hat Satellite インスタンスから既存のホストを移行したりできます。
Satellite Server のベースオペレーティングシステムに、デフォルトで katello-client-bootstrap パッケージがインストールされています。bootstrap.py スクリプトは、/var/www/html/pub/ ディレクトリーにインストールされており、satellite.example.com/pub/bootstrap.py でホストに公開されます。このスクリプトでは、/usr/share/doc/katello-client-bootstrap-version/README.md ファイルにドキュメントが含まれます。
ブートストラップスクリプトを使用するには、ホストにスクリプトをインストールする必要があります。スクリプトは 1 度しか必要ではなく、また、root ユーザー専用であるため、/root または /usr/local/sbin に配置して、使用後に削除できます。この手順では、/root を使用します。
セキュリティー上の理由から、Capsules でのリバースプロキシーはデフォルトで無効になっています。そのため、Capsule を使用してホストを登録する場合、ブートストラップスクリプトは機能しません。Red Hat では、代わりに グローバル登録 を使用してホストを登録することを推奨しています。
前提条件
-
Satellite ユーザーに、ブートストラップスクリプト実行に必要なパーミッションを割り当て済みである。この手順の例では、
adminユーザーを指定します。セキュリティーポリシーの関係上、この要件を満たせない場合には、新しいロールを作成して最小限必要なパーミッションを割り当てて、スクリプトを実行するユーザーにこのロールを追加してください。 - Red Hat Satellite Client 6 リポジトリーが有効になっているホストのアクティベーションキーがある。アクティベーションキーの設定方法は、コンテンツの管理 の アクティベーションキーの管理 を参照してください。
- ホストグループを作成済みである。ホストグループの作成方法は 2章ホストグループの使用 を参照してください。
手順
-
rootユーザーで、ホストにログインします。 スクリプトをダウンロードします。
# curl -O http://satellite.example.com/pub/bootstrap.pyスクリプトを実行可能にします。
# chmod +x bootstrap.pyヘルプテキストを表示して、スクリプトが実行可能であることを確認します。
Red Hat Enterprise Linux 8 の場合:
# /usr/libexec/platform-python bootstrap.py -h他の Red Hat Enterprise Linux バージョンの場合:
# ./bootstrap.py -h
ご使用の環境に適した値を使用して、ブートストラップコマンドを入力します。
--serverオプションの場合は、Satellite Server または Capsule Server の FQDN を指定します。オプションが--location、--organization、および--hostgroupの場合は、オプションへの引数として、ラベルではなく引用符で囲まれた名前を使用します。高度なユースケースは、「詳細なブートストラップスクリプトの設定」 を参照してください。Red Hat Enterprise Linux 8 の場合は、以下のコマンドを入力します。
# /usr/libexec/platform-python bootstrap.py \ --login=admin \ --server satellite.example.com \ --location="My_Location" \ --organization="My_Organization" \ --hostgroup="My_Host_Group" \ --activationkey="My_Activation_Key"Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。
# ./bootstrap.py --login=admin \ --server satellite.example.com \ --location="My_Location" \ --organization="My_Organization" \ --hostgroup="My_Host_Group" \ --activationkey="My_Activation_Key"
--loginオプションで指定した Satellite ユーザーのパスワードを入力します。スクリプトは、進捗の通知を stdout に送信します。
-
スクリプトでプロンプトが表示されたら、ホストの Puppet 証明書を承認します。Satellite Web UI で Infrastructure > Capsules に移動して、
--serverオプションで指定した Satellite または Capsule Server を検出します。 - アクション コラムのリストから、証明書 を選択します。
- アクション コラムで、署名 をクリックして、ホストの Puppet 証明書を承認します。
- ホストに戻り、残りのブートストラップ処理が完了するのを確認します。
- Satellite Web UI で Hosts > All Hosts に移動して、そのホストが適切なホストグループに接続していることを確認します。
オプション: ホストの登録が完了したら、スクリプトを削除します。
# rm bootstrap.py