Git/Structure interne

< Git

Structure de Git brute

modifier

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

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.

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

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

Branches

modifier

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
cp .git/hooks/pre-push.sample .git/hooks/pre-push
vim .git/hooks/pre-push

objects

modifier

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.

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

.gitkeep

modifier

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

.gitignore

modifier

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

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

.gitattributes

modifier

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