Git/Structure interne

Sous-modules et Super-projets

pull-request

Git

Principes
Apprendre à travailler avec Git
Fonctionnalités avancées
Recettes
- Exclure des fichiers du dépôt
- Écrire des messages de commit
Environnement
Git et Subversion (svn)
Problèmes connus
Ressources externes

Version imprimable

[ Modifier le sommaire ]

Sous-modules et Super-projets

pull-request

Structure de Git brute[modifier | modifier le wikicode]

Le schéma suivant représente un dépôt Git v1.5.2.5^[1].

.
└── .git/
    ├── HEAD
    ├── branches/
    ├── config
    ├── description
    ├── hooks/
    │   ├── applypatch-ms
    │   ├── commit-msg
    │   ├── post-commit
    │   ├── post-receive
    │   ├── post-update
    │   ├── pre-applypatc
    │   ├── pre-commit
    │   ├── pre-push
    │   ├── pre-rebase
    │   └── update
    ├── info/
    │   └── exclude
    ├── objects/
    │   ├── info/
    │   └── pack/
    └── refs/
        ├── heads/
        └── tags/

Fichiers[modifier | modifier le wikicode]

HEAD[modifier | modifier le wikicode]

HEAD indique le code actuellement vérifié. Généralement le point de la branche sur lequel on travaille.

Il est possible d'ajouter un état "HEAD détaché", en dehors de la branche locale. Dans ce cas la tête pointe sur une soumission et non sur une branche.

config[modifier | modifier le wikicode]

Le fichier de configuration pour ce dépôt Git. Il peut contenir les paramètres permettant de gérer et stocker les données dans le dépôt local, les distants connus, et les informations sur les utilisateurs (local et autres).

description[modifier | modifier le wikicode]

Utilisé par les outils du navigateur de dépôt, contient une description du projet, généralement inchangée dans les dépôts non partagés.

Dossiers[modifier | modifier le wikicode]

Branches[modifier | modifier le wikicode]

hooks[modifier | modifier le wikicode]

Contient les scripts à lancer quand des évènements particuliers surviennent dans le dépôt Git.

Ces points d'entrée sont utilisés par exemple pour lancer des tests avant chaque soumission, filtrer le contenu uploadé, et implémenter ce genre de personnalisations.

Il peut être intéressant de les placer en dehors du dossier .git pour les partager avec les autres membres du dépôt^[2].

Exemple[modifier | modifier le wikicode]

cp .git/hooks/pre-push.sample .git/hooks/pre-push
vim .git/hooks/pre-push

info[modifier | modifier le wikicode]

objects[modifier | modifier le wikicode]

Stocke les listes de répertoires, fichiers et soumission.

Il y a les objets non compressés des nombreux répertoires, et les "packs" d'objets compressés. Les premiers sont régulièrement collectés via git gc.

refs[modifier | modifier le wikicode]

Contient les informations où les branches pointent. Inclut normalement des répertoires "heads" pour les branches locales, et "remotes" pour les copies des branches distantes. Toutes les branches ne figurent pas dans ces répertoires. Celles qui n'ont pas changé récemment sont listées dans le fichier .git/packed-refs.

Fichiers Git hors dossier .git[modifier | modifier le wikicode]

.gitkeep[modifier | modifier le wikicode]

Placé dans un dossier, il garantit qu'il sera commité même vide.

.gitignore[modifier | modifier le wikicode]

Liste les fichiers et dossiers à exclure du versioning. Ex :

/var/
/vendor/
/.env.*.local

.gitattributes[modifier | modifier le wikicode]

Contient des attributs^[3]. Par exemple pour ignorer .gitattributes et .gitignore des exports effectués par "git archive" :

.gitattributes export-ignore
.gitignore export-ignore

Références[modifier | modifier le wikicode]

↑ Généré avec la commande tree v1.5.1.1 : tree -AnaF.
↑ https://www.viget.com/articles/two-ways-to-share-git-hooks-with-your-team/
↑ https://git-scm.com/docs/gitattributes

[1] Généré avec la commande tree v1.5.1.1 : tree -AnaF.

[2] ttps://www.viget.com/articles/two-ways-to-share-git-hooks-with-your-team/

[3] ttps://git-scm.com/docs/gitattributes

[1]

[2]

[3]