Git & GitHub Professional Workflow · Lezione

Riscrivere la cronologia con git filter-repo

Impari a riscrivere la cronologia del repository su larga scala per rimuovere file di grandi dimensioni o dati sensibili usando git filter-repo.

Lezione 4 di 413 passaggi

Riscrivere la cronologia con git filter-repo è una lezione Git & GitHub Professional Workflow gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Git & GitHub Professional Workflow, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Git & GitHub Professional Workflow include 4 lezioni in totale.

Perché riscrivere la cronologia

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.

Scoprire git filter-repo

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

Installazione dello strumento

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

pip install git-filter-repo

Lavorare sempre su un clone

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

git clone --mirror git@github.com:you/repo.git

Rimuovere un file dalla cronologia

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

git filter-repo --path secrets.env --invert-paths

Rimuovere i blob di grandi dimensioni

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

git filter-repo --strip-blobs-bigger-than 10M

Riscrivere gli indirizzi email degli autori

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

git filter-repo --mailmap my-mailmap.txt

Sostituire il testo nella cronologia

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

git filter-repo --replace-text expressions.txt

Gli hash dei commit cambiano

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.

Eseguire il force push del risultato

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

git push --force --all

Coordinarsi con il team

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.

Verifica rapida

Verificate la vostra comprensione della riscrittura della cronologia.

Riepilogo

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
Gratis per iniziare

Impara Git & GitHub Professional Workflow con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi
12
Lezioni
48

Domande Frequenti

La lezione «Riscrivere la cronologia con git filter-repo» è gratuita?

Sì — il testo completo di «Riscrivere la cronologia con git filter-repo» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Git & GitHub Professional Workflow, passa a CoddyKit PRO. Il corso Git & GitHub Professional Workflow include 4 lezioni in totale.

Cosa imparerò in «Riscrivere la cronologia con git filter-repo»?

Impari a riscrivere la cronologia del repository su larga scala per rimuovere file di grandi dimensioni o dati sensibili usando git filter-repo. Eserciti Git & GitHub Professional Workflow con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Git & GitHub Professional Workflow?

Non è richiesta alcuna esperienza precedente. Git & GitHub Professional Workflow su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Riscrivere la cronologia con git filter-repo»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Git & GitHub Professional Workflow?

Sì. Ogni lezione Git & GitHub Professional Workflow include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Git Reflog e recupero della cronologia
  2. Git Bisect per il debug
  3. Manutenzione e pulizia del repository
  4. Riscrivere la cronologia con git filter-repo
← Torna a Git & GitHub Professional Workflow