16.3. ホスト上のパッケージのアップグレード

手順

1. Satellite Web UI で、Hosts > All Hosts に移動します。
2. 変更するホストの名前をクリックします。
3. Content タブをクリックし、Packages タブをクリックします。
4. Status 一覧から Upgradable を選択します。
5. 該当する場合は、Upgradable to 列のドロップダウンメニューからアップグレードバージョンを選択します。
6. アップグレードするパッケージを選択します。
7. Upgrade をクリックします。リモート実行ジョブが完了すると、REX ジョブ通知が表示されます。

API の手順

1. "job_invocation" オブジェクトを作成し、ボディーの残りの部分をこのオブジェクト内に配置します。
2. 更新するパッケージを指定する文字列型の "package" フィールドを持つ "inputs" オブジェクトを作成します。複数のパッケージを指定する場合は、空白で区切ります。
3. 値 "katello_package_update" を持つ文字列型の "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