反復

イテレーションは、一定期間のイシューを追跡する方法です。これにより、チームはベロシティとボラティリティのメトリクスをトラッキングできます。異なる期間にわたって追跡するには、イテレーションのマイルストーンを使用できます。様々なイテレーション・ケイデンスを作成し、管理することができます。

例えば

  • プログラム・インクリメント(8~12週間)のマイルストーン。
  • スプリントのイテレーションは2週間。

GitLabでは、イテレーションはマイルストーンに似ていますが、いくつかの違いがあります:

  • イテレーションはグループでのみ利用可能です。
  • イテレーションはイテレーション・ケイデンスにグループ化されます。
  • 反復には開始日と終了日の両方が必要です。
  • イテレーションの日付範囲は、イテレーション・ケーデンス内で重複することはできません。

イテレーションケイデンス

  • GitLab 14.1からiteration_cadences というフラグで導入されました。デフォルトでは無効になっています。
  • GitLab 15.0で変更:すべてのスケジュールされたイテレーションは、ケイデンス開始日と同じ曜日に開始しなければなりません。ケイデンスの開始日は、最初のイテレーション開始後は編集できません。
  • GitLab.comで有効にし、GitLab 15.0で自己管理
  • GitLab 15.4で変更:新しい自動化の開始日をケイデンスに選択できるようになりました。今後のイテレーションは、変更された開始日と同じ曜日に開始するようスケジュールされます。自動スケジューリング機能をオフにすることで、イテレーションのケイデンスを手動で管理することができます。
  • GitLab 15.5で一般的に利用可能。機能フラグiteration_cadences を削除しました。

イテレーションケイデンスはイテレーションのコンテナで、イテレーションスケジューリングの自動化に使えます。1週間、2週間、3週間、4週間ごとにイテレーションを自動化することができます。また、イテレーション・ケーデンスを設定して、未完了のイシューを自動的に次のイテレーションにロールオーバーすることもできます。

イテレーションケーデンスの作成

GitLab 15.0の最小ユーザーロールを開発者からレポーターに変更しました

前提条件:

  • 少なくともグループのレポーターロールを持っている必要があります。

イテレーション・ケイデンスを作成するには

  1. 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
  2. プラン > イテレーションを選択します。
  3. 新しい反復ケイデンスを選択します。
  4. イテレーション・ケイデンスのタイトルと説明を入力します。
  5. イテレーション・ケイデンスを手動で管理するには、[自動スケジューリングを有効にする] チェックボックスをオフにして、次のステップをスキップします。
  6. 自動スケジューリングを使用するには、必要なフィールドに入力します。
    • 反復ケイデンスの自動化開始日を選択します。イテレーションは、開始日の曜日と同じ曜日に開始するようにスケジュールされます。
    • 期間] ドロップダウン リストから、各イテレーションの期間を何週間にするかを選択します。
    • Upcoming iterationsドロップダウンリストから、GitLab が作成・メンテナーする今後のイテレーションの数を選択します。
    • オプション。未完了のイシューを次のイテレーションに移動するには、Roll over issues を選択します。現在のイテレーションの終わりに、すべての未解決イシューが次のイテレーションに追加されます。イシューはインスタンスのタイムゾーン(デフォルトではUTC)の深夜に移動します。管理者はインスタンスのタイムゾーンを変更できます。
  7. ケイデンスの作成] を選択します。ケイデンス・リスト・ページが開きます。

作成したケイデンスを手動で管理したい場合は、「Manual Iteration Management」をお読みください。

イテレーションリストの表示

  1. 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
  2. プラン > イテレーションを選択します。

ケイデンス内のすべての反復を日付の古い順に表示するには、その反復ケイデンスを選択します。そこから新しい反復を作成したり、反復を選択してより詳細なビューを表示したりできます。

note
プロジェクトでイシューのトラッキングがオフになっている場合、イテレーションのリストを表示するには、そのURLを入力します。そのためには、プロジェクトまたはグループのURLに、/-/cadences を追加します。例えば、https://gitlab.com/gitlab-org/sample-data-templates/sample-gitlab-project/-/cadences。これはイシュー339009で追跡されています。

反復ケイデンスの編集

前提条件:

  • 少なくともグループの開発者ロールを持っている必要があります。

反復ケイデンスを編集するには

  1. 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
  2. プラン > イテレーションを選択します。
  3. 反復ケイデンスの編集] を選択します。

自動スケジューリングを使用し、オートメーション開始日フィールドを編集する場合は、既存の現在または過去のイテレーションと重複しない新しい開始日を設定する必要があります。

今後の反復]の編集は非破壊アクションです。今後予定されている反復がすでに10回存在する場合、「今後予定されている反復」の数字を2 に変更しても、既存の8回の今後予定されている反復は削除されません。

イテレーションケーデンスの自動スケジューリングのオンとオフ

  1. 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
  2. プラン > イテレーションを選択します。
  3. 自動スケジューリングをオンまたはオフにしたいケイデンスの横で、三点メニュー({ellipsis_v})> ケイデンスを編集 を選択します。
  4. 自動スケジューリングを有効にする]チェックボックスをオンまたはオフにします。
  5. 自動スケジューリングをオンにする場合は、必須フィールド「期間」、「反復予定」、「オートメーション開始日」を入力します。

    自動化の開始日は、既存のオープンイテレーションと重ならない任意の日を選択できます。今後のイテレーションがある場合、自動スケジューリングは選択した期間に合わせて適切に調整します。

  6. 変更を保存を選択します。

