このガイドでは、Linux でインストーラーを使用し、Bitbucket Server のインストールを最新バージョンにアップグレードする方法について紹介します。

Upgrading to any later version is free if you have current software maintenance. See our Licensing FAQ to find out more.

Bitbucket のその他のアップグレード方法:

• 手動 – アーカイブ ファイルを使用してアップグレードします。
• Data Center – Data Center クラスタをアップグレードします。
• ローリング アップグレード - ダウンタイムなしで、Data Center クラスタを次のバグ修正バージョンにアップグレードします。
• Bitbucket Server 用の Docker コンテナ イメージ。

はじめる前に

Bitbucket をアップグレードする前に、いくつかの質問に答える必要があります。

インストーラーの使用は適切なアップグレード方法ですか?	詳細を読む... You can choose to upgrade using the installer, or, if the installer is not suitable for your situation you can use an archive file to update your Bitbucket Server instance. Only use an archive file to update Bitbucket Server if the installer is not suitable for your situation, as the installer is the the recommended approach to upgrade for most use cases. Bitbucket Server をアーカイブ ファイルからアップグレードする方法について確認する。
アップグレードの資格がありますか?	詳細を読む... ご利用のライセンスでソフトウェア メンテナンスが有効かどうかを調べるには、 > [ライセンス] に移動して、ライセンスのサポート期間が失効していないことを確認します。 サポート期間が失効しいる場合、プロンプトに従ってライセンスを更新し、再適用してからアップグレードを行います。
サポート対象プラットフォームに変更はありますか?	詳細を読む... 「サポート対象プラットフォーム」ページで、アップグレード先の Bitbucket バージョンを確認します。ここでは、サポート対象のオペレーティング システム、データベース、およびブラウザを確認できます。
バージョン固有のアップグレード情報をすべて考慮しましたか？	アプリケーションの現在のバージョンとアップグレード先のバージョンとの間の各バージョンについて、関連するセクションをご確認ください。 リリース ノート サポート対象プラットフォーム サポート終了のお知らせ アップグレード マトリクス This will give you information about specific update notes for each version of Bitbucket Data Center.
Bitbucket 4.x より前のバージョンからアップグレードしていて、server.xml ファイルを変更しましたか?	詳細を読む... Bitbucket 5 で、ポート番号、コンテキスト パス、アクセス プロトコルなどのプロパティの設定場所を変更して単一のディレクトリおよびファイルにまとめ、以降のリリースでのアップグレードを行いやすくしました。 Bitbucket 4.14 以前の任意のバージョンから Bitbucket 5.0 以降にアップグレードする場合、server.xml ファイルへの変更を bitbucket.properties ファイルに手動で移行する必要があります。 See the page Migrate customizations from server.xml to bitbucket.properties for instructions on locating your server.xml file and how to migrate your customizations.

アップグレードを計画する

1. アップグレード パスを決定する

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

1. アップグレード先として計画しているバージョン (およびその間のバージョン) のバージョンごとのアップグレード ノートを確認します。
2. Go to Administration and select Support Tools. Then, review the Log analyzer for any issues that may need to be resolved.

3. 利用しているアプリに、アップグレード先として計画しているバージョンとの互換性があるかどうかを確認します。

   1. Go to Administration and select Manage apps. Then, select Bitbucket update check.

   2. Choose the version you plan to upgrade to. Then, select Check.

      互換性のないアプリがある場合

      If your users rely on particular apps, you may want to wait until they are compatible before upgrading Bitbucket. App vendors generally update their apps very soon after a major release.

      参考情報

      • If you're performing a major version upgrade, user-installed apps will be disabled. You will need to enable your apps after successfully upgrading, regardless of compatibility with Bitbucket.

      • You can disable an app temporarily if it is not yet compatible. 

3. Bitbucket をテスト環境でアップグレードする

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

Bitbucket のアップグレード

このアップグレード プロセスは、インプレースのアップグレードではなく、新しいインストール ディレクトリに新しいバージョンの Bitbucket Server をインストールします。新しいインスタンスは、既存の Bitbucket Server のホーム ディレクトリと外部データベースを使用します。

