How to delete outdated chroots¶
All of these tasks are automatized for the main Copr instance in Fedora. This page might be rather useful for maintainers of other instances or developers enhancing this feature.
Please read Outdated chroots removal policy to see how the deletion of outdated chroots work from the user perspective.
This article explains how to mark a chroot as outdated, how to notify project owners, that some of their chroots are outdated and going to be deleted in the future, and lastly how to actually delete them.
Mark chroot as outdated¶
copr-frontend alter-chroot --action eol fedora-25-x86_64
It doesn’t matter whether the chroot is currently activated or deactivated, using
always deactivates it. More importantly, for every related
CoprChroot it generates a
saying when the copr chroot should be deleted.
Notify project admins¶
delete_after is set, the notification command starts to notice such copr chroot. The following command
prints to the stdout a list of people and about what they should be notified. Please be aware, that not only
project owners are going to be notified, but rather all project admins.
copr-frontend notify-outdated-chroots --dry-run
When working on a non-production instance and wanting to really send the emails, filter the recipients to just yourself or team members. Any real users shouldn’t be contacted from devel instances!
copr-frontend notify-outdated-chroots --dry-run -e email@example.com
If this command prints that it would notify just the expected people (which were specified with the
then it is safe to run it without
copr-frontend notify-outdated-chroots -e firstname.lastname@example.org
When the notification about a particular copr chroot is sent and then the
is executed again, it will not send the notification for the second time. It is designed to be daily executed via Cron
and it needs to avoid spamming the people over and over again. Therefore when a notification is sent, a timestamp when
to send a next one is stored to the
delete_notify column. In a case that this logic needs to be suppressed,
--all parameter. Then notifications are going to be sent regardless of the previous notification.
Delete the data¶
delete_after timestamp is reached, the particular copr chroot should be deleted. To print
all the chroots for which this applies, use this command.
copr-frontend delete-outdated-chroots --dry-run
To really delete them (i.e. creating an action which will delete the chroot directory on the backend),
run the command without
When deleting the chroot (creating an action to delete the data on the backend), the
delete_notify columns are set to NULL and therefore
delete-outdated-chroots commands don’t see the chroot anymore.
This whole article is mainly for understanding how notifications and deletion of outdated
chroots work in order to debug or rework it. The only thing, that Copr administrator needs
to do manually is Mark chroot as outdated, everything else is achieved by a daily
cron script. See