Używanie etykiet do tworzenia migawki plików w usłudze Azure Repos

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

etykiety Kontrola wersji serwera Team Foundation (TFVC) umożliwiają utworzenie migawki plików. Później możesz odwołać się do tej migawki. Za pomocą etykiety można wyświetlać, kompilować, a nawet wycofać duży zestaw plików do stanu, w którym znajdowały się podczas stosowania etykiety.

Wymagania wstępne

  • Aby zastosować etykietę, musisz mieć uprawnienie Etykieta ustawioną na Wartość Zezwalaj.
  • Aby znaleźć, wyświetlić lub wyświetlić etykiety, musisz mieć uprawnienie Odczyt ustawione na Zezwalaj.
  • Aby zmodyfikować lub usunąć etykietę, musisz być właścicielem etykiety lub mieć uprawnienie Administracja ister Labels ustawione na Zezwalaj.

Używanie etykiet

W wielu projektach oprogramowania, gdy kod osiągnął rozsądny poziom jakości i stabilności, zespół tworzy i zwalnia nową wersję produktu. Zespół musi oznaczyć bieżącą wersję każdego pliku. Nawet gdy pliki nadal się zmieniają, zespół nadal może uzyskać i skompilować nową wersję każdego pliku w swoim projekcie.

Teoretycznie można zarejestrować identyfikator każdego zestawu zmian dla każdego pliku ręcznie. Ale tego rodzaju proces nie jest praktyczny. Funkcja TFVC ułatwia wykonywanie zadań. Zastosuj etykietę do folderu, gałęzi lub projektu zawierającego pliki. Możesz nadać etykiecie nazwę zgodną z dowolną preferowaną konwencją nazewnictwa. Oto kilka przykładów nazw etykiet: "Sprint 5", "M1", "Beta2" i "Release Candidate 0".

Po zastosowaniu etykiety można jej użyć do kwalifikowania operacji, takich jak kompilowanie, rozgałęzianie, scalanie, porównywanie i pobieranie określonych wersji plików i folderów.

Czasami po zastosowaniu etykiety decydujesz, że musisz ją zmienić. Funkcja TFVC umożliwia zastosowanie etykiety do dodatkowych plików, usunięcie etykiety z niektórych plików i zmodyfikowanie wersji określonego pliku, do którego ma zastosowanie etykieta.

Napiwek

Stosowanie etykiety zapewnia wiele takich samych korzyści, jak tworzenie gałęzi, ale zazwyczaj z niższym kosztem i złożonością. Kompromis polega na tym, że w przypadku dużych baz danych operacje, takie jak scalanie, mogą trwać znacznie dłużej niż zwykle podczas uruchamiania względem etykiety.

Stosowanie etykiety

Uwaga

Jeśli używasz programu Visual Studio do stosowania etykiety, która już istnieje, operacja usuwa etykietę ze wszystkich wersji plików, a następnie stosuje etykietę. Jednak w wierszu polecenia operacja etykiety jest addytywna. Zobacz polecenie Etykieta (Kontrola wersji serwera Team Foundation).

  1. W programie Visual Studio w menu Widok wybierz pozycję Inne Eksplorator kontroli źródła systemu Windows>.

  2. W Eksploratorze kontroli źródła kliknij prawym przyciskiem myszy kolekcję, projekt, gałąź, folder lub plik, do którego chcesz zastosować etykietę, a następnie wybierz pozycję Zaawansowane>zastosuj etykietę. Zostanie wyświetlone okno dialogowe Nowa etykieta .

  3. W polu Nazwa wprowadź nazwę etykiety.

  4. (Opcjonalnie) W polu Komentarz wprowadź komentarz.

  5. Na liście Wersja domyślnie wybierana jest najnowsza wersja. Ta opcja to ta, która jest najczęściej używana. Jeśli chcesz, aby etykieta dotyczyła określonej wersji, wybierz jedną z następujących opcji:

    • Zestaw zmian: określ liczbę zestawów zmian w polu Zestaw zmian . Alternatywnie wybierz wielokropek (...), aby otworzyć okno dialogowe Znajdź zestawy zmian. Aby uzyskać więcej informacji, zobacz Znajdowanie i wyświetlanie zestawów zmian.

    • Data: określ datę w polu Data lub wybierz datę z kalendarza w menu rozwijanym.

    • Etykieta: określ istniejącą etykietę do podstawy nowej etykiety. Wprowadź nazwę etykiety w polu Etykieta lub wybierz wielokropek (...), aby otworzyć okno dialogowe Znajdź etykietę. Aby uzyskać więcej informacji, zobacz Znajdowanie, edytowanie i usuwanie etykiet.

    • Wersja obszaru roboczego: utwórz etykietę dla wersji w obszarze roboczym.

  6. Jeśli ustawienia są zadowalające, wykonaj jedną z następujących czynności:

    • Aby zastosować etykietę, wybierz pozycję Utwórz.

    • Aby zastosować etykietę, a następnie zmodyfikować ją po jej zastosowaniu, wybierz pozycję Utwórz i edytuj. Ta akcja stosuje etykietę, a następnie wyświetla okno Etykieta. Aby uzyskać więcej informacji na temat edytowania etykiety przy użyciu okna Etykieta , zobacz Używanie okna Etykieta do pracy z etykietami.

