ラベル

ラベルは、GitLabの機能全体で作業を整理および追跡します。プロジェクトが小規模チームから大規模な組織に成長するにつれて、ラベルは増加する作業量を追跡および管理するのに役立ちます。ラベル:

• カスタム属性でイシュー、マージリクエスト、およびエピックを分類します。
• リストとボードのコンテンツをフィルタリングします。
• 色と説明的なタイトルで作業アイテムに優先順位を付けます。
• スコープ付きラベルで優先度と重大度を追跡します。
• 整理されたグループ化を通じてワークフローを構造化します。

ラベルの種類

GitLabで使用できるラベルは3種類あります。

• プロジェクトラベルは、そのプロジェクト内のイシューとマージリクエストにのみ割り当てることができます。
• グループラベルは、選択したグループまたはそのサブグループ内の任意のプロジェクトのイシュー、マージリクエスト、およびエピックに割り当てることができます。
• インスタンスラベルは、インスタンス管理者によって作成され、すべての新しいプロジェクトにコピーされます。

ラベルの割り当てと割り当て解除

ラベルは、任意のイシュー、マージリクエスト、またはエピックに割り当てることができます。

ラベルの変更は、ページを更新しなくても、次の場所で他のユーザーにすぐに表示されます。

• エピック
• インシデント
• イシュー
• マージリクエスト

ラベルを割り当てる、または割り当てを解除するには:

1. サイドバーのラベルセクションで、編集を選択します。
2. ラベル割り当てリストで、名前を入力してラベルを検索します。繰り返し検索して、さらにラベルを追加できます。選択したラベルにはチェックマークが付いています。
3. 割り当てるまたは割り当てを解除するラベルを選択します。
4. ラベルへの変更を適用するには、ラベル割り当ての横にあるXを選択するか、ラベルセクションの外側の任意の領域を選択します。

または、ラベルの割り当てを解除するには、割り当てを解除するラベルのXを選択します。

クイックアクションを使用して、ラベルの割り当てと解除もできます:

• ラベルを割り当てるには、/labelを使用します。
• ラベルを削除するには、/unlabelを使用します。
• すべてのラベルを削除して新しいラベルを割り当てるには、/relabelを使用します。

利用可能なラベルを表示

プロジェクトラベルを表示

プロジェクトのラベルを表示するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 管理 > ラベルを選択します。

または:

1. イシューまたはマージリクエストを表示します。
2. 右サイドバーのラベルセクションで、編集を選択します。
3. プロジェクトラベルを管理を選択します。

ラベルのリストには、プロジェクトで作成されたラベルと、プロジェクトの祖先グループで作成されたすべてのラベルが含まれます。ラベルごとに、それが作成されたプロジェクトまたはグループのパスを確認できます。

グループラベルを表示

グループのラベルを表示するには:

1. トップバーで検索または移動先を選択し、グループを見つけます。
2. 管理 > ラベルを選択します。

または:

1. エピックを表示します。
2. 右サイドバーのラベルセクションで、編集を選択します。
3. グループラベルを管理を選択します。

リストには、グループ内でのみ作成されたすべてのラベルが含まれます。グループのプロジェクトで作成されたラベルはリストされません。

ラベルを作成

前提条件:

• プロジェクトまたはグループのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

プロジェクトラベルを作成

プロジェクトラベルを作成するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 管理 > ラベルを選択します。
3. 新しいラベルを選択します。
4. タイトルフィールドに、ラベルの短い説明的な名前を入力します。このフィールドを使用して、範囲指定された相互に排他的なラベルを作成することもできます。
5. オプション。説明フィールドに、このラベルの使用方法と時期に関する追加情報を入力します。
6. オプション。使用可能な色から選択するか、背景色フィールドに特定の色を表す16進数のカラー値を入力して、色を選択します。
7. ラベルを作成を選択します。

イシューまたはマージリクエストからプロジェクトラベルを作成

イシューまたはマージリクエストから新しいプロジェクトラベルを作成することもできます。この方法で作成するラベルは、イシューまたはマージリクエストと同じプロジェクトに属します。

前提条件:

• プロジェクトに対してプランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。

これを行うには、次の手順に従います。

