Merge branch 'baserock/pedroalvarez/old-jobs-removal'

Reviewed-by: Richard Maw
Reviewed-by: Pedro Alvarez

1 files changed, 15 insertions, 1 deletions

diff --git a/ARCH b/ARCH
index a815c99..6eb8376 100644
--- a/ARCH
+++ b/ARCH
@@ -282,9 +282,12 @@ Running job management:
   MINION gets around to it.) This request returns as soon as the
   STATEDB change is done.
 
-* `GET /1.0/list-all-jobs` causes WEBAPP to return a JSON list of ids
+* `GET /1.0/list-jobs` causes WEBAPP to return a JSON list of ids
   of all jobs, running or finished, that it knows about. (RQ/ALLJOBS)
 
+* `GET /1.0/list-jobs-html` is the same as `list-jobs`, but returns an
+  HTML page instead.
+
 * `POST /1.0/remove-job` with `job_id=jobid` in the body, removes a
   stopped job from the state database.
 
@@ -369,6 +372,17 @@ The MINION
   to WEBAPP.
 * Go back to top to request new job.
 
+
+Old job removal
+---------------
+
+To avoid the STATEDB filling up with logs of old jobs, a systemd timer
+unit will run occasionally to remove jobs so old, nobody cares about
+them anymore. To make it easier to experiment with the logic of
+choosing what to remove (age only? keep failed ones? something else?)
+the removal is kept outside the WEBAPP.
+
+
 STATEDB
 -------