> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# タグ

> Diversion でコミットにタグを付けて、リリース、マイルストーン、ビルドを目印にする

## タグとは?

タグは特定のコミットを指す名前付きラベルです。リリース、マイルストーン、QA を通過したビルドなど、重要なコミットに印を付けて、あなたやチームが後から見つけられるようにするために使います。

ブランチとは異なり、タグは動きません。作成されると、タグは常に同じコミットを参照します。タグの名前や説明は変更できますが、タグ付けしたコミットを指し続けます。

デスクトップアプリのコミット一覧では、コミットのタグはメッセージの下にチップとして表示されます。タグはデスクトップアプリ、[CLI](/ja/cmd-ref/tag)、または [API](/ja/api-reference/repository-tag-manipulation/list-tags) から管理できます。

## タグの作成

1. **デスクトップアプリでリポジトリを開く**
   * **Commits** ビューに移動し、タグを付けたいコミットを見つけます

2. **コミットのメニューを開く**
   * コミット行に表示されるメニューアイコン(⋯)をクリックします
   * **「Create tag...」** を選択します

<img src="https://mintcdn.com/diversion-2/5ygicBurOObD2isO/images/tags/create-tag-menu.png?fit=max&auto=format&n=5ygicBurOObD2isO&q=85&s=eb255b8d72fae0cdafeed086c6c99344" alt="Commit menu with the Create tag option" width="1106" height="690" data-path="images/tags/create-tag-menu.png" />

3. **タグ名を入力する**
   * 入力するとタグ名がバリデーションされます — 下記の [タグ名のルール](#タグ名のルール) を参照してください
   * オプションで説明を追加できます(最大 1024 文字)

<img src="https://mintcdn.com/diversion-2/5ygicBurOObD2isO/images/tags/create-tag-dialog.png?fit=max&auto=format&n=5ygicBurOObD2isO&q=85&s=4d45f0937fdd818179a8ab9c535c45e5" alt="Create tag dialog with name and description fields" width="1100" height="816" data-path="images/tags/create-tag-dialog.png" />

4. **「Create tag」をクリックする**
   * 新しいタグはすぐにコミットに表示されます

## タグ ID のコピー

CLI と API のタグ操作では、タグ名ではなくタグ ID を使用します。取得方法は次のとおりです:

1. コミット一覧で **タグのチップをクリックする**
2. **「Copy tag ID」** を選択します — ID がクリップボードにコピーされます

<img src="https://mintcdn.com/diversion-2/5ygicBurOObD2isO/images/tags/tag-chip-menu.png?fit=max&auto=format&n=5ygicBurOObD2isO&q=85&s=bd95a0b31eb40cd209d34b6e57455888" alt="Tag chip menu with copy ID, edit, and delete options" width="964" height="450" data-path="images/tags/tag-chip-menu.png" />

## タグの編集

1. **タグのチップをクリック** し、**「Edit tag...」** を選択します
2. **名前または説明を変更する** — ダイアログには現在の値が入力済みで開き、作成時と同じバリデーションが適用されます
3. **「Save」をクリックする**

編集で変更されるのはタグの名前や説明のみで、タグは引き続き同じコミットを指します。

## タグの削除

1. **タグのチップをクリック** し、**「Delete tag...」** を選択します
2. ダイアログで **削除を確認** します

<img src="https://mintcdn.com/diversion-2/5ygicBurOObD2isO/images/tags/delete-tag-dialog.png?fit=max&auto=format&n=5ygicBurOObD2isO&q=85&s=f114209f643281addaff2fed52ce57e1" alt="Delete tag confirmation dialog" width="1200" height="674" data-path="images/tags/delete-tag-dialog.png" />

## タグ名のルール

* 名前には英字、数字、および `.` `-` `_` `/` の文字を使用できます(スペースは不可)
* 名前は 128 文字まで、説明は 1024 文字までに制限されています
* タグ名はリポジトリ内で一意である必要があります

リポジトリで Git 同期が進行中の場合、タグ操作は一時的に「sync in progress」エラーで失敗することがあります。少し待ってから再試行してください。

## CLI からタグを使用する

```bash theme={null}
# タグを一覧表示
dv tag

# 現在のコミットにタグを作成
dv tag -c v1.4-release -a "QA-approved release build"

# ID でタグを削除
dv tag -d <tag_id>
```

すべてのオプションについては [`dv tag` リファレンス](/ja/cmd-ref/tag)、自動化については [Tags API](/ja/api-reference/repository-tag-manipulation/list-tags) を参照してください。