Git Init : Comment initialiser et configurer un dépôt Git

Vous avez déjà supprimé un fichier par erreur ou écrasé votre code sans pouvoir le récupérer ? Sans contrôle de version, de telles erreurs peuvent être catastrophiques. C'est là qu'intervient git init, qui transforme votre dossier de projet en dépôt Git, garantissant ainsi la traçabilité et la récupération de chaque modification. 

Dans ce tutoriel, je vous montrerai comment configurer Git, je partagerai des conseils personnels tirés de mon expérience et je vous aiderai à créer un flux de travail solide dès le départ.

Qu'est-ce que Git Init ?

La commande git init donne le coup d'envoi de votre parcours de contrôle de version. Lorsque vous l'exécutez, Git crée un dossier caché .git dans le répertoire de votre projet qui stocke les données de configuration, l'historique des livraisons et toutes les métadonnées nécessaires au suivi de vos modifications. 

Chaque modification étant enregistrée, vous pouvez créer des branches, fusionner et collaborer en toute confiance, sachant que l'historique complet de votre projet est toujours à portée de commande.

Image par l'auteur

Comment utiliser Git Init

Avant d'aborder des sujets avancés, il est essentiel de comprendre comment utiliser git init dans la pratique.

Utilisation de base de git init

Suivez les étapes suivantes pour créer un nouveau dépôt Git à partir de zéro :  

• Ouvrez votre terminal : Lancez votre interface de ligne de commande préférée.
• Naviguez jusqu'au répertoire de votre projet :

cd /path/to/your/project

Votre dossier actuel devient alors le dossier dont vous voulez assurer le cursus.

• Initialiser le référentiel : 

git init

Après l'exécution de cette commande, un dossier caché .git est créé. Ce dossier contient toutes les informations de suivi de Git.

• Vérifiez l'état du référentiel :

git status

À ce stade, Git est configuré mais ne suit aucun fichier.

Initialiser un référentiel avec un projet existant

Pour les projets qui ne sont pas encore sous contrôle de version, vous pouvez initialiser Git et commencer le cursus des modifications comme suit :

• Naviguez jusqu'au répertoire de votre projet :

cd /path/to/your/project

• Convertir le projet en dépôt Git :

git init

Comme indiqué précédemment, la commande ci-dessus crée le dossier caché .git qui permet le cursus Git.

• Mettez en scène vos fichiers : Comme le site git init ne suit pas automatiquement les fichiers, ajoutez-les avec :

git add .

• Validez vos fichiers : Sauvegardez l'instantané initial en exécutant :  

git commit -m "Initial commit"

Ce processus transforme un projet non géré en un projet avec un historique complet des versions, prêt pour de nouveaux développements et pour la collaboration.

Configuration de Git (si nécessaire)

Si vous rencontrez l'erreur "Identité de l'auteur inconnue", cela signifie que Git ne sait pas qui vous êtes. Pour y remédier, configurez votre identité d'utilisateur :

• Configurez les informations relatives à l'utilisateur de Git : 

git config --global user.email "your_email@example.com"
git config --global user.name "Your Name"

L'utilisation de --global permet d'appliquer ces paramètres à tous les dépôts de votre machine. Si vous l'omettez, l'identité ne sera définie que pour le référentiel actuel.

• Vérifiez votre configuration :  

git config --global user.email
git config --global user.name

• Réessayez la validation :  

git commit -m "First Commit"

J'ai rencontré cette erreur lorsque j'ai commencé à utiliser Git - la définition de mon identité l'a résolue.

Le premier commit Git a été exécuté avec succès dans PowerShell.

Connexion à un référentiel distant

Une fois que vous avez initialisé un dépôt Git localement, vous voudrez probablement le sauvegarder ou collaborer avec d'autres en le connectant à un dépôt distant (par exemple, GitHub, GitLab, Bitbucket).

• Ajouter un dépôt à distance : Pour lier votre référentiel local à un référentiel distant, utilisez :

git remote add origin <repository-url>

Remplacez par l'URL de votre référentiel distant. origin est l'alias par défaut du référentiel distant, mais vous pouvez utiliser n'importe quel nom.

• Vous pouvez vérifier la connexion avec :

git remote -v

• Transférez vos modifications dans le référentiel distant :

# Push the first commit and track the remote branch
git push -u origin $(git branch --show-current)  # Works for 'main' or 'master' 

La commande ci-dessus pousse la branche courante et la place en position de suivre la branche distante.

Si vous utilisez une ancienne version de Git qui ne supporte pas $(git branch --show-current), utilisez :

git push -u origin main  # Or 'master' depending on your default branch  

Au fur et à mesure que vous travaillez sur votre projet, vous devrez fusionner des modifications provenant de différentes branches lorsque vous collaborerez avec une équipe. Apprenez à gérer les fusions de manière efficaceavec ce tutoriel sur les fusions Git.

Authentification et accès

Si vous poussez vers GitHub, GitLab ou Bitbucket, vous devrez peut-être vous authentifier. En fonction de votre configuration, vous pouvez :

• Utiliser clés SSH au lieu de l'authentification HTTPS (recommandé pour la sécurité) :

git remote set-url origin git@github.com:your-username/your-repo.git

• Utilisez un jeton d'accès personnel (PAT) au lieu d'un mot de passe lorsque vous utilisez HTTPS. Pour GitHub, remplacez le mot de passe par un jeton :

git push https://your-username@github.com/your-repo.git

La connexion à un référentiel distant a été un tournant pour moi : elle m'a permis de confirmer que mon travail local était sauvegardé en toute sécurité et prêt à être collaboré. De plus, cela m'a donné confiance dans le contrôle des versions, sachant que mon historique était préservé même si ma machine locale tombait en panne.