GitHub Enterprise Importer Demo

This repo can be used to demo GitHub Enterprise Importer (GEI)

Prerequisites

GitHub CLI
GitHub Enterprise Importer CLI
Powershell
Blob storage if migrating from GHES

Demo

1. Make sure gh-gei is up to date by running

gh extension upgrade github/gh-gei

2. Copy setenv.sh.orig to setenv.sh and populate it with values for your migration.
3. Run gh-migration-analyzer.sh to demo the use of gh-migration-analyzer.
4. Run gh-repo-stats.sh to demo gh-repo-stats.
5. Run migrate-repo.sh to demo a repo migration.
6. (Optional) Run gen-migration-script.sh to demo generating a migration script.
7. (Optional, only for GitHub.com to GHEC) Run migrate-org.sh to demo an org migration.
8. Run gen-mannequin-mapping.sh to demo generating a mannequin mapping file after a migration.
9. Fill out the third field of the usermapping.csv file, make sure the users are members of the org, then run reclaim-mannequins.sh.
10. Source repository locking/unlocking:
    Demonstrate source repository locking by setting LOCK_SOURCE_REPO to true in setenv.sh and running migrate-repo.sh.
    Unlock the source repository by running source-lock-remove.sh.

Notes

GEI limitations

LFS

The process to migrate repos that contain files larger than 100mb is as follows:

1. Migrate the repo to LFS on the source system.
2. Migrate the repo using GEI
3. Migrate the LFS files as described here.

Note: Due to an issue with LFS, it's better to run the following, rather than git lfs push github --all

for object_id in $(git lfs ls-files --long | awk '{print $1}'); do
   git lfs push --object-id github "$object_id"
done