77 lines
3 KiB
Markdown
77 lines
3 KiB
Markdown
---
|
|
type: reference, howto
|
|
stage: Manage
|
|
group: Import
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
|
|
---
|
|
|
|
# Import your project from Bitbucket Cloud to GitLab **(FREE)**
|
|
|
|
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).
|
|
|
|
Import your projects from Bitbucket Cloud to GitLab with minimal effort.
|
|
|
|
The Bitbucket importer can import:
|
|
|
|
- Repository description
|
|
- Git repository data
|
|
- Issues
|
|
- Issue comments
|
|
- Pull requests
|
|
- Pull request comments
|
|
- Milestones
|
|
- Wiki
|
|
|
|
When importing:
|
|
|
|
- References to pull requests and issues are preserved.
|
|
- Repository public access is retained. If a repository is private in Bitbucket, it's created as
|
|
private in GitLab as well.
|
|
|
|
## Requirements
|
|
|
|
To import your projects from Bitbucket Cloud, the [Bitbucket Cloud integration](../../../integration/bitbucket.md)
|
|
must be enabled. Ask your GitLab administrator to enable this if it isn't already enabled.
|
|
|
|
## How it works
|
|
|
|
When issues/pull requests are being imported, the Bitbucket importer tries to find
|
|
the Bitbucket author/assignee in the GitLab 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 the GitLab 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.
|
|
|
|
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.
|
|
|
|
## Import your Bitbucket repositories
|
|
|
|
1. Sign in to GitLab.
|
|
1. On the top bar, select **New** (**{plus}**).
|
|
1. Select **New project/repository**.
|
|
1. Select **Import project**.
|
|
1. Select **Bitbucket Cloud**.
|
|
1. Log in to Bitbucket and grant GitLab access to your Bitbucket account.
|
|
|
|
|
|
|
|
1. Select the projects that you'd like to import or import all projects.
|
|
You can filter projects by name and select the namespace
|
|
each project will be imported for.
|
|
|
|
|
|
|
|
## Troubleshooting
|
|
|
|
If you have more than one Bitbucket account, be sure to sign in to the correct account.
|
|
If you've accidentally started the import process with the wrong account, follow these steps:
|
|
|
|
1. Revoke GitLab access to your Bitbucket account, essentially reversing the process in the following procedure: [Import your Bitbucket repositories](#import-your-bitbucket-repositories).
|
|
|
|
1. Sign out of the Bitbucket account. Follow the procedure linked from the previous step.
|