Bitbucket Server からクラウドへの移行計画


This guide provides an overview of recommended activities before, during, and after the migration process. It covers enlisting your project team, evaluating technology options, ensuring that the current Bitbucket Server site is ready for migration, and executing the migration. 

Not ready to start planning your migration? Learn more about the benefits of Atlassian Cloud or check out our Bitbucket migration FAQs.


Use this guide when:

  • You want to evaluate if you should migrate from Bitbucket Server to Bitbucket Cloud.
  • You've decided you want to, and need to know how to plan and conduct the migration.



  1. Know what you can migrate: Currently, we only support migrating repository data (your source code) from Bitbucket Server to Bitbucket Cloud. There's no supported method for migrating user accounts, permission structures, or repository metadata like pull request history and comments. We're currently gathering interesting in this feature, so if this is something you need we recommend watching or voting for this issue.
    Note that due to the limited scope of data migrated, you can migrate from any version of Bitbucket Server. 
  2. Review your security and compliance requirements: Adhering to your organization's security requirements is critical to a successful migration. For more information about Atlassian's security, privacy, and compliance policies, check out Trust at Atlassian. At this point, you may want to work with your procurement or security teams to make sure Bitbucket Cloud meets your requirements.
  3. Evaluate apps: Before deciding to migrate, review any apps and custom integrations you may have to determine what you'll need for your Bitbucket Cloud site. The Atlassian Marketplace offers a variety of apps and integrations that extend the functionality of Bitbucket Cloud. These include free integrations with leading SaaS productivity and collaboration products like Slack and Gmail, and subscription-based licensing of some of your most beloved server apps. Keep in mind while you're evaluating that while Atlassian’s cloud and server products provide the same benefits, they can differ in features and functionality. As you evaluate, you may discover that Bitbucket Cloud includes functionality that is fulfilled through an app on server. Refer to the Bitbucket feature comparison grid for more information. You may also have in-house or custom-built apps to consider. 
    1. App data is not typically included when migrating from Bitbucket Server to Bitbucket Cloud. Some apps do have the capability to export and import their data but you'll need to check with the app developers or their documentation to confirm if this is possible.
    2.  If you do need to map Bitbucket Server apps to Bitbucket Cloud, first check if there is a cloud equivalent of your server app in our Marketplace. If there is a cloud equivalent, your next step would be to check with the app developer to see if it stores any data. If it does, you'll need to work with the app vendor to understand your data migration options. Atlassian doesn't directly handle migrating data generated from third-party server apps to cloud apps. If there's no equivalent and the app stores data, you should still contact the vendor to see if there's a way to export the data. 
  4. Check costs: There's no cost to migrate to Bitbucket Cloud besides the cost of your Bitbucket Cloud subscription. However, you'll still want to assess your payment options and overall costs. A few things to keep in mind:
    1. Unlike Bitbucket Server, Bitbucket Cloud is offered as a monthly subscription on a per-user basis, with three different pricing plans: Free, Standard, and Premium. Check out Bitbucket Licensing to decide which plan is best for your team and estimate your monthly costs.
    2. If you're planning on using apps from the Atlassian Marketplace in Bitbucket Cloud, remember to factor these into your cost considerations.
    3. Note that your existing Bitbucket Server license and maintenance won't transfer to Bitbucket Cloud. These are two separate licenses and are paid for separately.
  5. Review the FAQs: We've developed a comprehensive set of FAQs in the Atlassian Cloud Migration Center to assist you in planning your Bitbucket migration.
  6. Try out Bitbucket Cloud: Sign up for a free Bitbucket Cloud trial to give Bitbucket Cloud a spin. Keep in mind as you try it out that the design and user interface and administration experience can vary across Bitbucket Server and Bitbucket Cloud, and you can't switch between the two. We recommend trying cloud before migrating to get comfortable with the differences and identify any communications or training needed to help onboard your users.


