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

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

Visual Studio 2019 | Visual Studio 2022

Etykiety kontroli wersji programu 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.

Warunki wstępne

• Aby zastosować etykietę, należy ustawić uprawnienie LabelZezwalaj na.
• Aby znaleźć, wypisać lub wyświetlić etykiety, ustaw uprawnienia Odczyt na Zezwalaj na.
• Aby zmodyfikować lub usunąć etykietę, musisz być właścicielem etykiety lub mieć uprawnienie Administrowanie etykietami 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ą. Kosztem jest to, że w przypadku dużych baz danych operacje, takie jak scalanie, mogą trwać znacznie dłużej niż zwykle, działając na etykiecie.

Stosowanie etykiety

Notatka

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 komendę Label (Team Foundation Version Control).

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ę dla etykiety.

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

5. Na liście wersja, najnowsza wersja jest domyślnie wybrana. 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 numer zestawu zmian w polu Zestaw zmian . Alternatywnie wybierz wielokropki (...), aby otworzyć okno dialogowe Znajdź zestawy zmian. Aby uzyskać więcej informacji, zobacz sekcję 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ę, na podstawie której stworzysz nową etykietę. 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 ją zmodyfikować, wybierz Utwórz i Edytuj. Ta akcja stosuje etykietę i następnie wyświetla okno etykiety. Aby uzyskać więcej informacji na temat używania okna etykiet do edytowania etykiety, zobacz Używanie okna Etykieta do pracy z etykietami.

Notatka

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

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 Źródła kliknij prawym przyciskiem myszy na węźle kolekcji projektu (węźle głównym), 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 wersji wybierz etykietę . Pojawia się pole etykiety .

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. Pojawi się okno dialogowe znajdź etykietę. Użyj opcji w oknie dialogowym Znajdź etykietę, aby odfiltrować 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.

Wymienianie, wyszukiwanie, wyświetlanie, edytowanie i usuwanie etykiet

Istnieją dwa sposoby wyświetlania listy i znajdowania etykiet: okno dialogowe Znajdź etykietę oraz 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ę File>Source Control>Find>Find Label. Pojawi się okno dialogowe znajdź etykietę.

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 wybierz projekt zawierający etykietę, którą chcesz znaleźć.

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

3. Wybierz 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. Okno Etykieta zostanie wyświetlone. Aby uzyskać więcej informacji, zobacz Użyj okna Etykieta do pracy z etykietami.

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

   • Wybierz , a następnie Zamknij.

Lista i praca z etykietami, które dotyczą 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źć i pracować z etykietą w tej sytuacji.

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 Edytuj etykietę. Pojawi się okno Etykieta . Aby uzyskać informacje na temat korzystania z tego okna, zobacz Jak używać okna Etykiety do pracy z etykietami.

   • Aby usunąć etykietę, kliknij prawym przyciskiem myszy etykietę, a następnie wybierz pozycję 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 etykiety w oknie Historia, zobacz Uzyskiwanie historii elementu.

Pobieranie wersji plików z etykietą 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, jak istniały w tej migawce. 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 konkretną wersję. Pojawia się okno dialogowe Pobierz.

2. Z listy Typu wybierz pozycję Etykieta, a następnie wprowadź nazwę etykiety w polu Etykieta lub wybierz przycisk wielokropka (...), 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 Pobierz.

4. Wybierz pozycję Pobierz.

Korzystanie z okna Etykieta do pracy z etykietami

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

Możesz użyć okna etykiet, aby wykonać następujące zadania:

• 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 Wybierz wersję elementu przejdź do elementu, który chcesz dodać, a następnie wybierz go.

   Napiwek

   Możesz przytrzymać klawisz Ctrl lub Shift, a następnie wybrać wiele elementów.

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

   • Najnowsza wersja : Zastosuj etykietę do najnowszej wersji, która znajduje się w kontroli wersji.

   • Changeset: określ numer zestawu zmian w polu zestawu zmian. Alternatywnie wybierz wielokropki (...), 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ę, na podstawie której ma powstać nowa etykieta. 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 pozycję 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 pozycję 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 pozycję Plik>Zapisz.

Zmienianie wersji pliku

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

2. Kliknij plik prawym przyciskiem myszy i wybierz zmień wersję oznaczoną etykietą. Pojawi się okno dialogowe Zmień wersję oznaczoną .

3. Wybierz jedną z następujących wartości:

   • Najnowsza Wersja: Zastosuj etykietę do najnowszej wersji, która jest pod kontrolą wersji.

   • Zestaw zmian: Określ numer zestawu zmian w polu Zestaw zmian. Alternatywnie wybierz przycisk wielokropków (...), aby otworzyć okno dialogowe Znajdź zestawy zmian. Aby uzyskać więcej informacji, zapoznaj się z tematem Znajdowanie i wyświetlanie zestawów zmian.

   • data: podaj datę w polu Data lub wybierz datę z kalendarza z menu rozwijanego.

   • Etykieta: określ istniejącą etykietę, na podstawie której utworzysz nową etykietę. 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 swoim 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ń:

• Widok (tylko pliki)
• Wyświetl historię
• Porównaj (tylko pliki)
• Dodawanie adnotacji do (tylko pliki)
• Pobierz tę wersję

Praca w wierszu poleceń

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

• Użyj polecenia label, aby zastosować lub usunąć etykietę. Aby uzyskać więcej informacji, zobacz polecenie Label (Team Foundation Version Control).

  Napiwek

  W przypadku zastosowania etykiety za pomocą polecenia label można określić zakres inny niż projekt.

Następne kroki

• znajdowanie i wyświetlanie zestawów zmian
• Tworzenie i praca z obszarami roboczymi
• uprawnienia i grupy — dokumentacja
• Używanie gałęzi do izolowania ryzyka w usłudze Team Foundation Version Control
• zarządzanie plikami w ramach kontroli wersji za pomocą Eksploratora kontroli kodu źródłowego