Cosa otterrai

Installerai Git LFS, lo configurerai per un progetto che include immagini, video e file di design.

Passo 1: installare Git LFS

# macOS
brew install git-lfs

# Debian/Ubuntu
sudo apt install git-lfs

git lfs version

git lfs install

Passo 2: entrare nel repo

cd path/to/repo
git lfs install --local

Passo 3: tracciare i tipi di file

git lfs track "*.psd"
git lfs track "*.ai"
git lfs track "*.sketch"
git lfs track "*.mp4"
git lfs track "*.mov"
git lfs track "*.wav"
git lfs track "assets/raw/**"

Passo 4: committare .gitattributes

git add .gitattributes
git commit -m "Configure LFS tracking for media files"

Passo 5: aggiungere nuovi file media

cp ~/Downloads/logo.psd assets/
git add assets/logo.psd
git commit -m "Add logo PSD"
git push

git lfs ls-files

Passo 6: migrare binari esistenti

git lfs migrate import --include="*.psd,*.mp4,*.mov,*.wav" --everything

git push --force --all
git push --force --tags

Passo 7: lockare file binari (opzionale)

# .gitattributes
*.psd filter=lfs diff=lfs merge=lfs -text lockable
*.ai filter=lfs diff=lfs merge=lfs -text lockable

git lfs lock assets/logo.psd
git push
git lfs unlock assets/logo.psd
git lfs locks

Passo 8: verificare su clone fresco

cd /tmp
git clone <url> test-clone
cd test-clone
ls -la assets/logo.psd

git cat-file -p HEAD:assets/logo.psd

Passo 9: gestire le quote

• Gitea o Forgejo - LFS integrato.
• GitLab - LFS nativo.
• Server LFS bare.

Passo 10: pruning

git lfs prune
git lfs prune --dry-run

Tip di performance

• Saltare LFS smudge sul clone iniziale.
• Usare git lfs fetch --recent in CI.
• Configurare cache CI.

Troubleshooting

• File pointer mostrato nel working tree: LFS non installato.
• Push respinto.