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

  • Článek

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

Visual Studio 2019 | Visual Studio 2022

popisky Správa verzí Team Foundation (TFVC) poskytují způsob, jak pořídit snímek souborů. Později se můžete na tento snímek vrátit. Pomocí popisku můžete zobrazit, sestavit nebo dokonce vrátit velkou sadu souborů do stavu, ve které byly při použití popisku.

Požadavky

  • Pokud chcete použít popisek, musíte mít oprávnění Popisek nastavené na Povolit.
  • Pokud chcete najít, vypsat nebo zobrazit popisky, musíte mít oprávnění ke čtení nastavené na Povolit.
  • Pokud chcete popisek upravit nebo odstranit, musíte ho vlastnit nebo mít oprávnění Správa ister Labels nastavená na Povolit.

Použití popisků

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. Popisek můžete pojmenovat podle jakýchkoli konvencí pojmenování, které dáváte přednost. 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í popisku rozhodnete, že ho budete muset 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.

Tip

Použití popisku poskytuje řadu stejných výhod jako vytvoření větve, ale obvykle s nižšími náklady a složitostí. Nevýhodou je, že u velkých databází může operace, jako je slučování, trvat mnohem déle, než obvykle při spuštění na popisku.

Použití popisku

Poznámka:

Pokud použijete Sadu Visual Studio k použití popisku, který už existuje, operace odebere popisek ze všech verzí souborů a pak popisek použije. Z příkazového řádku je však operace popisku sčítá. Viz příkaz Popisek (Správa verzí Team Foundation).

  1. V sadě Visual Studio v nabídce Zobrazit vyberte Jiný průzkumník správy zdrojového kódu systému Windows>.

  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 Rozšířený>popisek. Zobrazí se dialogové okno Nový popisek .

  3. Do pole Název zadejte název popisku.

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

  5. V seznamu verzí 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 počet sady změn v poli Sada změn . Můžete také vybrat tři tečky (...) a otevřít dialogové okno Najít sady změn . Další informace naleznete v tématu Vyhledání a zobrazení sad změn.

    • Datum: Zadejte datum v poli 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 popisku do pole Popisek nebo výběrem tří teček (...) otevřete dialogové okno Najít popisek . Další informace najdete v tématu Vyhledání, úprava a odebrání popisků.

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

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

    • Pokud chcete popisek použít, 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 naleznete 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 chcete pokračovat výběrem možnosti OK , TFVC odebere tento popisek ze všech položek, které nejsou v cestě, na kterou popisek používáte.

Přejmenování popisku

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 Rozšířený>popisek použít. Zobrazí se dialogové okno Nový popisek .

  2. Do pole Název zadejte název popisku.

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

  4. V seznamu verzí vyberte Popisek. Zobrazí se pole Popisek .

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

    • Zadejte název existujícího popisku.

    • Pokud si nejste jistí názvem existujícího popisku, vyberte tlačítko procházet 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, u kterého chcete použít nový popisek. Další informace najdete v tématu Vyhledání, úprava a odebrá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 Vyhledání, úprava a odebrání popisků.

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

Existují dva způsoby, jak vypsat a najít popisky: dialogové okno Najít popisek a kartu 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. V Průzkumníku správy zdrojového kódu na řádku nabídek vyberte> Najít popisek Hledání>správy zdrojového kódu>souboru. 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 Projektu vyberte projekt, který obsahuje popisek, který chcete najít.

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

  3. Vyberte Najít. V seznamu Výsledků se zobrazí 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. Zobrazí se okno Popisek . Další informace najdete v tématu Použití okna Popisek k práci s popisky.

    • 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 popisek a pracovat s tímto 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. Výběrem karty Popisky zobrazíte seznam popisků, které se vztahují na tuto položku.

  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 pak vyberte Upravit popisek. Zobrazí se okno Popisek . Informace o tom, jak toto okno používat, najdete v tématu Použití okna Popisek pro práci s popisky.

    • Pokud chcete popisek odstranit, klikněte na popisek pravým tlačítkem myši 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. Zobrazí se dialogové okno Získat .

  2. V seznamu Typ vyberte Popisek a pak zadejte název popisku do pole Popisek, nebo výběrem tří teček (...) otevřete dialogové okno Najít popisek. Další informace o tom, jak používat toto dialogové okno, 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.

Práce s popisky pomocí okna Popisek

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.

Okno Popisek můžete použít k provedení následujících úloh:

  • Přidání položky do popisku
  • Odebrání položky 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ě Popisek 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.

    Tip

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

  3. (Volitelné) Pokud potřebujete, aby byl popisek určený pro určitou verzi, vyberte v seznamu verze verzi:

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

    • Sada změn: Zadejte počet sady změn v poli Sada změn. Můžete také vybrat tři tečky (...) a otevřít dialogové okno Najít sady změn . Další informace naleznete v tématu Vyhledání a zobrazení sad změn.

    • Datum: Zadejte datum v poli 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 popisku do pole Popisek nebo výběrem tří teček (...) otevřete dialogové okno Najít popisek . Další informace najdete v tématu Vyhledání, úprava a odebrání popisků.

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

  4. Vyberte OK.

  5. Vyberte Soubor>Uložit.

Odebrání položky 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 verzi s popiskem. Zobrazí se dialogové okno Změnit verzi s popiskem.

  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í.

    • Sada změn: Zadejte počet sady změn v poli Sada změn . Můžete také vybrat tři tečky (...) a otevřít dialogové okno Najít sady změn . Další informace naleznete v tématu Vyhledání a zobrazení sad změn.

    • Datum: Zadejte datum v poli 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 kliknutím na tři tečky (...) otevřete dialogové okno Najít popisek. Další informace najdete v tématu Vyhledání, úprava a odebrá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ů:

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

  • labels Pomocí příkazu zobrazte seznam popisků. Další informace naleznete v tématu Popisky příkaz.

  • label Pomocí příkazu použijte nebo odeberte popisek. Další informace najdete v části Příkaz Popisek (Správa verzí Team Foundation).

    Tip

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

Další kroky