アップグレードのロールバックは、Bitbucket Server のホーム ディレクトリと Bitbucket Server データベースの両方のバックアップを復元することでのみ行なうことができ、ホーム ディレクトリとデータベースが一貫している必要があります。その後、アプリケーションの過去のバージョンをインストール ディレクトリに再インストールできます。詳細についてはロールバックのセクションをご参照ください。

4. Bitbucket Server をダウンロードする

Download the installer (the recommended approach) for your operating system - www.atlassian.com/software/bitbucket/download.

5. データをバックアップする

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

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

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

   For Bitbucket mirrors, the home directory doesn't store any persistent state that can't be reconstructed from the primary Bitbucket instance, but you should still make sure you have a backup of at least the important configuration files such as SSL certificate, server.xml,  config/ssh-server-keys.pem,  bitbucket.properties file, and so on in a safe place. See  How do I back up my mirrors? for more information.

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

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

 6. カスタマイズ設定を移行する

Bitbucket 4.x 以前のバージョンからアップグレードする場合は、「カスタマイズ設定を移行する」を参照してください。

7. アプリケーションを停止する

Bitbucket Server を Linux ターミナルから停止するには、<Bitbucket Server installation directory> に移動して次のコマンドを実行します。

bin/stop-bitbucket.sh

詳細な手順については「Bitbucket の開始と終了」ページをご確認ください。

8. インストーラーを実行する

インストーラーは、GUI、コンソール または無操作モードで実行できます。

1. インストーラーを実行します。Linux ターミナルから、Bitbucket Server のダウンロード先のディレクトリに移動し、次のコマンドを実行してインストーラーを実行可能にします。 

   chmod +x atlassian-bitbucket-x.x.x-x64.bin

   sudo を使用してインストーラーを実行することをお勧めします。これにより Bitbucket Server を実行する専用アカウントが作成され、Bitbucket Server をサービスとして実行できます。

   インストーラーを実行するために sudo を使用するには、次のコマンドを実行します。 

   $ sudo ./atlassian-bitbucket-x.x.x-x64.bin

   root ユーザー権限でインストーラーを実行することもできます。

   
   

2. プロンプトに従って Bitbucket Server をアップグレードします。

   1. [Welcome] ステップで、アップグレードするインスタンスのタイプを選択します。
      
      

      アップグレードするタイプの選択方法について

      単一ノードの場合 (ほとんどのユースケース)、[Upgrade an existing Bitbucket instance] オプションを選択します。
      
      Bitbucket Data Center インスタンスの場合、[Upgrade an existing Bitbucket instance] オプションを選択し、それぞれのアプリケーション ノードでアップグレード プロセスを繰り返します。
      
      Bitbucket ミラーの場合、[Upgrade an existing mirror] オプションを選択します。

   2. 「Select Bitbucket Server Home」ステップで、既存のホーム ディレクトリを選択します。

   3. インストーラー残りのステップに従います。

      
      

9. アプリケーションを開始する

インストーラーを使用している場合、インストール ウィザードの最後に、アプリケーションを開始してブラウザで開くオプションがあります。

Bitbucket を手動で開始する方法を含む詳細な手順については、「Bitbucket の開始と終了」をご確認ください。

ロールバック

更新のロールバックは、Bitbucket Server のホーム ディレクトリと Bitbucket Server データベースの両方のバックアップを復元することでのみ行なうことができ、ホーム ディレクトリとデータベースが一貫している必要があります。その後、アプリケーションの過去のバージョンをインストール ディレクトリに再インストールできます。アップグレード済みのホーム ディレクトリで古いバイナリ ファイルを実行することはできません。

既知の問題やトラブルシューティング情報を確認する

If something is not working correctly after you have completed the steps above to update your Bitbucket installation, please check for known issues and try troubleshooting your update as described below:

• 既知の問題の確認。既知の問題は、アトラシアンの課題追跡システムの BSERV プロジェクトで確認できます。
• Bitbucket Knowledge Base. Sometimes we find out about a problem with the latest Bitbucket version after we have released the software. In such cases we publish information in the Bitbucket Knowledge Base.
• 更新中に問題が発生していて解決が難しい場合、サポート チケットを作成してください。アトラシアンのサポート エンジニアがお手伝いします。