Uwaga

Po zastosowaniu etykiety używającej nazwy, która już istnieje, system ostrzega Cię i pyta, czy chcesz kontynuować. Jeśli wybierzesz przycisk OK , aby kontynuować, rozszerzenie TFVC usunie tę etykietę ze wszystkich elementów, które nie znajdują się w ścieżce, do której jest stosowana etykieta.

Zmienianie nazwy etykiety

Nie można zmodyfikować nazwy istniejącej etykiety. Można jednak łatwo zastosować nową etykietę do dokładnie tych samych plików i tych samych wersji, do których ma zastosowanie inna etykieta.

  1. W Eksploratorze kontroli źródła kliknij prawym przyciskiem myszy węzeł kolekcji projektu (węzeł główny), a następnie wybierz pozycję Zaawansowane>zastosuj etykietę. Zostanie wyświetlone okno dialogowe Nowa etykieta .

  2. W polu Nazwa wprowadź nazwę etykiety.

  3. (Opcjonalnie) W polu Komentarz wprowadź komentarz.

  4. Na liście Wersja wybierz pozycję Etykieta. Zostanie wyświetlone pole Etykieta.

  5. Wykonaj jedną z następujących czynności:

    • Wprowadź nazwę istniejącej etykiety.

    • Jeśli nie masz pewności co do nazwy istniejącej etykiety, wybierz przycisk przeglądania z wielokropkiem (...) obok pola Etykieta . Zostanie wyświetlone okno dialogowe Znajdowanie etykiety . Użyj opcji w oknie dialogowym Znajdowanie etykiety , aby filtrować listę etykiet i znaleźć istniejącą etykietę, do której chcesz zastosować nową etykietę. Aby uzyskać więcej informacji, zobacz Znajdowanie, edytowanie i usuwanie etykiet.

  6. Wybierz pozycję Utwórz.

  7. (Opcjonalnie) Po utworzeniu nowej etykiety możesz usunąć starą etykietę. Aby uzyskać więcej informacji, zobacz Znajdowanie, edytowanie i usuwanie etykiet.

Wyświetlanie, wyświetlanie, edytowanie i usuwanie etykiet

Istnieją dwa sposoby wyświetlania listy i znajdowania etykiet: okno dialogowe Znajdowanie etykiety i karta Etykieta w oknie Historia . Po znalezieniu interesującej Cię etykiety możesz wyświetlać, edytować lub usuwać. Możesz również pracować z plikami, do których ma zastosowanie etykieta.

