Jak mogę zarchiwizować gałęzie git?

Mam kilka starych gałęzi w moim repozytorium git, które nie są już aktywnie rozwijane. Chciałbym zarchiwizować gałęzie, aby nie wyświetlały się domyślnie podczas działania git branch -l -r. Nie chcę ich usuwać, ponieważ chcę zachować historię. W jaki sposób mogę to zrobić?

Wiem, że można utworzyć ref poza refs / heads. Na przykład refs/archive/old_branch. Czy są jakieś konsekwencje takiego postępowania?

Uważam, że właściwym sposobem jest oznaczenie gałęzi. Jeśli usuniesz gałąź po jej otagowaniu, to skutecznie ją utrzymasz, ale nie zaśmieci ona twojej listy.

Jeśli chcesz wrócić do oddziału, po prostu sprawdź tag. Skutecznie przywróci gałąź ze znacznika.

Aby zarchiwizować i usunąć gałąź:

git tag archive/<branchname> <branchname>
git branch -d <branchname>

Aby przywrócić gałąź jakiś czas później:

git checkout -b <branchname> archive/<branchname>

Historia oddziału zostanie zachowana dokładnie tak, jak wtedy, gdy go oznaczyłeś.

Odpowiedź Jeremy'ego jest w zasadzie poprawna, ale polecenia IMHO, które określa, nie są całkiem poprawne.

Oto jak zarchiwizować gałąź do znacznika bez konieczności pobierania gałęzi (a zatem bez konieczności kasowania do innej gałęzi przed usunięciem tej gałęzi):

> git tag archive/<branchname> <branchname>
> git branch -D <branchname>

A oto jak przywrócić gałąź:

> git checkout -b <branchname> archive/<branchname>

Tak, możesz utworzyć odwołanie za pomocą niestandardowego prefiksu git update-ref. na przykład

• Zarchiwizuj oddział: git update-ref refs/archive/old-topic topic && git branch -D topic
• Przywróć gałąź (w razie potrzeby): git branch topic refs/archive/old-topic

Referencje z niestandardowym prefiksem (tutaj refs/archive) nie pojawią się zwykle git branch, git logani git tag. Nadal możesz je wymienić git for-each-ref.

Używam następujących aliasów:

[alias]
    add-archive = "!git update-ref refs/archive/$(date '+%Y%m%d-%s')"
    list-archive = for-each-ref --sort=-authordate --format='%(refname) %(objectname:short) %(contents:subject)' refs/archive/
    rem = !git add-archive
    lsrem = !git list-archive