1. イシューまたはマージリクエストを表示します。
2. 右サイドバーのラベルセクションで、編集を選択します。
3. プロジェクトラベルを作成を選択します。
4. 名前フィールドに入力します。この方法でラベルを作成する場合、説明を指定することはできません。説明は後でラベルを編集することで追加できます。
5. 使用可能な色から選択するか、特定の色を表す16進数のカラー値を入力して、色を選択します。
6. 作成を選択します。ラベルが作成され、選択されます。

グループラベルを作成

グループラベルを作成するには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
2. 管理 > ラベルを選択します。
3. 新しいラベルを選択します。
4. タイトルフィールドに、ラベルの短い説明的な名前を入力します。このフィールドを使用して、範囲指定された相互に排他的なラベルを作成することもできます。
5. オプション。説明フィールドに、このラベルの使用方法と時期に関する追加情報を入力します。
6. オプション。使用可能な色から選択するか、背景色フィールドに特定の色を表す16進数のカラー値を入力して、色を選択します。
7. ラベルを作成を選択します。

エピックからグループラベルを作成

エピックから新しいグループラベルを作成することもできます。この方法で作成するラベルは、エピックと同じグループに属します。

前提条件:

• グループのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

これを行うには、次の手順に従います。

1. エピックを表示します。
2. 右サイドバーのラベルセクションで、編集を選択します。
3. グループラベルを作成を選択します。
4. 名前フィールドに入力します。この方法でラベルを作成する場合、説明を指定することはできません。説明は後でラベルを編集することで追加できます。
5. 使用可能な色から選択するか、特定の色を表す16進数のカラー値を入力して、色を選択します。
6. 作成を選択します。

ラベルを編集

前提条件:

• プロジェクトまたはグループのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

プロジェクトラベルを編集

プロジェクトラベルを編集するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 管理 > ラベルを選択します。
3. 編集するラベルの横にある縦方向の省略記号（ ）を選択し、次に編集を選択します。
4. 変更を保存を選択します。

グループラベルを編集

グループラベルを編集するには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
2. 管理 > ラベルを選択します。
3. 編集するラベルの横にある縦方向の省略記号（ ）を選択し、次に編集を選択します。
4. 変更を保存を選択します。

ラベルを削除

前提条件:

• プロジェクトに対してプランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。

プロジェクトラベルを削除

プロジェクトラベルを削除するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 管理 > ラベルを選択します。
3. サブスクライブボタンの横にある（ ）を選択し、次に削除を選択します。

グループラベルを削除

グループラベルを削除するには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。

2. 管理 > ラベルを選択します。

3. 次のいずれかの操作を行います:

   • サブスクライブボタンの横にある（ ）を選択します。
   • 編集するラベルの横にある編集（ ）を選択します。

4. 削除を選択します。

アーカイブ済みラベル

使用されなくなったラベルは、履歴の観点および検索目的で保持する必要がある場合、アーカイブできます。

たとえば、リリース完了後にQ4-25のようなリリースラベルをアーカイブすると、検索には利用できる状態を保ちつつ、ラベル選択ドロップダウンリストからは削除できます。

ラベルをアーカイブすると:

• ラベルは、イシュー、マージリクエスト、エピックのラベル選択ドロップダウンリストから非表示になります。
• ラベルは、以前割り当てられていた既存のイシュー、マージリクエスト、エピックで引き続き表示されます。
• ラベルを検索し、履歴データを表示することは引き続き可能です。
• ラベルは、ラベルページ上の別のアーカイブ済みタブに表示されます。

ラベルをアーカイブする

前提条件:

• プロジェクトまたはグループのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

ラベルをアーカイブするには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
2. 管理 > ラベルを選択します。
3. アーカイブしたいラベルの横にある編集（ ）を選択します。
4. アーカイブ済みチェックボックスを選択します。
5. 変更を保存を選択します。

ラベルはアーカイブされ、優先度が低くなります。

アーカイブ済みラベルを表示する

アーカイブ済みラベルを表示するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
2. 管理 > ラベルを選択します。
3. プロジェクトまたはグループのラベルページに移動します。
4. アーカイブ済みタブを選択します。

ラベルのアーカイブを解除する

前提条件:

• プロジェクトまたはグループのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

