Skip to main content

タグとは?

タグは特定のコミットを指す名前付きラベルです。リリース、マイルストーン、QA を通過したビルドなど、重要なコミットに印を付けて、あなたやチームが後から見つけられるようにするために使います。 ブランチとは異なり、タグは動きません。作成されると、タグは常に同じコミットを参照します。タグの名前や説明は変更できますが、タグ付けしたコミットを指し続けます。 デスクトップアプリのコミット一覧では、コミットのタグはメッセージの下にチップとして表示されます。タグはデスクトップアプリ、CLI、または API から管理できます。

タグの作成

  1. デスクトップアプリでリポジトリを開く
    • Commits ビューに移動し、タグを付けたいコミットを見つけます
  2. コミットのメニューを開く
    • コミット行に表示されるメニューアイコン(⋯)をクリックします
    • 「Create tag…」 を選択します
Commit menu with the Create tag option
  1. タグ名を入力する
    • 入力するとタグ名がバリデーションされます — 下記の タグ名のルール を参照してください
    • オプションで説明を追加できます(最大 1024 文字)
Create tag dialog with name and description fields
  1. 「Create tag」をクリックする
    • 新しいタグはすぐにコミットに表示されます

タグ ID のコピー

CLI と API のタグ操作では、タグ名ではなくタグ ID を使用します。取得方法は次のとおりです:
  1. コミット一覧で タグのチップをクリックする
  2. 「Copy tag ID」 を選択します — ID がクリップボードにコピーされます
Tag chip menu with copy ID, edit, and delete options

タグの編集

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

タグの削除

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

タグ名のルール

  • 名前には英字、数字、および . - _ / の文字を使用できます(スペースは不可)
  • 名前は 128 文字まで、説明は 1024 文字までに制限されています
  • タグ名はリポジトリ内で一意である必要があります
リポジトリで Git 同期が進行中の場合、タグ操作は一時的に「sync in progress」エラーで失敗することがあります。少し待ってから再試行してください。

CLI からタグを使用する

すべてのオプションについては dv tag リファレンス、自動化については Tags API を参照してください。