You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+27-1Lines changed: 27 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,10 +8,11 @@ The [GitHub Enterprise Importer](https://docs.github.com/en/migrations/using-git
8
8
> GEI is generally available for repository migrations originating from Azure DevOps or GitHub that target GitHub Enterprise Cloud. It is in public beta for repository migrations from BitBucket Server and Data Center to GitHub Enterprise Cloud.
9
9
10
10
## Using the GEI CLI
11
-
There are 3 separate CLIs that we ship as extensions for the official [GitHub CLI](https://github.com/cli/cli#installation):
11
+
There are 4 separate CLIs that we ship as extensions for the official [GitHub CLI](https://github.com/cli/cli#installation):
12
12
-`gh gei` - Run migrations between GitHub products
13
13
-`gh ado2gh` - Run migrations from Azure DevOps to GitHub
14
14
-`gh bbs2gh` - Run migrations from BitBucket Server or Data Center to GitHub
15
+
-`gh gl2gh` - Run migrations from GitLab to GitHub _(not yet generally available)_
15
16
16
17
To use `gh gei` first install the latest [GitHub CLI](https://github.com/cli/cli#installation), then run the command
17
18
>`gh extension install github/gh-gei`
@@ -22,6 +23,11 @@ To use `gh ado2gh` first install the latest [GitHub CLI](https://github.com/cli/
22
23
To use `gh bbs2gh` first install the latest [GitHub CLI](https://github.com/cli/cli#installation), then run the command
23
24
>`gh extension install github/gh-bbs2gh`
24
25
26
+
To use `gh gl2gh` first install the latest [GitHub CLI](https://github.com/cli/cli#installation), then run the command
27
+
>`gh extension install github/gh-gl2gh`
28
+
29
+
> **Note:**`gh gl2gh` is not yet generally available. The extension repo and releases may not be published yet.
30
+
25
31
We update the extensions frequently, so make sure you update them on a regular basis:
26
32
>`gh extension upgrade github/gh-gei`
27
33
@@ -33,6 +39,8 @@ To see the available commands and options run:
33
39
34
40
>`gh bbs2gh --help`
35
41
42
+
>`gh gl2gh --help`
43
+
36
44
### GitHub to GitHub Usage (GitHub.com -> GitHub.com)
37
45
1. Create Personal Access Tokens with access to the source GitHub org, and the target GitHub org (for more details on scopes needed refer to our [official documentation](https://docs.github.com/en/migrations/using-github-enterprise-importer/preparing-to-migrate-with-github-enterprise-importer/managing-access-for-github-enterprise-importer)).
38
46
@@ -87,6 +95,24 @@ Refer to the [official documentation](https://docs.github.com/en/migrations/usin
87
95
88
96
Refer to the [official documentation](https://docs.github.com/en/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-bitbucket-server-to-github-enterprise-cloud) for more details.
89
97
98
+
### GitLab to GitHub Usage
99
+
1. Create a Personal Access Token for the source GitLab instance (with `api` and `read_repository` scopes) and one for the target GitHub org (for more details on scopes needed refer to our [official documentation](https://docs.github.com/en/migrations/using-github-enterprise-importer/preparing-to-migrate-with-github-enterprise-importer/managing-access-for-github-enterprise-importer)).
100
+
101
+
2. Set the `GITLAB_PAT` and `GH_PAT` environment variables.
102
+
103
+
3. Run the `generate-script` command to generate a migration script.
The `--gitlab-server-url` flag accepts both GitLab.com (`https://gitlab.com`) and self-hosted GitLab instances.
111
+
112
+
4. The previous command will have created a `migrate.ps1` PowerShell script. Review the steps in the generated script and tweak if necessary.
113
+
114
+
5. The `migrate.ps1` script requires PowerShell to run. If not already installed see the [install instructions](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-7.2) to install PowerShell on Windows, Linux, or Mac. Then run the script.
115
+
90
116
### Skipping version checks
91
117
92
118
When the CLI is launched, it logs if a newer version of the CLI is available. You can skip this check by setting the `GEI_SKIP_VERSION_CHECK` environment variable to `true`.
- Added new `gl2gh` CLI (not yet generally available) for migrating GitLab repositories (GitLab.com and self-hosted) to GitHub. Includes `migrate-repo`, `generate-script`, and `inventory-report` along with the standard supporting commands (e.g. `download-logs`, `wait-for-migration`, `abort-migration`, `grant-migrator-role`, `revoke-migrator-role`, `create-team`, `generate-mannequin-csv`, `reclaim-mannequin`). Archives can be uploaded via Azure Blob Storage, AWS S3, or GitHub-owned storage.
0 commit comments