ラベルのアーカイブを解除するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 管理 > ラベルを選択します。
3. アーカイブ済みタブを選択します。
4. アーカイブ解除したいラベルの横にある編集（ ）を選択します。
5. アーカイブ済みチェックボックスをオフにします。
6. 変更を保存します。

プロジェクトラベルをグループラベルにプロモート

同じグループ内の他のプロジェクトでプロジェクトラベルを使用できるようにすることができます。次に、ラベルをグループラベルにプロモートできます。

同じグループ内の他のプロジェクトに同じタイトルのラベルがある場合、それらはすべて新しいグループラベルとマージされます。同じタイトルのグループラベルが存在する場合、それもマージされます。

前提条件:

• プロジェクトに対してプランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
• プロジェクトの親グループのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

プロジェクトラベルをグループラベルにプロモートするには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 管理 > ラベルを選択します。
3. サブスクライブボタンの横にある3つのドット（ ）を選択し、グループラベルへ昇格を選択します。

古いラベルが付いたすべてのイシュー、マージリクエスト、イシューボードリスト、イシューボードフィルター、およびラベルサブスクリプションが、新しいグループラベルに割り当てられます。

新しいグループラベルには、以前のプロジェクトラベルと同じIDが設定されます。

サブグループラベルを親グループにプロモート

グループラベルを親グループに直接プロモートすることはできません。これを実現するには、次の回避策を使用してください。

前提条件:

• サブグループを含むグループ（「親グループ」）が必要です。
• 親グループに、プロモートするラベルを持つサブグループが必要です。
• 両方のグループのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

ラベルを親グループに「プロモート」するには:

1. 親グループで、元のラベルと同じ名前のラベルを作成します。作業中に混同しないように、別の色にしてください。

2. サブグループで、そのラベルを表示します。2つのラベルとその出典が表示されます:

   

3. サブグループラベル（古いラベル）の横にあるイシュー、マージリクエスト、またはエピックを選択します。

4. 古いラベルを持つイシュー、マージリクエスト、およびエピックに新しいラベルを追加します。より迅速に行うには、一括編集を使用します。

5. サブグループまたは親グループで、下位グループに属するラベルを削除します。

これで、親グループに古いラベルと同じ名前のラベルが設定され、同じイシュー、MR、およびエピックに追加されます。

デフォルトのプロジェクトラベルを生成

プロジェクトまたはその親グループにラベルがない場合は、ラベルリストページからデフォルトのプロジェクトラベルセットを生成できます。

前提条件:

• プロジェクトに対してプランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
• プロジェクトにラベルが存在しない必要があります。

デフォルトのラベルをプロジェクトに追加するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 管理 > ラベルを選択します。
3. デフォルトのラベルセットを生成を選択します。

次のラベルが作成されます:

• bug
• confirmed
• critical
• discussion
• documentation
• enhancement
• suggestion
• support

スコープ付きラベル

チームは、スコープ付きラベルを使用して、相互に排他的なラベルでイシュー、マージリクエスト、およびエピックに注釈を付けることができます。特定のラベルが一緒に使用されるのを防ぐことで、より複雑なワークフローを作成できます。

範囲指定したラベルは、タイトルにダブルコロン（::）構文を使用します（例: workflow::in-review）。

イシュー、マージリクエスト、またはエピックは、同じkeyを持つkey::value形式のスコープ付きラベルを2つ持つことはできません。同じkeyで異なるvalueを持つ新しいラベルを追加すると、以前のkeyラベルが新しいラベルに置き換えられます。

スコープ付きラベルでフィルタリング

指定されたスコープでイシュー、マージリクエスト、またはエピックリストをフィルタリングするには、検索されたラベル名に<scope>::*を入力します。

たとえば、platform::*ラベルでフィルタリングすると、platform::iOS、platform::Android、またはplatform::Linuxラベルを持つイシューが返されます。

スコープ付きラベルの例

例1。イシューの優先度を更新する:

1. イシューの優先度が低いと判断し、priority::lowラベルを割り当てます。
2. さらにレビューした後、イシューの優先度が高くなったことに気付き、priority::highラベルを割り当てます。
3. イシューは2つの優先度ラベルを同時に持つべきではないため、GitLabはpriority::lowラベルを削除します。

