Automated Package Unretirement Process

This is a Standard Operating Procedure document that outlines what steps Release Engineering must do in order to automatically unretire a package.

It is NOT intended for package maintainers.

If you are a package maintainer that would like to claim a package that has been retired please refer to this document instead:

https://docs.fedoraproject.org/en-US/package-maintainers/Package_Retirement_Process/#claiming

Description

Sometimes a packager might request (via opening a ticket) that we unretire a package branch that has previously been retired.

Unretirement requests can be processed automatically using the fedpkg tool. This is often the most efficient way to handle standard requests compared to a manual repository manipulation.

Actions

Validating the Package Branch

Before running any unretirement commands, ensure the following conditions are met: . Ensure the branch actually exists on dist-git. . Verify that the branch is currently blocked in Koji.

Running the Unretirement Command

Run the unretirement command:

$ fedpkg request-unretirement

This command takes a number of arguments. To view all of them and understand what arguments are required in your specific case, run:

$ fedpkg request-unretirement -h

After processing, this command will provide a URL for your request ticket. Follow this ticket for further information about the status of the automated unretirement.

Rawhide Branches: If requesting the rawhide branch, it should have f + number of the Rawhide release as a script argument.
Assigning Maintainers: To assign a specific person to the package, you need to add the --user FAS_MAINTAINER argument. For example: fedpkg --user FAS_MAINTAINER request-unretirement
Providing Branches: When requesting multiple branches, they should be space-separated (e.g., --branches f39 f40 rawhide), NOT comma-separated.

Full Command Example

A comprehensive request that specifies the repository, namespace, bug ID (needed if retired >8 weeks), and space-separated branches looks like this:

$ fedpkg request-unretirement --repo REPO_NAME --namespace NAMESPACE --bz_bug_id 1234567 --branches f39 f40

Unblock The Package In Koji

Currently, the fedpkg request-unretirement command will not unblock tags on Koji. You must manually perform the following steps to finish the process.

Check the current state of the tags.

$ koji list-pkgs --show-blocked --package PACKAGE_NAME

Unblock each requested tag.

$ koji unblock-pkg TAG_NAME PACKAGE_NAME

Untag all of the builds for each tag that was unblocked.
```
$ koji untag-build --all TAG_NAME PACKAGE_NAME --force
```

Resources

Want to help? Learn how to contribute to Fedora Docs ›