はじめる前に知っておくべき情報

Bamboo で利用できるリソースについてある程度想定しておけるように、このチュートリアルでは Bamboo Cloud を使用していることを前提としています。

ローカル ネットワークにインストールされた Bamboo Server を使用している場合でも、このチュートリアルを使用できます。必要なのは、ご自身または所属企業の管理者が、プランを実行するために Bamboo を適切にインストールして設定していることを確認するだけです。

また、個人用 Bitbucket アカウントを持っていることも前提としています。アカウントを持っていない場合は、こちらからわずか数分で作成できます。チュートリアルが完了したらいつでもアカウントを削除できます。使用できます

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

Bamboo プランでは、ソース コード リポジトリ、ビルドで実行するタスク、ビルドをトリガーするタイミングを指定します。最初に次の手順で新しいプランを作成します。

1. プランを作成できる権限を持つユーザーとして Bamboo インスタンスにログインします。
2. メニュー バーから [作成] > [新しいプランを作成する] を選択します。

すべてのプランがプロジェクトに属しています。まだプロジェクトがないため、[プロジェクト] > [新規プロジェクト] を選択して、プロジェクトとプラン両方についての詳細を入力します。

プラン名、プラン キー、プランの目的の簡単な説明を Bamboo に通知する必要があります。 

詳細は「プランの設定」をご確認ください。

2. ソース リポジトリに接続する

ソース コード リポジトリの場所を Bamboo に通知する必要があり、ビルド実行時にコードをチェック アウトできるよう、リポジトリにアクセスできる権限を Bamboo に付与する必要があります。Bitbucket の資格情報を入力し、[Load Repositories (リポジトリを読み込み)] をクリックしてリポジトリを参照します。

必要に応じて、このチュートリアルの Bitbucket のデモ用 atlassian_tutorial/helloworld リポジトリに接続してください。

詳細は「ソース コード リポジトリへのリンク」をご確認ください。

3. ビルドのトリガー方法を選択する

Bamboo でプラン ビルドを実行するトリガーを選択できます。このチュートリアルでは、コードがリポジトリにコミットされたときに Bamboo でビルドが実行されるようにします。

[Trigger IP Addresses (トリガー IP アドレス)] の設定は空のままにしておきます。

詳細は「ビルドのトリガー」をご確認ください。

4. タスクの設定

プランごとに 1 つ以上のタスクを指定する必要があります。タスクによってプランの実際の作業が実行されます。

ソース コード チェックアウト タスク

新しく作成された計画には、先ほど指定したソース リポジトリからソース コードを取得する既定のソース コード チェックアウト タスクがあります。

詳細は「コードのチェックアウト」をご確認ください。

ビルダー タスク

また、コードをコンパイルして、ユニット テストと統合テストを実行します。そのために、Bamboo プランにビルダー タスクを追加します。プロジェクトには、Bamboo が呼び出せるビルド プロセスがすでに設定されていると仮定します。

[タスクを追加] をクリックしてから [ビルダー] をクリックして、プロジェクトのビルド ツールに合ったタスクを選択します。次のセクションのいずれかを展開して、そのビルダー タスクに固有の設定詳細を表示します。

注意:

• Bamboo タスクを使用する前に、Bamboo サーバー マシンにビルド ツールをインストールする必要があります。
• Bamboo には、Gant や Gradle などの他社製ツールのビルド タスクを追加するプラグインがあります。詳細については Atlassian Marketplace をご確認ください。

テスト結果を取得する

ビルダー タスクによってコードがコンパイルされるとテストが実行されます。上記の各ビルダー タスクには、テスト結果が生成されること、およびテスト結果の保存場所を Bamboo に通知するセクションがあります。プロジェクト ディレクトリで従来の構造を使用していない場合は、結果が保存される場所を指定できます。

詳細については、「ジョブの設定」と「 タスクの設定 」をご確認ください。

5. プランを実行する

計画を有効にして、[作成] をクリックします。

プランが実行されるのを確認できます。Bamboo によって以下が実行されます。

• コード リポジトリに接続する
• ソース コードをチェックアウトする
• コードをコンパイルする
• ユニット テストと統合テストを実行する
• テスト結果を報告する

ビルドが成功したかどうかが [プラン概要] タブに表示されます。

ソース コード リポジトリの適切なディレクトリでのテストは、ビルドの一部として自動的に実行され、そのテスト結果は Bamboo に表示されます。

これで、リポジトリに変更をコミットするたびに、Bamboo がソース コードをビルドしてテスト結果をレポートします。

6. フィードバックを取得する

Bamboo のダッシュボードにビルド結果の要約が表示されます。

ビルドに関する詳細情報は、次の方法で入手できます。

• 1 つ以上の計画のビルド結果をウォールボードで確認できます。
• ビルド結果に関する通知をメール、インスタント メッセージ (IM)、RSS フィードで受信できます。
• 計画に関するビルド統計や、ビルドにコードを提供している開発者に関するビルド統計を取得できます。
• 結果を掘り下げて、ビルドをトリガーしたコードの変更内容と、そのビルドに対して実行されたテストを確認できます。

詳細は「フィードバックの取得」をご確認ください。