例2。各イシューが1つのプラットフォームのみをターゲットとする、機能が対象とするオペレーティングシステムプラットフォームを追跡するために、イシューにカスタムフィールドが必要であるとします。

3つのラベルを作成します。

• platform::iOS
• platform::Android
• platform::Linux

これらのラベルのいずれかをイシューに割り当てると、platform::で始まる既存のラベルが自動的に削除されます。

例3。範囲指定したラベルを使用して、チームのワークフローの状態を表すことができます。

次のラベルがあるとします:

• workflow::development
• workflow::review
• workflow::deployed

イシューにworkflow::developmentラベルが既にあり、デベロッパーがイシューがレビュー中であることを示したい場合は、workflow::reviewを割り当てると、workflow::developmentラベルが削除されます。

これは、イシューボードのラベルリスト間でイシューを移動する場合にも発生します。スコープ付きラベルを使用すると、イシューボードで作業していないチームメンバーも、イシュー自体でワークフローの状態を一貫して進めることができます。

動画での説明については、以下をご覧ください。

ネストされたスコープ

作成時に複数のダブルコロン::を使用して、ネストされたスコープを持つラベルを作成できます。この場合、最後の::より前のすべてのものがスコープです。

たとえば、プロジェクトに次のラベルがあるとします:

• workflow::backend::review
• workflow::backend::development
• workflow::frontend::review

イシューは、workflow::backend::reviewラベルとworkflow::backend::developmentラベルの両方を同時に持つことはできません。それらは両方とも同じスコープを共有しているためです: workflow::backend。

一方、イシューは、workflow::backend::reviewラベルとworkflow::frontend::reviewラベルの両方を同時に持つことができます。それらは両方とも異なるスコープを持っているためです: workflow::frontendとworkflow::backend。

ラベルが使用されたときに通知を受け取る

ラベルにサブスクライブすると、ラベルがイシュー、マージリクエスト、またはエピックに割り当てられるたびに通知を受け取ることができます。

ラベルにサブスクライブするには:

1. ラベルリストページを表示します。
2. 任意のラベルの右側にあるサブスクライブを選択します。
3. オプション。プロジェクトからグループラベルにサブスクライブしている場合は、次のいずれかを選択します。
   • このプロジェクトのイベントに関する通知を受け取るには、プロジェクトレベルでサブスクライブするを選択します。
   • グループ全体のイベントに関する通知を受け取るには、グループレベルで購読するを選択します。

ラベルの優先度を設定

ラベルには相対的な優先度を設定できます。これは、イシューリストとマージリクエストリストをラベル優先度と優先度でソートする場合に使用されます。

ラベル優先度を設定する場合は、プロジェクトから行う必要があります。グループラベルリストから行うことはできません。

前提条件:

• プロジェクトに対してプランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。

ラベルの優先度を設定するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 管理 > ラベルを選択します。
3. 優先度を設定するラベルの横にある星印（ ）を選択します。

このラベルは、優先ラベルの下の、ラベルリストの最上部に表示されます。

これらのラベルの相対的な優先度を変更するには、リストを上下にドラッグします。リストの上位にあるラベルは、より高い優先度を取得します。

優先順またはラベル優先順で並べ替えた場合にどうなるかについては、イシューリストの並べ替えと順序付けを参照してください。

マージリクエストがマージされたときにラベルをロック

特定の監査要件に準拠するために、ラベルをロックされるように設定できます。ロックされたラベルを含むマージリクエストがマージされると、誰もMRからそれらを削除できません。

ロックされたラベルをイシューまたはエピックに追加すると、それらは標準のラベルのように動作します。

前提条件:

• プロジェクトまたはグループのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

マージ時にロックされるようにラベルを設定するには:

1. 上部のバーで、検索または移動先を選択して、グループまたはプロジェクトを見つけます。
2. 管理 > ラベルを選択します。
3. 編集するラベルの横にある縦方向の省略記号（ ）を選択し、次に編集を選択します。
4. マージリクエストのマージ後にラベルをロックチェックボックスを選択します。
5. 変更を保存を選択します。

関連トピック

• チュートリアル:
  • イシュートリアージ用に単一のプロジェクトをセットアップする
  • チームハンドオフ用のイシューボードを設定する
• ラベルの管理