このページでは、Atlassian の Git リポジトリ管理ツールである Bitbucket を Linux 環境にインストールする手順について紹介します。

はじめに

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

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

プログラムディレクトリ	/opt/atlassian/bitbucket/7.1.2
データディレクトリ	/var/atlassian/application-data/bitbucket
コンテキストルート (URL でサーバー名に続く文字）	/bitbucket
インストールを実行するユーザー	root
Bitbucket 稼働ユーザー	atlbitbucket
DB (データベース)	Bitbucket と同一のコンピュータにインストールされた PostgreSQL を利用 (今回は bitbucket を使用)
Java	AdoptOpenJDK 1.8 (インストーラ同梱の Java を利用)
Git	ver. 2.25.4 をビルド
起動方法	サービスとして登録し、自動起動する

ご注意ください

Bitbucket のバージョンによってサポートされている稼働環境は異なります。
最新の情報は、サポート対象プラットフォームのページからご確認ください。

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

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

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

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

以前のバージョンをダウンロードしたい場合はすべての Server バージョンのリンクをクリックします。ページが移動しますので該当のバージョンをダウンロードしてください。

同意を求めるダイアログが表示されるので、内容に問題がなければチェックボックスを有効にし 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 へアクセスする際のコンテキストルートを設定します。

以下のコマンドを実行し、Bitbucket のデータディレクトリに bitbucket.properties ファイルを追加します。
```
vi /var/atlassian/application-data/bitbucket/shared/bitbucket.properties
```
以下の行を追加します。
```
server.context-path=/bitbucket
```
保存してテキストエディタを閉じます。

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

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

以下のコマンドを実行し、_start-webapp.sh ファイルをテキストエディタで開きます。
```
vi /opt/atlassian/bitbucket/7.1.2/bin/_start-webapp.sh
```
以下の行を見つけ、それぞれ変更していきます。
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

RHEL 7 や CentOS 7 系の OS をご利用の場合は、systemd を利用する起動スクリプトを別途作成する方法もございます。

Bitbucket Server 起動スクリプトを変更する (CentOS7系)

セットアップ

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

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

ご注意ください

セットアップウィザードは、インストール後初めて Bitbucket にアクセスすると表示されます。
http://localhost:7990/bitbucket でセットアップを実施した場合は、セットアップ後に管理画面の一般設定で ベース URL を変更しなければ、他のコンピュータからアクセスした場合に不具合が発生します。
ベース URL の変更方法は Specifying the base URL for Bitbucket Server をご確認ください。

ベース URL とは

Bitbucket へアクセスするときに使用する URL です。Bitbucket 以外のコンピュータからアクセスしたときに参照できる (ブラウザーで開くことのできる) URL を指定します。
ベース URL が "localhost", "127.0.0.1" に設定されている場合は、Bitbucket 以外のコンピュータから Bitbucket にアクセスできない可能性があります。

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

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

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

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

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

項目名	内容	入力値
データベースタイプ	DB (データベース) の種別	PostgreSQL
ホスト名	DB サーバーのホスト名か IP アドレス	localhost
ポート	DB への接続に使用するポート番号	5432
データベース名	DB の名前	bitbucket (DB 作成時の DB 名)
データベースユーザー名	DB のユーザー名	bitbucket (Bitbucket 用 DB を作成したときのユーザー名)
データベースパスワード	DB のパスワード	Bitbucket 用 DB を作成したときのパスワード

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

次へボタンを押すとデータベースの初期化処理が実行されます。
場合によっては少し時間がかかるかもしれません。

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

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

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

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

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

項目	内容
ユーザー名	管理者ユーザーのログインユーザー名
お名前	管理者ユーザーの表示名
メールアドレス	管理者ユーザーの電子メールアドレス
パスワード	ログインパスワード
パスワードを確認	ログインパスワードの確認入力

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

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

リポジトリの作成

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

リポジトリの操作について

クライアント側での Git リポジトリの操作については、ご使用になっているツールの取扱説明書を参照してください。

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

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

画面上部のメニューからプロジェクトをクリックし、表示されるプロジェクト画面からプロジェクトを作成を選択します。

プロジェクトの基本情報を設定します。

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

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

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

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

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

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

3. ファイルを追加する

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

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

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

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

サポートされていないブラウザーです