Migrating Bitbucket to Atlassian Cloud

This guide outlines the process of migrating Bitbucket repositories and configurations from server or Data Center to Bitbucket Cloud.

1. Pre-Migration Assessment

  • Evaluate your current Bitbucket setup, including repositories, user permissions, and integrations.
  • Document any custom hooks, scripts, and pipelines that need to be migrated.

Important: Review any third-party integrations and custom CI/CD pipelines. Ensure that these can be replicated or replaced in the cloud environment.

2. Prepare for Migration

Security Implication: Securely store your backup files with encryption, especially if they contain sensitive code or configuration data. Follow best practices for data handling to prevent unauthorized access.

  • Test the migration process in a staging environment. This helps identify potential issues with repository access, permissions, or CI/CD configurations.

Important: If you rely heavily on custom hooks or scripts, test these thoroughly in the cloud environment to ensure they function as expected.

3. Migrating to Cloud

  • Use the Bitbucket Cloud Migration Assistant to begin the migration.
  • Migrate repositories, users, and configurations as per the migration plan.

Important: Pay special attention to branch permissions and merge strategies. Cloud implementations may differ, requiring adjustments to maintain your workflow security.

  • Validate the migration by testing repository access, CI/CD pipelines, and integrations.

Security Implication: Review and update all user access and permissions after migration. Ensure that sensitive repositories are accessible only to authorized personnel.

4. Post-Migration Tasks

  • Data Validation: Ensure all repositories and configurations have migrated correctly. Test access controls and CI/CD pipelines to ensure they are functioning as expected.
  • Reconfigure Integrations: Update any third-party integrations, such as Jira links or CI/CD tools, to point to the new Bitbucket Cloud instance.
  • User Training: Provide training for developers and administrators to help them adapt to the cloud interface and new features.

Security Implication: Review and update any API keys, SSH keys, or OAuth tokens used by your CI/CD pipelines or integrations. Ensure that these are securely managed in the cloud environment.

5. Resources