Most of the properties for classes control what kinds of project
data are deleted and under what conditions they are deleted.
The system checks for jobs to delete at an interval defined by the Purge
Check Time system setting, which defaults to 15 minutes.
Note: You can also use schedules to denote when purges should be performed,
so that the system does not try to run purges when the system is otherwise
occupied. You can use this feature to have purges occur only at night, or
once a week, for example. See
Scheduling Purges.
Delete Files: Determines what kinds of data are deleted. It has
the following options:
- Everything
- Deletes all information about the job from the database and deletes the
job directory from the server(s) that ran it.
- Console Data
- Deletes all information about the job from the database, but leaves the
job directory on the server intact.
- Logs And Files
- Deletes the job directory and the logs, but retains step pass/failure
information on the page.
- Logs Only
- Deletes only the job logs.
- Files Only
- Deletes the job directory on the server(s) that ran the job. Logs and
some other information (such as step pass/fail status) remain within the database;
the job record moves to the page.
Days: The number of days old a job must be before it is deleted.
Count: The maximum number of jobs allowed. When the number of jobs
exceeds the Count value, the system schedules purge jobs to delete the extra
builds. The default value, Unlimited, prevents the system from deleting jobs
because of the number of jobs that exist.
Note:The system deletes jobs when either the Days or Count
values are exceeded. For example, if you have Count set to 10 and Days set
to 2, and there are 8 jobs, but 3 are more than 2 days old, those three jobs
would be deleted. Similarly, if you had 12 jobs, all less than 2 days old,
the two oldest jobs would be deleted.
Which: The Which property sets additional conditions that must be
met before a job can be deleted. It has the following options:
- Any Build
- When this option is selected, the Which property has no effect on job
deletion.
- Only Failed
- The system deletes only failed jobs.
- Only Passed
- The system deletes only passed jobs.
- Keep 1 Pass
- The system always retains the most recent passed job, even if it meets
other deletion criteria.