Bitbucket Server アップグレード ガイド
Starting from 8.15.x, new releases of Bitbucket will be available only to Data Center customers. If you have a Server license, learn about your options.
Use this document only if you're upgrading to Bitbucket Server 8.14 or earlier.
Bitbucket 8.15 以降へのアップグレードについては、Bitbucket Data Center アップグレード ガイドをご確認ください。
If you try to upgrade to release 8.15 or later with your Server license, Bitbucket will fail to start, and you’ll need to downgrade. To do this, follow our Bitbucket Server downgrade guide.
If you’re using bundled search, you’ll also need to delete search index data before downgrading Bitbucket.
このガイドでは、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 をアップグレードする前に、いくつかの質問に答える必要があります。
| インストーラーの使用は適切なアップグレード方法ですか? | |
| アップグレードの資格がありますか? |
詳細を読む...
ご利用のライセンスでソフトウェア メンテナンスが有効かどうかを調べるには、
 > [ライセンス] に移動して、ライセンスのサポート期間が失効していないことを確認します。サポート期間が失効しいる場合、プロンプトに従ってライセンスを更新し、再適用してからアップグレードを行います。 |
| サポート対象プラットフォームに変更はありますか? | |
バージョン固有のアップグレード情報をすべて考慮しましたか？ | アプリケーションの現在のバージョンとアップグレード先のバージョンとの間の各バージョンについて、関連するセクションをご確認ください。 This will give you information about specific update notes for each version of Bitbucket Data Center. |
Bitbucket 4.x より前のバージョンからアップグレードしていて、server.xml ファイルを変更しましたか? |
アップグレードを計画する
1. アップグレード パスを決定する
アップグレードにおいて必須となるパスはないため、Bitbucket Server (または Stash) の過去の任意のバージョンから最新バージョンに更新できます。
Bitbucket Data Center and Server 8.x is a major upgrade
本番サイトをアップグレードする前に、Bitbucket Server 8.0 のリリース ノートを確認し、完全なバックアップを作成して、非本番環境でアップグレードのテストを行うようにしてください。
Upgrading from a version older than Bitbucket 8.x disables all user-installed apps on startup
Be sure to update your own apps and check the Atlassian Marketplace to ensure 3rd-party apps are compatible with Bitbucket Data Center and Server 8.x before upgrading.
次のバグ修正アップデートへのアップグレード
複数ノードの Bitbucket クラスタを次のバグ修正アップデートにアップグレードする場合 (8.0.0 から 8.0.1 など)、ダウンタイムなしでアップグレードできます。
2. アップグレード前の確認を完了する
- アップグレード先として計画しているバージョン (およびその間のバージョン) のバージョンごとのアップグレード ノートを確認します。
> [サポート ツール] に移動し、解決が必要な問題がログ アナライザーにあるかどうかを確認します。利用しているアプリに、アップグレード先として計画しているバージョンとの互換性があるかどうかを確認します。
- > [アプリの管理] > [Bitbucket 更新の確認] に移動します。
アップグレード先として計画しているバージョンを選択して [確認] を押します。
3. Bitbucket をテスト環境でアップグレードする
- 現在の本番環境のステージング コピーを作成します。
- 以下の手順に従って、テスト環境をアップグレードします。
- 本番環境のアップグレード前に、すべてのサポート対象外のアプリ、カスタマイズ、およびプロキシ構成 (可能な場合) をテストします。
Bitbucket のアップグレード
このアップグレード プロセスは、インプレースのアップグレードではなく、新しいインストール ディレクトリに新しいバージョンの Bitbucket Server をインストールします。新しいインスタンスは、既存の Bitbucket Server のホーム ディレクトリと外部データベースを使用します。
アップグレードのロールバックは、Bitbucket Server のホーム ディレクトリと Bitbucket Server データベースの両方のバックアップを復元することでのみ行なうことができ、ホーム ディレクトリとデータベースが一貫している必要があります。その後、アプリケーションの過去のバージョンをインストール ディレクトリに再インストールできます。詳細についてはロールバックのセクションをご参照ください。
4. Bitbucket Server をダウンロードする
Take this step only if you're upgrading to Bitbucket Server 8.14 or earlier.
Download the installer (the recommended approach) for your operating system - www.atlassian.com/software/bitbucket/download.
5. データをバックアップする
使用するバックアップ戦略を決定します。
- Bitbucket ホーム ディレクトリと外部データベースのすべてのデータをバックアップします。
6. カスタマイズ設定を移行する
Bitbucket 4.x 以前のバージョンからアップグレードする場合は、「カスタマイズ設定を移行する」を参照してください。
7. アプリケーションを停止する
Bitbucket Server を Linux ターミナルから停止するには、<Bitbucket Server installation directory> に移動して次のコマンドを実行します。
bin/stop-bitbucket.sh詳細な手順については「Bitbucket の開始と終了」ページをご確認ください。
8. インストーラーを実行する
インストーラーは、GUI、コンソール または無操作モードで実行できます。
インストーラーを実行します。Linux ターミナルから、Bitbucket Server のダウンロード先のディレクトリに移動し、次のコマンドを実行してインストーラーを実行可能にします。
chmod +x atlassian-bitbucket-x.x.x-x64.binsudoを使用してインストーラーを実行することをお勧めします。これにより Bitbucket Server を実行する専用アカウントが作成され、Bitbucket Server をサービスとして実行できます。インストーラーを実行するために
sudoを使用するには、次のコマンドを実行します。$ sudo ./atlassian-bitbucket-x.x.x-x64.binroot ユーザー権限でインストーラーを実行することもできます。
- プロンプトに従って Bitbucket Server をアップグレードします。
[Welcome] ステップで、アップグレードするインスタンスのタイプを選択します。
「Select Bitbucket Server Home」ステップで、既存のホーム ディレクトリを選択します。
インストーラー残りのステップに従います。
9. アプリケーションを開始する
オペレーティング システムのライブラリもアップグレードしていて、PostgresSQL と glibc のバージョンが2.28よりも前のものを使い、アップグレードによって glibc のバージョンが 2.28 以降に上がる場合、Bitbucket を起動する前に PostgresSQL のインデックスを再構築する必要があります。
インストーラーを使用している場合、インストール ウィザードの最後に、アプリケーションを開始してブラウザで開くオプションがあります。
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.
- 更新中に問題が発生していて解決が難しい場合、サポート チケットを作成してください。アトラシアンのサポート エンジニアがお手伝いします。