Commit b06492e4 authored by Mike Jang's avatar Mike Jang

Clarify GitLab importer note, include limitations

parent 471ab1c4
...@@ -12,18 +12,6 @@ your self-managed GitLab instance. ...@@ -12,18 +12,6 @@ your self-managed GitLab instance.
## Overview ## Overview
NOTE: **Note:**
These instructions work for users on GitLab.com, but if you are an
administrator of a self-managed GitLab instance or if you are importing from GitHub Enterprise,
you must enable [GitHub integration](../../../integration/github.md). GitHub integration is the only method for
importing from GitHub Enterprise. If you are using GitLab.com, you can alternatively import
GitHub repositories using a [personal access token](#using-a-github-token),
but this method is not recommended because it cannot associate all user activity
(such as issues and pull requests) with matching GitLab users.
If you are 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.
The following aspects of a project are imported: The following aspects of a project are imported:
- Repository description (GitLab.com & 7.7+) - Repository description (GitLab.com & 7.7+)
...@@ -43,6 +31,30 @@ each imported repository maintains visibility level unless that [visibility ...@@ -43,6 +31,30 @@ each imported repository maintains visibility level unless that [visibility
level is restricted](../../../public_access/public_access.md#restricting-the-use-of-public-or-internal-projects), level is restricted](../../../public_access/public_access.md#restricting-the-use-of-public-or-internal-projects),
in which case it defaults to the default project visibility. in which case it defaults to the default project visibility.
The namespace is a user or group in GitLab, such as `gitlab.com/janedoe` or `gitlab.com/customer-success`. You can do some bulk actions to move projects to different namespaces in the rails console.
This process does not migrate or import any types of groups or organizations from GitHub to GitLab.
### If you're using GitLab.com
If you're using GitLab.com, you can alternatively import
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
(such as issues and pull requests) with matching GitLab users.
### If you're importing from GitLab Enterprise
If you're importing from GitHub Enterprise, you must enable [GitHub integration][gh-import].
### If you're using a self-managed GitLab instance
If you're an administrator of a self-managed GitLab instance, you must enable
[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
When issues and pull requests are being imported, the importer attempts to find their GitHub authors and When issues and pull requests are being imported, the importer attempts to find their GitHub authors and
......
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