Commit 3475cca6 authored by Mike Jang's avatar Mike Jang

Merge branch 'mjang-github-importer' into 'master'

Consolidate use cases for GitHub import

See merge request gitlab-org/gitlab!43037
parents 21dd0ed7 0262dd06
...@@ -35,25 +35,20 @@ The namespace is a user or group in GitLab, such as `gitlab.com/janedoe` or `git ...@@ -35,25 +35,20 @@ The namespace is a user or group in GitLab, such as `gitlab.com/janedoe` or `git
This process does not migrate or import any types of groups or organizations from GitHub to GitLab. This process does not migrate or import any types of groups or organizations from GitHub to GitLab.
### If you're using GitLab.com ### Use cases
If you're using GitLab.com, you can alternatively import The steps you take depend on whether you are importing from GitHub.com or GitHub Enterprise, as well as whether you are importing to GitLab.com or self-managed GitLab instance.
GitHub repositories using a [personal access token](#using-a-github-token),
but we don't recommend this method because it can't associate all user activity - If you're importing to GitLab.com, you can alternatively import GitHub repositories
(such as issues and pull requests) with matching GitLab users. using a [personal access token](#using-a-github-token). We do not recommend
this method, as it does not associate all user activity (such as issues and
### If you're importing from GitLab Enterprise pull requests) with matching GitLab users.
- If you're importing to a self-managed GitLab instance, you can alternatively use the
If you're importing from GitHub Enterprise, you must enable [GitHub integration][gh-import]. [GitHub Rake task](../../../administration/raketasks/github_import.md) to import
projects without the constraints of a [Sidekiq](../../../development/sidekiq_style_guide.md) worker.
### If you're using a self-managed GitLab instance - If you're importing from GitHub Enterprise to your self-managed GitLab instance, you must first enable
[GitHub integration](../../../integration/github.md). However, you cannot import projects from GitHub Enterprise to GitLab.com.
If you're an administrator of a self-managed GitLab instance, you must enable - If you're importing from GitHub.com to your self-managed GitLab instance, you do not need to set up GitHub integration.
[GitHub integration][gh-import].
If you're an administrator of a self-managed GitLab instance, you can also use the
[GitHub Rake task](../../../administration/raketasks/github_import.md) to import projects from
GitHub without the constraints of a Sidekiq worker.
## How it works ## How it works
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment