Bitbucket Server 7.1 のインストール (Linux)

はじめに

Bitbucket Sever は、企業向け Git リポジトリ管理ツールです。ファイアーウォールの内側で Git リポジトリを作成、管理できます。細かいパーミッションの設定も可能です。

インストールする環境は以下を想定しています。

このページの手順を実施する前に、以下のページの手順を実施して下さい。

• PostgreSQL のインストールと DB (データベース) の作成 (CentOS 7.x)
• Git のインストール (Linux)

Bitbucket インストールファイルのダウンロード

Bitbucket は、Atlassian のホームページからダウンロードできます。

ダウンロードするファイルを選択する画面が表示されます。
ここでは、2020/4/20 現在、最新のバージョンである Bitbucket 7.1.2 の Linux 64 bit を選択し Get started をクリックします。

同意を求めるダイアログが表示されるので、内容に問題がなければチェックボックスを有効にし Submit をクリックします。

ダウンロードしたファイルは適当なディレクトリに保存してください。

インストール

Bitbucket を Linux 環境にインストールします。

ダウンロードしたインストールファイルは、あらかじめサーバーへ転送しておいてください。

1. ファイルの実行権限を変更する

以下のコマンドを実行し、インストールファイルに対する実行権限を設定します。

chmod 744 atlassian-bitbucket-7.1.2-x64.bin

2. インストールを実行する

以下のコマンドを実行し、Bitbucket のインストールを実行します。

./atlassian-bitbucket-7.1.2-x64.bin

途中でインストールする内容の確認が表示されますので、下記を参考に確認事項に回答してインストールを進めてください。

Unpacking JRE ...
Starting Installer ...

Bitbucket 7.1.2 installation wizard
Would you like to install or upgrade an instance?
Install a new instance [1, Enter], Upgrade an existing instance [2]          → 新規インストールのため Enter キーを押します。


Install Bitbucket 7.1.2
What type of instance are you looking to install?
Install a Server instance [1, Enter], Install a Data Center instance [2], Install a Smart Mirroring instance [3]          → 今回は Server 版のインストールなので Enter キーを押します。

Where should Bitbucket be installed?

Select the folder where you would like Bitbucket 7.1.2 to be installed, then
click Next.
[/opt/atlassian/bitbucket/7.1.2]          → インストールディレクトリの場所を指定します。今回はデフォルトのままインストールを進めるので Enter キーを押します。

Default location for Bitbucket home directory

The location for Bitbucket data.
This will be the default location for repositories, plugins, and other data.

Ensure that this location is not used by another Bitbucket installation.
[/var/atlassian/application-data/bitbucket]          → データディレクトリの場所を指定します。今回はデフォルトのままインストールを進めるので Enter キーを押します。

Configure which ports Bitbucket will use.


Configure TCP Ports
Bitbucket requires a TCP port that isn't being used by other applications.

The HTTP port is where users access Bitbucket through their browsers.

Bitbucket also requires ports 7992 and 7993 are available to run an embedded
Elasticsearch instance that provides search functionality to Bitbucket.
HTTP Port Number
[7990]          → Bitbucket で使用するポートを指定します。今回はデフォルトのままインストールを進めるので Enter キーを押します。



Run as a service
For a production server we recommend that you run Bitbucket as a
Windows/Linux service because Bitbucket will restart automatically when the
computer restarts.
Install Bitbucket as a service?
Yes [y, Enter], No [n]          → Bitbucket をサービスとしてインストールするかを指定します。今回はサービスとしてインストールするので Enter キーを押します。

Please review your Bitbucket installation settings


Installation Summary
Installation Directory: /opt/atlassian/bitbucket/7.1.2
Home Directory: /var/atlassian/application-data/bitbucket
HTTP Port: 7990
Install as a service: Yes

Install [i, Enter], Exit [e]          → 内容に問題がなければ Enter キーを押してインストールします。


Extracting files ...


Installation of Bitbucket is complete
Would you like to launch Bitbucket?
Yes [y, Enter], No [n]          → 起動するか聞かれますが、先に設定ファイルを編集するため "n" + Enter キーを押してインストールを終了します。
n

An important note about changes to starting Bitbucket Server
Bitbucket Server standard startup commands have changed to automatically
start a new service that enabled code search.When starting Bitbucket Server
manually, ensure you start all required services using both of the following
command:service atlbitbucket start

Installation of Bitbucket 7.1.2 is complete
Your installation of Bitbucket 7.1.2 is now ready and can be accessed via
your browser.
Bitbucket 7.1.2 can be accessed at http://localhost:7990
Finishing installation ...

3. コンテキストルートを指定する

bitbucket.properties ファイルを作成して、ブラウザーから Bitbucket へアクセスする際のコンテキストルートを設定します。

