ラベルを使用して Azure Repos でファイルのスナップショットを取得する
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation バージョン管理 (TFVC) ラベルを使用すると、ファイルのスナップショットを取得できます。 そのスナップショットは、後で参照することができます。 ラベルを使用すると、多数のファイルを表示およびビルドできるだけでなく、ラベルを適用したときの状態までロールバックできます。
前提条件
- ラベルを適用するには、[ラベル] のアクセス許可が [許可] に設定されている必要があります。
- ラベルを検索、一覧表示、または表示するには、[読み取り] のアクセス許可が [許可] に設定されている必要があります。
- ラベルを変更または削除するには、ラベルの所有者であるか、[ラベルの管理] のアクセス許可セットが [許可] に設定されている必要があります。
ラベルの使用
多くのソフトウェア プロジェクトでは、コードの品質と安定性が適切なレベルに達した場合、チームは新しいバージョンの製品をビルドし、リリースします。 チームは、各ファイルの現在のバージョンをマークする必要があります。 そうすることで、ファイルの変更が続いている間でも、チームはプロジェクト内のどのファイルに対しても新しいバージョンを取得およびビルドできます。
理論的には、各ファイルの各変更セットの ID を手動で記録できます。 しかし、このようなプロセスは実用的ではありません。 TFVC を使用すると、この作業が簡単になります。 対象のファイルを含むフォルダー、ブランチ、またはプロジェクトにラベルを適用するだけです。 ラベルには、任意の名前付け規則に従って名前を付けることができます。 たとえば、"Sprint 5"、"M1"、"Beta2"、"Release Candidate 0" などのラベル名を付けることができます。
ラベルを適用すると、特定のバージョンのファイルやフォルダーのビルド、分岐、マージ、比較、取得などの操作を限定するために使用できます。
ラベルの適用後に、ラベルを変更する必要が出てくることもあります。 TFVC を使用すると、追加のファイルにラベルを適用すること、特定のファイルからラベルを削除すること、ラベルを適用する特定のファイルのバージョンを変更することができます。
ヒント
ラベルの適用には、分岐を作成できるだけでなく多くの利点がありますが、コストと複雑さは軽減されます。 トレードオフは、大規模なデータベースでは、ラベルに対して実行する際、マージなどの操作が通常よりもはるかに時間がかかる場合があるということです。
ラベルの適用
注意
Visual Studio を使用して既存のラベルを適用すると、すべてのファイル バージョンからそのラベルが削除された後で、そのラベルが適用されます。 一方、コマンド プロンプトからの場合、ラベル操作は付加的です。 「Label コマンド (Team Foundation バージョン管理)」を参照してください。
Visual Studio の [表示] メニューで、[Other Windows](その他のウィンドウ)>[ソース管理エクスプローラー] の順に選択します。
[ソース管理エクスプローラー] で、ラベルを適用するコレクション、プロジェクト、ブランチ、フォルダー、またはファイルを右クリックし、[詳細設定]>[ラベルの適用] を選択します。 [新しいラベル] ダイアログ ボックスが表示されます。
[名前] ボックスにラベルの名前を入力します。
(省略可能) [コメント] ボックスにコメントを入力します。
[バージョン] リストでは、既定で [最新バージョン] が選択されています。 このオプションは、最も一般的に使用されるオプションです。 特定のバージョンを対象とするラベルが必要な場合は、次のいずれかのオプションを選択します。
[変更セット]: [変更セット] ボックスで変更セットの番号を指定します。 または、省略記号 ([...]) をクリックして [変更セットの検索] ダイアログ ボックスを開きます。 詳細については、「変更セットの検索と表示」を参照してください。
[日付]: [日付] ボックスで日付を指定します。または、ドロップダウン メニューのカレンダーから日付を選択します。
[ラベル]: 新しいラベルのベースにする既存のラベルを指定します。 [ラベル] ボックスにラベル名を入力するか、省略記号 ([...]) をクリックして [ラベルの検索] ダイアログ ボックスを開きます。 詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。
[ワークスペース バージョン]: ワークスペースのバージョン用のラベルを作成します。
設定が終わったら、次の手順のいずれかに進みます。
ラベルを適用するには、[作成] を選択します。
ラベルを適用し、適用後に変更するには、[作成および編集] を選択します。 このアクションでラベルが適用され、[ラベル] ウィンドウが表示されます。 [ラベル] ウィンドウを使用してラベルを編集する方法の詳細については、「[ラベル] ウィンドウを使用したラベルの操作」を参照してください。
注意
既存の名前を使用してラベルを適用すると、続行するかどうかを確認する警告が表示されます。 [OK] を選択して続行すると、TFVC はラベルを適用するパスにない項目からそのラベルを削除します。
ラベル名の変更
既存のラベルの名前を変更することはできません。 ただし、新しいラベルは、別のラベルが適用されるのとまったく同じファイルと同じバージョンに簡単に適用できます。
[ソース管理エクスプローラー] でプロジェクト コレクション ノード (ルート ノード) を右クリックし、[詳細設定]>[ラベルの適用] の順に選択します。 [新しいラベル] ダイアログ ボックスが表示されます。
[名前] ボックスにラベルの名前を入力します。
(省略可能) [コメント] ボックスにコメントを入力します。
[バージョン] リストで [ラベル] を選択します。 [ラベル] ボックスが表示されます。
次のいずれかのステップを使用します。
既存のラベル名を入力します。
既存のラベル名をよく覚えていない場合、[ラベル] ボックスの横にある省略記号 ([...]) の参照ボタンをクリックします。 [ラベルの検索] ダイアログ ボックスが表示されます。 [ラベルの検索] ダイアログ ボックスのオプションを使用して、ラベルの一覧をフィルター処理し、新しいラベルを適用する既存のラベルを検索します。 詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。
［作成］ を選択します
(省略可能) 新しいラベルを作成したら、古いラベルを削除できます。 詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。
ラベルの一覧、検索、表示、編集、および削除
ラベルを一覧および検索する方法は 2 つあります。[ラベルの検索] ダイアログ ボックスと [履歴] ウィンドウの [ラベル] タブです。 関心のあるラベルを見つけたら、ラベルを表示、編集、または削除できます。 ラベルが適用されるファイルを操作することもできます。
[ラベルの検索] ダイアログ ボックスを使用したラベルの検索と操作
[ソース管理エクスプローラー] のメニュー バーで、[ファイル]>[ソース管理]>[検索条件]>[ラベルの検索] の順に選択します。 [ラベルの検索] ダイアログ ボックスが表示されます。
(省略可能) 次の 1 つ以上の手順を実行して、検索を絞り込みます。
[名前] テキスト ボックスにラベル名を入力します。
[プロジェクト] リストで、検索するラベルが含まれるプロジェクトを選択します。
[所有者] テキスト ボックスにラベルの所有者の名前またはエイリアスを入力します。
[検索条件] を選択します。 [結果] リストに、入力した検索条件に一致するラベルが表示されます。
(省略可能) 次のいずれかの手順を実行します。
ラベルを表示または編集するには、ラベルを選択して [編集] を選択します。 [ラベル] ウィンドウが表示されます。 詳細については、「[ラベル] ウィンドウを使用したラベルの操作」を参照してください。
ラベルを削除するには、ラベルを選択し、[削除] をクリックします。
[閉じる] を選択します。
特定の項目に適用するラベルの一覧および操作
ラベル名をよく覚えていない場合でも、バージョン管理でそのラベルが特定の項目に適用されたことがわかっていることがあります。 このような場合に、ラベルを検索し、操作する手順について説明します。
[ソース管理エクスプローラー] で、ラベルが適用された項目を右クリックし、[履歴の表示] を選択します。 [履歴] ウィンドウが表示されます。
[ラベル] タブを選択すると、この項目に適用されているラベルの一覧が表示されます。
(省略可能) 次のいずれかの手順を実行します。
ラベルを表示または編集するには、ラベルを右クリックし、[ラベルの編集] を選択します。 [ラベル] ウィンドウが表示されます。 このウィンドウの使用方法の詳細については、「[ラベル] ウィンドウを使用したラベルの操作」を参照してください。
ラベルを削除するには、ラベルを右クリックして、[ラベルの削除] を選択します。
ラベルを右クリックし、[このバージョンの取得] や [比較] などの別のアクションを選択します。
[履歴] ウィンドウの [ラベル] タブの使用方法については、「項目の履歴の取得」を参照してください。
ファイルのラベル付きバージョンをワークスペースにダウンロードする
一連のファイルにラベルを付ける操作は、特定の時点に存在したファイルのスナップショットを取得する場合と似ています。 スナップショットの取得後、数週間または数か月経ってから、そのスナップショットの時点のファイルを表示または操作する必要が出てくる可能性があります。 次の手順では、一連のファイルのラベル付きバージョンをワークスペースにダウンロードする方法について説明します。
[ソース管理エクスプローラー] で、ダウンロードする項目を含むプロジェクト コレクション、プロジェクト、ブランチ、またはフォルダーを右クリックし、[詳細設定]>[特定バージョンの取得] の順に選択します。 [取得] ダイアログ ボックスが表示されます。
[種類] ボックスの [ラベル] を選択し、[ラベル] ボックスにラベル名を入力するか、省略記号 ([...]) を選択して [ラベルの検索] ダイアログ ボックスを開きます。 このダイアログ ボックスの使用方法の詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。
[取得] ダイアログ ボックスで、その他の適切なオプションを選択します。
[取得] を選択します。
[ラベル] ウィンドウを使用したラベルの操作
前述した手順のいずれかを使用して [ラベル] ウィンドウを開いたら、ラベルを操作できます。 ウィンドウの上部にはコメントのボックスが表示され、これは編集できます。
[ラベル] ウィンドウは、次のタスクの実行に使用できます。
- ラベルへの項目の追加
- ラベルからの項目の削除
- ファイルのバージョン変更
- 項目に対するその他の操作
ラベルへの項目の追加
[ラベル] ウィンドウで、[項目の追加] を選択します。 [項目のバージョンの選択] ダイアログ ボックスが表示されます。
[項目のバージョンの選択] ダイアログ ボックスで、追加する項目に移動し、選択します。
ヒント
複数の項目を選択するには、Ctrl または Shift キーを押しながら項目を選択します。
(省略可能) 特定のバージョンを対象にしたラベルが必要な場合、[バージョン] リストから次のいずれかのバージョンを選択します。
[最新バージョン]: バージョン管理に含まれる最新バージョンにラベルが適用されます。
[変更セット]: [変更セット] ボックスで変更セットの番号を指定します。 または、省略記号 ([...]) をクリックして [変更セットの検索] ダイアログ ボックスを開きます。 詳細については、「変更セットの検索と表示」を参照してください。
[日付]: [日付] ボックスで日付を指定します。または、ドロップダウン メニューのカレンダーから日付を選択します。
[ラベル]: 新しいラベルのベースにする既存のラベルを指定します。 [ラベル] ボックスにラベル名を入力するか、省略記号 ([...]) をクリックして [ラベルの検索] ダイアログ ボックスを開きます。 詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。
[ワークスペース バージョン]: ワークスペースのバージョン用のラベルを作成します。
[OK] を選択します。
[ファイル]>[保存] を選びます。
ラベルからの項目の削除
[ラベル] ウィンドウで、このラベルから削除するコレクション、プロジェクト、ブランチ、フォルダー、またはファイルを見つけます。
項目を右クリックし、[ラベルから削除] を選択します。 項目からラベルが削除されます。 項目がプロジェクト コレクション、プロジェクト、ブランチ、またはフォルダーの場合、含まれるすべての項目からもラベルが削除されます。
[ファイル]>[保存] を選びます。
ファイルのバージョン変更
[ラベル] ウィンドウで、変更するファイルを見つけます。
ファイルを右クリックし、[ラベル付きバージョンの変更] を選択します。 [ラベル付きバージョンの変更] ダイアログ ボックスが表示されます。
次のいずれかの値を選択します。
[最新バージョン]: バージョン管理に含まれる最新バージョンにラベルが適用されます。
[変更セット]: [変更セット] ボックスで変更セットの番号を指定します。 または、省略記号 ([...]) をクリックして [変更セットの検索] ダイアログ ボックスを開きます。 詳細については、「変更セットの検索と表示」を参照してください。
[日付]: [日付] ボックスで日付を指定します。または、ドロップダウン メニューのカレンダーから日付を選択します。
[ラベル]: 新しいラベルのベースにする既存のラベルを指定します。 [ラベル] ボックスのラベル名を選択するか、省略記号 ([...]) をクリックして [ラベルの検索] ダイアログ ボックスを開きます。 詳細については、「ラベルの一覧、検索、編集、および削除」を参照してください。
[ワークスペース バージョン]: ワークスペースのバージョン用のラベルを作成します。
[ファイル]>[保存] を選びます。
ラベル付き項目に対するその他の操作
[ラベル] ウィンドウの項目を右クリックすると、次のコマンドのいずれかを選択することもできます。
- 表示 (ファイルのみ)
- 履歴を表示する
- 比較 (ファイルのみ)
- 注釈 (ファイルのみ)
- このバージョンの取得
コマンド プロンプトから作業する
labelsコマンドを使用してラベルを一覧表示します。 詳細については、「Labels コマンド」を参照してください。labelコマンドを使用して、ラベルを適用または削除します。 詳細については、「Label コマンド (Team Foundation バージョン管理)」を参照してください。ヒント
この
labelコマンドを使ってラベルを適用すると、プロジェクト以外のスコープを指定できます。