Description of problem: Improve or add new API endpoints to use the REX functionality instead of katello-agent Version-Release number of selected component (if applicable): satellite-6.10 How reproducible: When using /api/hosts/:host_id/packages/ Steps to Reproduce: 1. Modify setting remote_execution_by_default | true 2. Use the "Curl" command to install package/errata 3. This process use katello-agent Actual results: PUT /api/hosts/:host_id/errata/apply DEPRECATED Schedule errata for installation using katello-agent. NOTE: Katello-agent is deprecated and will be removed in a future release. Consider using remote execution instead. PUT /api/hosts/:host_id/packages/install DEPRECATED Install packages remotely using katello-agent. NOTE: Katello-agent is deprecated and will be removed in a future release. Consider using remote execution instead. PUT /api/hosts/:host_id/packages/upgrade DEPRECATED Update packages remotely using katello-agent. NOTE: Katello-agent is deprecated and will be removed in a future release. Consider using remote execution instead. PUT /api/hosts/:host_id/packages/upgrade_all DEPRECATED Update packages remotely using katello-agent. NOTE: Katello-agent is deprecated and will be removed in a future release. Consider using remote execution instead. PUT /api/hosts/:host_id/packages/remove DEPRECATED Uninstall packages remotely using katello-agent. NOTE: Katello-agent is deprecated and will be removed in a future release. Consider using remote execution instead. PUT /api/hosts/bulk/install_content DEPRECATED Install content on one or more hosts using katello-agent. NOTE: Katello-agent is deprecated and will be removed in a future release. Consider using remote execution instead. PUT /api/hosts/bulk/update_content DEPRECATED Update content on one or more hosts using katello-agent. NOTE: Katello-agent is deprecated and will be removed in a future release. Consider using remote execution instead. PUT /api/hosts/bulk/remove_content DEPRECATED Remove content on one or more hosts using katello-agent. NOTE: Katello-agent is deprecated and will be removed in a future release. Consider using remote execution instead. Expected results: either keep those Endpoints and migrate them to REX or introduce new Endpoints for REX like "/api/v2/katello/remote_execution". Additional info:
Do we need to really do anything here? There is the regular REX api (and hammer) which can be used to install/update/remove packages on one or many hosts If we do anything about this, the changes should probably land in Katello.
The REX job invocation API covers all of the use cases of these endpoints. The corresponding hammer commands for remote execution are documented here: https://access.redhat.com/documentation/en-us/red_hat_satellite/6.12/html-single/managing_hosts/index#Migrating_From_Katello_Agent_to_Remote_Execution_managing-hosts But the corresponding API endpoints and job templates aren't documented. I can see improving the documentation. Each of these tasks can be accomplished with hammer CLI, API, or web UI (and also sometimes Ansible!), but the documentation is in several places and doesn't cover everything. (For instance, https://access.redhat.com/documentation/en-us/red_hat_satellite/6.12/html-single/managing_hosts/index#managing-packages_managing-hosts describes the web UI for managing packages on a single host, but doesn't cover CLI or API and doesn't cover bulk hosts.) Perhaps organizing a doc section around accomplishing tasks would help. Changing BZ title and component to reflect this.
Hi! Currently preparing PR to include REX APIs in the docs.