Bitbucket Data Center アップグレード ガイド
アップグレードを計画する
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 をテスト環境でアップグレードする
- 現在の本番環境のステージング コピーを作成します。
- 以下の手順に従って、テスト環境をアップグレードします。
- 本番環境のアップグレード前に、すべてのサポート対象外のアプリ、カスタマイズ、およびプロキシ構成 (可能な場合) をテストします。
Upgrade Bitbucket Data Center
1. Back up your data
使用するバックアップ戦略を決定します。
- Bitbucket ホーム ディレクトリと外部データベースのすべてのデータをバックアップします。
2. クラスタの停止
You must stop all the nodes in the cluster before upgrading. For more info, see Starting and stopping Bitbucket.
We recommend configuring your load balancer to redirect traffic away from Bitbucket until the upgrade is complete on all nodes.
3. Download Bitbucket
Download the appropriate file for your operating system - https://www.atlassian.com/software/bitbucket/download-archives.
4.1 つ目のノードをアップグレードする
- Extract the files to a directory. This will be your new installation directory and it must be different from your existing installation directory.
Update the value of BITBUCKET_HOME in the
<Installation-directory>/bin/set-bitbucket-home.shfile so the new Bitbucket installation points to your existing Bitbucket home directory.If you’re using a BITBUCKET_HOME environment variable to specify the home directory location, no change is required.
Copy any other immediately required customizations from the old version to the new one. For example, if you aren’t running Bitbucket on the default ports or if you’re managing users externally, you'll need to update or copy the relevant files.
If you’ve configured Bitbucket to run as a Linux service, don't forget to update its service configuration as well. Learn more about running Bitbucket as a Linux service
- Start Bitbucket on the node. Learn more about starting Bitbucket
Why doesn’t Bitbucket search work after the upgrade?
When you’re starting up your Bitbucket Data Center instance after the upgrade, the bundled search server won’t run. Instead, the remote search will be started.
This happens because Data Center instances use the remote search, not the bundled search.
During the upgrade, the --no-search flag is inserted in the /etc/init.d/atlbitbucket file. This flag allows running the remote search but blocks the bundled search.
5. Copy Bitbucket to remaining nodes
The next step is to replicate your upgraded Bitbucket directories to other nodes in the cluster.
Stop Bitbucket on the first node.
Copy the installation directory and local home directory from the first node to the next node.
If the path to the local home directory is different on this node, edit the /bin/set-bitbucket-home.sh to point to the correct location.Start Bitbucket, and confirm that everything works as expected.
Stop Bitbucket on this node before continuing with the next node.
残りの各ノードに対し、同様のプロセスを繰り返します。
6. Start Bitbucket and check cluster connectivity
Once all nodes have been upgraded you can start Bitbucket Data Center on each node, one at a time (starting up multiple nodes simultaneously can lead to serious failures).
The Cluster monitoring console (Administration > Settings > Clustering) includes information about the active cluster nodes. When the cluster is running properly, you should be able to see the details of each node.