Použití popisků k pořízení snímku souborů v Azure Repos

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Popisky v Team Foundation Version Control (TFVC) poskytují možnost vytvořit snímek vašich souborů. Později se můžete na tento snímek vrátit. Pomocí štítku můžete zobrazit, sestavit nebo dokonce vrátit velkou sadu souborů do stavu, ve kterém byly při použití štítku.

Požadavky

• Pokud chcete použít popisek, nastavte oprávnění Popisek na Povolit.
• Pokud chcete najít, vypsat nebo zobrazit popisky, nastavte oprávnění Číst na Povolit.
• Chcete-li upravit nebo odstranit popisek, musíte ho vlastnit nebo mít oprávnění Spravovat popisky nastavené na Povolit.

Použijte popisky

V mnoha softwarových projektech, když kód dosáhl přiměřené úrovně kvality a stability, tým sestaví a vydá novou verzi produktu. Tým musí označit aktuální verzi každého souboru. I když se soubory stále mění, tým může stále získat a sestavit novou verzi každého souboru v projektu.

Teoreticky byste mohli zaznamenat ID každé sady změn pro každý soubor ručně. Tento druh procesu ale není praktický. TFVC usnadňuje práci. Použijte popisek u složky, větve nebo projektu, který obsahuje soubory. Štítek můžete pojmenovat podle zásad pojmenovávání, které preferujete. Mezi příklady názvů popisků patří Sprint 5, M1, Beta2 a Release Candidate 0.

Jakmile popisek použijete, můžete ho použít k opravňujícím operacím, jako je sestavování, větvení, slučování, porovnávání a získávání konkrétních verzí souborů a složek.

Někdy se po použití štítku rozhodnete, že jej potřebujete změnit. TFVC poskytuje způsob, jak použít popisek u dalších souborů, odebrat popisek z určitých souborů a upravit, na kterou verzi konkrétního souboru se popisek vztahuje.

Spropitné

Použití štítku poskytuje mnoho stejných výhod jako vytvoření větve, ale obvykle s nižšími náklady a menší složitostí. Nevýhodou je, že u velkých databází mohou operace, jako je slučování, trvat výrazně déle než obvykle při spuštění proti značce.

Použít štítek

Poznámka

Když použijete Visual Studio k aplikaci štítku, který už existuje, operace nejprve odebere štítek ze všech verzí souborů, a poté ho znovu aplikuje. Z příkazového řádku je však operace se štítky přidávající. Viz příkaz Štítek (Správa verzí Team Foundation).

1. V sadě Visual Studio v nabídce View (Zobrazit) vyberte Další okna>Průzkumník správy zdrojového kódu.

2. V Průzkumníku správy zdrojového kódu klikněte pravým tlačítkem myši na kolekci, projekt, větev, složku nebo soubor, u kterého chcete použít popisek, a pak vyberte Upřesnit>Použít popisek. Dialogové okno Nový popisek se zobrazí.

3. Do pole Název zadejte název štítku.

4. (Volitelné) Do pole Komentář zadejte komentář.

5. V seznamu verze je ve výchozím nastavení vybraná nejnovější verze. Tato možnost je ta, která se nejčastěji používá. Pokud potřebujete popisek pro cílení na konkrétní verzi, vyberte jednu z následujících možností:

   • Sada změn: Zadejte číslo sady změn v poli Sada změn. Můžete také vybrat výpustku (...), abyste otevřeli dialogové okno Najít sady změn. Další informace naleznete v tématu Najít a zobrazit sady změn.

   • Datum: Zadejte datum do pole Datum nebo vyberte datum z kalendáře v rozevírací nabídce.

   • popisek: Zadejte existující popisek, na kterém se má nový popisek založit. Buď zadejte název štítku do pole Štítek, nebo vyberte elipsy (...) a otevřete dialogové okno Najít štítek. Další informace najdete v tématu Hledání, úpravy a odebírání popisků.

   • verze pracovního prostoru: Vytvořte štítek pro verzi ve vašem pracovním prostoru.

6. Až budete s nastavením spokojeni, proveďte jeden z následujících kroků:

   • Chcete-li použít štítek, vyberte Vytvořit.

   • Pokud chcete popisek použít a potom ho po použití upravit, vyberte Vytvořit a upravit. Tato akce použije popisek a pak zobrazí okno Popisek. Další informace o použití okna Popisek k úpravě popisku najdete v tématu Použití okna Popisek pro práci s popisky.

Poznámka

Když použijete popisek, který používá název, který už existuje, systém vás upozorní a zeptá se, jestli chcete pokračovat. Pokud vyberete OK pokračovat, TFVC odebere tento popisek ze všech položek, které nejsou v cestě, na kterou popisek používáte.

Přejmenujte štítek

