From 3e7d86a30ee7e48ef11eb5898d9cf502e56231e0 Mon Sep 17 00:00:00 2001 From: Maximilian Kolb Date: Thu, 11 Sep 2025 13:25:43 +0200 Subject: [PATCH 1/3] Add hint about related setting for REX concurrency Fixes #38247 (Missing docs on how to REX batching works) --- .../modules/ref_advanced-settings-in-the-job-wizard.adoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/guides/common/modules/ref_advanced-settings-in-the-job-wizard.adoc b/guides/common/modules/ref_advanced-settings-in-the-job-wizard.adoc index e67ac0954fe..7ea56569727 100644 --- a/guides/common/modules/ref_advanced-settings-in-the-job-wizard.adoc +++ b/guides/common/modules/ref_advanced-settings-in-the-job-wizard.adoc @@ -44,6 +44,10 @@ Is used if effective user is different from the ssh user. Concurrency level:: Defines the maximum number of jobs executed at once. This can prevent overload of system resources in a case of executing the job on a large number of hosts. ++ +If a batch size is set, {SmartProxies} run batches of concurrent remote execution jobs. +For Ansible-based remote execution jobs, change the `foreman_ansible_proxy_batch_size` setting in the {ProjectWebUI} under *Administer* > *Settings* on the *Ansible* tab. +For Script-based remote execution jobs, change the `foreman_tasks_proxy_batch_size` setting in the {ProjectWebUI} under *Administer* > *Settings* on the *Tasks* tab. Execution ordering:: Determines the order in which the job is executed on hosts. From 0b21124e2083e9ce903d6e07064cbd2203f45770 Mon Sep 17 00:00:00 2001 From: Maximilian Kolb Date: Tue, 2 Dec 2025 15:38:45 +0100 Subject: [PATCH 2/3] Rework just of fun --- .../modules/ref_advanced-settings-in-the-job-wizard.adoc | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/guides/common/modules/ref_advanced-settings-in-the-job-wizard.adoc b/guides/common/modules/ref_advanced-settings-in-the-job-wizard.adoc index 7ea56569727..b1ca0fa6b77 100644 --- a/guides/common/modules/ref_advanced-settings-in-the-job-wizard.adoc +++ b/guides/common/modules/ref_advanced-settings-in-the-job-wizard.adoc @@ -42,12 +42,8 @@ Effective user password:: Is used if effective user is different from the ssh user. Concurrency level:: -Defines the maximum number of jobs executed at once. -This can prevent overload of system resources in a case of executing the job on a large number of hosts. -+ -If a batch size is set, {SmartProxies} run batches of concurrent remote execution jobs. -For Ansible-based remote execution jobs, change the `foreman_ansible_proxy_batch_size` setting in the {ProjectWebUI} under *Administer* > *Settings* on the *Ansible* tab. -For Script-based remote execution jobs, change the `foreman_tasks_proxy_batch_size` setting in the {ProjectWebUI} under *Administer* > *Settings* on the *Tasks* tab. +Defines the maximum number of tasks executed at once. +This can prevent overload of system resources in a case of executing the tasks on a large number of hosts. Execution ordering:: Determines the order in which the job is executed on hosts. From 5383d349bbb3c7039a9257be0398e8d8af12be21 Mon Sep 17 00:00:00 2001 From: Maximilian Kolb Date: Tue, 2 Dec 2025 16:05:24 +0100 Subject: [PATCH 3/3] Rework again just for fun --- ...y_configuring-and-setting-up-remote-jobs.adoc | 2 ++ ...running-remote-execution-jobs-in-batches.adoc | 16 ++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 guides/common/modules/proc_running-remote-execution-jobs-in-batches.adoc diff --git a/guides/common/assembly_configuring-and-setting-up-remote-jobs.adoc b/guides/common/assembly_configuring-and-setting-up-remote-jobs.adoc index 8a6f307ba33..35e76664723 100644 --- a/guides/common/assembly_configuring-and-setting-up-remote-jobs.adoc +++ b/guides/common/assembly_configuring-and-setting-up-remote-jobs.adoc @@ -83,6 +83,8 @@ include::modules/proc_executing-a-remote-job-by-using-cli.adoc[leveloffset=+1] include::modules/ref_advanced-settings-in-the-job-wizard.adoc[leveloffset=+1] +include::modules/proc_running-remote-execution-jobs-in-batches.adoc[leveloffset=+1] + include::modules/con_using-extended-cron-lines.adoc[leveloffset=+1] include::modules/proc_scheduling-a-recurring-ansible-job-for-a-host.adoc[leveloffset=+1] diff --git a/guides/common/modules/proc_running-remote-execution-jobs-in-batches.adoc b/guides/common/modules/proc_running-remote-execution-jobs-in-batches.adoc new file mode 100644 index 00000000000..b417d73babe --- /dev/null +++ b/guides/common/modules/proc_running-remote-execution-jobs-in-batches.adoc @@ -0,0 +1,16 @@ +:_mod-docs-content-type: PROCEDURE + +[id="running-remote-execution-jobs-in-batches"] += Running remote execution jobs in batches + +[role="_abstract"] +You can run remote execution jobs in batches. + +.Procedure +. In the {ProjectWebUI}, navigate to *Administer* > *Settings*. +ifdef::satellite[] +. On the *Tasks* tab, set *Allow Capsule batch tasks* to `Yes`. +endif::[] +ifndef::satellite[] +. On the *Tasks* tab, set *Allow proxy batch tasks* to `Yes`. +endif::[]