git init
Description
La commande git init est utilisée pour créer un nouveau dépôt Git vide ou pour réinitialiser un dépôt existant. Grâce à cette commande, un sous-répertoire .git est créé, contenant les métadonnées, telles que des sous-répertoires pour les objets et les fichiers de modèle, nécessaires à l'initialisation du dépôt.
Utilisation de git init
Utiliser git init est le moyen le plus simple de mettre en place des projets sous contrôle de version, car il gère automatiquement la création et l'initialisation du dépôt.
- Pour initialiser un dépôt Git de travail, il suffit de se déplacer (
cd) dans le répertoire de votre projet et d'exécuter la commandegit initdans votre terminal.
git init
git init- Convertit le répertoire actuel en un dépôt Git pour suivre les modifications du projet. Vous pouvez également spécifier un chemin pour créer un nouveau sous-répertoire
.gità cet emplacement.
git init <directory>
git init <directory>Si vous exécutez git init sur un répertoire contenant déjà un sous-répertoire .git, il réinitialisera en toute sécurité sans écraser la configuration existante.
Dépôts Git nus avec git init
Les dépôts centraux ou distants doivent être créés avec le drapeau --bare. Le drapeau --bare crée un dépôt sans répertoire de travail, empêchant ainsi la modification directe des fichiers et les commits. Il marque effectivement le dépôt comme un simple espace de stockage. Les dépôts nus sont utilisés pour git push et git pull, mais vous ne devez jamais y faire de commits directement. Les dépôts centraux doivent être nus, car pousser des modifications vers un dépôt non nu peut écraser des changements. Alors que les dépôts locaux sont non nus, les dépôts centraux sont toujours nus. L'utilisation la plus courante de git init --bare est la création d'un dépôt central distant.
Répertoire de modèles
Les modèles sont utilisés pour initialiser un nouveau dépôt avec un sous-répertoire .git. Le répertoire de modèles sera l'un des suivants :
- l'argument fourni avec l'option
--template, - le contenu de la variable d'environnement
$GIT_TEMPLATE_DIR, - la variable de configuration
init.templateDir, - le modèle par défaut, qui se trouve généralement dans le répertoire
/usr/share/git-core/templates.
Les modèles par défaut montrent comment utiliser les fonctionnalités des modèles. Les modèles personnalisés peuvent définir des répertoires et des fichiers par défaut qui seront automatiquement copiés dans le nouveau sous-répertoire .git.
Configuration de git init
La commande git init <directory> accepte un argument <directory> optionnel. S'il est omis, la commande s'exécute dans le répertoire courant. Si le répertoire spécifié n'existe pas, Git le crée automatiquement. Des options supplémentaires comme --initial-branch et --shared permettent respectivement de définir le nom de la branche par défaut et de configurer les permissions de groupe pour un accès partagé. Voici la liste complète des options :
| Drapeau | Description |
|---|---|
-q ou --quiet | Affiche uniquement les erreurs et les avertissements. Toute autre sortie est masquée. |
--bare | Crée un dépôt nu. |
--template=<templatedirectory> | Spécifie à partir de quels modèles le répertoire doit être utilisé. |
--separate-git-dir=<git dir> | Remplace le répertoire .git par un fichier texte contenant le chemin vers <git dir>. Lorsqu'il est utilisé sur un dépôt existant, le répertoire .git est déplacé vers le chemin spécifié, et un fichier contenant ce chemin est créé à sa place. |
| `--shared[=(false | true |
--initial-branch=<name> | Définit le nom de la branche initiale dans le nouveau dépôt créé. |
Pratique
Quelles sont les fonctions et les options de la commande 'git init' ?