2018-11-18 11:00:15 +05:30
|
|
|
# Import your project from Bitbucket Cloud to GitLab
|
2018-03-17 18:26:18 +05:30
|
|
|
|
2018-11-18 11:00:15 +05:30
|
|
|
NOTE: **Note:**
|
|
|
|
The Bitbucket Cloud importer works only with Bitbucket.org, not with Bitbucket
|
|
|
|
Server (aka Stash). If you are trying to import projects from Bitbucket Server, use
|
|
|
|
[the Bitbucket Server importer](bitbucket_server.md).
|
2018-03-17 18:26:18 +05:30
|
|
|
|
2018-11-18 11:00:15 +05:30
|
|
|
Import your projects from Bitbucket Cloud to GitLab with minimal effort.
|
2018-03-17 18:26:18 +05:30
|
|
|
|
2018-11-18 11:00:15 +05:30
|
|
|
## Overview
|
2018-11-08 19:23:39 +05:30
|
|
|
|
2018-03-17 18:26:18 +05:30
|
|
|
- At its current state, the Bitbucket importer can import:
|
|
|
|
- the repository description (GitLab 7.7+)
|
|
|
|
- the Git repository data (GitLab 7.7+)
|
|
|
|
- the issues (GitLab 7.7+)
|
|
|
|
- the issue comments (GitLab 8.15+)
|
|
|
|
- the pull requests (GitLab 8.4+)
|
|
|
|
- the pull request comments (GitLab 8.15+)
|
|
|
|
- the milestones (GitLab 8.15+)
|
|
|
|
- the wiki (GitLab 8.15+)
|
|
|
|
- References to pull requests and issues are preserved (GitLab 8.7+)
|
|
|
|
- Repository public access is retained. If a repository is private in Bitbucket
|
|
|
|
it will be created as private in GitLab as well.
|
|
|
|
|
2018-11-18 11:00:15 +05:30
|
|
|
## Requirements
|
|
|
|
|
|
|
|
The [Bitbucket Cloud integration][bb-import] must be first enabled in order to be
|
|
|
|
able to import your projects from Bitbucket Cloud. Ask your GitLab administrator
|
|
|
|
to enable this if not already.
|
2018-03-17 18:26:18 +05:30
|
|
|
|
|
|
|
## How it works
|
|
|
|
|
|
|
|
When issues/pull requests are being imported, the Bitbucket importer tries to find
|
2019-10-12 21:52:04 +05:30
|
|
|
the Bitbucket author/assignee in GitLab's database using the Bitbucket `nickname`.
|
|
|
|
For this to work, the Bitbucket author/assignee should have signed in beforehand in GitLab
|
|
|
|
and **associated their Bitbucket account**. Their `nickname` must also match their Bitbucket
|
|
|
|
`username.`. If the user is not found in GitLab's database, the project creator
|
|
|
|
(most of the times the current user that started the import process) is set as the author,
|
|
|
|
but a reference on the issue about the original Bitbucket author is kept.
|
2018-03-17 18:26:18 +05:30
|
|
|
|
|
|
|
The importer will create any new namespaces (groups) if they don't exist or in
|
|
|
|
the case the namespace is taken, the repository will be imported under the user's
|
|
|
|
namespace that started the import process.
|
|
|
|
|
|
|
|
## Importing your Bitbucket repositories
|
|
|
|
|
|
|
|
1. Sign in to GitLab and go to your dashboard.
|
|
|
|
1. Click on **New project**.
|
|
|
|
|
2018-11-18 11:00:15 +05:30
|
|
|
1. Click on the "Bitbucket Cloud" button.
|
2018-03-17 18:26:18 +05:30
|
|
|
|
2019-10-12 21:52:04 +05:30
|
|
|

|
2018-03-17 18:26:18 +05:30
|
|
|
|
|
|
|
1. Grant GitLab access to your Bitbucket account
|
|
|
|
|
2019-10-12 21:52:04 +05:30
|
|
|

|
2018-03-17 18:26:18 +05:30
|
|
|
|
|
|
|
1. Click on the projects that you'd like to import or **Import all projects**.
|
2019-12-21 20:55:43 +05:30
|
|
|
You can also filter projects by name and select the namespace under which
|
|
|
|
each project will be imported.
|
2018-03-17 18:26:18 +05:30
|
|
|
|
2019-12-21 20:55:43 +05:30
|
|
|

|
2018-03-17 18:26:18 +05:30
|
|
|
|
|
|
|
[bb-import]: ../../../integration/bitbucket.md
|
|
|
|
[social sign-in]: ../../profile/account/social_sign_in.md
|