ionchy
/
hg2git
1
0
Fork 0
Code

Added intro message and fixed list ordering.

This commit is contained in:
jochan 2017-06-20 10:53:44 -07:00
parent 6283bad98a
commit 5536a1a9c5
1 changed files with 9 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
README.md
View File

@ -1,4 +1,5 @@
# Mercurial to Git Migration # Mercurial to Git Migration
These scripts will migrate a Mercurial repository to a Git repository using hg-fast-export, strip large files using BFG Repo-Cleaner, tag and delete branches that were closed in Mercurial, and convert .hgignore files to .gitignore files.
## Notes ## Notes
* If any .sh scripts cannot be executed, replace `./` with `bash ` or execute `chmod u+x <.sh script>`. * If any .sh scripts cannot be executed, replace `./` with `bash ` or execute `chmod u+x <.sh script>`.
@ -10,18 +11,18 @@
* `<bfg-cleaner>`: The directory to which the BFG Repo-Cleaner .jar file will be downloaded. * `<bfg-cleaner>`: The directory to which the BFG Repo-Cleaner .jar file will be downloaded.
## Instructions ## Instructions
0. Copy all hg2git\*.sh, authors.py, and users.csv files to the same directory. 1. Copy all hg2git\*.sh, authors.py, and users.csv files to the same directory.
1. Run `./hg2git.sh <source> <target> <authors> <fast-export>`. This may take a while. Do **NOT** delete the reformatted-authors.txt file. 2. Run `./hg2git.sh <source> <target> <authors> <fast-export>`. This may take a while. Do **NOT** delete the reformatted-authors.txt file.
2. If you have new changes in your Mercurial repository and you wish to update your Git repository, ensure the changes have been pulled (`hg pull`) and run `./hg2git_update.sh <source> <target>`. 3. If you have new changes in your Mercurial repository and you wish to update your Git repository, ensure the changes have been pulled (`hg pull`) and run `./hg2git_update.sh <source> <target>`.
3. Before moving on, make sure that you are **absolutely sure** you no longer need to update your Git repository from your Mercurial repository. Once you perform the next steps, you **cannot** update again. 4. Before moving on, make sure that you are **absolutely sure** you no longer need to update your Git repository from your Mercurial repository. Once you perform the next steps, you **cannot** update again.
4. To strip out large files from history and delete closed branches, run `./hg2git_clean.sh <source> <target> <bfg-cleaner>`. Files larger than 40M will be stripped. This may take a while. 5. To strip out large files from history and delete closed branches, run `./hg2git_clean.sh <source> <target> <bfg-cleaner>`. Files larger than 40M will be stripped. This may take a while.
5. To copy .hgignore files to .gitignore, convert _some_ of the regex to globs, and commit these files for every branch, run `./hg2git_ignore.sh <target>`. Note that this will convert the repository from bare to non-bare and check out files. 6. To copy .hgignore files to .gitignore, convert _some_ of the regex to globs, and commit these files for every branch, run `./hg2git_ignore.sh <target>`. Note that this will convert the repository from bare to non-bare and check out files.
6. Set an upstream (`git remote add origin <url>`) and push the repository (`git push -u origin master`). This may take a while. 7. Set an upstream (`git remote add origin <url>`) and push the repository (`git push -u origin master`). This may take a while.
## TL;DR ## TL;DR
1. `./hg2git.sh <source> <target> <authors> <fast-export>` 1. `./hg2git.sh <source> <target> <authors> <fast-export>`
2. `./hg2git_update.sh <source> <target>` 2. `./hg2git_update.sh <source> <target>`
3. Read [Instructions](#instructions) > Step 3. 3. Read [Instructions](#instructions) > Step 4.
4. `./hg2git_clean.sh <source> <target> <bfg-cleaner>` 4. `./hg2git_clean.sh <source> <target> <bfg-cleaner>`
5. `./hg2git_ignore.sh <target>` 5. `./hg2git_ignore.sh <target>`
6. `git remote add origin <url> && git push -u origin master` 6. `git remote add origin <url> && git push -u origin master`