Znajdowanie etykiet i praca z nimi przy użyciu okna dialogowego Znajdowanie etykiety

  1. Na pasku menu w Eksploratorze kontroli źródła wybierz pozycję Znajdź etykietę Znajdź>kontrolkę źródła>plików.> Zostanie wyświetlone okno dialogowe Znajdowanie etykiety .

  2. (Opcjonalnie) Uściślij wyszukiwanie, wykonując co najmniej jedną z następujących czynności:

    • W polu tekstowym Nazwa wprowadź nazwę etykiety.

    • Na liście Project (Projekt) wybierz projekt zawierający etykietę, którą chcesz znaleźć.

    • W polu tekstowym Właściciel wprowadź nazwę lub alias właściciela etykiety.

  3. Wybierz pozycję Znajdź. Na liście Wyniki są wyświetlane etykiety zgodne z wprowadzonymi kryteriami wyszukiwania.

  4. (Opcjonalnie) Wykonaj jedną z następujących czynności:

    • Aby wyświetlić lub edytować etykietę, wybierz ją i wybierz pozycję Edytuj. Zostanie wyświetlone okno Etykieta. Aby uzyskać więcej informacji, zobacz Używanie okna Etykieta do pracy z etykietami.

    • Aby usunąć etykietę, zaznacz ją i wybierz pozycję Usuń.

    • Wybierz Zamknij.

Wyświetlanie listy i praca z etykietami, które mają zastosowanie do określonego elementu

Czasami nie masz pewności co do nazwy etykiety, ale wiesz, że etykieta została zastosowana do określonego elementu pod kontrolą wersji. W poniższej procedurze wyjaśniono, jak znaleźć etykietę i pracować z tą etykietą.

  1. W Eksploratorze kontroli źródła kliknij prawym przyciskiem myszy element, do którego zastosowano etykietę, a następnie wybierz pozycję Wyświetl historię. Zostanie wyświetlone okno Historia .

  2. Wybierz kartę Etykiety, aby wyświetlić listę etykiet, które mają zastosowanie do tego elementu.

  3. (Opcjonalnie) Wykonaj jedną z następujących czynności:

    • Aby wyświetlić lub edytować etykietę, kliknij prawym przyciskiem myszy etykietę, a następnie wybierz polecenie Edytuj etykietę. Zostanie wyświetlone okno Etykieta. Aby uzyskać informacje o sposobie korzystania z tego okna, zobacz Używanie okna Etykieta do pracy z etykietami.

    • Aby usunąć etykietę, kliknij prawym przyciskiem myszy etykietę, a następnie wybierz polecenie Usuń etykietę.

    • Kliknij prawym przyciskiem myszy etykietę, a następnie wybierz inną akcję, taką jak Pobierz tę wersję lub Porównaj.

Aby uzyskać więcej informacji na temat używania karty etykiet w oknie Historia , zobacz Pobieranie historii elementu.

Pobieranie z etykietą wersji plików do obszaru roboczego

Etykietowanie zestawu plików przypomina tworzenie migawki sposobu ich istnienia w określonym momencie w czasie. Kilka tygodni lub miesięcy po utworzeniu tej migawki może być konieczne wyświetlenie lub praca z plikami, ponieważ istniały w tej migawki. W poniższej procedurze wyjaśniono, jak pobrać oznaczone wersje zestawu plików do obszaru roboczego.

  1. W Eksploratorze kontroli źródła kliknij prawym przyciskiem myszy kolekcję projektu, projekt, gałąź lub folder zawierający elementy, które chcesz pobrać, a następnie wybierz pozycję Zaawansowane>Pobierz określoną wersję. Zostanie wyświetlone okno dialogowe Pobieranie .

  2. Z listy Typ wybierz pozycję Etykieta, a następnie wprowadź nazwę etykiety w polu Etykieta lub wybierz wielokropek (...), aby otworzyć okno dialogowe Znajdź etykietę. Aby uzyskać więcej informacji na temat korzystania z tego okna dialogowego, zobacz Znajdowanie, edytowanie i usuwanie etykiet.

  3. Wybierz inne odpowiednie opcje w oknie dialogowym Pobieranie .

  4. Wybierz pozycję Pobierz.

Korzystanie z okna Etykieta do pracy z etykietami

Po otwarciu okna Etykieta przy użyciu jednej z powyższych procedur możesz rozpocząć pracę z etykietą. W górnej części okna zostanie wyświetlony komentarz, który można edytować.

Aby wykonać następujące zadania, możesz użyć okna Etykieta :

  • Dodawanie elementu do etykiety
  • Usuwanie elementu z etykiety
  • Zmienianie wersji pliku
  • Wykonywanie innych akcji na elemencie

