将iOS应用源代码从SVN迁移至AWS CodeCommit的方法及路径确认

Great question! Your proposed migration path is totally correct—AWS CodeCommit is a Git-based repository service, so you do need to convert your SVN repo to Git first before moving it over. Let’s walk through the full step-by-step process tailored for your iOS project:

1. Prerequisites to Get Started #

First, make sure you have these tools/permissions in place:

• Git and SVN clients installed on your local machine
• Read (and ideally write) access to your source SVN repository
• An active AWS account with permissions to create/access CodeCommit repositories
• AWS CLI configured on your local machine (we’ll use this for credential setup)

2. Convert Your SVN Repository to a Local Git Repository #

2.1 Map SVN Authors to Git Identities #

SVN uses plain usernames, while Git requires the Name <email> format. Export your SVN author list first:

svn log --xml | grep author | sort -u | awk -F '>' '{print $2}' | awk -F '<' '{print $1}' > authors.txt

Open authors.txt and edit each line to match Git’s format:

svn_username1 = John Doe <john.doe@example.com>
svn_username2 = Jane Smith <jane.smith@example.com>

2.2 Clone SVN Repo to Git #

If your SVN repo uses the standard trunk/branches/tags structure, use this command:

git svn clone --stdlayout --authors-file=authors.txt https://your-svn-repo-url/ios-app local-ios-git-repo

If it’s a flat repo (no trunk/branches/tags), omit the --stdlayout flag:

git svn clone --authors-file=authors.txt https://your-svn-repo-url/ios-app local-ios-git-repo

This will pull all SVN commits and convert them to Git commits, preserving full history.

2.3 Verify the Local Git Repo #

Navigate to the cloned repo and check that everything looks right:

cd local-ios-git-repo
git log  # Confirm commit history and author mappings are correct
ls       # Ensure all iOS project files (like .xcodeproj, source files) are present

3. Set Up Your AWS CodeCommit Repository #

3.1 Create the CodeCommit Repo #

You can do this via the AWS Console or CLI. Using the CLI:

aws codecommit create-repository --repository-name ios-app --repository-description "iOS app migrated from SVN"

Note down the repository URL provided in the output (it’ll look like https://git-codecommit.<region>.amazonaws.com/v1/repos/ios-app).

3.2 Configure Git to Access CodeCommit #

Set up the AWS CodeCommit credential helper so Git can authenticate with AWS:

git config --global credential.helper '!aws codecommit credential-helper $@'
git config --global credential.UseHttpPath true

If you haven’t configured AWS CLI yet, run aws configure first and enter your AWS access key ID, secret access key, default region, and output format.

4. Push Local Git Repo to AWS CodeCommit #

4.1 Add CodeCommit as a Remote #

Link your local Git repo to the CodeCommit repository:

git remote add codecommit https://git-codecommit.<region>.amazonaws.com/v1/repos/ios-app

Replace <region> with your AWS region (e.g., us-east-1, eu-west-1).

4.2 Push All Branches and Tags #

First, push your main branch (typically master or main, depending on how Git SVN mapped the trunk):

git push codecommit main

To push all other branches:

git branch -a  # List all local branches
git push codecommit <branch-name>  # Repeat for each branch

Push all tags to preserve SVN tag history:

git push codecommit --tags

5. Validate the Migration #

To ensure everything transferred correctly:

1. Log into the AWS CodeCommit console, navigate to your repo, and check:
   • Commit history matches your local Git repo
   • All branches and tags are present
   • iOS project files are intact
2. Clone the CodeCommit repo to a new local directory to verify:

   git clone https://git-codecommit.<region>.amazonaws.com/v1/repos/ios-app migrated-ios-app
   cd migrated-ios-app
   git log  # Confirm history is complete
   open ios-app.xcodeproj  # Test opening the project in Xcode to ensure no issues
   

Key Notes for iOS Projects #

• Large Repos: If your SVN repo is large (with many commits or large files), the git svn clone step may take time—be patient.
• Submodules: If your iOS project uses SVN submodules, you’ll need to migrate each submodule separately to Git first, then update the main repo’s submodule references.
• Backup: Before starting, consider creating a backup of your SVN repo to avoid data loss.

内容的提问来源于stack exchange，提问作者Ranjitsingh Chandel