Riscrivere la cronologia con git filter-repo

A volte è necessario riscrivere l'intera cronologia di un repository: per rimuovere una password divulgata, eliminare file enormi inclusi accidentalmente nei commit o correggere gli indirizzi email degli autori in tutti i commit.

git filter-repo è lo strumento moderno e veloce per riscrivere la cronologia. Sostituisce il vecchio e lento git filter-branch.

È un programma separato, spesso installato tramite pip o un gestore di pacchetti.

La riscrittura della cronologia è distruttiva. Operate su un clone appena creato, così potrete eliminarlo se qualcosa va storto.

Per eliminare completamente un file da ogni commit, usate le opzioni --path e --invert-paths.

Potete eliminare i file che superano una determinata soglia di dimensione per ridurre le dimensioni di un repository troppo grande.

Correggete un indirizzo email errato dell'autore in tutti i commit usando un mailmap o un callback.

Rimuovete le stringhe segrete ovunque compaiano usando un file di espressioni.

La riscrittura della cronologia produce nuovi hash dei commit per tutto ciò che viene modificato. La cronologia del repository diverge da quella delle vecchie copie.

Dopo la riscrittura dovete eseguire il force push, perché la cronologia remota non corrisponde più a quella locale.

Poiché i clone di tutti sono ormai obsoleti, i colleghi devono creare un nuovo clone. Annunciate la riscrittura per evitare che i dati rimossi vengano reintrodotti.

Avete imparato a riscrivere la cronologia:

• git filter-repo sostituisce filter-branch
• Rimuove file, blob di grandi dimensioni o testo segreto dall'intera cronologia
• Lavorate sempre su un clone; gli hash dei commit cambiano
• Eseguite il force push e fate creare un nuovo clone al team