pmartindev / gei-demo

Demo GitHub Enterprise Importer (GEI)

GitHub Enterprise Importer Demo

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

Prerequisites

GitHub CLI
GitHub Enterprise Importer CLI

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) 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. 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.