As project might contain some files which size is bigger than 50M or whole project size bigger than 1G, using TFS provided tool might not work to migrate to Git. The following are steps we are going to use to migrate project to Devops.
Instructions
(Please note If you have Chocolatey already installed, you can jump to step 4)
1. Open CMD as administrator
2. run following in cmd shell to install Chocolatey package manager
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
3. run following in cmd shell to test Chocolatey installation
choco
(Please note If you have Git-TFS already installed, you can jump to step 7)
4. run following in cmd shell to install git-tfs through Chocolatey
choco install gittfs
5. Type "Y" when prompt to install any additional toolset.
6. run following in cmd shell to verify git-tfs installation.
git tfs help
7. run following command if want to list all TFS branches that could be cloned (Please be careful to use this command as it might take long time. Also be sure to replace appropriately with your TFS collection information)
git tfs list-remote-branches http://tfsprod:8080/tfs/Marine%20Safety/
Note: %20,in the path string "Marine%20Safety" represents the empty space " " in the path string "Marine Safety"
If you don't see the branch you want to clone, then it probably hasn't been configured as a branch in TFS. You can do this through Visual Studio by right-clicking on the "project" in Source Control Explorer and converting it to a branch:
8.Run following command to clone only latest code. For example: MPDIS-SDDPM (You might need to set up userName and Email for git before clone: git config – global user.name "YourName" ; git config --global user.email "xx.xx@tc.gc.ca"). Go to the next step if you want to keep the full history!
git tfs clone http://tfsprod:8080/tfs/Marine%20Safety/ $/MPDIS-SDDPM_Scrum/DEVELOPMENT/MPDIS-SDDPM c:\tmp\migration\mpdis
Above command clones the tfs repository http://tfsprod:8080/tfs/Marine%20Safety/ $/MPDIS-SDDPM_Scrum/DEVELOPMENT/MPDIS-SDDPM
to a temporary git repository at the given local path c:\tmp\migration\mpdis A temporary git repositoiry gets created at this location.
9. or Run following command to clone all history from TFS for all branches. For example: MPDIS-SDDPM
git tfs clone http://tfsprod:8080/tfs/Marine%20Safety/ $/MPDIS-SDDPM_Scrum/DEVELOPMENT/MPDIS-SDDPM c:\tmp\migration\mpdis --branches=all
If your codebase in TFS has sensitive information (eg. passwords), do not include them in your Azure Devops repository. You can do one of two things:
- Remove them from the codebase, check the changed files back into TFS and then be sure to clone the latest code only (step #8). You will lose all history in this case.
- If you clone all history (as in step #9), the passwords will still be available in the repo history. Remove the culprit files from history as follows:
- In the cmd shell, navigate to your repo's folder (in the above example it was c:\tmp\migration\mpdis).
- (See this page for more detail regarding this step). Run the following making sure to change the path-to-the-file to the actual path to the file (eg. src/web.config): git filter-branch --force --index-filter "git rm --cached --ignore-unmatch path-to-the-file" --prune-empty --tag-name-filter cat -- --all
- You've now removed the culprit files from history. You can re-create and add them to the repository later with sensitive information removed if you'd like.
NOTE: If there is a space in a folder name in path-to-the-file, place a slash"\" before the space. E.g. if the path is My Project/Settings.settings, change it to My\ Project/Settings.settings. Otherwise, the above command does not remove specified file.
10. Check history:
git log
git log command can produce very long message with every following key stroke. To exit viewing the log history, hit "q" key from your keyboard
11. check origin:
git remote -v
12. If has already attached a remote origin, we need to remove origin:
git remote rm origin
13. Add devops origin (replacing below with appropriate repo information):
git remote add origin https://tcnarwhals@dev.azure.com/tcnarwhals/MPDIS-SDDPM_Scrum/_git/MPDIS-SDDPM_Scrum
If the DevOps Master branch has ReadMe.md file created and committed, we need to run the following commands to merge remote and local together.
git -c diff.mnemonicprefix=false -c core.quotepath=false --no-optional-locks pull --no-commit origin master --allow-unrelated-histories
git commit -m "Merge branch 'master' of https://dev.azure.com/DSD-Marine/MSS-Portfolio/_git/MPDIS-SDDPM_Scrum"
14.
git push -u origin --all
Related articles
Filter by label
There are no items with the selected labels at this time.