Now that you've decided to migrate, let's figure out how to get you there.

  1. Assemble your team: Migrating from Bitbucket Server to Cloud will have an impact on your users' experience and workflows, as well as various stakeholders throughout your organization. Depending on the size of your organization and number of users, a migration may require a fully fledged project with defined roles and responsibilities across teams. As early as possible, you should communicate with individuals and stakeholders who are interested and impacted by a move to Bitbucket Cloud. Where possible, recruit and enlist these people to be a part of the process.
  2. プロアクティブかつ頻繁に連絡する: 移行スケジュールについて組織に知らせる前に、チーム メンバーと移行計画を共有します。発生する問題やエラーについて、ユーザーにどのように警告するかを決定します。この段階では、移行のコミュニケーション計画に以下のような内容を含める必要があります。
    1. When will the migration occur?
    2. ユーザーが想定すべきダウンタイム
    3. 移行中はあらゆる変更を加えないよう、ユーザーに依頼する
    4. 移行後の古いサイトへの影響。アクセスまたは読み取りが引き続き可能かどうか
  3. Prepare your Bitbucket Server: Evaluate your current environment to determine if you need to make any changes before migrating your data. We recommend finishing and merging or closing all open pull requests before migrating. This way, all new pull requests will get created directly in Bitbucket Cloud after you migrate.
  4. Set up your organization: An organization allows you to view all Atlassian Cloud users at your company in one place, manage your users' accounts, and set up security features like SAML SSO. Organizations are particularly helpful if your company manages more than one Atlassian Cloud site and wants insight into all your sites, products, and the users who can access them. Learn more about how to set up an organization.
  5. Evaluate authentication options: Bitbucket Cloud supports SAML SSO with a subscription to Atlassian Access. You can configure SAML SSO for all users in your organization. When they access the Bitbucket Cloud web interface, they will be redirected to your SSO provider to log in. However, your users' SSO credentials are not valid for Git operations. Users will need to use an app password for https authentication, or switch to SSH authentication for Git operations.


  • Migration services: If you need assistance with your migration, we have a wide network of partners globally that are very experienced in Atlassian migrations. Visit our Atlassian Partners page to find one who can help with your migration.



  1. Run a test migration: We recommend performing a trial run in a testing or staging site to ensure that everything is working expected and the migration runs smoothly. You can do this using a free Bitbucket Cloud trial. The test migration will help you:
    1. 実際の移行の前に解決する必要がある潜在的な問題や手順の確認。
    2. 予想されるダウンタイムも含めた、実際の移行のタイムラインの明確化。
    3. Validate the data before moving to Bitbucket Cloud.
  2. Build a timeline: Identifying an ideal migration window can mean the difference between happy and frustrated users. Determine how much time your migration will take, factoring in time for troubleshooting. Consider scheduling the migration for overnight, on a weekend, or when your team is less likely to need access to Bitbucket. This will reduce the risk of data discrepancies between server and cloud.
  3. Migrate to cloud: There are a few ways to move your data to the cloud:
    1. Use our repository importer to import individual repositories. To migrate using the importer, your Bitbucket Server domain needs to be publicly accessible. If it's not publicly accessible Bitbucket Cloud will not be able to access to your Bitbucket Server to perform the import.
    2. You can also create a new repository on Bitbucket Cloud, and then simply push from your local repository to the new repository in Bitbucket Cloud.
    3. If you have a lot of repositories, Bitbucket Cloud provides APIs for you to script the creation and pushing of repositories in bulk.
  4. Create users and grant access: Our migration tools currently only migrate repositories. We currently don't support migrating users, groups, or repository access configurations from Bitbucket Server to Bitbucket Cloud. After migrating, you'll need to first create your usersincloud and then give the correct users access to each repository.



  • Merging server sites: If you need to merge multiple server sites, just follow the same process for each site to import your repositories and add your users to your cloud site.


If you've run into a problem during your migration, we're here to help. You can start by searching for known issues in Bitbucket Server or Bitbucket Cloud in our public issue trackers. There, you can find information about some of the common issues we see with Bitbucket migrations, including their status and suggested workarounds.

If you've run into a different question or need help to move forward with your migration, you can contact our Technical Support team or reach out to our Atlassian Community for advice.



  • Review your cloud siteWhen your migration is complete, you will need to review the new Bitbucket Cloud site to ensure your data has migrated successfully. We recommend:
    • Checking repositories for things like your commits and branches.
    • さまざまなチームやユーザーが異なる機能をテストするための時間の確保。
    • アプリケーションの操作や機能をテストし、動作の違いが見られた場合はそれを特定して、必要に応じてユーザーに共有。 
  • Migrating Jira and Bitbucket: If you are migrating both Jira and Bitbucket, you'll want to connect them in cloud after you migrate.
  • Install apps: If you've identified apps that should be installed, add them to your Bitbucket Cloud site.

  • Get acquainted with a cloud: To learn more about what's new in Bitbucket Cloud and how to get the most of it, check out the Bitbucket Cloud documentation. Consider sharing this resource with your users if this is their first introduction to Bitbucket Cloud. You may also find the Atlassian Cloud documentation a helpful resource as you get started as a Bitbucket Cloud admin.
  • Welcome your team: Now that the migration is complete, make sure your organization is ready. We recommend developing a comprehensive launch communication plan to share the new Bitbucket Cloud site information with the team. This can cover topics like:

    • What action is needed post-migration? For example:
      • Resetting passwords
      • Resetting avatars
      • Updating local remote URLs for migrated repositories
    • 新しいサイトへアクセスする際に使用する URL
    • 質問の問い合わせ先および問い合わせ方法。たとえば、課題やフィードバックを送信できるチャット ルームや課題トラッカーがあるかどうか
    • ユーザーが認識しておくべき重大な変更
    • その他の資料や FAQ へのリンク

Jira Cloud の利用を開始


To keep track of major changes that affect all users of the Bitbucket Cloud products, follow the Atlassian Cloud Documentation blog. This includes new features, bug fixes, and other changes across all Atlassian Cloud products.


We have a number of support channels available to help you with your migration. For more Bitbucket migration planning information and FAQs, visit the Atlassian Cloud Migration Center.

ストラテジー、ベスト プラクティス、または計画の疑問について支援が必要な場合、アトラシアンの移行計画のスペシャリストが Jira Server から Jira Cloud への移行計画をサポートします。 

技術的な質問がある場合や、問題が発生している場合は、テクニカル サポート チームにお問い合わせください。

また、アトラシアン コミュニティもご利用ください。


最終更新日 2019 年 4 月 30 日


Powered by Confluence and Scroll Viewport.