Merge ~ubuntu-release/ubuntu-release-tools/+git/templates:huge-items-to-checklist into ~ubuntu-release/ubuntu-release-tools/+git/templates:main

[Brian Murray]

The task list used to have this comment "Required steps (this could be a checklist, but items are quite 'huge')", however I think this is actually an argument for having a checklist because the checklist will help you keep track of where you are! So I made the items a checklist so the person assigned the card can document their progress in the card rather than somewhere else.

[Steve Langasek (vorlon)]

LGTM.

I should not be trusted to review the yaml syntax and therefore have not attempted to do so.

review: Approve

Unmerged commits

fce6143... by Brian Murray on 2024-02-05

end-of-life: convert huge required steps to a checklist

diff --git a/jira-milestones/end-of-life.yaml b/jira-milestones/end-of-life.yaml
index 9f30389..7ea2068 100644
--- a/jira-milestones/end-of-life.yaml
+++ b/jira-milestones/end-of-life.yaml
@@ -45,11 +45,9 @@
       Refer to the publicly-visible structure on http://old-releases.ubuntu.com/releases/.
       This procedure indicates with some degree of accuracy what steps need to be taken, but anyone following this procedure is strongly advised to use their initiative. 
       In the following instructions, RELEASE should be replaced throughout with the name of the EOLed release. PROJECT is used for flavours of Ubuntu other than Ubuntu itself (e.g. Kubuntu, Edubuntu, etc.).
-
-      Required steps (this could be a checklist, but items are quite 'huge'):
-
-      * Disable mirror syncing: `touch /srv/cdimage.ubuntu.com/etc/STOP_SYNC_MIRRORS`
-      * In /srv/cdimage.ubuntu.com/www/simple/, find all directories named after the EOLed release. In each one:
+    checklist:
+    - Disable mirror syncing: `touch /srv/cdimage.ubuntu.com/etc/STOP_SYNC_MIRRORS`
+    - In /srv/cdimage.ubuntu.com/www/simple/, find all directories named after the EOLed release. In each one:
         * Move all files containing the release number in the adjacent .pool directory to the corresponding .pool subdirectory of /srv/cdimage.ubuntu.com/www/old-releases/ (either .pool or PROJECT/.pool), creating it if necessary.
         * In the target .pool directory, run checksum-directory . /path/to/old/directory, or update checksums manually if necessary (in the latter case, remember to use sign-cdimage on each checksums file).
         * Move all files starting with a lower-case letter to the corresponding subdirectory of /srv/cdimage.ubuntu.com/www/old-releases/ (either RELEASE or PROJECT/RELEASE), creating it if necessary.
@@ -63,20 +61,19 @@
         * Remove the remaining files and symlinks corresponding to the EOLed release from under /srv/cdimage.ubuntu.com/www/simple/. Clean up emptied directories if any.
         * Edit /srv/cdimage.ubuntu.com/www/simple/.htaccess, /srv/cdimage.ubuntu.com/www/simple/.manifest, /srv/cdimage.ubuntu.com/www/simple/.manifest.full  and /srv/cdimage.ubuntu.com/www/simple/HEADER.html (or simple/PROJECT/...) by hand to remove references to the EOLed release.
         * Edit /srv/cdimage.ubuntu.com/www/simple/.htaccess (not PROJECT-specific) to add appropriate RedirectPermanent directives redirecting users to the new URLs. 
-      * Re-enable mirror syncing: `rm /srv/cdimage.ubuntu.com/etc/STOP_SYNC_MIRRORS`
-      * Push to mirrors: `sync-old-releases; sync-mirrors`
+    - Re-enable mirror syncing: `rm /srv/cdimage.ubuntu.com/etc/STOP_SYNC_MIRRORS`
+    - Push to mirrors: `sync-old-releases; sync-mirrors`
   - task: Move any images from cdimage.ubuntu.com to old-images on nusakan and notify IS team for archival
-    description: |
-      Required steps (this could be a checklist, but items are quite 'huge'):
-
-      * Disable mirror syncing: `touch /srv/cdimage.ubuntu.com/etc/STOP_SYNC_MIRRORS`
-      * If /srv/cdimage.ubuntu.com/www/full/netboot/RELEASE/ exists, remove it (it is only an HTML page with links, and does not need to be archived), remove any symlinks to it, and remove references to it from /srv/cdimage.ubuntu.com/www/full/netboot/index.html.
-      * In /srv/cdimage.ubuntu.com/www/full/, find all directories named after the EOLed release which have /releases/ in their path. Each one will have a subdirectory identifying the milestone (e.g. release, release.1, etc.). For each one:
-        * Move the RELEASE directory to the corresponding (i.e. FLAVOR) /releases/ subdirectory of /srv/cdimage.ubuntu.com/old-images/, creating it if necessary.
-        * Remove any remaining files and symlinks corresponding to the EOLed release from under /srv/cdimage.ubuntu.com/www/full/. Clean up emptied directories if any. 
-      * In /srv/cdimage.ubuntu.com/www/torrent/, find all directories named after the EOLed release which have /releases/, /ports/, or /simple/ in their path. Remove these directories.
-      * Re-enable mirror syncing: `rm /srv/cdimage.ubuntu.com/etc/STOP_SYNC_MIRRORS`
-      * Push to mirrors: `sync-mirrors`
+    checklist:
+    - Disable mirror syncing: `touch /srv/cdimage.ubuntu.com/etc/STOP_SYNC_MIRRORS`
+    - If /srv/cdimage.ubuntu.com/www/full/netboot/RELEASE/ exists, remove it (it is only an HTML page with links, and does not need to be archived), remove any symlinks to it, and remove references to it from /srv/cdimage.ubuntu.com/www/full/netboot/index.html.
+    - In /srv/cdimage.ubuntu.com/www/full/, find all directories named after the EOLed release which have /releases/ in their path. Each one will have a subdirectory identifying the milestone (e.g. release, release.1, etc.). For each one:
+      * Move the RELEASE directory to the corresponding (i.e. FLAVOR) /releases/ subdirectory of /srv/cdimage.ubuntu.com/old-images/, creating it if necessary.
+      * Remove any remaining files and symlinks corresponding to the EOLed release from under /srv/cdimage.ubuntu.com/www/full/. Clean up emptied directories if any. 
+    - In /srv/cdimage.ubuntu.com/www/torrent/, find all directories named after the EOLed release which have /releases/, /ports/, or /simple/ in their path. Remove these directories.
+    - Re-enable mirror syncing: `rm /srv/cdimage.ubuntu.com/etc/STOP_SYNC_MIRRORS`
+    - Push to mirrors: `sync-mirrors`
+    - Notify IS team for archival e.g. https://portal.admin.canonical.com/C152695
   - task: Archive the apt archive to old-releases
     description: >
       Even with sign-off from all parties, we typically give a generous grace period between backup and removal, a month for 9mo releases and 6mo for LTS