1. 以下のコマンドを実行し、Bitbucket のデータディレクトリに bitbucket.properties ファイルを追加します。

   vi /var/atlassian/application-data/bitbucket/shared/bitbucket.properties

2. 以下の行を追加します。

   server.context-path=/bitbucket

3. 保存してテキストエディタを閉じます。

4. パフォーマンス対策をする

_start-webapp.sh を編集して、文字化け対策とメモリ値を設定します。

1. 以下のコマンドを実行し、_start-webapp.sh ファイルをテキストエディタで開きます。

   vi /opt/atlassian/bitbucket/7.1.2/bin/_start-webapp.sh

2. 以下の行を見つけ、それぞれ変更していきます。
   
   

   1. JVM_SUPPORT_RECOMMENDED_ARGS のコメントアウトを解除し、起動上限時間の延長と文字化け対策のパラメータを設定します。
      また、LANG 変数についての行を追記し、文字化け対策の定義を追加しておきます。

      変更前

      #JVM_SUPPORT_RECOMMENDED_ARGS=

      変更後

      JVM_SUPPORT_RECOMMENDED_ARGS="-Datlassian.plugins.enable.wait=300 -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8"
      export LANG=en_US.UTF-8

   2. JVM_MINIMUM_MEMORY の値を変更し、パフォーマンス対策のため最小メモリ値を 1g へ変更します。

      変更前

      JVM_MINIMUM_MEMORY=512m

      変更後

      JVM_MINIMUM_MEMORY=1g

5. Bitbucket を起動する

設定が完了したら、以下のコマンドを実行し Bitbucket を起動します。

service atlbitbucket start

セットアップ

インストールした Bitbucket を起動し、初めてブラウザーからアクセスすると、セットアップウィザードが始まります。

セットアップウィザードでは、ライセンス情報の入力や管理者アカウントの作成などを行います。

1. セットアップウィザードを開始する

Bitbucket を起動し、ブラウザーから "http://(IP アドレスまたはホスト名):7990/bitbucket" にアクセスすると、下図のようなセットアップウィザードの画面が表示されます。

2. データベースを設定する

データベースで 外部 を選択し、下側に表示される各項目を入力していきます。

入力する内容は以下を参考にしてください。
指定できたら テスト ボタンを押して次に進みます。

テストに成功すると下図のように表示されます。つづけて 次へ ボタンをクリックします。

3. ライセンスを入力する

ライセンスと設定 画面が表示されます。ここで Bitbucket の名前とベース URL を指定できます。
ライセンスキー の項で Bitbucketのライセンスキーを持っています を選択し、弊社より送付しましたライセンスキーを貼り付けて 次へ ボタンをクリックします。

4. 管理者アカウントを作成する

最後に管理者アカウントを作成します。この画面で入力した内容で最初の管理者ユーザーが作られます。

各項目に入力する内容は、以下の表を参考にしてください。
入力できたら Bitbucketへ移動する ボタンをクリックします。 

下図のようにログイン画面が表示されたら Bitbucket のセットアップは完了です。
作成した管理者アカウントの情報を入力してログインしましょう。

ログインすると、ようこそ画面が表示されます。

リポジトリの作成

セットアップが完了したところで、Bitbucket にプロジェクトとリポジトリを作成します。

1. プロジェクトを作成する

Bitbucket のインストール直後はプロジェクトが作成されていません。
以下の手順からプロジェクトを作成します。

1. 画面上部のメニューから プロジェクト をクリックし、表示される プロジェクト 画面から プロジェクトを作成 を選択します。
   
   
   
2. プロジェクトの基本情報を設定します。
   
   

   各項目に設定する内容は、以下の表を参考にしてください。
   入力できたら プロジェクトを作成 ボタンをクリックします。 

   項目	内容
   プロジェクト名	プロジェクトの名前
   プロジェクトキー	プロジェクト固有の識別子
   説明	プロジェクトの説明
   プロジェクトアバター	プロジェクトのアバター画像

   
   

2. リポジトリを作成する

作成直後のプロジェクトには、リポジトリが存在しません。
以下の手順からリポジトリを作成します。

1. プロジェクトの画面から、リポジトリの作成 ボタンをクリックします。
   
   
   
2. リポジトリの基本情報を設定します。
   
   

   各項目に入力する内容は、以下の表を参考にしてください。
   入力できたら リポジトリを作成 ボタンをクリックします。 

   項目	内容
   名前	リポジトリの名前
   説明	リポジトリの説明

3. ファイルを追加する

リポジトリが作成されると、下図のようにリポジトリにファイルを追加するためのヒントが表示されます。

ここで、クライアント側から任意のツールを使い、作成したリポジトリにファイルをプッシュします。
変更が反映されると、更新 ボタンをクリックするかリポジトリを開き直したときに変更内容が画面に表示されます。

以上で Bitbucket のインストールは完了です。