GitLab アジャイルポートフォリオ管理 - ハンズオンラボ: Issue を作成する

このハンズオンガイドでは、GitLab で Issue とラベルを作成する手順を説明します。

完了までの推定時間: 45 分

目標

Issue は GitLab のコアとなる構成要素で、コラボレーション、ディスカッション、作業の計画・追跡を可能にします。Issue はグループではなくプロジェクトのスコープ内で定義されます。詳細についてはドキュメントを参照してください。

タスク A. ラベルを作成・管理する

ラベルを使用すると、バグ、機能リクエスト、ドキュメントなどの色や説明タイトルを使ってエピック、Issue、マージリクエストを分類できます。これにより、エピック、Issue、マージリクエストを動的にフィルタリング・管理できます。詳細についてはドキュメントを参照してください。

  1. Awesome Inc グループに移動してください。

  2. 左ペインの Manage > Labels をクリックしてください。

  3. 右上の New label をクリックしてください。

  4. Title フィールドに Status::Open と入力してください。ラベルタイトル内の 2 つのコロンは、これがスコープ付きラベルになることを意味します。

    スコープ付きラベルはタイトルに二重コロン(::)の構文を使用します(例: workflow::in review)。Issue、マージリクエスト、エピックは、同じキーを持つ key::value 形式の 2 つのスコープ付きラベルを持つことができません。同じキーで異なる値を持つ新しいラベルを追加すると、以前のキーラベルは新しいラベルに置き換えられます。

  5. Description フィールドに Item that is ready to begin work と入力してください。

  6. ラベルの色については、GitLab は任意の16進カラーコードをサポートしています。このラベルには、提案されたカラーパレットから Blue-gray を選択してください(または Background color フィールドに #6699cc と入力してください)。

  7. Create label をクリックしてください。

  8. 以下の追加ラベルを、任意の説明と背景色を設定して作成してください。スコープ付きのものとスコープなしのものがあることに注意してください。

    • Status::Open
    • Status::WIP
    • Status::Done
    • Priority::High
    • Priority::Medium
    • Priority::Low
    • Dev
    • QA
    • Security
  9. Family Budget Calculator プロジェクトに移動してください。プロジェクトは Awesome Inc > Software > Core グループ階層の中にあります。

  10. 左サイドバーの Manage > Labels をクリックしてください。

  11. Subscribe ボタンの左にある星アイコンをクリックして、以下のラベルを優先ラベルとして指定してください。優先ラベルはラベル一覧の上部に表示されます。

    • Priority::High
    • Priority::Medium
    • Priority::Low

タスク B. 作業を追跡する Issue を作成する

  1. Family Budget Calculator プロジェクトで、左サイドバーの Plan > Issues をクリックしてください。

  2. New issue ボタンをクリックしてください。

  3. タイトルセクションに Third-party financial services integration と入力してください。

  4. 説明はオプションのセクションですが、この Issue の説明を自由に入力してください。

  5. Assignees ドロップダウンを使用して、ドロップダウンをクリックしてから自分のユーザー名をクリックし、自分自身を Issue に割り当ててください。現時点ではオプションはそのままにしますが、それぞれの機能を理解しておくことが重要です。

    • Epic: Issue をエピックに関連付けます。

    • Milestone: GitLab のマイルストーンは、特定の期間内に広範な目標を達成するために作成された Issue とマージリクエストを追跡する方法です。

    • Labels: Issue にラベルを適用します。Issue をソートおよびフィルタリングするために使用できるメタデータタグです。

    • Weight: 特定の Issue が持つまたはかかる時間、複雑さ、または価値を測定するためのウェイト値を Issue に適用します。

    • Due date: Issue に期限を設定し、機能が時間通りに出荷されるようにします。

    • Iteration: Issue をイテレーションに関連付けて、一定期間にわたって追跡します。これにより、チームは速度と変動性のメトリクスを追跡できます。

  6. Create issue ボタンをクリックしてください。

  7. Issue のメタデータペインで Labels フィールドの横の Edit をクリックしてください。

  8. Status::Open ラベルを選択し、メタデータペインの外をクリックして Issue にラベルを適用してください。

  9. 前の 2 つのステップを繰り返して、Priority::MediumDev ラベルを Issue に適用してください。

  10. 左ペインの Plan > Issues をクリックしてください。先ほど作成した Issue がラベルとともに一覧に表示されます。

  11. Issue 一覧ページの右上の New issue をクリックして 2 つ目の Issue を作成してください。

  12. Title セクションに Backend services と入力してください。

  13. Description セクションに以下を貼り付けてください。

    - Create DB
    - Create service infrastructure
    - Write documentation
    
  14. Assignees ドロップダウンを使用して、ドロップダウンをクリックしてから自分のユーザー名をクリックし、自分自身を Issue に割り当ててください。

  15. Create issue ボタンをクリックしてください。

  16. Backend services Issue に以下のラベルを適用してください。ラベルをクリックしてから、メタデータペインの外をクリックしてラベルを適用してください: DevStatus::OpenPriority::High

  17. 左ペインの Plan > Issues をクリックして、両方の Issue をラベルとともに確認してください。

  18. Issue 一覧ページの右上の New issue をクリックして 3 つ目の Issue を作成してください。

  19. Title セクションに Frontend services と入力してください。

  20. Description セクションに以下を貼り付けてください。

    - UX design
    - Integration
    - Write documentation
    
  21. Assignees ドロップダウンを使用して、ドロップダウンをクリックしてから自分のユーザー名をクリックし、自分自身を Issue に割り当ててください。

  22. Create issue をクリックしてください。

  23. Frontend services に以下のラベルを適用してください。ラベルをクリックしてから、メタデータペインの外をクリックしてラベルを適用してください: DevStatus::WIPPriority::High

  24. 左ペインの Plan > Issues をクリックして、3 つすべての Issue をラベルとともに確認してください。

変更のご提案

変更を提案したい場合は、マージリクエストを使用して送信してください。