Geschiedenis herschrijven met git filter-repo

Soms moet je de volledige geschiedenis van een repository herschrijven: om een gelekt wachtwoord te verwijderen, grote bestanden te verwijderen die per ongeluk zijn gecommit, of auteurs-e-mailadressen in alle commits te corrigeren.

git filter-repo is de moderne, snelle tool voor het herschrijven van geschiedenis. Het vervangt het oude en trage git filter-branch.

Het is een afzonderlijk programma dat je vaak via pip of een pakketbeheerder installeert.

Het herschrijven van geschiedenis is destructief. Werk op een verse kloon, zodat je die kunt weggooien als er iets misgaat.

Gebruik de opties --path en --invert-paths om een bestand uit elke commit te verwijderen.

Je kunt bestanden boven een bepaalde grootte verwijderen om een opgeblazen repository kleiner te maken.

Corrigeer een verkeerd auteurs-e-mailadres in alle commits met een mailmap of callback.

Verwijder geheime tekenreeksen overal waar ze voorkomen met een bestand met expressies.

Het herschrijven van geschiedenis maakt nieuwe commit-hashes voor alles wat wordt beïnvloed. De geschiedenis van de repository wijkt daardoor af van oude kopieën.

Na het herschrijven moet je geforceerd pushen, omdat de geschiedenis op afstand niet langer overeenkomt.

Omdat de klonen van iedereen nu verouderd zijn, moeten teamgenoten de repository opnieuw klonen. Kondig het herschrijven aan om te voorkomen dat de verwijderde gegevens opnieuw verschijnen.

Je hebt geleerd hoe je geschiedenis herschrijft:

• git filter-repo vervangt filter-branch
• Verwijder bestanden, grote blobs of geheime tekst uit de volledige geschiedenis
• Werk altijd op een kloon; commit-hashes veranderen
• Push geforceerd en laat het team daarna de repository opnieuw klonen