Dodawanie elementu do etykiety

  1. W oknie Etykieta wybierz pozycję Dodaj element. Zostanie wyświetlone okno dialogowe Wybieranie wersji elementu.

  2. W oknie dialogowym Wybieranie wersji elementu przejdź do elementu, który chcesz dodać, a następnie wybierz go.

    Napiwek

    Możesz zaznaczyć i trzymać klawisze Ctrl lub Shift , a następnie wybrać wiele elementów.

  3. (Opcjonalnie) Jeśli chcesz, aby etykieta dotyczyła określonej wersji, z listy Wersja wybierz wersję:

    • Najnowsza wersja: zastosuj etykietę do najnowszej wersji, która jest w kontroli wersji.

    • Zestaw zmian: określ liczbę zestawów zmian w polu Zestaw zmian . Alternatywnie wybierz wielokropek (...), aby otworzyć okno dialogowe Znajdź zestawy zmian. Aby uzyskać więcej informacji, zobacz Znajdowanie i wyświetlanie zestawów zmian.

    • Data: określ datę w polu Data lub wybierz datę z kalendarza w menu rozwijanym.

    • Etykieta: określ istniejącą etykietę do podstawy nowej etykiety. Wprowadź nazwę etykiety w polu Etykieta lub wybierz wielokropek (...), aby otworzyć okno dialogowe Znajdź etykietę. Aby uzyskać więcej informacji, zobacz Znajdowanie, edytowanie i usuwanie etykiet.

    • Wersja obszaru roboczego: utwórz etykietę dla wersji w obszarze roboczym.

  4. Wybierz przycisk OK.

  5. Wybierz Plik>Zapisz.

Usuwanie elementu z etykiety

  1. W oknie Etykieta znajdź kolekcję, projekt, gałąź, folder lub plik, który chcesz usunąć z tej etykiety.

  2. Kliknij prawym przyciskiem myszy element i wybierz polecenie Usuń z etykiety. Etykieta zostanie usunięta z elementu. Jeśli element jest kolekcją projektu, projektem, gałęzią lub folderem, etykieta zostanie również usunięta ze wszystkich elementów, które zawiera.

  3. Wybierz Plik>Zapisz.

Zmienianie wersji pliku

  1. W oknie Etykieta znajdź plik, który chcesz zmodyfikować.

  2. Kliknij prawym przyciskiem myszy plik i wybierz polecenie Zmień wersję oznaczoną etykietą. Zostanie wyświetlone okno dialogowe Zmień wersję z etykietą.

  3. Należy wybrać jedną z następujących opcji:

    • Najnowsza wersja: zastosuj etykietę do najnowszej wersji, która jest w kontroli wersji.

    • Zestaw zmian: określ liczbę zestawów zmian w polu Zestaw zmian . Alternatywnie wybierz wielokropek (...), aby otworzyć okno dialogowe Znajdź zestawy zmian. Aby uzyskać więcej informacji, zobacz Znajdowanie i wyświetlanie zestawów zmian.

    • Data: określ datę w polu Data lub wybierz datę z kalendarza w menu rozwijanym.

    • Etykieta: określ istniejącą etykietę do podstawy nowej etykiety. Wybierz nazwę etykiety w polu Etykieta lub wybierz wielokropek (...), aby otworzyć okno dialogowe Znajdź etykietę . Aby uzyskać więcej informacji, zobacz Znajdowanie, edytowanie i usuwanie etykiet.

    • Wersja obszaru roboczego: utwórz etykietę dla wersji w obszarze roboczym.

  4. Wybierz Plik>Zapisz.

Wykonywanie innych akcji na elemencie oznaczonym etykietą

Po kliknięciu prawym przyciskiem myszy elementu w oknie Etykieta możesz również wybrać jedno z następujących poleceń:

Praca z wiersza polecenia

  • Użyj polecenia , labels aby wyświetlić listę etykiet. Aby uzyskać więcej informacji, zobacz Polecenie Etykiety.

  • Użyj polecenia , label aby zastosować lub usunąć etykietę. Aby uzyskać więcej informacji, zobacz Polecenie label (Kontrola wersji serwera Team Foundation).

    Napiwek

    Jeśli używasz label polecenia , aby zastosować etykietę, możesz określić zakres inny niż projekt.

Następne kroki