Upgrade Bitbucket without downtime

To upgrade Bitbucket with no downtime, you'll need to perform a rolling upgrade. A rolling upgrade allows you to upgrade Bitbucket Data Center to a later bug fix version with no downtime. This involves upgrading nodes individually within a multi-node cluster. When you take a node offline to upgrade it, other active nodes keep your Bitbucket site available to users. This allows you to avoid downtime.

Bug fix upgrades only

Bitbucket only allows rolling upgrades for bug fix upgrades (for example, from Bitbucket 7.9.0 to 7.9.4). For platform upgrades (such as Bitbucket 7 to 8) or feature upgrades (such as 7.4 to 7.8), see Bitbucket Data Center upgrade guide instead.

Learn more about the different types of upgrades/versions    

Bitbucket Data Center features an upgrade mode that allows Bitbucket nodes with different bug fix versions to form a cluster. Upgrade mode lets you upgrade a node to a later bug fix version and then re-connect it to your cluster, letting you take another node offline to upgrade it.



ローリング アップグレードの計画を開始する前に、いくつかの質問に答える必要があります。

Does my Bitbucket deployment support rolling upgrades?

You can only perform a rolling upgrade with no downtime on a multi-node Bitbucket cluster. Clustering is only supported on a Bitbucket Data Center license. In addition, a rolling upgrade involves enabling upgrade mode, which is only available in Bitbucket Data Center.

Learn more about multi-node clustering in Bitbucket

ローリング アップグレード中にユーザー リクエストをサポートするために十分なノードはありますか?

You need to take a node offline to upgrade it. During this time, other active nodes will take over the offline node’s workload. Make sure you have enough active nodes to handle user traffic at any given time. Whenever possible, add a node temporarily to your cluster to compensate for offline nodes.

ローリング アップグレードの準備

1. アップグレード前の確認を完了する

  1. Check the Version specific upgrade notes for the version you plan to upgrade to (and any in between).
  2. Go to  > Support Tools, then review the Log analyzer for any issues that may need to be resolved.
  3. 利用しているアプリに、アップグレード先として計画しているバージョンとの互換性があるかどうかを確認します。

    1. Go to  > Manage apps > Bitbucket update check.
    2. Choose the version you plan to upgrade to then hit Check.


      特定のアプリが必要不可欠な場合、互換性がサポートされるまで Bitbucket のアップグレードを待つことをおすすめします。アプリ ベンダーは一般に、メジャー リリースのあとすぐにアプリをアップグレードします。


      • Upgrading from a version older than Bitbucket Server 6 will automatically disable all user-installed apps. You will need to enable your apps after successfully upgrading, regardless of compatibility with Bitbucket Server 6.
      • アプリに互換性がない場合、そのアプリを一時的に無効化できます。 


If you manage Bitbucket with a team of admins, schedule the rolling upgrade with them. Notify them to postpone any app installs or upgrades until after the rolling upgrade. Installing or upgrading apps during a rolling upgrade could result in unexpected errors.

3. Back up Bitbucket 

  1. 使用するバックアップ戦略を決定します。 

    Bitbucket で使用できるさまざまなバックアップ戦略の概要...

    Bitbucket Server (バージョン 4.8 以降) のインスタンスの場合、Bitbucket の実行中にゼロ ダウンタイム バックアップバックアップ クライアント (バージョン 2.7 以降)、または DIY バックアップ (バージョン 2.12 以降) を使用できます。Bitbucket を停止し、ホーム ディレクトリとデータベースを zip 圧縮して安全な場所に保存しておくこともできます。

    Bitbucket Data Center (バージョン 4.8 以降) のインスタンスの場合、ゼロ ダウンタイム バックアップまたは DIY バックアップを使用するか、すべてのノードの停止中に共有ホーム ディレクトリ (NFS 上) とデータベースのスナップショットを作成できます。 

    Bitbucket ミラーの場合、ホーム ディレクトリにはプライマリ Bitbucket インスタンスから再構築可能な持続的な情報はありませんが、SSL 証明書、server.xmlconfig/ssh-server-keys.pembitbucket.properties ファイルなどの重要な設定ファイルのバックアップを作成しておくことをおすすめします。詳細については、「ミラーのバックアップ方法」をご参照ください。

    詳細情報と、効果的なバックアップ戦略を作成するためのガイダンスについては、「データ リカバリとバックアップ」をご参照ください。

  2. Bitbucket ホーム ディレクトリ外部データベースのすべてのデータをバックアップします。

デプロイが AWS でホストされている場合、スナップショットを使用してサイトのバックアップを作成する、AWS のネイティブ バックアップ機能を使用することをおすすめします。詳しくは、「AWS バックアップ」を参照してください。 

4.ローリング アップグレードをテストするためのステージング環境のセットアップ

最初に、ステージングまたはテスト環境におけるローリング アップグレードの実行を強くお勧めします。 

  1. 現在の本番環境のステージング コピーを作成します。
  2. 以下の手順に従って、テスト環境をアップグレードします。
  3. 本番環境のアップグレード前に、すべてのサポート対象外のアプリ、カスタマイズ、およびプロキシ構成 (可能な場合) をテストします。

 ローリング アップグレードの実行

There are three methods for performing a rolling upgrade, depending on what orchestration tools your deployment uses:



A manual upgrade is suitable for deployments that feature minimal orchestration, particularly in node upgrades. If your deployment is based on our Azure templates, you'll also need to perform a manual upgrade.

AWS CloudFormation

If your deployment is defined by an AWS CloudFormation template (like our AWS Quick Start), then you can use the same template to orchestrate your upgrade. 

API 駆動

API コールを使用して、ローリング アップグレード プロセス全体をオーケストレーションできます。 
最終更新日 2021 年 4 月 6 日


Powered by Confluence and Scroll Viewport.