From 738054fbfb19dae1f3d5a9c57272d61bc63e4916 Mon Sep 17 00:00:00 2001 From: Robert Marshall Date: May 04 2017 20:51:44 +0000 Subject: WIP: updating EOL SOP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP DO NOT MERGE THIS WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP WIP --- diff --git a/docs/source/sop_end_of_life.rst b/docs/source/sop_end_of_life.rst index 3f42897..e1ac2da 100644 --- a/docs/source/sop_end_of_life.rst +++ b/docs/source/sop_end_of_life.rst @@ -17,7 +17,7 @@ Actions Set date -------- -* Releng responsibilities: +* Release Engineering responsibilities: * Follow guidelines of `maintenance schedule`_ * Take into account any infrastructure or other supporting project resource contention @@ -31,28 +31,74 @@ Reminder announcement Koji tasks ---------- -* disable builds by removing targets +#. Disable builds by removing targets - :: + :: + + $ koji remove-target f19 + $ koji remove-target f19-updates-candidate + +#. Log into compose-backend + + :: + + $ ssh -A compose-x86-01.phx2.fedoraproject.org + +#. Obtain the ``koji-cleanedup-signed.py`` script from releng repository + + The first time any user account signs packages the releng git repository + must be cloned. + + :: + + $ git clone ssh://git@pagure.io/releng.git + + Enter the releng directory. + + :: + + $ cd releng + + If the clone step above was not required then fully update the existing + repository checkout from pagure. + + :: + + $ git fetch origin + $ git checkout master + $ git pull origin master - koji remove-target f19 - koji remove-target f19-updates-candidate +#. Locate New End-of-Life GPG Keys -* Purge from disk the signed copies of rpms that are signed with the EOL'd - release key + Navigate to the `obsolete signing keys`_ page and manually check for any + missing obsoleted GPG keys and add them to the script ``koji-cleanedup-signed.py``. + +#. Purge all rpms signed with an EOL release key from disk + + :: + + koji-cleanedup-signed.py Bodhi tasks ----------- -* Run the following end of life script from bodhi backend - :: - bodhi-manage-releases edit --name F21 --state archived +#. Remote to the bodhi backend + + :: + + $ ssh -A bodhi-backend01.phx2.fedoraproject.org + +#. Run the following end of life script from bodhi backend + + :: + + $ bodhi-manage-releases edit --name F21 --state archived PackageDB --------- Set the release to be End of Life in the PackageDB. A admin can login and do -this from the web interface. +this from the web interface. This sends a notification via fedmsg. Source Control (git) -------------------- @@ -61,6 +107,8 @@ Source Control (git) the Fedora X+2 release. New builds are no longer allowed for EOL Fedora releases. +* STUB: TODO: how to toggle flag in pkgdb + Fedora Program Manager Tasks ---------------------------- @@ -102,7 +150,11 @@ Badges tasks Cloud tasks ----------- +* STUB: TODO: + * something with fedimg + * complaints filed when EOL Cloud images removed to archives + * what else? .. note:: FIXME: This needs updating, I'm pretty sure we need to do something with fedimg here @@ -152,8 +204,58 @@ Update eol wiki page https://fedoraproject.org/wiki/End_of_life update with release and number of days. +Archiving the Release +--------------------- +The following locations should be archived by hardlinking the individual files +to the archive location. + +* Primary Architectures + + * ``/pub/fedora/linux/core/[release_version]`` to ``/pub/archive/fedora/linux/core/[release_version]`` + * ``/pub/fedora/linux/development/[release_version]`` to ``/dev/null`` + * ``/pub/fedora/linux/extras/[release_version]`` to ``/pub/archive/fedora/linux/extras/[release_version]`` + * ``/pub/fedora/linux/releases/[release_version]`` to ``/pub/archive/fedora/linux/releases/[release_version]`` + * ``/pub/fedora/linux/updates/[release_version]`` to ``/pub/archive/fedora/linux/updates/[release_version]`` + +* Secondary Architectures `/pub/fedora-secondary/releases/[release_version]` + + * ``/pub/fedora-secondary/linux/development/[release_version]`` to ``/dev/null`` + * ``/pub/fedora-secondary/linux/releases/[release_version]`` to ``/pub/archive/fedora-secondary/linux/releases/[release_version]`` + * ``/pub/fedora-secondary/linux/updates/[release_version]`` to ``/pub/archive/fedora-secondary/linux/updates/[release_version]`` + +* Cloud & Lab Releases `/pub/alt/releases/[release_version]` + + * ``/pub/alt/releases/[release_version]`` to TODO?? + * TODO: Any other locations to archive? + * It's known that Cloud/Atomic can't be truly "archived" yet due to concerns + were made known but it is no longer recorded which parties asked for no archival + +Removing the Torrents +--------------------- +#. Log into torrent server + + :: + + $ ssh -A torrent.fedoraproject.org + +#. Navigate to the directory where torrents are stored + + :: + + $ cd /srv/torrent/btholding + +#. Clean out End-of-Life Torrents + + Remove all directories and files related to the End-of-Life release. This is not + currently scripted or automated. + + Verification ============ +* STUB: TODO: How much verification is enough? +* STUB: TODO: Who should be involved, this sounds like a conversation for a brief + meeting eg: are we only verifiying rel-eng work (since other sections here + reference non-rel-eng tasks) or more than that? .. note:: FIXME: This section needs some love @@ -172,3 +274,5 @@ Consider Before Running https://pagure.io/fedora-badges-assets/blob/master/f/rules/you-can-pry-it-from-my-cold-undead-hands.yml .. _File Taskotron ticket: https://phab.qadevel.cloud.fedoraproject.org/maniphest/task/edit/form/default/?title=release%20is%20EOL&priority=80&tags=libtaskotron +.. _obsolete signing keys: + https://getfedora.org/keys/obsolete.html