正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

マージリクエストのホームページ

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

自分が作成者、担当者、またはレビュアーであるマージリクエストは、マージリクエストのホームページに表示されます。このページでは、マージリクエストがワークフローまたはロールでソートされます。ワークフロービューには、自分の作業か他の人の作業かにかかわらず、注意が必要なマージリクエストが最初に表示されます。ワークフロービューでは、このレビュープロセスの段階ごとにマージリクエストがグループ化されます:

%%{init: { "fontFamily": "GitLab Sans" }}%%
flowchart LR
    accTitle: Merge request review workflow
    accDescr: Flow from merge request creation through review, approval, and merge stages with decision points for reviewers and approvals.

    A[Your<br>merge request] --> B{Reviewers<br>added?}
    B-->|Yes| D[<strong>Review<br>requested</strong>]
    B -.->|No| C[<strong>Your merge<br>requests</strong>]
    D -->|Approved| E[<strong>Approved<br>by others</strong>]
    D -..->|Changes<br>requested| F[<strong>Returned<br>to you</strong>]
    F -->|You make<br>changes| D
    E -->G{All<br>approvals?}
    G -->|Yes| K[Ready to merge]
    G -.->|No| J[Remains in<br><strong>Waiting for approvals</strong>]

    linkStyle default stroke:red
    linkStyle 0 stroke:green
    linkStyle 1 stroke:green
    linkStyle 3 stroke:green
    linkStyle 5 stroke:green
    linkStyle 6 stroke:green
    linkStyle 7 stroke:green
    style K stroke:black,fill:#28a745,color:#fff

このレビューフローは、レビュアーがレビューを開始レビューを送信機能を使用することを前提としています。

ロールビューでは、マージリクエスト内のロールごとにマージリクエストがソートされます。

マージリクエストのホームページを表示する

この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。

GitLabのすべてのページの左側のサイドバーに、合計有効なマージリクエストが表示されます:

合計を示すGitLabインターフェースの左上領域。

このユーザーには以下があります:

  • 9件のオープンイシュー( issue-type-issue
  • 1件のアクティブなマージリクエスト( merge-request-open
  • 1件のTo-Do項目( todo-done

マージリクエストのホームページには、これらのマージリクエストに関する詳細情報が表示されます。これを確認するには、次のいずれかの方法を使用します:

  • Shift+m キーボードショートカットを使用します。
  • 左側のサイドバーで、マージリクエスト merge-request-open )を選択します。
  • 左側のサイドバーで検索または移動先を選択し、ドロップダウンリストからマージリクエストを選択します。

お客様の注意を引く必要のあるものに集中できるように、GitLabでは、マージリクエストのホームページを3つのタブに整理します:

画面上部に表示される3つのホームページタブ。

  • 有効: これらのマージリクエストは、自分またはチームメンバーからの注意が必要です。
  • マージ済み: これらのマージリクエストは、過去14日間にマージされました。これらは自分の作業であるか、自分からのレビューが含まれています。
  • 検索: すべてのマージリクエストを検索し、必要に応じてフィルターします。

アクティブタブの「返却されました」セクションに、3つのマージリクエストの情報を含む表が表示されています。

  • ステータス: マージリクエストの現在のステータス。
  • タイトル: イシューに関する重要なメタデータ。以下を含みます:
    • マージリクエストのタイトル。
    • 担当者のアバター。
    • 追加および削除されたファイルと行の数(+ / -)。
    • マイルストーン。
  • 作成者: 作成者のアバター。
  • レビュアー: レビュアーのアバター。緑色のチェックマークが付いているレビュアーは、マージリクエストを承認しています。
  • チェック: マージ可能性のコンパクトな評価。
    • マージコンフリクトが存在する場合の警告( warning-solid )。
    • 0 of 3のような未解決スレッドの数。
    • 現在の必須承認ステータス
    • 最新のパイプラインステータス。
    • 最終更新日。

表示設定を行う

マージリクエストのホームページの右上にあるDisplay preferences(表示設定)( preferences )を選択します:

  • ラベルを表示を切り替えて、各マージリクエストのラベルを表示または非表示にします。
  • 並べ替えの設定: ワークフローまたはロール
    • ワークフローは、ステータスごとにマージリクエストをグループ化します。GitLabは、作成者かレビュアーかに関係なく、注意が必要なマージリクエストを最初に表示します。
    • ロールは、レビュアーであるか作成者であるかによって、マージリクエストをグループ化します。

アクティブなマージリクエストは、左側のサイドバーに表示される合計にカウントされます。GitLabでは、無効なマージリクエストをレビュー数から除外します。

ワークフロービュー: アクティブなステータス

これらのマージリクエストは注意が必要です。これらは、左側のサイドバーに表示される合計にカウントされます:

  • マージリクエスト: 自分がマージリクエストの作成者または担当者です。レビュープロセスを開始するには、レビュアーを割り当てます。ステータス:
    • ドラフト: マージリクエストはドラフトです。
    • Reviewers needed(レビュアーが必要です): マージリクエストはドラフトではありませんが、レビュアーがいません。
  • リクエストしたレビュー: 自分がレビュアーです。マージリクエストをレビューします。フィードバックを提供します。オプションで、承認または変更をリクエストします。ステータス:
    • 変更リクエスト済み: レビュアーが変更をリクエストしました。変更リクエストはマージリクエストをブロックしますが、回避することができます。
    • レビュアーがコメント: レビュアーがコメントを残しましたが、変更はリクエストしていません。
  • 返却されました: レビュアーがフィードバックを提供したか、変更をリクエストしました。レビュアーのコメントに対処し、提案された変更を適用します。ステータス:
    • 変更リクエスト済み: レビュアーが変更をリクエストしました。
    • レビュアーがコメント: レビュアーがコメントを残しましたが、変更はリクエストしていません。

ワークフロービュー: 非アクティブなステータス

GitLabでは、これらのマージリクエストはアクティブ数から除外されます。これは、現時点では何も操作を行う必要がないためです:

  • Waiting for assignee(担当者待ち): 作成者の場合、マージリクエストはレビュー待ちです。レビュアーの場合、変更をリクエストしました。ステータス:
    • 変更をリクエストしました: レビューを完了し、変更をリクエストしました。
    • コメント済み: コメントしましたが、レビューを完了していません。
  • 承認待ち: 承認を待機している、割り当てられたマージリクエスト、および変更をリクエストしたレビュー。ステータス:
    • 承認が必要: 残りの必要な承認の数。
    • 承認済み: 自分が承認したか、必要な承認がすべて満たされています。
    • 承認待ち
  • あなたにより承認済み: レビューして承認したマージリクエスト。ステータス:
    • 承認済み: 自分が承認し、必要な承認がすべて満たされています。
    • 承認が必要: 承認しましたが、必要な承認がすべて満たされているわけではありません。
  • 他の人により承認済み: 他のチームメンバーから承認を受けたマージリクエスト。すべての要件が満たされている場合、マージする準備ができている可能性があります。ステータス:
    • 承認済み: マージリクエストは必要な承認を受けました。

ロールビュー

ロールビューは、自分が担当者またはレビュアーであるマージリクエストをグループ化します:

  • Reviewer(Active)(レビュアー(有効)): 自分からのレビュー待ち。
  • Reviewer(Inactive)(レビュアー(無効)): 自分がすでにレビューしました。
  • Your merge requests(Active)(自分のマージリクエスト(有効))
  • Your merge requests(Inactive)(自分のマージリクエスト(無効))

有効リストのマージリクエストは、左側のサイドバーに表示される合計にカウントされます。