Upgrade Bitbucket without downtime
はじめる前に
ローリング アップグレードの計画を開始する前に、いくつかの質問に答える必要があります。
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. |
ローリング アップグレード中にユーザー リクエストをサポートするために十分なノードはありますか? | 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. アップグレード前の確認を完了する
- アップグレード先として計画しているバージョン (およびその間のバージョン) のバージョンごとのアップグレード ノートを確認します。
- Go to Administration and select Support Tools. Then, review the Log analyzer for any issues that may need to be resolved.
利用しているアプリに、アップグレード先として計画しているバージョンとの互換性があるかどうかを確認します。
- Go to Administration and select Manage apps. Then, select Bitbucket update check.
Choose the version you plan to upgrade to. Then, select Check.
UPM アプリ署名チェックを設定する
Before proceeding with your Bitbucket 10 upgrade or installation, configure the Universal Plugin Manager (UPM) app signature check.
署名検証用の証明書がインストールされていない場合、[アプリの管理] 画面に「署名のチェックに失敗しました」というエラーが表示されてアプリのインストールに失敗します。
2.アップグレード期間中にアプリのインストールまたはアップグレードが実行されないようにします。
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
使用するバックアップ戦略を決定します。
- Bitbucket ホーム ディレクトリと外部データベースのすべてのデータをバックアップします。
デプロイが AWS でホストされている場合、スナップショットを使用してサイトのバックアップを作成する、AWS のネイティブ バックアップ機能を使用することをおすすめします。詳しくは、「AWS バックアップ」を参照してください。
4.ローリング アップグレードをテストするためのステージング環境のセットアップ
最初に、ステージングまたはテスト環境におけるローリング アップグレードの実行を強くお勧めします。
- 現在の本番環境のステージング コピーを作成します。
- 以下の手順に従って、テスト環境をアップグレードします。
- Test any unsupported apps, customizations, and proxy configuration (if possible) before upgrading your production environment.
ローリング アップグレードの実行
There are three methods for performing a rolling upgrade, depending on what orchestration tools your deployment uses:
| Method | 説明 | 手順 |
|---|---|---|
手動アップグレード | 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 コールを使用して、ローリング アップグレード プロセス全体をオーケストレーションできます。 |