Git Filter Repo
Advanced Git
Amanda Crawford-Adamo
Software and Data Engineer
Co je git filter-repo?
Příkaz Git Filter-Repo
git filter-repo
Nástroj pro rychlé a bezpečné přepisování historie repozitáře Git.
- Přejmenování souborů nebo adresářů
- Funguje na všech větvích současně
Použití
- Odstranění citlivých dat (např. hesel, tokenů)
- Vyčištění nepotřebných souborů
- Restrukturalizace repozitářů
- Zmenšení velikosti repozitáře
Proces Filter-Repo
Instalace git filter-repo pomocí pip
pip install git-filter-repoOdstranění secrets.txt z každého commitu
git filter-repo --path secrets.txt --invert-paths
Filtry Filter-Repo
--path: určuje, na které cesty se operace vztahuje
--invert-paths: operuje na všech cestách kromě těch uvedených v --path
Výsledek Filter-Repo
Výstup
Parsed 150 commits
New history written in 0.10 seconds; now repacking/cleaning...
Repacking your repo and cleaning out old unneeded objects
Klíčové důsledky
- Všechny větve a commity byly aktualizovány
- Všechny hashe commitů byly změněny
- Po tomto kroku je nutný force push
- Členové týmu budou muset znovu naklonovat repozitář
Kdy používat filter-repo
Případy použití
- Odstranění citlivých dat (např. hesel)
- Vyčištění přeplněných repozitářů
- Přejmenování nebo reorganizace souborů ve všech commitech
Tipy
- Před použitím filter-repo vždy zálohujte repozitář
- Před odesláním přepsané historie se domluvte se spolupracovníky
Pojďme si procvičit!
Advanced Git
