15.2. ホストへのパッケージのインストール
この手順を使用して、Satellite Web UI を使用してパッケージを確認し、ホストにインストールします。インストール可能なパッケージのリストは、ホストに割り当てられたコンテンツビュー環境によって異なります。
手順
- Satellite Web UI で、Hosts > All Hosts に移動します。
- ホストを選択します。
- Content タブで、Packages タブをクリックします。
- アップグレードボタンの横にある縦の省略記号アイコンで、Install packages をクリックします。
- Install packages ウィンドウで、ホストにインストールするパッケージを選択します。
- Install をクリックします。Satellite Web UI に、リモート実行ジョブの通知が表示されます。
API の手順
API リクエスト本文を JSON 形式で指定します。
API リクエストボディーの例
{
"job_invocation" : {
"concurrency_control" : {
"concurrency_level" : 100
},
"feature" : "katello_package_{PackageAction}",
"inputs" : {
"package" : "nano vim"
},
"scheduling" : {
"start_at" : "2023-09-21T19:00:00+00:00",
"start_before" : "2023-09-23T00:00:00+00:00"
},
"search_query" : "*",
"ssh" : {
"effective_user" : "My_Username",
"effective_user_password" : "My_Password"
},
"targeting_type" : "dynamic_query"
}
}
- 1
- API リクエストが含まれる
"job_invocation"オブジェクト。 - 2
- オプション: ジョブが同時に実行されるホストの数を制限します。
- 3
"feature"フィールドには"katello_package_install"の値を指定します。- 4
- インストールするパッケージを指定する
"inputs/package"オブジェクト。複数のパッケージは空白で区切ります。 - 5
- オプション: パッケージのインストールを開始する時間の境界。
- 一方または両方の境界を ISO 8601 形式で指定できます。
- この時点でパッケージをインストールできない場合は、アクションはキャンセルされます。
- 時刻を省略すると、デフォルトの 00:00:00 になります。
- タイムゾーンを省略すると、デフォルトで UTC になります。
- 6
- パッケージをインストールするホストに一致する検索クエリー。
- 7
- オプション: SSH ユーザーの認証情報 (そのユーザーとしてパッケージをインストールする場合)。
- 8
- オプション:
"scheduling"オブジェクトを指定した場合、"targeting_type/dynamic_query"フィールドを指定して、ジョブの実行時に検索クエリーを評価できます。- これは、ジョブの実行時にクエリーが異なる結果を生成することが予想される場合に役立ちます。
-
このフィールドを省略すると、デフォルトの
"static_query"が使用されます。
作成したボディーを含む
POSTリクエストを Satellite Server の/api/job_invocationsエンドポイントに送信し、フォーマットされた応答を確認します。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
検証
- Satellite Web UI で、Monitor > Jobs に移動し、選択したホストでパッケージをインストールする、スケジュール済みまたは完了済みのリモート実行ジョブのレポートを確認します。