GitLab/Hosting a project on GitLab

WMF Release Engineering is collecting notes here on migrating a project from Gerrit; this may become a basis for automating at least some of this process.

See also: draft.


 * GitLab users are organized in a top-level group called /people. /people should remain a flat namespace. Appropriate people groups include employees of an organization, members of a particular team at an organization, etc. (There are some details yet to be worked out here.)
 * Examples:
 * https://gitlab.wikimedia.org/people/wmf-team-data-engineering
 * https://gitlab.wikimedia.org/people/wmf-team-releng
 * https://gitlab.wikimedia.org/people/wmf
 * https://gitlab.wikimedia.org/people/wmde
 * GitLab projects live in a top-level group at /repos.
 * This gives access to a pool of CI runners.

Sections to develop here:


 * How to request a migration
 * Doing a phab form: https://phabricator.wikimedia.org/transactions/editengine/maniphest.task/view/105/
 * Creating a new /repos group if necessary
 * Group settings
 * Make appropriate people group a member of the project group
 * Creating a new GitLab project
 * Always use  for primary branch
 * Don't use issues
 * Project settings
 * Copying the repo over (including review metadata with ).
 * Archiving the old project on Gerrit
 * Remove from CI
 * Update Phabricator mirroring?
 * Updating external references and docs
 * Mirroring to GitHub
 * Changing remotes on existing clones