手動反復ケイデンスの自動スケジューリングをオンにする例

4月15日金曜日で、手動反復ケイデンスに3つの反復があるとします:

  • 4月4日(月)~4月8日(金)(クローズド
  • 4月12日(火)~15日(金)(継続中
  • 5月3日(火)~6日(金)(予定

このシナリオでは、4月15日が現在進行中のイテレーションと重なるため、オートメーションの開始日は4月16日(土)が最短となります。

4月18日(月)を自動化開始日として選択し、今後2回の反復まで毎週反復のスケジューリングを自動化する場合、変換後には次の反復があります:

  • 4月4日(月)~4月8日(金)(クローズド
  • 4月12日(火)~15日(金)(継続中
  • 4月18日(月)~4月24日(日)(予定
  • 4月25日(月)~5月1日(日)(予定

4月12日(火)~4月15日(金)を4月18日(金)~4月24日(日)に変更します。

少なくとも2回の反復が予定されているという要件を満たすため、追加の反復「4月25日~5月1日」が予定されています。

反復計画の削除

GitLab 15.0の最小ユーザーロールを開発者からレポーターに変更しました

前提条件:

  • 少なくともグループのレポーターロールを持っている必要があります。

反復ケイデンスを削除すると、そのケイデンス内のすべての反復も削除されます。

反復ケイデンスを削除するには

  1. 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
  2. プラン > イテレーションを選択します。
  3. 三点鎖線メニュー({ellipsis_v})>削除するケイデンスを選択します。
  4. ケイデンスの削除を選択します。

手動反復管理

イテレーションをイテレーション・ケーディンスによってスケジュールしたくない場合は、手動でイテレーションを作成して管理することもできます。

イテレーションの作成

GitLab 15.0の最小ユーザーロールを開発者からレポーターに変更しました

前提条件:

イテレーションを作成するには

  1. 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
  2. 左側のサイドバーで、[Plan] > [Iterations] を選択し、イテレーション・ケイデンスを選択します。
  3. 新しい反復を選択します。
  4. タイトル、説明(オプション)、開始日、期限を入力します。
  5. イテレーションの作成] を選択します。反復の詳細ページが開きます。

イテレーションの編集

前提条件:

反復を編集するには、3点メニュー({ellipsis_v})>編集を選択します。

イテレーションの削除

前提条件:

反復を削除するには、3点メニュー({ellipsis_v})>削除を選択します。

イテレーションにイシューを追加するには

GitLab 13.2 で導入されました

イテレーションにイシューを追加する方法については、イシューの管理の手順をご覧ください。

イテレーションレポートの表示

GitLab 13.5 で導入されたプロジェクトでのイテレーションレポートの表示。

イテレーションレポートをレビューすることで、イテレーションの進捗を追跡することができます。イテレーションレポートには、イテレーションに割り当てられたすべてのイシューとそのステータスのリストが表示されます。

このレポートには、イテレーション内の全イシューの内訳も表示されます。オープン イテレーション レポートには、完了した課題、未着手の課題、進行中の課題の概要が表示されます。クローズされたイテレーション・レポートには、期日までに完了した課題の総数が表示されます。

イテレーション・レポートを表示するには、イテレーション・リスト・ページに移動し、イテレーションの期間を選択します。

イテレーションのバーンダウンチャートとバーンアップチャート

イテレーションレポートには、マイルストーンを表示するときと同様に、バーンダウンチャートとバーンアップチャートが含まれます。

バーンダウン チャートは、スコープ全体の完了進捗を追跡するのに役立ち、バーンアップ チャートは、指定されたタイムボックスで追加され完了したイシューの毎日の合計数と重みを追跡します。

サブグループまたはプロジェクトにスコープされたイテレーションチャート

GitLab 14.9で導入されました

バーンダウンチャートやバーンアップチャートは、グループのサブグループやプロジェクトで作成されたイテレーションのものです。この場合、チャートはサブグループやプロジェクトに属するイシューのみをカウントします。

たとえば、あるグループにProject 1Project 2という2つのプロジェクトがあるとします。各プロジェクトには、グループの同じイテレーションに割り当てられたイシューが1つあります。

グループに対して作成されたイテレーション・レポートには、グループのすべてのプロジェクトのイシュー数が表示されます:

  • 完了2件中0件
  • 未完成2件中0件
  • 未着手2件中2件
  • バーンダウンチャート合計イシュー: 2
  • バーンアップチャート総発行数:2

Project 1 、このプロジェクトに属するイシューのみが表示されます:

  • 完了しました:1 件中 0 件
  • 未完成1件中0件
  • 未着手1件中1件
  • バーンダウンチャート合計イシュー:1
  • バーンアップチャート総イシュー数1

レーベル別イシューグループ

GitLab 13.8 で導入されました

イシューのリストをラベルでグループ分けすることができます。これにより、チームのラベルを持つイシューを表示したり、各ラベルに起因するスコープをより正確に把握することができます。

ラベルでイシューをグループ化するには

  1. 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
  2. プラン > イテレーションを選択します。
  3. グループ別] ドロップダウン リストで、[ラベル] を選択します。
  4. ラベルによるフィルタ] ドロップダウン リストを選択します。
  5. ラベル ドロップダウン リストでグループ化するラベルを選択します。検索入力でラベルを検索することもできます。
  6. ラベル ドロップダウン リスト外の任意の領域を選択します。ページが選択したラベルでグループ化されます。