JIRA Software ユーザー スタートガイド
JIRA Software のプロジェクトにようこそ! このチュートリアルでは、 課題を見つけ、自分にアサインし、完了させるためのプロジェクトと簡単なワークフローについて一通り紹介します。このチュートリアルが終わるまでには、簡単なワークフローを通して、JIRA Software ユーザーとして次のステップを完了することになります。
課題の検索
通常、あなたの開発マネージャーがスクラムまたはカンバン プロジェクトを作成済みで、バックログに課題が作成されているはずです。プロジェクトではさまざまなナビゲーションを利用できますが、情報に一番簡単にアクセスする方法は、ボードを利用することです。ボードは 1 つ以上のプロジェクトからの課題を表示します。ボードは作業の表示、管理、およびレビュを行うためのの柔軟な方法を提供します。このステップでは、自身が取り組む必要がある課題をスクラム プロジェクトのボードのアクティブ スプリントで見つける、一般的な方法について説明します。
- トップ メニューから [ボード] を選択し、ドロップダウン リストから 1 つのボードを選択します。
- [アクティブ スプリント] 選択したボードのスプリント内の課題を表示します。
- ボードのアクティブ スプリントには、課題が課題カードとして表示されます。カードで課題キー、担当者、説明等の大まかな情報を簡単に確認できます。To Do 列の 1 番目のカードにカーソルを合わせ、In Progress 列にドラッグします。これによって課題が自分にアサインされ、作業を開始できます。
課題に取り組む
課題を "In Progress" に移動して、課題の作業を開始したことを示します。この段階では、自身に課題をアサインし、それによってチームの全員が誰がその作業をしているかを確認できるようになります。また、課題についていくつかの技術的な詳細を追加したい場合があります。自身が作業中の課題に関連する情報を知ることは、チームメイトにも役立ちます。
- ボード内 [アクティブ スプリント] で、[In Progress] 列にある課題を選択します。課題の詳細ビューにその課題が表示されます。
- 課題の詳細ビューで歯車ドロップダウンから [編集] を選択します。[課題の編集] ダイアログが表示されます。
- 課題がまだ自身にアサインされていない場合、[担当者] フィールドに自分の名前を入力してください。
- 必要に応じて技術的な詳細情報を追加します。
コンポーネントやバージョンを指定したり (そのプロジェクトにコンポーネントやバージョンが指定されている場合)、必要に応じて添付ファイルを追加したりすることができます。 - 技術的な詳細情報を追加したら、[更新] ボタンをクリックします。
チームとのコラボレーション
課題について作業している間、情報を共有したり、要件を明確にしたり、課題の詳細についてチームメンバーと議論する必要がある場合があります。これは、課題のコメントを利用して簡単に行えます。
- コメントを追加する課題を選択します。
- 課題詳細ビューで [コメント] ボタンを見つけてクリックします。
- [コメント] テキストボックスに、コメントを入力します。
- コメントをメールで他のユーザーに送信するには、コメントテキストボックスで、単にそのユーザーをメンション (「@ユーザーの名前」を入力) します。メールは、JIRA アカウントで登録されているそのユーザーのメールアドレスに送信されます。
- [追加] ボタンをクリックしてコメントを保存します。
ブランチの作成
自身に課題をアサインし、技術的な詳細情報を入力したら、コーディングの準備は完了です。課題の作業を開始するタイミングでブランチを作成することをおすすめします。これによって、自分だけの作業フローを持ち、チームの作業に干渉しないようにできます。また、自分の変更がマスター ブランチにマージされる前に確実にレビューされるようにできます。
JIRA Softwareはコードホスティングやリポジトリ管理ツール、Bitbucket CloudやBitbucket Serverと連携させることができます。これによって JIRAの中から直接コードを開き、協業し、ソースの管理をすることが可能になります。アプリケーションを統合することで、あなたやチームは、課題から直接ブランチを作成したり、課題を選択してコーディングを行うような速いワークフローを提供します。
ブランチを作成する前に、チームが利用しているソース リポジトリのブランチの使い方について知っておく必要があります (Bitbucket Cloud 用の手順、Bitbucket Server 用の手順)。
- ブランチの作成対象の課題を選択します。
- 課題の詳細ビューで [開発] パネルを見つけ、[ブランチを作成] をクリックします。ブランチの作成ダイアログが表示されます。
- ブランチ名に課題キーを含めます。ワークフロー トリガーが構成されている場合、課題のステータスが自動的に "In Progress" にトランジションすることがあります。詳細は、「ワークフロー トリガーの構成」を参照してください。
- 必要に応じ、ブランチに他の詳細情報を入力します。
- [ブランチを作成] ボタンをクリックします。ソース リポジトリにブランチが作成されます。
コーディングの開始
新しいブランチを作成したため、自分の変更がマスター ブランチに影響を及ぼす可能性を心配することなく、コーディングを開始できます。作業している課題を参照する課題キーを必ず追加するようにします。開発作業で課題キーを参照する際、連携された開発ツールは関連する課題へのリンクを相方向で保持します。
- 新しいブランチを作成したソース リポジトリに移動し、新しいブランチにアクセスします。
- 新しいブランチで、必要に応じてコードまたは修正を実装します。
作業をレビューに送信
プル リクエストを使用し、リポジトリにプッシュした変更についてチームメートに伝えます。プル リクエストが送信されると、チームはレビュー、変更に関する話し合い、またはフォローアップ コミットのプッシュを行うことができます。
- 開発パネルにあるブランチをクリックすると、ソフトウェア構成管理 (SCM) にある、リンクされたブランチのリンクが、Jira Software のダイアログに表示されます。2 つ以上の SCM にリンクしている場合、各 SCM アプリ (例: Bitbucket Server) に対して 1 つのタブが表示されます。ブランチはこれらのタブで、各 SCM で分類されます。
- リポジトリまたはブランチをクリックし、関連リポジトリまたはブランチでリンクされた SCM を開きます。
- プル リクエストのステータス (MERGEDなど) にカーソルを合わせ、プル リクエストへのリンクを表示するポップアップを表示します。
- [プルリクエストを作成] をクリックして、ブランチのプル リクエストを作成します (マスターにマージして戻すため)。
- プル リクエストのタイトルに課題キーを含めます。ワークフロー トリガーが構成されている場合、課題のステータスが自動的に "In Review"" にトランジションすることがあります。詳細は、「ワークフロー トリガーの構成」を参照してください。
作業の完了
作業がレビューされ、マスター ブランチにマージされたら、最後のステップとして課題を解決またはクローズします。
- ボードの [アクティブ スプリント] にあるカードを見つけます。
- カードを "Done" 列にドラッグ アンド ドロップします。ワークフロー トリガーが構成されている場合、課題のステータスが自動的に "Closd"" にトランジションすることがあります。以降の手順は省略できます。詳細は、「ワークフロートリガーの構成」を参照してください。
ドロップダウン メニューから課題の [解決状況] を選択します。
- 必要に応じて詳細を入力します。
- [課題をクローズ] を選択します。
よく出来ました！JIRA Software を使ってシンプルなワークフローをうまく一通り行いました。
課題の管理や JIRA Software のカスタマイズ等をうまくやるには下にある "上級者向けの情報" ボタンをクリックしてください。