15.2. ホストへのパッケージのインストール

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. ホストを選択します。
3. Content タブで、Packages タブをクリックします。
4. アップグレードボタンの横にある縦の省略記号アイコンで、Install packages をクリックします。
5. Install packages ウィンドウで、ホストにインストールするパッケージを選択します。
6. Install をクリックします。Satellite Web UI に、リモート実行ジョブの通知が表示されます。

API の手順

1. "job_invocation" オブジェクトを作成し、ボディーの残りの部分をこのオブジェクト内に配置します。
2. インストールするパッケージを指定する文字列型の "package" フィールドを持つ "inputs" オブジェクトを作成します。複数のパッケージを指定する場合は、空白で区切ります。
3. 値 "katello_package_install" を持つ文字列型の "feature" フィールドを作成します。
4. 文字列型の "search_query" フィールドを作成し、パッケージをインストールするホストに一致する検索クエリーを入力します。

5. オプション: 特定のユーザーとしてパッケージをインストールする場合は、次の文字列型のフィールドを持つ ssh オブジェクトを作成します。

   • ssh ユーザーの名前を含む "effective_user" フィールド
   • ssh ユーザーのパスワードを含む "effective_user_password" フィールド (このパスワードが必要な場合)

6. オプション: 後でパッケージをインストールする場合は、"scheduling" オブジェクトを作成します。このオブジェクトには、ISO 8601 形式の日付、時刻、タイムゾーンを含む、次の文字列型フィールドの 1 つまたは両方を含めることができます。

   • "start_at" - パッケージをインストールする時刻を設定します。
   • "start_before" - パッケージをインストールする最も遅い時刻を設定します。この時刻までにパッケージをインストールできない場合、このアクションはキャンセルされます。

   時刻を省略すると、デフォルトの 00:00:00 になります。タイムゾーンを省略した場合は、デフォルトで UTC が使用されます。

7. オプション: ジョブを同時に実行するホストの数を制限する場合は、整数型の "concurrency_level" フィールドを持つ "concurrency_control" オブジェクトを作成します。ホストの数をフィールドの値として割り当てます。
8. オプション: 後でパッケージをインストールし、ジョブの実行時にホスト検索クエリーを評価する場合は、"dynamic_query" 値を持つ文字列型の "targeting_type" フィールドを作成します。これは、ホストのステータスの変更により、ジョブの実行時に検索クエリーの結果が異なることが予想される場合に便利です。このフィールドを省略すると、デフォルトの "static_query" が使用されます。

9. 作成したボディーを含む POST リクエストを Satellite Server の /api/job_invocations エンドポイントに送信し、Python などのツールを使用してフォーマットされた応答を確認します。

   API リクエストの例:

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool