What would be the best way to migrate an existing GitLab instance (7.3) to the latest (8.x)?
I am only interested in the contents, no the actual repository, as it can be easily reused.
What path should I take? Any pitfalls along the way?
It doesn’t seem that very many people care about upgrades from v7, or have never done them. Are you using omnibus or non-omnibus install? Ubuntu? Fedora? What? Maybe people will have specific ideas that are relevant to you, if you’re specific too.
If it was me, I would just take a VM snapshot and do it. If I wasn’t using a VM, I’d make a backup. Then I’d just do it.
Please find steps for the upgrade, this approach is a tested one.
Few things to be noted before embarking on the Upgrade.
The upgrade is a big leap from 7.x to 8.8.0 (latest version) There are a lot of changes between 7.x to 8.8 U can see the Change Log
Multiple steps are need to upgrade to latest, direct upgrade is not possible.
Gitlab backup can be restored on the same version of Gitlab version. Eg: 7.1 backup will go in to 7.1 only, not on 7.2.
I recommend you take a backup before you embark on the upgrade from 7.x to 8.8 (latest)
Assuming you are on 7.1, direct upgrade from 7.1 to 8.8 or any 8.x might not be successful, earlier people have faced DB migration failing, to avoid this you need to take a few steps Please find them below
Upgrade
Gitlab 7.1 to Gitlab 7.4
Gitlab 7.4 to Gitlab 7.6
Gitlab 7.6 to Gitlab 8.0
Gitlab 8.0 to Gitlab 8.5 (optional , u can skip this step if you like and upgrade from 8.0 to 8.8)
Gitlab 8.5 to Gitlab 8.8
(try to solve all issues before progressing to next step of upgrade, U can ignore the hooks and other simple errors which come in the rake tests)
Configure your HTTPS/LDAP etc if needed.
I suggest you to try this on a test server and then do this upgrade on the actual server. Please feel free to post any issue which you encounter during/post upgrade.