このページでは...

... describes how the Atlassian development tools work together with JIRA to give your team a fast and guided software development process.

Set it up...

... with our  guide to help JIRA admins set up JIRA and the Atlassian tools, so they work together as advertised.

For JIRA Cloud...

... see our guide to how JIRA and the Atlassian development tools work together in the cloud.

 

JIRA, Bitbucket Server and Bamboo integrate to support common Git workflows, while making your team's progress easy to see and understand. 

Add FishEye to get Subversion support, and connect Crucible for code reviews. And you can also use your repos hosted in Bitbucket. 

 

Create a feature branch from JIRA when starting work on an issue

 

 

If you use Bitbucket to manage your Git repositories, your developers can create a code branch directly from an issue in JIRA or JIRA Agile. Clicking Create branch opens your DVCS application to begin the branch creation process. The process guides the developer in a number of ways at this crucial step:

• ブランチを作成できる、利用可能なリポジトリ アプリケーションの表示
• It starts with the developer's latest project and repository
• ブランチ元のブランチの提案
• It automatically adds the JIRA issue key to the new branch name.

Bitbucket Server suggests a branch type and a matching prefix for the branch name, when you have a branch model configured. The branch model helps developers to conform to your process guidelines when creating branches. Read more about the Bitbucket Server branch model.

 

ワークフローのステータスを自動更新する

Instead of having JIRA issue statuses lagging behind, and the team not knowing the true state of the project, JIRA administrators can now configure triggers in JIRA workflows that respond to events in your linked development tools. For example, when a developer creates a branch to start work on an issue in Bitbucket Server, the issue will automatically be transitioned from 'Open' to 'In progress' in JIRA.

JIRA responds to events in Bitbucket, FishEye and Crucible, as well as GitHub and GitHub:Enterprise.

現在利用可能なイベント:

• ブランチの作成
• コミットの作成
• プル リクエストの作成、マージ、却下、再オープン
• 開始、要約、承認、却下、クローズ漏れ、クローズしたレビュー

See all the branches made for a JIRA issue

 

The Development panel, seen above, shows how many branches are related to the issue, wherever they're located (perhaps in multiple instances of Bitbucket Server and FishEye, or hosted in Bitbucket). 

To see details of those branches, simply click the branches link. You'll see where each branch is located, and the status of any pull requests for the branches:

 

 

Click a branch to go to it in Bitbucket Server (or wherever it's hosted), or hover over a pull request status lozenge to see a direct link to the PR.

[プル リクエストの作成] リンクを使用してリポジトリを表示し、プル リクエストの作成プロセスを開始します。これは、特定のブランチでのコードの変更についてマージ前のディスカッションを開始するための優れた方法です。

As long as the branch name includes the issue key, and uses the default JIRA issue key format, the branch is automatically included in the Development panel.

 

See all the work for a JIRA issue

 

The Development panel shows the number of commits that are related to a JIRA issue. It collects those from all the linked instances of Bitbucket Server (or other linked repository applications such as Bitbucket and FishEye).

これらのコミットの詳細を確認するには、[コミット] リンクをクリックします。コミットの作成者、タイミング、および変更されたファイルの数を確認できます (マージ済みのコミットは灰色で表示されます)。

 

 

クリックして、特定のコミットをコミットが作成されたリポジトリで確認できます。 

A developer only needs to add the issue key to the commit message, using the default key format, for the commit to be automatically linked to the JIRA issue, and included in the commits summary in the Development panel for the issue.

 

ビルドが失敗しているかどうかをひと目で確認

 

The Development panel displays the most relevant status of all the Bamboo CI builds that are related to your JIRA issue. The status icon is:

   if all the different builds (for example, unit tests, functional tests, deploy to staging) succeeded.
   if at least one run failed for any build by any linked instance of Bamboo. 

これらのビルドの詳細を確認するには、[ビルド] リンクをクリックします。ビルド プランの名前と、成功または失敗したテストの数が表示されます。

 

クリックして、ビルド プランとビルド結果を Bamboo で表示できます。

プランのリポジトリで新しいブランチが検出されたときに Bamboo でプラン ブランチを自動的に作成するように構成できます。プラン ブランチを使用することで、master へのコミットだけでなくリポジトリ ブランチへのコミットで、継続的インテグレーションのテストを行うようにすることができます。Bamboo はこれを自動的に行うため、リポジトリのそれぞれの新しいブランチに対して新しい Bamboo プランを手動で繰り返し構成する必要はありません。Bamboo でのブランチ プランニングの詳細をご確認ください。

Bamboo can be configured to regularly poll the repo and to start a build when it finds changes. Alternatively, a repository change can trigger Bamboo to run the build, for example by using a post-receive web hook, such as this one. The web hook triggers the build plan (or plan branch) whenever a commit is made. Either way, the build result is passed to the JIRA issue and added to the summary in the Development panel. Note that Bamboo must be able to authenticate with Bitbucket Server to check out source code.

ビルド内の関与するコミットのコミットメッセージに JIRA 課題キーがある場合、ビルドは JIRA 課題へ自動リンクされます。

 

課題に対する作業の議論またはマージを特定

 

The Development panel shows the most relevant status of the pull requests that are related to a JIRA issue. The pull request status is:

オープン: オープンなプル リクエストが 1 つ以上ある場合。

マージ済み: オープンなプル リクエストがなく、1 つ以上のプル リクエストがマージされている場合

却下: オープンまたはマージ済みのプル リクエストがなく、1 つ以上のプル リクエストが却下されている場合

すべてののプル リクエストの詳細を確認するには、[プル リクエスト] リンクをクリックします。各プル リクエストのステータス、レビュアー、およびレビューを完了していない人物を確認できます。プル リクエストのコメントの数を確認することもできます。

 

 

Click on the title of a pull request to see see it in Bitbucket Server. 

Once you are ready to merge a pull request, and when the reviewers have approved it, just follow the link to the PR in Bitbucket Server.

Bitbucket Server can be configured to automatically merge changes to newer release branches. This reduces the need for manual maintenance of repository branches, and allows bug fixes, for example, to be propagated to other branches where they should be applied. Read more about automatic merging in Bitbucket Server.

A developer just needs to add the issue key to the title of the pull request, or have the key in the source branch name, for the PR to be automatically linked to the JIRA issue. Merge commits are not included.

 

コード レビューのステータスをひと目で確認

 

開発パネルには、Jira 課題に関連する Crucible レビューのもっとも関連性の高いステータスが表示されます。レビューのステータスは次のとおりです。

REVIEW 1 つ以上のオープンなレビューがある場合。

APPROVAL  if at least one review is ready for aproval.

SUMMARIZE オープンなレビューがなく、1 つ以上のレビューですべてのレビュアーがレビューを完了している場合。

REJECTED 1 つ以上のレビューが破棄された場合。

CLOSED オープンなレビューや要約待ちのレビューがなく、1 つ以上のレビューがクローズされた場合。

 

これらのレビューの詳細を確認するには、[レビュー] リンクをクリックします。各レビューのステータス、作成者およびレビュアー、レビューを完了していない人物、レビューが期限切れかどうかを確認できます。コメントの数を確認することもできます。

 

クリックして、特定のレビューを Crucible で簡単に表示できます。 

A developer just needs to add the issue key to the title of the review, or link the issue from the review, for the review to be automatically linked to the JIRA issue.

課題での作業が意図したようにデプロイされたかどうかを確認

 

The Development panel shows the environments to which related Bamboo builds for a JIRA issue have been deployed. 

最近のデプロイの詳細を見るには、[デプロイ済み] リンクをクリックします。デプロイメントのステータス、リリース番号、および日付が表示されます。

 

 

クリックして Bamboo で詳細を確認できます。

A deployment is linked to a JIRA issue if a commit involved in the deploy has the issue key in its commit message. When those code changes are later built (see above), and the resulting artifact is deployed (either manually or automatically)  the environment information is passed to the JIRA issue. This assumes that the Bamboo build plan is associated with a deployment project in Bamboo.