Git/Structure interne

< Git

Structure de Git bruteModifier

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/

FichiersModifier

HEADModifier

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.

configModifier

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).

descriptionModifier

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.

DossiersModifier

BranchesModifier

hooksModifier

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].

ExempleModifier

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

infoModifier

objectsModifier

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.

refsModifier

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 .gitModifier

.gitkeepModifier

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

.gitignoreModifier

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

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

.gitattributesModifier

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érencesModifier

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