Bitbucket Server アップグレード ガイド

This guide describes how to upgrade your Bitbucket Server installation on Linux to the latest version using the installer.

現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。


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

このページの内容

はじめる前に

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

インストーラーの使用は適切なアップグレード方法ですか?
詳細を読む...

インストーラーを使用してアップグレードするか、ご利用の状況にインストーラーが適していない場合はアーカイブ ファイルを使用して Bitbucket Server インスタンスを更新できます。ほとんどの事例においてインストーラーによるアップグレードが推奨されます。アーカイブ ファイルを使用した Bitbucket Server の更新は、インストーラーを使用できない状況の場合にのみ行ってください。

Bitbucket Server をアーカイブ ファイルからアップグレードする方法についてご確認ください

アップグレードの資格がありますか?
詳細を読む...

ご利用のライセンスでソフトウェア メンテナンスが有効かどうかを調べるには、 > [ライセンス] に移動して、ライセンスのサポート期間が失効していないことを確認します。

サポート期間が失効しいる場合、プロンプトに従ってライセンスを更新し、再適用してからアップグレードを行います。

サポート対象プラットフォームに変更はありますか?
詳細を読む...

サポート対象プラットフォーム」ページで、アップグレード先の Bitbucket バージョンを確認します。ここでは、サポート対象のオペレーティング システム、データベース、およびブラウザを確認できます。

Have you taken into consideration all the version-specific upgrade information?

Make sure you read the following pages for each version between your current version of the application and the version you're upgrading to:

This will give you information about specific update notes for each version of Bitbucket Data Center and Server.

Are you upgrading from Bitbucket 4.x or earlier and have you modified your server.xml file?
詳細を読む...

Bitbucket 5 で、ポート番号、コンテキスト パス、アクセス プロトコルなどのプロパティの設定場所を変更して単一のディレクトリおよびファイルにまとめ、以降のリリースでのアップグレードを行いやすくしました。

Bitbucket 4.14 以前の任意のバージョンから Bitbucket 5.0 以降にアップグレードする場合、server.xml ファイルへの変更を bitbucket.properties ファイルに手動で移行する必要があります。

server.xml ファイルの確認方法や、カスタマイズの移行方法については、「server.xml ファイルのカスタマイズ設定を bitbucket.properties に移行する」をご参照ください。

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

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

ご利用の環境が Bitbucket の最新バージョンの実行要件を満たしているかどうかを、「サポート対象プラットフォーム」ページで確認します。また、「サポート終了のお知らせ」を確認します。 

アップグレードにおいて必須となるパスはないため、Bitbucket Server (または Stash) の過去の任意のバージョンから最新バージョンに更新できます。

Bitbucket 8 はメジャー アップグレードです

本番サイトをアップグレードする前に、Bitbucket Server 8.0 のリリース ノートを確認し、完全なバックアップを作成して、非本番環境でアップグレードのテストを行うようにしてください。

Bitbucket 8 よりも古いバージョンからアップグレードすると、ユーザーがインストールしたすべてのアプリが起動時に無効化されます

Be sure to update your own apps and check the Atlassian Marketplace to ensure 3rd-party apps are compatible with Bitbucket Server 8 before upgrading.

tip/resting Created with Sketch.

次のバグ修正アップデートへのアップグレード

複数ノードの Bitbucket クラスタを次のバグ修正アップデートにアップグレードする場合 (8.0.0 から 8.0.1 など)、ダウンタイムなしでアップグレードできます

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

  1. アップグレード先として計画しているバージョン (およびその間のバージョン) のバージョンごとのアップグレード ノートを確認します。
  2.  > [サポート ツール] に移動し、解決が必要な問題がログ アナライザーにあるかどうかを確認します。
  3. 利用しているアプリに、アップグレード先として計画しているバージョンとの互換性があるかどうかを確認します。

    1.  > [アプリの管理] > [Bitbucket 更新の確認] に移動します。
    2. アップグレード先として計画しているバージョンを選択して [確認] を押します。

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

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

      参考情報

      • 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 Server.

      • アプリに互換性がない場合、そのアプリを一時的に無効化できます。 

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

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

Bitbucket のアップグレード

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

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

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

ご利用のオペレーティング システムに対応するインストーラーをダウンロードします (推奨) - www.atlassian.com/software/bitbucket/download

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

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

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

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

    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. カスタマイズ設定を移行する

If upgrading from Bitbucket 4.x or earlier, see migrate customizations.


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

To stop Bitbucket Server from your Linux terminal, change to the <Bitbucket Server installation directory> and run:

bin/stop-bitbucket.sh
Bitbucket Data Center の場合...

Bitbucket Data Center のすべてのノードが停止されていることを確認し、1 つのノードでアップグレード ステップを実行します。その後、同じ手順をそれぞれのクラスタ ノードで繰り返します。

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

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

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

  1. Run the installer. 
    From your Linux terminal, change to the directory where you downloaded Bitbucket Server then execute this command to make the installer executable: 

    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. アプリケーションを開始する

If you’re also upgrading your operating system libraries and using PostgresSQL and glibc version lower than 2.28, and the upgrade increases the glibc version to 2.28 or later, you’ll need to rebuild the PostgresSQL indices before starting Bitbucket.


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


For a H2 database (on a Bitbucket Mirror or Server), you must
  1. Choose No at this option
  2. Change to your <Bitbucket Server installation directory>
  3. Migrate your H2 database to MvStore format. For detailed instructions, see Migrate H2 database from 1.3 to 1.4.
  4. Start Bitbucket manually.

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



ロールバック

If necessary, rolling back an update can only be performed by restoring a backup of both the Bitbucket Server home directory and the Bitbucket Server database – rolling back requires a consistent home directory and database. You can then reinstall the previous version of the application to the installation directory. Never start an older binary against an upgraded home directory.

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

Stash インストールの更新で、上述のステップを実行したあとに問題が発生する場合、次のように Stash の既知の問題を確認し、更新内容のトラブルシューティングをお試しください。

最終更新日: 2023 年 2 月 7 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.