Název existujícího popisku nelze změnit. Nový popisek ale můžete snadno použít u stejných souborů a stejných verzí, na které se vztahuje jiný popisek.

1. V Průzkumníku správy zdrojového kódu klikněte pravým tlačítkem myši na uzel kolekce projektů (kořenový uzel) a pak vyberte Pokročilé>Přiřadit štítek. Zobrazí se dialogové okno Nový popisek.

2. Do pole Název zadejte název štítku.

3. (Volitelné) Do pole Komentář zadejte komentář.

4. V seznamu Verze vyberte Popisek. Objeví se okno Popisek.

5. Proveďte jeden z následujících kroků:

   • Zadejte název existujícího štítku.

   • Pokud si nejste jistí názvem existujícího popisku, vyberte tlačítko procházení se třemi tečkami (...) vedle pole Popisek. Zobrazí se dialogové okno Najít popisek. Pomocí možností v dialogovém okně Najít popisek vyfiltrujte seznam popisků a najděte existující popisek, na který chcete nový popisek použít. Další informace najdete v tématu Hledání, úpravy a odebírání popisků.

6. Vyberte Vytvořit.

7. (Volitelné) Po vytvoření nového popisku můžete starý popisek odebrat. Další informace najdete v tématu Hledání, úpravy a odebírání popisků.

Seznam, hledání, zobrazení, úpravy a odebrání popisků

Popisky můžete vypsat a najít dvěma způsoby: dialogové okno Najít popisek a karta Popisek v okně Historie. Jakmile najdete popisek, který vás zajímá, můžete ho zobrazit, upravit nebo odebrat. Můžete také pracovat se soubory, na které se popisek vztahuje.

Hledání a práce s popisky pomocí dialogového okna Najít popisek

1. Na řádku nabídek v Průzkumníku správy verzí vyberte Soubor>Správa verzí>Najít>Najít popisek. Zobrazí se dialogové okno Najít popisek.

2. (Volitelné) Hledání můžete upřesnit provedením jednoho nebo několika následujících kroků:

   • Do textového pole Název zadejte název popisku.

   • V seznamu Project vyberte projekt obsahující popisek, který chcete najít.

   • Do textového pole Vlastník zadejte jméno nebo alias vlastníka štítku.

3. Vyberte Najděte. Seznam Výsledky zobrazuje popisky, které odpovídají zadaným kritériím hledání.

4. (Volitelné) Proveďte jeden z následujících kroků:

   • Pokud chcete zobrazit nebo upravit popisek, vyberte ho a vyberte Upravit. Objeví se okno štítku . Další informace naleznete v tématu Použití okna Štítek pro práci s štítky.

   • Pokud chcete popisek odstranit, vyberte ho a vyberte Odstranit.

   • Vyberte Zavřít.

Seznam a práce s popisky, které platí pro konkrétní položku

Někdy si možná nejste jistí názvem popisku, ale víte, že se popisek použil na konkrétní položku v rámci správy verzí. Následující postup vysvětluje, jak v této situaci najít a pracovat s popiskem.

1. V Průzkumníku správy zdrojového kódu klikněte pravým tlačítkem myši na položku, na kterou byl popisek použit, a pak vyberte Zobrazit historii. Zobrazí se okno historie .

2. Pro zobrazení seznamu popisků platných pro tuto položku vyberte záložku Popisky.

3. (Volitelné) Proveďte jeden z následujících kroků:

   • Pokud chcete zobrazit nebo upravit popisek, klikněte na něj pravým tlačítkem myši a vyberte Upravit popisek. Zobrazí se okno Štítek. Pro informace o tom, jak používat toto okno, se podívejte na Okno pro práci s popisky.

   • Chcete-li odstranit popisek, klikněte pravým tlačítkem myši na popisek a vyberte Odstranit popisek.

   • Klikněte pravým tlačítkem myši na popisek a vyberte jinou akci, například Získat tuto verzi nebo Porovnat.

Další informace o použití karty popisku v okně Historie naleznete v tématu Získání historie položky.

Stažení označených verzí souborů do pracovního prostoru

Označení sady souborů je jako pořízení snímku toho, jak existovaly v určitém okamžiku. Týdny nebo měsíce po pořízení tohoto snímku možná budete muset zobrazit nebo pracovat se soubory, které existovaly v tomto snímku. Následující postup vysvětluje, jak stáhnout označené verze sady souborů do pracovního prostoru.

1. V Průzkumníku správy zdrojového kódu klikněte pravým tlačítkem myši na kolekci projektů, projekt, větev nebo složku obsahující položky, které chcete stáhnout, a pak vyberte Upřesnit>Získat konkrétní verzi. Dialogové okno Získat se zobrazí.

