Java と Bamboo を使い始める

This page describes how your development team can start using the Bamboo continuous integration server to get rapid feedback on your Java project.

You may want to read Understanding the Bamboo CI Server first.

すでに次のものが存在すると仮定します。

Bamboo installed and running. See the Bamboo installation guide for details. You'll want user accounts in Bamboo for each member of your team.
バージョン管理されたソースコード。各チームメンバーがリポジトリにアクセスできる
テスト (プロジェクトのソースコードの一部として)
A command (e.g. a Maven goal) that builds the code and executes the tests.

継続的インテグレーションの推奨ワークフローは次のとおりです。

開発者がコードをコミットします。
次のように Bamboo でプロジェクトをビルドします。
1. リポジトリに接続し、ソースコードをチェックアウトします。
2. コードをコンパイルします。
3. ユニットテストと統合テストを実行します。
Bamboo がテスト結果に関するフィードバックを提供します。

Bamboo でこのワークフローを実行するにはどうすればよいでしょうか。

これから、ソースコードをチェックアウトしてビルドする方法を知っている新しい Bamboo 計画を作成し、テスト結果をレポートします。

このページの内容

関連ページ

Bamboo 計画を作成する

Bamboo 計画では、継続的インテグレーションワークフローの詳細を定義します。

計画を使用すると、ソースコードのリポジトリ、Bamboo がビルド実行をトリガーするタイミング、Bamboo がテスト結果のフィードバックを提供する方法を指定できます。

1. プランの詳細

メニューバーで [プランを作成] をクリックして、次に [Create a New Plan (新しいプランを作成)] をクリックします。

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

See Configuring plans for details.

2. ソースリポジトリを選択する

Bamboo はソースコードリポジトリがどこにあるかを知る必要があり、ビルド実行時にコードをチェックアウトできるよう、リポジトリにアクセスする必要があります。

ソースリポジトリからリポジトリタイプを選択し、ユーザー名やパスワードなどのアクセス詳細を指定します。

See Connecting to code repositories for details.

3. Build strategy

The build strategy for a plan lets us choose how Bamboo gets triggered to run the build.

コードがリポジトリにチェックインされるたびに、Bamboo がプロジェクトをビルドするようにします。

Choose Build Strategy > Repository triggers the build..., and optionally, specify an IP address for the repository server.

See Triggering builds for details.

4. タスクの設定

計画ごとに 1 つ以上のタスクを指定する必要があります。タスクは計画の実際の作業を実行します。

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

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

See Checking out code for details.

ビルダータスク

We also want to compile the code, and run the unit and integration tests. We'll add a builder task to the Bamboo plan to do that. We assume that your project already has a build process set up that Bamboo can call upon.

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

See http://ant.apache.org/manual/index.html for information about Ant.

Bamboo では Maven 1.0 と Maven 2.0 もサポートされています。

See http://ant.apache.org/manual/index.html for information about Maven.

See http://grails.org/doc/latest/guide/index.html for information about Grails.

注意:

Bamboo タスクを使用する前に、Bamboo サーバーマシンにビルドツールをインストールする必要があります。
There are plugins available for Bamboo that add build tasks for other tools, such as Gant and Gradle. See https://plugins.atlassian.com/plugin/details/27818?versionId=851052 for details.

テスト結果を取得する

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

See Configuring jobs and tasks for details.

5. 実行

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

計画が実行されるのを確認できます。[プラン概要] タブにビルドが成功したかどうかが表示されます。

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

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

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

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

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

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

See Getting feedback for details.

Child pages