Pourquoi utiliser git archive au lieu de zip ?

git archive exclut automatiquement le dossier .git, respecte les regles d'export (.gitattributes export-ignore) et peut exporter un tag ou un commit specifique. Un zip classique inclut tout, y compris l'historique Git.

Comment exclure des fichiers de l'archive ?

Ajoute export-ignore dans .gitattributes. Par exemple : "tests/ export-ignore" exclut le dossier tests de l'archive. C'est utile pour exclure les tests, la CI, les docs internes, etc.

Peut-on archiver un commit specifique ?

Oui, remplace HEAD par le hash du commit ou un tag : git archive --format=zip a1b2c3d. Tu peux meme archiver une branche : git archive --format=zip origin/release.

Quels formats sont supportes ?

Git supporte tar, tar.gz (tgz), zip par defaut. Le format tar est le plus leger. Utilise --format pour specifier, ou Git le deduit de l'extension dans --output.

Comment archiver uniquement un sous-dossier ?

Ajoute le chemin apres la reference : git archive HEAD src/. Seul le contenu du dossier src sera inclus dans l'archive.

Git archive : exporter ton projet proprement

git archive cree une archive (zip, tar) de ton projet sans le dossier .git. Ideal pour livrer du code, creer des releases ou partager sans l'historique.

Pratiquer git archive Glossaire Git

gitquest — enquête

Livraison

C'est quoi git archive ?

git archive cree une archive de ton projet a partir d'un commit, tag ou branche. L'archive contient tes fichiers sans le dossier .git.

C'est comme faire un colis de ton code : tu choisis la version a emballer et Git cree un zip ou tar propre, pret a etre livre ou partage.

Syntaxe de git archive

git archive --format=zip -o f.zip HEAD

Archive ZIP du HEAD

git archive --format=tar.gz -o f.tar.gz v1.0

Archive tar.gz d'un tag

git archive --prefix=projet/ HEAD

Avec un dossier racine dans l'archive

Git archive en pratique

Creer des archives zip et tar de ton projet.

Archive ZIP

gitquest — archive zip

# Creer une archive ZIP du projet

$git archive --format=zip --output=projet.zip HEAD

Archive creee : projet.zip

# Creer une archive d'un tag specifique

$git archive --format=zip --output=v1.0.zip v1.0.0

Archive creee : v1.0.zip

# Le dossier .git n'est PAS inclus !

Archive TAR et sous-dossier

gitquest — archive tar

# Creer une archive tar.gz

$git archive --format=tar.gz --output=projet.tar.gz HEAD

Archive creee : projet.tar.gz

# Exporter uniquement un sous-dossier

$git archive HEAD src/ | tar -x -C /tmp/export/

Dossier src/ exporte

# Avec un prefixe de dossier

$git archive --prefix=mon-projet/ HEAD | gzip > release.tar.gz

Archive avec prefixe creee

git archive vs zip classique

`git archive`

Exclut automatiquement .git, respecte export-ignore, peut cibler un tag/commit specifique.

Recommande pour les projets Git

`zip classique`

Inclut tout le dossier y compris .git, node_modules et les fichiers ignores.

Generique mais moins propre

Erreurs courantes avec git archive

Inclure des fichiers sensibles

Si .env est dans le depot, il sera dans l'archive. Utilise .gitattributes avec export-ignore pour exclure les fichiers sensibles.

Oublier --prefix

Sans prefix, les fichiers sont a la racine de l'archive. Ajoute --prefix=nom-projet/ pour les mettre dans un dossier (n'oublie pas le / final).

Archiver des fichiers non commites

git archive ne prend que les fichiers commites. Les modifications non commitees ne seront pas dans l'archive. Commite ou stash avant.

Fait partie du guide Git avance

Commandes liées

git tag

Creer des tags pour les releases

git log

Trouver le commit a archiver

git config

Configurer les exports

GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.

Questions sur git archive

Livre ton code avec GitQuest

Apprends a creer des releases propres et livrer ton code avec confiance.

Commencer les enquetes