From 0591d782905af10a8404e6dca70c48c806005c32 Mon Sep 17 00:00:00 2001
From: Fabian Arrotin <arrfab@centos.org>
Date: Mar 24 2022 15:13:30 +0000
Subject: Mirrors management snippet - TBC


Signed-off-by: Fabian Arrotin <arrfab@centos.org>

---

diff --git a/docs/operations/apps/mirrormanagement.md b/docs/operations/apps/mirrormanagement.md
new file mode 100644
index 0000000..360ad00
--- /dev/null
+++ b/docs/operations/apps/mirrormanagement.md
@@ -0,0 +1,37 @@
+# CentOS Mirror managements SOP
+
+Depending on the CentOS version, (8-stream, 7 or 9-stream), yum/dnf repositories on client machines are configured to either use `mirrorlist.centos.org` or `mirrors.centos.org`. 
+`mirrors.centos.org` is an alias to mirrors.fedoraproject.org and so is a MirrorManager instance hosted by Fedora infra team. Let's see which process to follow when we get a ticket  (see [Howto on the wiki](https://wiki.centos.org/HowTos/CreatePublicMirrors) ) to add/remove/modify a mirror entry in corresponding DB.
+
+## CentOS Stream 9
+
+When we get a new request for CentOS Stream 9 mirror, the process goes like this : 
+
+  * ticket is reviewed by infra-and-releng team and tagged with `mirrormanager` label
+  * assignee should : 
+    * verify that mirror isn't located at GeoIP level from an [embargoed country](https://www.centos.org/legal)
+    * verify that provided URLs (http/https and - optional - rsync) are working
+    * follow the link to that mirror in mirrormanager (needs `sysadmin-web` FAS group membership)
+    * add the `CentOS` category and then add the URLs
+    * update ticket with info and close
+
+## CentOS Linux 7 and 8-stream
+
+When we get a new request for CentOS Linux 7 or 8-stream, the process goes like this : 
+
+  * ticket is reviewed by infra-and-releng team and tagged with `mirror-linux` label
+  * assignee should :
+    * verify that mirror isn't located at GeoIP level from an [embargoed country](https://www.centos.org/legal)
+    * verify that provided URLs (http/https and - optional - rsync) are working
+    * update ticket with info and close
+
+
+### Adding new mirror
+To help with these steps, there is a simple wrapper/helper script on the machine behind https://mirror-status.centos.org.
+It will run some pre-flights checks and output the SQL statements to copy/paste into mysql to add the new mirror in mirmon DB.
+
+The process to launch, when one has a shell on the mirmon node, is `/var/lib/centos-mirrors/mirror-geo-check.py`
+Follow the steps and then copy/paste mysql statement into mysql (against mirmon database)
+
+
+### Updating existing mirror
diff --git a/mkdocs.yml b/mkdocs.yml
index 452d6a0..5b9fcc7 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -15,6 +15,7 @@ nav:
      - operations/decommission.md
      - Applications:
        - operations/apps/blog.md
+       - operations/apps/mirrormanagement.md
      - CI Infra:
        - SOP:
          - Installations: