Jira での Git ソフトウェア開発プロセス

 

You can connect Jira SoftwareBitbucket Server and Bamboo 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

 

Jira で課題の作業を開始するときにフィーチャー ブランチを作成

 

 

If you use Atlassian's Bitbucket Server 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:

  • ブランチを作成できる、利用可能なリポジトリ アプリケーションの表示
  • 開発者の最近のプロジェクトおよびリポジトリから開始
  • ブランチ元のブランチの提案
  • 新しいブランチ名に Jira の課題キーを自動的に追加

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,  Bitbucket Server, Fisheye and Crucible, as well as GitHub and GitHub:Enterprise.

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

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


 

Jira 課題に関連するすべてのブランチの確認

 

The Development panel, seen above, shows how many branches are related to the issue, wherever they're located (perhaps in multiple instances of 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.

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

ブランチ名に課題キーが含まれ、既定の Jira 課題キーの形式を使用している限り、ブランチは開発パネルに自動的に含まれます。

 

Jira 課題に関連するすべての作業の確認

 

開発パネルには、Jira 課題に関連するコミットの数が表示されます。これらは、リンクされたすべての Bitbucket Server インスタンス (または Bitbucket や Fisheye などのリンクされた他のリポジトリ アプリケーション) から収集されます。

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

 

 

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

開発者がコミット メッセージに既定のキー形式を使用して課題キーを追加するだけで、コミットを Jira 課題に自動的にリンクして、課題の開発パネルのコミットの概要に含めることができます。

 

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

 

開発パネルには、Jira 課題に関連するすべての Bamboo CI ビルドのもっとも関連するステータスが表示されます。ステータス アイコンは次のとおりです。

   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. 

To see details for those builds, just click the builds link. You'll see the name of the build plan and how many tests have passed, or failed:

 

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

You can configure plan branches to be automatically created by Bamboo when a new branch is detected in the repository for the plan. Using plan branches ensures that commits to repository branches, and not just commits to master, get continuous integration testing. Because Bamboo does this automtically, there's no need to manually, and repetitively, configure a new Bamboo plan for every new branch in the repo. Read more about plan branches in 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 課題へ自動リンクされます。

 

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

 

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

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

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

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

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

 

 

プル リクエストのタイトルをクリックして、プル リクエストを Bitbucket Server で確認します。 

プル リクエストをマージする準備が整い、レビュアーによる承認が完了したら、Bitbucket Server で PR へのリンクに従います。

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.

開発者がプル リクエストのタイトルに課題キーを追加するか、ソースのブランチ名にキーを含めるだけで、PR を Jira 課題に自動的にリンクさせることができます。マージ コミットは含まれません。

 

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

 

The Development panel shows the most relevant status of the Crucible reviews that are related to an issue. The review status is:

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

APPROVAL 1 つ以上のレビューが承認待ちの場合。

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.

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

 

開発パネルには、Jira 課題の関連 Bamboo ビルドがデプロイされた環境が表示されます。 

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

 

 

クリックして 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.

 

リリースハブにおける開発情報

 

ボードのリリースハブを見れば、リリースの進捗(リリースバージョン)を見て公開すべきものをひと目で決定できるようになります。バージョンではステータスごとに分類されたすべての課題を見ることができ、バージョンのリリースに影響しうる問題も把握できます(例えば、リリースするはずの課題にマージされていないプルリクエストや、コードレビューされていない、またビルドに失敗した課題が含まれている、など)。

 

 

Jira Software を一旦開発ツールに接続すれば、詳細設定は必要ありません。ただし、開発ツールで 課題を参照する方法をチームに知らせる必要はあります。

さらに詳しく:開発作業から課題を参照する

  • ラベルなし