ラベル

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

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

ラベルの種類

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

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

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

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

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

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

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

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

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

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

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

利用可能なラベルを表示

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

project’s labels（プロジェクト）のラベルを表示するには:

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

または:

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

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

グループラベルを表示

group’s labels（グループ）のラベルを表示するには:

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. サブグループで、そのラベルを表示します。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ラベルを持つイシューが返されます。

スコープ付きラベルの例

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

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

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

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

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

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

Example 3（例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ラベルの両方を同時に持つことはcan’t（できません）。それらは両方とも同じスコープを共有しているためです：workflow::backend。

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

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

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

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

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

ラベルの優先度を設定

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

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

前提要件:

• プロジェクトのプランナーロール以上を持っている必要があります。

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

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

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

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

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

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

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

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

前提要件:

• プロジェクトまたはグループのプランナーロール以上を持っている必要があります。

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

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

関連トピック

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