This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/sling-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 9e8f8dc79 Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/1153/
9e8f8dc79 is described below
commit 9e8f8dc79c91fd5beaa6397ed1978426a5da4cf5
Author: jenkins <[email protected]>
AuthorDate: Tue Sep 16 10:57:16 2025 +0000
Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/1153/
---
.../bundles/apache-sling-eventing-and-job-handling.html | 15 ++++++++++++++-
pagefind/fragment/en_94226a8.pf_fragment | Bin 6356 -> 0 bytes
pagefind/fragment/en_bce988c.pf_fragment | Bin 0 -> 6825 bytes
pagefind/index/en_1b1e748.pf_index | Bin 40596 -> 0 bytes
pagefind/index/en_21a52fd.pf_index | Bin 38048 -> 0 bytes
pagefind/index/en_3f3e56e.pf_index | Bin 39309 -> 0 bytes
pagefind/index/en_4e57c75.pf_index | Bin 41774 -> 0 bytes
pagefind/index/en_50bd2aa.pf_index | Bin 0 -> 4004 bytes
pagefind/index/en_5e1cac4.pf_index | Bin 0 -> 40456 bytes
pagefind/index/en_6ca915c.pf_index | Bin 45075 -> 0 bytes
pagefind/index/en_732d799.pf_index | Bin 0 -> 38111 bytes
pagefind/index/en_751cb99.pf_index | Bin 0 -> 41064 bytes
pagefind/index/en_754ea15.pf_index | Bin 45215 -> 0 bytes
pagefind/index/en_77734f8.pf_index | Bin 0 -> 45241 bytes
pagefind/index/en_7c25299.pf_index | Bin 41982 -> 0 bytes
pagefind/index/en_8afbf36.pf_index | Bin 0 -> 41818 bytes
pagefind/index/en_8dfd2fb.pf_index | Bin 0 -> 45105 bytes
pagefind/index/en_96815fa.pf_index | Bin 42591 -> 0 bytes
pagefind/index/en_982662a.pf_index | Bin 4000 -> 0 bytes
pagefind/index/en_9cba7d7.pf_index | Bin 0 -> 42600 bytes
pagefind/index/en_a10bc22.pf_index | Bin 37504 -> 0 bytes
pagefind/index/en_a165622.pf_index | Bin 0 -> 47085 bytes
pagefind/index/en_a35d28f.pf_index | Bin 47049 -> 0 bytes
pagefind/index/en_a3bd221.pf_index | Bin 39255 -> 0 bytes
pagefind/index/en_aa6e40e.pf_index | Bin 0 -> 39039 bytes
pagefind/index/en_bf9ce96.pf_index | Bin 0 -> 41987 bytes
pagefind/index/en_cbd6dba.pf_index | Bin 0 -> 40655 bytes
pagefind/index/en_cefee99.pf_index | Bin 0 -> 39301 bytes
pagefind/index/en_d116feb.pf_index | Bin 41020 -> 0 bytes
pagefind/index/en_d250972.pf_index | Bin 0 -> 40145 bytes
pagefind/index/en_d92ee7a.pf_index | Bin 0 -> 37537 bytes
pagefind/index/en_dc4acdc.pf_index | Bin 39473 -> 0 bytes
pagefind/index/en_dcd497d.pf_index | Bin 40383 -> 0 bytes
pagefind/index/en_ea6bcaf.pf_index | Bin 40078 -> 0 bytes
pagefind/index/en_ec14c92.pf_index | Bin 0 -> 39488 bytes
pagefind/index/en_ed678ae.pf_index | Bin 39005 -> 0 bytes
pagefind/index/en_f1cb59b.pf_index | Bin 40771 -> 0 bytes
pagefind/index/en_fd59e59.pf_index | Bin 0 -> 40786 bytes
pagefind/index/en_fdcdb3f.pf_index | Bin 0 -> 39295 bytes
pagefind/pagefind-entry.json | 2 +-
pagefind/pagefind.en_27a3fff4fd.pf_meta | Bin 0 -> 1836 bytes
pagefind/pagefind.en_55db2bac82.pf_meta | Bin 1836 -> 0 bytes
sitemap.xml | 4 ++--
43 files changed, 17 insertions(+), 4 deletions(-)
diff --git a/documentation/bundles/apache-sling-eventing-and-job-handling.html
b/documentation/bundles/apache-sling-eventing-and-job-handling.html
index 5174d2c12..dcae08cf9 100644
--- a/documentation/bundles/apache-sling-eventing-and-job-handling.html
+++ b/documentation/bundles/apache-sling-eventing-and-job-handling.html
@@ -296,6 +296,7 @@ public class MyComponent {
<tr><td> <code>queue.retries</code> </td><td> How often the job should be
retried in case of failure (i.e. Job did not finish with succeeded or cancelled
result). -1 for endless retries. In case of exceptions there is no retry.
</td></tr>
<tr><td> <code>queue.retrydelay</code> </td><td> The waiting time in
milliseconds between job retries. </td></tr>
<tr><td> <code>queue.priority</code> </td><td> The thread priority: NORM, MIN,
or MAX </td></tr>
+<tr><td> <code>queue.keepJobs</code> </td><td> A boolean flag if set to true
keeps metadata about successfully executed jobs in the repository instead of
immediately removing those. </td></tr>
<tr><td> <code>service.ranking</code> </td><td> A ranking for this
configuration.</td></tr>
</tbody>
</table>
@@ -306,6 +307,18 @@ public class MyComponent {
<p>Unordered queues process jobs in parallel.</p>
<h4><a href="#topic-round-robin-queues"
id="topic-round-robin-queues">Topic-Round-Robin Queues</a></h4>
<p>The jobs are processed in parallel. Scheduling of the jobs is based on the
topic of the jobs. These are started by doing round-robin on the available
topics.</p>
+<h3><a href="#job-persistence" id="job-persistence">Job Persistence</a></h3>
+<p>By default jobs are persisted below <code>/var/eventing/jobs</code> or
<code>/var/eventing/scheduled-jobs</code> (for scheduled jobs) when they are
added. Depending on the state of the job they are moved to different child
resources.</p>
+<ol>
+<li><code>assigned</code>, for jobs which are assigned to an instance. The job
resource is located below a resource with the name of the instance id.</li>
+<li><code>unassigned</code>, for jobs which are not yet assigned to an
instance.</li>
+<li><code>cancelled</code>, for jobs which failed or were cancelled.</li>
+<li><code>finished</code>, for jobs which completed successfully, usually this
is empty as successfully finished jobs are immediately removed by default,
except if the queue is configured differently.</li>
+</ol>
+<h4><a href="#clean-up" id="clean-up">Clean up</a></h4>
+<p>There is a regular cleanup job (<code>CleanUpTask</code>) which removes old
jobs from the repository. By default this is triggered every minute from the
<code>JobManagerImpl</code>. The history (i.e. cancelled and finished jobs) is
by default kept for 2 days and afterwards removed.</p>
+<h4><a href="#auditing" id="auditing">Auditing</a></h4>
+<p>There is an audit logger with category
<code>org.apache.sling.event.jobs.audit</code> which captures all relevant job
state transitions with level <code>DEBUG</code>.</p>
<h3><a href="#job-distributing" id="job-distributing">Job Distributing</a></h3>
<p>For job distribution (= distributing the processing in a cluster), the job
handling uses the topology feature from Sling - each instance in the topology
announces the set of topics (consumers) it currently has - and this defines the
job capabilities, a mapping from an instance to the topics it can process.</p>
<p>When a job is scheduled, the job manager uses these capabilities to find
out the set of instances which is able to process the request. If the queue
type is <em>ordered</em> then all jobs are processed by the leader of this set.
For parallel queues, the jobs are distributed equally amongst those
instance.</p>
@@ -345,7 +358,7 @@ public class MyComponent {
content/documentation/bundles/apache-sling-eventing-and-job-handling.md
</a>
</div> <div class="revisionInfo">
- Last modified by <span class="author">Konrad
Windszus</span> on <span class="comment">2025-03-05</span>
+ Last modified by <span class="author">Konrad
Windszus</span> on <span class="comment">2025-08-19</span>
</div><p>
Apache Sling, Sling, Apache, the Apache feather logo,
and the Apache Sling project
logo are trademarks of The Apache Software Foundation. All other marks
mentioned
diff --git a/pagefind/fragment/en_94226a8.pf_fragment
b/pagefind/fragment/en_94226a8.pf_fragment
deleted file mode 100644
index 0e7be3284..000000000
Binary files a/pagefind/fragment/en_94226a8.pf_fragment and /dev/null differ
diff --git a/pagefind/fragment/en_bce988c.pf_fragment
b/pagefind/fragment/en_bce988c.pf_fragment
new file mode 100644
index 000000000..3d6a0f362
Binary files /dev/null and b/pagefind/fragment/en_bce988c.pf_fragment differ
diff --git a/pagefind/index/en_1b1e748.pf_index
b/pagefind/index/en_1b1e748.pf_index
deleted file mode 100644
index e11545390..000000000
Binary files a/pagefind/index/en_1b1e748.pf_index and /dev/null differ
diff --git a/pagefind/index/en_21a52fd.pf_index
b/pagefind/index/en_21a52fd.pf_index
deleted file mode 100644
index 9cff86fc0..000000000
Binary files a/pagefind/index/en_21a52fd.pf_index and /dev/null differ
diff --git a/pagefind/index/en_3f3e56e.pf_index
b/pagefind/index/en_3f3e56e.pf_index
deleted file mode 100644
index a4f30f247..000000000
Binary files a/pagefind/index/en_3f3e56e.pf_index and /dev/null differ
diff --git a/pagefind/index/en_4e57c75.pf_index
b/pagefind/index/en_4e57c75.pf_index
deleted file mode 100644
index f7d62d45f..000000000
Binary files a/pagefind/index/en_4e57c75.pf_index and /dev/null differ
diff --git a/pagefind/index/en_50bd2aa.pf_index
b/pagefind/index/en_50bd2aa.pf_index
new file mode 100644
index 000000000..7a7206236
Binary files /dev/null and b/pagefind/index/en_50bd2aa.pf_index differ
diff --git a/pagefind/index/en_5e1cac4.pf_index
b/pagefind/index/en_5e1cac4.pf_index
new file mode 100644
index 000000000..aef30ad7e
Binary files /dev/null and b/pagefind/index/en_5e1cac4.pf_index differ
diff --git a/pagefind/index/en_6ca915c.pf_index
b/pagefind/index/en_6ca915c.pf_index
deleted file mode 100644
index a8d090b1f..000000000
Binary files a/pagefind/index/en_6ca915c.pf_index and /dev/null differ
diff --git a/pagefind/index/en_732d799.pf_index
b/pagefind/index/en_732d799.pf_index
new file mode 100644
index 000000000..fb286684c
Binary files /dev/null and b/pagefind/index/en_732d799.pf_index differ
diff --git a/pagefind/index/en_751cb99.pf_index
b/pagefind/index/en_751cb99.pf_index
new file mode 100644
index 000000000..3561e23b7
Binary files /dev/null and b/pagefind/index/en_751cb99.pf_index differ
diff --git a/pagefind/index/en_754ea15.pf_index
b/pagefind/index/en_754ea15.pf_index
deleted file mode 100644
index c34bd6139..000000000
Binary files a/pagefind/index/en_754ea15.pf_index and /dev/null differ
diff --git a/pagefind/index/en_77734f8.pf_index
b/pagefind/index/en_77734f8.pf_index
new file mode 100644
index 000000000..f5bb631cf
Binary files /dev/null and b/pagefind/index/en_77734f8.pf_index differ
diff --git a/pagefind/index/en_7c25299.pf_index
b/pagefind/index/en_7c25299.pf_index
deleted file mode 100644
index 23b053f4a..000000000
Binary files a/pagefind/index/en_7c25299.pf_index and /dev/null differ
diff --git a/pagefind/index/en_8afbf36.pf_index
b/pagefind/index/en_8afbf36.pf_index
new file mode 100644
index 000000000..a7b43c103
Binary files /dev/null and b/pagefind/index/en_8afbf36.pf_index differ
diff --git a/pagefind/index/en_8dfd2fb.pf_index
b/pagefind/index/en_8dfd2fb.pf_index
new file mode 100644
index 000000000..f6aa3506a
Binary files /dev/null and b/pagefind/index/en_8dfd2fb.pf_index differ
diff --git a/pagefind/index/en_96815fa.pf_index
b/pagefind/index/en_96815fa.pf_index
deleted file mode 100644
index c19da455b..000000000
Binary files a/pagefind/index/en_96815fa.pf_index and /dev/null differ
diff --git a/pagefind/index/en_982662a.pf_index
b/pagefind/index/en_982662a.pf_index
deleted file mode 100644
index 096d59c02..000000000
Binary files a/pagefind/index/en_982662a.pf_index and /dev/null differ
diff --git a/pagefind/index/en_9cba7d7.pf_index
b/pagefind/index/en_9cba7d7.pf_index
new file mode 100644
index 000000000..41675edef
Binary files /dev/null and b/pagefind/index/en_9cba7d7.pf_index differ
diff --git a/pagefind/index/en_a10bc22.pf_index
b/pagefind/index/en_a10bc22.pf_index
deleted file mode 100644
index 70fda0126..000000000
Binary files a/pagefind/index/en_a10bc22.pf_index and /dev/null differ
diff --git a/pagefind/index/en_a165622.pf_index
b/pagefind/index/en_a165622.pf_index
new file mode 100644
index 000000000..ca10d8e98
Binary files /dev/null and b/pagefind/index/en_a165622.pf_index differ
diff --git a/pagefind/index/en_a35d28f.pf_index
b/pagefind/index/en_a35d28f.pf_index
deleted file mode 100644
index ea6a5b46e..000000000
Binary files a/pagefind/index/en_a35d28f.pf_index and /dev/null differ
diff --git a/pagefind/index/en_a3bd221.pf_index
b/pagefind/index/en_a3bd221.pf_index
deleted file mode 100644
index a087c9e71..000000000
Binary files a/pagefind/index/en_a3bd221.pf_index and /dev/null differ
diff --git a/pagefind/index/en_aa6e40e.pf_index
b/pagefind/index/en_aa6e40e.pf_index
new file mode 100644
index 000000000..41717a9ed
Binary files /dev/null and b/pagefind/index/en_aa6e40e.pf_index differ
diff --git a/pagefind/index/en_bf9ce96.pf_index
b/pagefind/index/en_bf9ce96.pf_index
new file mode 100644
index 000000000..d842b186b
Binary files /dev/null and b/pagefind/index/en_bf9ce96.pf_index differ
diff --git a/pagefind/index/en_cbd6dba.pf_index
b/pagefind/index/en_cbd6dba.pf_index
new file mode 100644
index 000000000..41a1e4887
Binary files /dev/null and b/pagefind/index/en_cbd6dba.pf_index differ
diff --git a/pagefind/index/en_cefee99.pf_index
b/pagefind/index/en_cefee99.pf_index
new file mode 100644
index 000000000..367366200
Binary files /dev/null and b/pagefind/index/en_cefee99.pf_index differ
diff --git a/pagefind/index/en_d116feb.pf_index
b/pagefind/index/en_d116feb.pf_index
deleted file mode 100644
index 159a16a42..000000000
Binary files a/pagefind/index/en_d116feb.pf_index and /dev/null differ
diff --git a/pagefind/index/en_d250972.pf_index
b/pagefind/index/en_d250972.pf_index
new file mode 100644
index 000000000..4c98f33b6
Binary files /dev/null and b/pagefind/index/en_d250972.pf_index differ
diff --git a/pagefind/index/en_d92ee7a.pf_index
b/pagefind/index/en_d92ee7a.pf_index
new file mode 100644
index 000000000..5bf094205
Binary files /dev/null and b/pagefind/index/en_d92ee7a.pf_index differ
diff --git a/pagefind/index/en_dc4acdc.pf_index
b/pagefind/index/en_dc4acdc.pf_index
deleted file mode 100644
index 07ad84fd8..000000000
Binary files a/pagefind/index/en_dc4acdc.pf_index and /dev/null differ
diff --git a/pagefind/index/en_dcd497d.pf_index
b/pagefind/index/en_dcd497d.pf_index
deleted file mode 100644
index a13159a45..000000000
Binary files a/pagefind/index/en_dcd497d.pf_index and /dev/null differ
diff --git a/pagefind/index/en_ea6bcaf.pf_index
b/pagefind/index/en_ea6bcaf.pf_index
deleted file mode 100644
index eefb2a2d5..000000000
Binary files a/pagefind/index/en_ea6bcaf.pf_index and /dev/null differ
diff --git a/pagefind/index/en_ec14c92.pf_index
b/pagefind/index/en_ec14c92.pf_index
new file mode 100644
index 000000000..e44bee362
Binary files /dev/null and b/pagefind/index/en_ec14c92.pf_index differ
diff --git a/pagefind/index/en_ed678ae.pf_index
b/pagefind/index/en_ed678ae.pf_index
deleted file mode 100644
index 12b490bd3..000000000
Binary files a/pagefind/index/en_ed678ae.pf_index and /dev/null differ
diff --git a/pagefind/index/en_f1cb59b.pf_index
b/pagefind/index/en_f1cb59b.pf_index
deleted file mode 100644
index f77115405..000000000
Binary files a/pagefind/index/en_f1cb59b.pf_index and /dev/null differ
diff --git a/pagefind/index/en_fd59e59.pf_index
b/pagefind/index/en_fd59e59.pf_index
new file mode 100644
index 000000000..45edaafc4
Binary files /dev/null and b/pagefind/index/en_fd59e59.pf_index differ
diff --git a/pagefind/index/en_fdcdb3f.pf_index
b/pagefind/index/en_fdcdb3f.pf_index
new file mode 100644
index 000000000..e77d5da79
Binary files /dev/null and b/pagefind/index/en_fdcdb3f.pf_index differ
diff --git a/pagefind/pagefind-entry.json b/pagefind/pagefind-entry.json
index e921716bc..f0b66c0ee 100644
--- a/pagefind/pagefind-entry.json
+++ b/pagefind/pagefind-entry.json
@@ -1 +1 @@
-{"version":"1.4.0","languages":{"en":{"hash":"en_55db2bac82","wasm":"en","page_count":189}},"include_characters":["_","‿","⁀","⁔","︳","︴","﹍","﹎","﹏","＿"]}
\ No newline at end of file
+{"version":"1.4.0","languages":{"en":{"hash":"en_27a3fff4fd","wasm":"en","page_count":189}},"include_characters":["_","‿","⁀","⁔","︳","︴","﹍","﹎","﹏","＿"]}
\ No newline at end of file
diff --git a/pagefind/pagefind.en_27a3fff4fd.pf_meta
b/pagefind/pagefind.en_27a3fff4fd.pf_meta
new file mode 100644
index 000000000..deaee567e
Binary files /dev/null and b/pagefind/pagefind.en_27a3fff4fd.pf_meta differ
diff --git a/pagefind/pagefind.en_55db2bac82.pf_meta
b/pagefind/pagefind.en_55db2bac82.pf_meta
deleted file mode 100644
index 66fa41a5c..000000000
Binary files a/pagefind/pagefind.en_55db2bac82.pf_meta and /dev/null differ
diff --git a/sitemap.xml b/sitemap.xml
index f2bda73ed..6d23ba9ee 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1,6 +1,8 @@
<?xml version="1.0"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9
http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd";>
<url>
+
<loc>https://sling.apache.org/documentation/bundles/apache-sling-eventing-and-job-handling.html</loc><lastmod>2025-08-19</lastmod>
+ </url><url>
<loc>https://sling.apache.org/releases.html</loc><lastmod>2025-09-10</lastmod>
</url><url>
<loc>https://sling.apache.org/documentation/development/sling-mock.html</loc><lastmod>2025-07-31</lastmod>
@@ -364,8 +366,6 @@
<loc>https://sling.apache.org/documentation/bundles/content-loading-jcr-contentloader.html</loc><lastmod>2025-04-16</lastmod>
</url><url>
<loc>https://sling.apache.org/documentation/bundles/commons-html-utilities.html</loc><lastmod>2019-07-18</lastmod>
- </url><url>
-
<loc>https://sling.apache.org/documentation/bundles/apache-sling-eventing-and-job-handling.html</loc><lastmod>2025-03-05</lastmod>
</url><url>
<loc>https://sling.apache.org/documentation.html</loc><lastmod>2025-04-16</lastmod>
</url><url>
