These instructions are generally the same whether you’re migrating from gitlab.cels.anl.gov (internal only) or xgitlab.cels.anl.gov (externally accessible).
All accounts on git.cels.anl.gov are tied to your GCE account. If you have non-ANL contributors who want to be able to login and/or contribute code, they will need a collaborator account. Details on that can be found at GCE Accounts.
Important: Until you login at https://git.cels.anl.gov, you don’t have an account on the server.
If it’s important for you that your projects have an accurate history of who owns what contributions and changes, then prior to this migration everyone with an account in your existing project must have an account in GCE, and that the two email addresses match exactly.
All project contributors need to login and check their profile page at https://gitlab.cels.anl.gov/profile and/or https://xgitlab.cels.anl.gov/profile and make note of the email address listed. If it does not match the email address at https://git.cels.anl.gov/profile, then they must adjust accordingly.
- Users with legacy/MCS accounts must visit https://accounts.mcs.anl.gov and adjust their primary email address. See this screenshot for details on what you’ll want to change. Ensure the correct email address is listed and that it is your primary email. Only one address should be listed as primary. Remove irrelevant addresses.
- Important: after changing the address, login/refresh your gitlab profile page (on both servers, if you have accounts on both) to ensure the change is reflected. As long as the correct address is primary, the update was successful.
- Users without legacy accounts using xgitlab.cels.anl.gov can update their email address directly from the xgitlab profile page.
- Any member of the project with a mismatched address will have their changes and contributions attributed to the project owner after migration.
Once all project members who care have confirmed their email addresses match the address on their GCE account, the project owner can migrate the project following the instructions at Gitlab’s site. Those docs reference gitlab.com, but the instructions are the same for self-hosted like ours.
Migrations need to be complete by July 31, 2021. New external xgitlab accounts will not be processed after January 31, 2021. Project creation on gitlab.cels.anl.gov and xgitlab.cels.anl.gov will be frozen on February 15, 2021.
If you would like us to handle the actual migration for you we can do that, however you will still need to work with your project members to ensure they have accounts before the migration. What we are able to do is the steps outlined on Gitlab’s documentation site linked above. If that’s how you want us to proceed, please fill out this form.
If you encounter problems, please reach out to us at firstname.lastname@example.org and we’ll work with you to get it resolved.