2. V seznamu Typ vyberte Popisek, a poté zadejte název popisku do pole Popisek, nebo vyberte tři tečky (...) pro otevření dialogového okna Najít Popisek. Další informace o použití tohoto dialogového okna naleznete v tématu Najít, upravit a odebrat popisky.

3. V dialogovém okně Získat vyberte všechny další vhodné možnosti.

4. Vyberte Získat.

Použijte okno Popisek k práci s popisky

Po otevření okna Popisek pomocí některého z předchozích postupů můžete začít pracovat s popiskem. V horní části okna se v poli zobrazí komentář, který můžete upravit.

K provedení následujících úloh můžete použít okno Štítek:

• Přidání položky do popisku
• Odstraňte položku z popisku
• Změna verze souboru
• Provádění dalších akcí u položky

Přidání položky do popisku

1. V okně Štítek vyberte Přidat položku. Zobrazí se dialogové okno Zvolit verzi položky.

2. V dialogovém okně Zvolit verzi položky přejděte na položku, kterou chcete přidat, a vyberte ji.

   Spropitné

   Můžete vybrat a podržet klávesy Ctrl nebo Shift a pak vybrat více položek.

3. (Volitelné) Pokud potřebujete, aby popisek cílil na konkrétní verzi, vyberte v seznamu verze verzi:

   • nejnovější verze: Použijte štítek na nejnovější verzi, která je pod správou verzí.

   • Sada změn: Zadejte číslo sady změn do pole sady změn. Můžete také vybrat tři tečky (...) a otevřít dialogové okno Najít sady změn. Další informace naleznete v části Najít a zobrazit sady změn.

   • Datum: Zadejte datum do pole Datum nebo vyberte datum z kalendáře v rozevírací nabídce.

   • popisek: Zadejte existující popisek, na kterém se má nový popisek založit. Zadejte název štítku do pole Štítek nebo klikněte na tři tečky (...) a otevřete dialogové okno Najít štítek. Další informace najdete v tématu Hledání, úpravy a odebírání popisků.

   • Verze workspace: Vytvořte označení pro verzi ve vašem pracovním prostoru.

4. Vyberte OK.

5. Vyberte Soubor>Uložit.

Odeber položku z popisku

1. V okně Popisek vyhledejte kolekci, projekt, větev, složku nebo soubor, který chcete z tohoto popisku odebrat.

2. Klikněte pravým tlačítkem myši na položku a vyberte Odebrat z popisku. Popisek se odebere z položky. Pokud se jedná o kolekci projektů, projekt, větev nebo složku, popisek se odebere také ze všech položek, které obsahuje.

3. Vyberte Soubor>Uložit.

Změna verze souboru

1. V okně Popisek vyhledejte soubor, který chcete upravit.

2. Klikněte pravým tlačítkem myši na soubor a vyberte Změnit označenou verzi. Zobrazí se dialogové okno Změnit označenou verzi.

3. Vyberte jednu z následujících hodnot:

   • nejnovější verze: Použijte popisek na nejnovější verzi, která je ve správě verzí.

   • Změna sady: Zadejte číslo sady změn do pole Sada změn. Můžete také vybrat tři tečky (...) a otevřít dialogové okno Najít sady změn. Další informace viz Najít a zobrazit sady změn.

   • Datum: Zadejte datum do pole Datum nebo vyberte datum z kalendáře v rozevírací nabídce.

   • popisek: Zadejte existující popisek, na kterém se má nový popisek založit. Buď vyberte název popisku v poli Popisek, nebo výběrem tří teček (...) otevřete dialogové okno Najít popisek. Pro více informací viz Hledání, úpravy a odebírání popisků.

   • verze pracovního prostoru: Vytvořte popisek pro verzi v pracovním prostoru.

4. Vyberte Soubor>Uložit.

Provádění dalších akcí u označené položky

Když kliknete pravým tlačítkem myši na položku v okně Popisek, můžete také vybrat jeden z následujících příkazů:

• Zobrazit (jenom soubory)
• Zobrazit historii
• Porovnat (pouze soubory)
• Označit (pouze soubory)
• Získejte tuto verzi

Práce z příkazového řádku

• K výpisu popisků použijte příkaz labels. Další informace najdete v tématu příkaz Štítky.

• Pomocí příkazu label aplikujte nebo odeberte štítek. Další informace najdete v příkazu Štítek (Team Foundation Version Control).

  Spropitné

  Když použijete příkaz label k použití popisku, můžete zadat jiný obor než projekt.

Další kroky

• Hledání a zobrazení sad změn
• Vytváření a práce s pracovními prostory
• Referenční oprávnění a skupiny
• Používejte větve k izolaci rizika ve správě verzí Team Foundation
• Použijte Průzkumníka verzí ke správě souborů pod správou verzí