Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Purge Settings define the configuration parameters to manage the archiving and purging of FlexDeploy execution data from the database repository, and purging of the artifacts stored in the artifacts repository.

Image RemovedImage Added

PropertyDescription

Purge Enabled

Indicates whether the purge process is enabled

Retention Days (Operational)

How many days of execution data to keep in the operational tables

Retention Days (Artifacts)

How many days of artifacts to keep in the file system

Keep Count

How many project versions to keep for each environment/instance regardless of Retention Days (Operational)

Keep Success Count

How many successful project version builds to keep regardless of Retention Days (Operational) (Note: this is a global setting and not specific to an environment/instance)

Keep Failed Count

How many failed project version builds to keep regardless of Retention Days (Operational) (Note: this is a global setting and not specific to an environment/instance)

Retention Days (Archive)

How many days of execution data to keep in the archive tables

Retention Days for LogsHow many days of execution data to keep in the log tables
Number of successful pipeline executions to keepNumber of successful of running pipeline executions to keep in operational tables.
Number of unsuccessful pipeline executions to keepNumber of aborted, failed , skipped, or out-of-date pipeline executions to keep in operational tables.

Purge Rules

  • Any workflow execution that is the last successful deployment to an environment is automatically excluded from the purge.
  • The three KEEP related parameters override the DAYS parameter (i.e. if Retention Days (Operational) is 1 day, anything that was deployed more than 1 day ago AND is one that needs to be kept to satisfy the KEEP parameters will be excluded from the archive/purge).
  • The Retention Days (Artifacts) only affects the removal of the artifacts from the file system. There is no archive of artifacts. The KEEP parameters will again override the artifact retention days. When the artifacts have been purged, a red circle will appear on the project version (as shown in figure 17.28) indicating that the artifacts have been purged. This project version will also no longer be available to deploy to any environment. To redeploy this version, the version of the source would need to be retrieved from source code repository (like SVN) in use and taken through the build/deploy cycle again.
  • The Retention Days are based on the first date it finds in this sequence: End time of the workflow execution, start time of the workflow execution, created time of the workflow execution, requested start time of the workflow request, or the created time of the workflow request.


Examples of configuring the purge

Scenario 1: Retain the last 3 successful builds in each environment/instance and keep the last 12 successful builds and last 2 failed builds overall. Artifacts will be purged from the file system after 15 days and execution data will be archived after 30 days. Data will remain in the archive for 365 days.

...

Expand
titleClick to show properties


PropertyValue
Retention Days (Operational)60
Retention Days (Artifacts)60
Keep Count2
Keep Success Count2
Keep Failed Count1
Retention Days (Archive)60
Retention Days for Logs60


Understanding the purge KEEP parameters


Section


Column
width15%

Project Deployments:

EnvironmentDEVQA

PROD

Project Versionsv9 (Failed)


v10v10v10

 v11  v11  v11 

 v12  v12  v12 

v13v13

 v14  v14 

v15v15

v16


v17


v18 (Failed)


v19



Column

Properties:

PropertyValueVersions Retained due to property value
Keep Count2v11, v12, v14, v15, v17, v19
Keep Success Count4v15, v16, v17, v19
Keep Failed Count1v18
DEPLOYED TO AN ENVIRNOMENTAUTOMATICv12, v15, v19



...