Bitbucket Server を別のサーバーに移行する

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

このページでは、Bitbucket Server のインストールを 1 つの物理マシンから別のマシンに移動する方法について説明します。ほとんどの場合、次の 4 ステップのプロセスを行います。状況により、これらのすべては必要ではない場合があります。

  1. 移行を準備します。
  2. Bitbucket Server データを移動します。
  3. Move the Bitbucket Server installation to the new location, and update the value of the BITBUCKET_HOME environment variable.
  4. Bitbucket Server bitbucket.properties ファイルを更新します。この手順は、ステップ 2 で移行ウィザードを使用できない場合に必要です。

Bitbucket Server アップグレード ガイドもご参照ください。Bitbucket Server を移行する前または後に Bitbucket Server をアップグレードできます。このページでは、アップグレード方法については説明していません

1. 移行の準備 

Bitbucket Server から別のサーバーへの移行の準備では、以下の手順が完了していることを確認します。

  • 新しいマシンのオペレーティング システム、データベース、その他の必要なプラットフォームおよびハードウェアが Bitbucket Server の要件を満たしていることを確認します。
  • Bitbucket Server ナレッジベースで、既知の問題がないかどうかを確認します。
  • ユーザーに対し、今後の Bitbucket Server のサービス停止を警告します。
  • 移行中、ユーザーが既存の Bitbucket Server データを更新できないようにします。これは、Bitbucket Server のアクセス権限を一時的に変更することで実現できます。
  • 新しいサーバーが外部ユーザー ディレクトリへのアクセス権を持っていない場合に Bitbucket Server から閉め出されるのを防ぐため、外部ユーザー ディレクトリではなく Bitbucket Server 内でシステム管理者グローバル権限を持つユーザーを作成済みであることを確認します。

2. Bitbucket Server のデータを別のマシンに移動する

このセクションでは、Bitbucket Server のデータを別のマシンに移動する方法の概要について説明します。組み込みのデータベースを引き続き使用する場合、操作は不要です。Bitbucket Server インストールを移動させた際に、Bitbucket Server のデータも移動されます。

Bitbucket Server のデータには、データ ディレクトリ (Git リポジトリを含む)、ログ ファイル、インストール済みプラグイン、一時ファイル、およびキャッシュが含まれます。

Bitbucket Server のデータは次のように移動できます。

  • 埋め込みデータベースからサポート対象の外部 DBMS へ。
  • 同じ DBMS の別のインスタンスへ。
  • 1 つの DBMS からサポート対象の別の DBMS (例: MySQL から PostgreSQL へ)。

実際の DBMS を移動することもできます。アトラシアンでは大規模なインストールの場合、Bitbucket Server と DBMS を別のマシンで実行することをおすすめしています。

2 つのステップがあります。

  1. 新しい場所で DBMS を作成して構成します。詳細については、「Bitbucket Server を外部データベースに接続する」と、関連する子ページを参照してください。
  2. 次のいずれかを実行します。
    • 新しい場所が Bitbucket Server から参照可能な場合、Bitbucket Server データベース移行ウィザードを使用します。詳細は、「Bitbucket Server を外部のデータベースに接続する」と、関連する子ページを参照してください。  
    • If the  new location is not currently visible to Bitbucket Server (perhaps because you are moving to a new hosting provider), you need to perform a database export and then import the backup to the new DBMS. Please refer to the vendor documentation for your DBMS for detailed information.
      You will also need to update the bitbucket.properties file in the <Bitbucket home directory> as described below.

3. Bitbucket Server を別のマシンに移動する

このセクションでは、Bitbucket Server インストールの別のマシンへの移動について説明します。

  1. Bitbucket Server を停止します。「Bitbucket Server の開始および終了」をご参照ください。
  2. Bitbucket ホーム ディレクトリのアーカイブ (zip ファイルなど) を作成します。ホーム ディレクトリには、データ ディレクトリ (Git リポジトリ)、ログ ファイル、インストール済みプラグイン、SSH フィンガープリント、一時ファイルやキャッシュが含まれます。ホーム ディレクトリの場所は次のように定義されます。
    • on Windows, by the BITBUCKET_HOME environment variable, or by the BITBUCKET_HOME line of <Bitbucket Server installation directory>/bin/set-bitbucket-home.bat.
    • on Linux and Mac, by the BITBUCKET_HOME line of <Bitbucket Server installation directory>/bin/set-bitbucket-home.sh.

  3. Bitbucket ホーム ディレクトリのアーカイブを新しいマシンにコピーして、そこで新しい場所に展開します。

    • 本番環境の場合、Bitbucket Server ホーム ディレクトリを認証されていないアクセスから保護する必要があります。詳細は「Bitbucket ホーム ディレクトリ」を参照してください。

    • When moving the Bitbucket Server home directory  from Windows to Linux or Mac, make sure that the files within <Bitbucket home directory> /git-hooks and <Bitbucket home directory> /shared/data/repositories/<repoID>/hooks directories have the executable file permission set.
  4. 次のいずれかの操作を実行して、Bitbucket Server インスタンスを新しい場所でセットアップします。
    • 古い Bitbucket Server インストール ディレクトリのアーカイブを作成して、新しいマシンにコピーします。
    • 新しいマシンで同じバージョンの Bitbucket Server をゼロからインストールします。
  5. Redefine the value for BITBUCKET_HOME, mentioned in Step 2. above, in the new <Bitbucket Server installation directory>, using the new location for your copied home directory. See Bitbucket Server home directory for more information.
  6. Bitbucket Server の組み込みデータベースを引き続き使用する場合、または移行ウィザードを使用して Bitbucket Server データを移行した場合は、この時点で新しいマシンで Bitbucket Server を開始し、すべてのデータを利用できます。「Bitbucket Server の開始および終了」をご参照ください。Bitbucket Server の新しいインストールが正常に機能していることを確認したら、Bitbucket Server へのアクセス権限を元の値に戻します。
  7. If you moved the Bitbucket Server data by performing a database export and import, carry on to Step 4. below to update the bitbucket.properties file in the <Bitbucket home directory>.

4. Bitbucket Server 構成の更新

If you moved the Bitbucket Server data by performing a database export, you must update the bitbucket.properties file within <Bitbucket home directory>/shared with the changed configuration parameters for the database connection.

構成パラメーターについては「Bitbucket Server 構成プロパティ」を参照してください。

構成パラメーターが更新されたら、新しいマシンで Bitbucket Server を開始し、すべてのデータを利用できます。「Bitbucket Server の開始および終了」をご参照ください。Bitbucket Server の新しいインストールが正常に機能していることを確認したら、Bitbucket Server へのアクセス権限を元の値に戻します。

最終更新日 2018 年 5 月 28 日

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

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