This topic outlines how to create a cleanup policy. You create a cleanup policy to delete unintended Release Bundle V2 in Artifactory.
To create a Release Bundle V2 Cleanup Retention policy, follow these steps:
As per the User persona, you can work with the contexts as described below:
Global Context
Note
Applies to Platform Admin only.
From the Projects drop-down list, click All Projects.
From the Administrator module, click Artifactory Settings, and then click Retention Policies.
The Retention Policies page appears.
Project Context
Note
Applies to both Platform Admin and Project Admin.
From the Projects drop-down list, choose the desired project.
From the Administrator module, click Artifactory, and then click Retention Policies.
The Retention Policies page appears.
In the Retention Policies page, from the Create Policy drop-down list, click Cleanup Policy:
In the Create New Cleanup Policy page, select Release Bundle V2.
Configure the following in the Create New Cleanup Policy page:
Field
Description
Policy Name
Enter a unique and meaningful name for the policy.
Description
Enter information regarding why this policy was created, and details that help users understand its configuration.
Policy Scope
Define which Release Bundle versions should be deleted
Include Projects / Include All Projects
Note
This setting is applicable only at the global level for Platform Admins. It does not appear when creating a policy at the project level. When this setting is visible, it is mandatory.
Select the projects where you want the policy to apply, or choose Include All Projects to run the policy across all projects on the platform. You can also select Unassigned Repositories to apply the policy to repositories not linked to any projects.
Include Release Bundles
Select one or more of the Release Bundles you want to delete.
Policy Conditions
Define under what conditions the cleanup policy removes Release Bundles versions
Release Bundle Versions Older Than
Apply the number of months/years for the older Release Bundles.
Not Promoted To Environments
Select one or more of the environments the release bundles are not promoted to.
Note
Select Exclude Release Bundles that have been promoted to any environment to exclude them from deletion.
Additional Settings
Cron Expression
Use a cron expression to set a schedule for policy execution. If left empty, the policy can only be Run Cleanup Policy Manually manually.
For example, 0 0 2 * * ? executes the policy every day at 02:00 AM. We recommend tuning it to run on off-hours.
Note
The minimum interval between policy runs is 6 hours. Scheduling a policy to run at intervals shorter than this will result in an error when saving the policy.
Max Run Duration
This setting limits the maximum duration the policy can run when enabled. The maximum allowed duration is 5 hours.
Note
The policy stops before the completion of the run if it exceeds the applied run duration. In one run, within this duration, it deletes all or part of your release bundles V2 depending on the size and number of items. If there are any pending release bundles v2 to be deleted, they are deleted incrementally in the next scheduled run and the subsequent runs.
Click Save to save the policy.
The newly created cleanup policy appears in the Policies list and executes on the scheduled date and time.
Perform Dry Run Cleanup Policy: This feature allows you to see which items would be deleted without actually deleting them. We recommend performing a dry run and reviewing the results before enabling a policy.
Enable/Disable Cleanup Policy: The policy must be enabled to run automatically according to the schedule or Run Cleanup Policy Manually manually.