Możesz także skonfigurować piloty, takie jak push = +refs/archive/*:refs/archive/*automatyczne wypychanie zarchiwizowanych gałęzi (lub git push origin refs/archive/*:refs/archive/*jednorazowo).

Innym sposobem jest zapisanie SHA1 gdzieś przed usunięciem gałęzi, ale ma ona ograniczenia. Zatwierdzenia bez żadnego refrenu zostaną GC'd po 3 miesiącach (lub kilku tygodniach bez reflogu) , nie mówiąc już o ręcznym git gc --prune. Zmiany wskazane przez referencje są bezpieczne od GC.

Edycja: Znaleziono implementację perl tego samego pomysłu przez @ap :git-attic

Edytuj ^ 2: Znaleziono wpis na blogu, w którym sam Gitster używa tej samej techniki.

Rozszerzyłem odpowiedź Steve'a, aby odzwierciedlić zmiany na pilocie

 git tag archive/<branchname> <branchname>
 git branch -D <branchname>
 git branch -d -r origin/<branchname>
 git push --tags
 git push origin :<branchname>

Aby przywrócić z pilota, zobacz to pytanie .

Możesz zarchiwizować gałęzie w innym repozytorium. Nie tak elegancki, ale powiedziałbym, że to realna alternatywa.

git push git://yourthing.com/myproject-archive-branches.git yourbranch
git branch -d yourbranch

Oto alias tego:

arc    = "! f() { git tag archive/$1 $1 && git branch -D $1;}; f"

Dodaj to w ten sposób:

git config --global alias.arc '! f() { git tag archive/$1 $1 && git branch -D $1;}; f'

Pamiętaj, że istnieje git archivejuż polecenie, więc nie możesz używać go archivejako pseudonimu.

Możesz także zdefiniować alias, aby wyświetlić listę „zarchiwizowanych” gałęzi:

arcl   = "! f() { git tag | grep '^archive/';}; f"

o dodawaniu aliasów

Używam następujących aliasów do ukrywania zarchiwizowanych gałęzi:

[alias]
    br = branch --no-merge master # show only branches not merged into master
    bra = branch                  # show all branches

Aby git brpokazać aktywnie rozwijane gałęzie i git brawszystkie gałęzie, w tym te „zarchiwizowane” .

Nie archiwizowałbym oddziałów. Innymi słowy, same oddziały archiwizują się. Chcemy, aby informacje istotne dla archeologów można było znaleźć w wiarygodny sposób. Niezawodny, ponieważ pomagają w codziennym rozwoju i nie stanowią dodatkowego kroku w procesie wykonywania pracy. Oznacza to, że nie sądzę, aby ludzie pamiętali, aby dodać tag po zakończeniu pracy z gałęzią.

Oto dwa proste kroki, które znacznie pomogą archeologii i rozwojowi.

1. Połącz każdą gałąź zadania z powiązanym problemem w narzędziu do śledzenia problemów, używając prostej konwencji nazewnictwa .
2. Zawsze używaj git merge --no-ffdo scalania gałęzi zadań; chcesz, aby scalenie zatwierdzenia i historia bąbelkowały, nawet tylko dla jednego zatwierdzenia.

Otóż ​​to. Dlaczego? Ponieważ jako archeolog kodu rzadko zaczynam od chęci dowiedzenia się, jakie prace wykonano na gałęzi. O wiele częściej to dlatego w tych wszystkich krzyczących dziewięciu piekłach kod jest napisany w ten sposób ?! Muszę zmienić kod, ale ma on pewne dziwne funkcje i muszę je rozszyfrować, aby uniknąć zepsucia czegoś ważnego.

Następnym krokiem jest git blameznalezienie powiązanych zatwierdzeń, a następnie nadzieja, że ​​komunikat dziennika jest objaśniający. Jeśli będę musiał kopać głębiej, dowiem się, czy praca została wykonana w oddziale i przeczytam gałąź jako całość (wraz z komentarzem w module do śledzenia problemów).

Powiedzmy git blamepunkty przy zatwierdzeniu XYZ. Otwieram przeglądarkę historii Git (gitk, GitX git log --decorate --graphitp.), Znajduję XYZ i widzę ...

AA - BB - CC - DD - EE - FF - GG - II ...
     \                       /
      QQ - UU - XYZ - JJ - MM

Tam jest mój oddział! Wiem, że QQ, UU, XYZ, JJ i MM są częścią tego samego oddziału i powinienem zapoznać się z ich komunikatami dziennika, aby uzyskać szczegółowe informacje. Wiem, że GG będzie zatwierdzeniem scalania i będzie miało nazwę oddziału, który, mam nadzieję, jest związany z problemem w module śledzącym.

Jeśli z jakiegoś powodu chcę znaleźć starą gałąź, mogę uruchomić git logi wyszukać nazwę gałęzi w zatwierdzeniu scalania. Jest wystarczająco szybki nawet w bardzo dużych repozytoriach.

Właśnie to mam na myśli, mówiąc, że oddziały same się archiwizują.

Oznaczanie każdej gałęzi dodaje niepotrzebną pracę do wykonania zadania (krytyczny proces, który powinien być bezwzględnie usprawniony), rozbija listę tagów (nie mówiąc o wydajności, ale czytelność dla człowieka) za pomocą setek tagów, które są bardzo okazjonalnie przydatne i nie jest nawet bardzo przydatne w archeologii.

Moje podejście polega na zmianie nazwy wszystkich gałęzi, na których mi nie zależy, z prefiksem „kosz”, a następnie użyć:

git branch | grep -v trash

(z powiązaniem klucza powłoki)

Aby zachować kolor aktywnej gałęzi, potrzebne byłyby:

git branch --color=always | grep --color=never --invert-match trash

Możesz użyć skryptu, który zarchiwizuje gałąź dla Ciebie

archbranch

Tworzy dla ciebie tag z archiwum prefiksu /, a następnie usuwa gałąź. Ale sprawdź kod przed użyciem.

Stosowanie - $/your/location/of/script/archbranch [branchname] [defaultbranch]

Jeśli chcesz uruchomić skrypt bez zapisywania lokalizacji, dodaj go do swojej ścieżki

Następnie możesz to nazwać

$ archbranch [branchname] [defaultbranch]

Jest [defaultbranch]to gałąź, do której przejdzie po zakończeniu archiwizacji. Istnieją pewne problemy z kodowaniem kolorami, ale inne niż to powinno działać. Używam go w projektach od dłuższego czasu, ale wciąż jest w fazie rozwoju.

Czasami archiwizuję oddziały w następujący sposób:

1. Wygeneruj pliki łatek, np. format-patch <branchName> <firstHash>^..<lastHash>(Pobierz firstHash i lastHash używając git log <branchName>.
2. Przenieś wygenerowane pliki łat do katalogu na serwerze plików.
3. Usuń gałąź, np. git branch -D <branchName>

„Zastosuj” łatkę, gdy musisz ponownie użyć gałęzi; jednak stosowanie plików łatek (patrz git am) może być trudne w zależności od stanu gałęzi docelowej. Zaletą tego podejścia jest umożliwienie zbierania śmieci oddziału i oszczędność miejsca w repozytorium.