A mandate from the powers above has been given to we mortals: Pack up your tools, your loved ones, your animals; Prepare for a perilous pilgrimage, and settle upon the promised land to the east whereupon the Great GitLab will rain gold upon the unwashed Gerrit masses.
1. Follow the guide at https://www.mediawiki.org/wiki/GitLab/Hosting_a_project_on_GitLab#Migrating_a_project
2. Port over any CI into Gitlab's CI. Use [[ https://wikitech.wikimedia.org/wiki/Blubber | Blubber ]] and [[ https://gitlab.wikimedia.org/repos/releng/kokkuri | Kokkuri ]]
3. Create GitLab MRs to mirror any still-open Gerrit CRs
4. Remove any existing Jenkins CI for the project
5. Set the Gerrit repository as read-only via "General→State" so as not to confuse anyone. Add a link to the description of the project pointing any perusers to its new home.
6. After migration, search for and update any documentation or code that references the old repository location. [[ https://codesearch.wmcloud.org | codesearch.wmcloud.org ]] is a useful tool.
| Archived gerrit repository URL | New GitLab repository URL |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/coredns | https://gitlab.wikimedia.org/repos/sre/coredns |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/dnsdist | https://gitlab.wikimedia.org/repos/sre/dnsdist |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/gdnsd | https://gitlab.wikimedia.org/repos/sre/gdnsd |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/pdns-recursor | https://gitlab.wikimedia.org/repos/sre/pdns-recursor |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/prometheus-pdns-exporter | https://gitlab.wikimedia.org/repos/sre/prometheus-pdns-exporter |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/prometheus-pdns-rec-exporter | https://gitlab.wikimedia.org/repos/sre/prometheus-pdns-rec-exporter |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/prometheus-varnishkafka-exporter | https://gitlab.wikimedia.org/repos/sre/prometheus-varnishkafka-exporter |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/pybal | https://gitlab.wikimedia.org/repos/sre/pybal |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/trafficserver | https://gitlab.wikimedia.org/repos/sre/trafficserver |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/varnish-modules | https://gitlab.wikimedia.org/repos/sre/varnish-modules |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/varnish4 | https://gitlab.wikimedia.org/repos/sre/varnish |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/varnish | https://gitlab.wikimedia.org/repos/sre/varnish-debs |
| https://gerrit.wikimedia.org/r/admin/repos/operations/debs/wikimedia-lvs-realserver | https://gitlab.wikimedia.org/repos/sre/wikimedia-lvs-realserver |
| https://gerrit.wikimedia.org/r/admin/repos/operations/dns | https://gitlab.wikimedia.org/repos/sre/dns |
| https://gerrit.wikimedia.org/r/admin/repos/operations/puppet/varnishkafka | https://gitlab.wikimedia.org/repos/sre/varnishkafka |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/acme-chief | https://gitlab.wikimedia.org/repos/sre/acme-chief |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/fifo-log-demux | https://gitlab.wikimedia.org/repos/sre/fifo-log-demux |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/knead-wikidough | https://gitlab.wikimedia.org/repos/sre/knead-wikidough |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/latency-measurement | https://gitlab.wikimedia.org/repos/sre/pop-latency-measurement |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/liberica | https://gitlab.wikimedia.org/repos/sre/liberica |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/nss-dnsdc | https://gitlab.wikimedia.org/repos/sre/nss-dnsdc |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/purged | https://gitlab.wikimedia.org/repos/sre/purged |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish | https://gitlab.wikimedia.org/repos/sre/varnish |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/libvmod-header | https://gitlab.wikimedia.org/repos/sre/libvmod-header |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/libvmod-netmapper | https://gitlab.wikimedia.org/repos/sre/libvmod-netmapper |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/libvmod-querysort | https://gitlab.wikimedia.org/repos/sre/libvmod-querysort |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/libvmod-re2 | https://gitlab.wikimedia.org/repos/sre/libvmod-re2 |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/libvmod-tbf | https://gitlab.wikimedia.org/repos/sre/libvmod-tbf |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/libvmod-uuid | https://gitlab.wikimedia.org/repos/sre/libvmod-uuid |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/libvmod-vslp | https://gitlab.wikimedia.org/repos/sre/libvmod-vslp |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/varnishkafka | https://gitlab.wikimedia.org/repos/sre/varnishkafka |
| https://gerrit.wikimedia.org/r/admin/repos/operations/software/varnish/vhtcpd | https://gitlab.wikimedia.org/repos/sre/vhtcpd |
| Repository | GL CI | Branches/tags migrated | CRs migrated | GL branch protection | Zuul archived | Gerrit archived | Docs updated |
| operations/debs/coredns | N/A | ✓ | ✓ | N/A | | ✓ | ✓ |
| operations/debs/dnsdist | | | | | | | |
| operations/debs/gdnsd | | | | | | | |
| operations/debs/pdns-recursor | | ✓ | ✓ | ✓ | | ✓ | ✓ |
| operations/debs/prometheus-pdns-exporter | N/A | ✓ | ✓ | N/A | | ✓ | ✓ |
| operations/debs/prometheus-pdns-rec-exporter | N/A | ✓ | ✓ | N/A | | ✓ | ✓ |
| operations/debs/prometheus-varnishkafka-exporter | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/debs/pybal | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/debs/trafficserver | | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/debs/varnish-modules | ✓ | ✓ | ✓ | ✓ | | ✓ | |
| operations/debs/varnish4 | | ✓ | ✓ | ✓ | | | |
| operations/debs/varnish | N/A | ✓ | ✓ | N/A | | ✓ | ✓ |
| operations/debs/wikimedia-lvs-realserver | | | | | | | |
| operations/dns | | | | | | | |
| operations/puppet/varnishkafka | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/software/acme-chief | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/software/fifo-log-demux | ✓ | ✓ | ✓ | N/A | ✓ | ✓ | ✓ |
| operations/software/knead-wikidough | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/software/latency-measurement | N/A | ✓ | ✓ | ✓ | N/A | ✓ | ✓ |
| operations/software/nss-dnsdc | N/A | ✓ | ✓ | ✓ | N/A | ✓ | ✓ |
| operations/software/purged | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/software/varnish* | N/A | N/A | N/A | N/A | N/A | N/A | N/A |
| operations/software/varnish/libvmod-header | N/A | ✓ | ✓ | N/A | | | ✓ |
| operations/software/varnish/libvmod-netmapper | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/software/varnish/libvmod-querysort | | ✓ | ✓ | ✓ | | | |
| operations/software/varnish/libvmod-re2 | ✓ | ✓ | ✓ | ✓ | | ✓ | ✓ |
| operations/software/varnish/libvmod-tbf | N/A | ✓ | ✓ | N/A | | | ✓ |
| operations/software/varnish/libvmod-uuid | N/A | ✓ | ✓ | N/A | | | ✓ |
| operations/software/varnish/libvmod-vslp | N/A | ✓ | ✓ | N/A | | | ✓ |
| operations/software/varnish/varnishkafka | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| operations/software/varnish/varnishkafka/testing | | | | | ✓ | | |
| operations/software/varnish/vhtcpd | N/A | N/A | N/A | N/A | | | N/A |
* The "operations/software/varnish" repository is empty and can simply be ignored