Migrating an SVN Code Repository

1. Use TortoiseSVN to download the repository to be migrated to the local computer.
2. Go to the local SVN repository (KotlinGallery in this example) and run the following command on the Git Bash client:

   svn log --xml | grep "^<author" | sort -u | \awk -F '<author>' '{print $2}' | awk -F '</author>' '{print $1}' > userinfo.txt

   After the command is executed, the userinfo.txt file is generated in the KotlinGallery directory, as shown in the following figure.

   

3. Open the userinfo.txt file. You can view the information about all committers who have committed code to the repository in the file.
4. Git uses an email address to identify a committer. To better map the SVN repository information to a Git repository, create a mapping between the SVN and Git usernames.

   Modify userinfo.txt so that in each line, SVN author = Git author nickname <email address >. The following figure shows the mapping format.

   

1. Run the git init command to create an empty Git repo directory on the local PC.
2. Copy the userinfo.txt file in step 1 to the directory and run the following command to switch to the directory:

   cd Destination directory address
3. Start the Git Bash client in the directory and run the following command to clone a Git repo:

   git svn clone <svn_repository_address> --no-metadata --authors-file=userinfo.txt --trunk=trunk --tags=tags --branches=branches

   The following table lists parameters in the command. Set the parameters as required.

   Parameter	Description
   --no-metadata	Indicates that the SVN metadata is not imported to the Git repo. In this way, the size of the Git code repo is reduced, but some SVN historical information may be lost.
   --authors-file=userinfo.txt	Indicates that the specified user information file is used for author information mapping.
   --trunk=trunk	Indicates that the trunk branch in SVN repo is used as the main branch of Git code repo.
   --tags=tags	Indicates that the tags directory in the SVN code repo is used as the tag of the Git code repo.
   --branches=branches	Indicates that the branches directory in the SVN code repo is used as the branch of the Git code repo.

   After the command is executed successfully, a Git code repo named KotlinGallery is generated locally.

   

4. Run the following commands to go to the KotlinGallery folder and verify the current Git repository branch structure:

   cd KotlinGallery
   git branch -a

   

   As shown in the preceding figure, all directory structures in the SVN are successfully migrated in the form of Git branches.

Therefore, before uploading tags to CodeArts Repo, adjust the local branches to comply with the Git usage specifications.

1. Go to the local Git repository and run the following commands on the Git Bash client to change the tags branch to appropriate Git tags:

   cp -Rf .git/refs/remotes/origin/tags/* .git/refs/tags/
   rm -Rf .git/refs/remotes/origin/tags
   git branch -a
   git tag

   

2. Run the following commands to change the remaining indexes under refs/remotes to local branches:

   cp -Rf .git/refs/remotes/origin/* .git/refs/heads/
   rm -Rf .git/refs/remotes/origin
   git branch -a
   git tag

   

3. Run the following commands to merge the trunk branch into the master branch and delete the trunk branch:

   git merge trunk
   git branch -d trunk
   git branch -a
   git tag

   

1. Set the SSH key of the code repo. For details, see Configuring the SSH Key.
2. Go to the CodeArts Repo homepage, click New Repository, and select an existing project from the Project drop-down list box or create a project.
3. Set Repository Type to Common, enter related parameters, deselect Generate README and set .gitignore Programming Language to create a code repository. The homepage of the code repository is displayed.
4. Choose Clone/Download > Clone with HTTPS in the upper right corner and copy the HTTPS address.
5. Run the following command to associate the local code repo with CodeArts Repo and push the master branch to the code repo of CodeArts Repo: When running commands, enter the HTTPS account and password of CodeArts Repo.

   git remote add origin HTTPS address of the new code repo
   git push --set-upstream origin master

   After the push is successful, go to the code repo homepage and choose Code > Branches to view the master branch in the current code repo.

6. Run the following command to push other local branches to CodeArts Repo:

   git push origin --all

   After the push is successful, go to the code repo homepage and choose Code > Branches. The r1.1_hotfix branch is added to the code repo.

7. Run the following command to push tags from the local host to CodeArts Repo:

   git push origin --tags

   After the push is successful, go to the code repo homepage and select the code > Tags. The r1.0 and r1.1 tags exist in the code repo.