Introduction

When migrating to git the app is evaluated against multiple criteria detailed in the document. The primary requirement for retaining version history is that the size of the full SVN repository should be smaller than 3.5 GB. When this limit is exceeded, the migration is performed without history.

In cases where certain branches still need to be retained, this article describes an approach for preserving branches when migrating without history. 

Environment

Version Control

Instructions/Procedure

The following approach is recommended to be first tested on a dummy project to get familiar with the process.

1. For each branch that is to be retained:
   • Check out the SVN branch.
   • Merge in the main branch into the branch - so conflict resolution on this branch (if applicable) will work post-migration.
   • Zip the entire project folder (except the .svn folder). Clearly name this so the branch is recognisable afterwards.
2. Then migrate to Git without history
3. For each branch to be restored (before changing the main branch to a different Mendix version):
   • Create a new branch from the main branch.
   • Overwrite the contents of the project folder (except the .git folder) with the content from the zip.
   • Commit "Branch recreated" and push to server.

Finally, please note that there will be a full SVN backup when migrating without history.

Outcome

This allows the necessary branches to be retained, thereby preserving the part of the history that is required.

Additional information

• Mendix documentation: Migrating to Git