- Pourquoi intégrer un projet existant dans un dépôt Git ?
- Scénario 1 : votre dépôt Git est encore vide
- Étape 1 : accéder au répertoire du projet
- Étape 2 : initialiser Git
- Étape 3 : ajouter les fichiers
- Étape 4 : créer le premier commit
- Étape 5 : connecter le dépôt distant
- Étape 6 : créer ou renommer la branche
- Étape 7 : envoyer les fichiers
- Scénario 2 : le dépôt contient déjà des fichiers, par exemple README ou .gitignore
- Étape 1 : renommer le dossier du projet
- Étape 2 : cloner le dépôt
- Étape 3 : copier les anciens fichiers dans le nouveau dépôt
- Étape 4 : ajouter les fichiers à Git
- Étape 5 : créer le commit
- Étape 6 : envoyer les modifications
- Aperçu des principales commandes Git et Linux
- Bien rédiger les messages de commit
- Conseils pour de bons messages de commit
- Exemples
- Que sont les Gitmojis ?
- Conseils, astuces et bonnes pratiques
- FAQ
- Glossaire
De nombreux développeurs connaissent cette situation : un site, un projet WordPress ou une application existe depuis des mois sur un serveur ou un ordinateur local, mais n’a jamais été versionné avec Git. Dès que les modifications deviennent difficiles à suivre ou que plusieurs personnes collaborent, il devient utile de créer un dépôt Git. Dans cet article, je vous montre étape par étape comment envoyer un projet existant vers GitHub ou GitLab et quelles commandes Git et Linux utiliser. Vous trouverez également des bonnes pratiques, des conseils pour les messages de commit, une introduction à Gitmoji, une FAQ et un glossaire.
Pourquoi intégrer un projet existant dans un dépôt Git ?
Le versionnement constitue une partie essentielle du développement logiciel moune. Git permet de gérer votre code de manière contrôlée, y compris pour les projets initialement créés sans Git. Un dépôt central sur GitHub ou GitLab offre les avantages suivants :
- Contrôle de version sécurisé
- Annulation des erreurs
- Modifications faciles à retracer
- Travail d’équipe structuré
- Automatisation des tests ou des déploiements
- Sauvegardes organisées
Les projets web tels que WordPress, Node.js, Laravel ou les sites statiques profitent particulièrement de Git.
Scénario 1 : votre dépôt Git est encore vide
Si votre dépôt GitHub ou GitLab ne contient encore aucun fichier, vous pouvez commencer directement dans le dossier du projet existant.
Étape 1 : accéder au répertoire du projet
cd /pfad/zu/deinem/projekt
Étape 2 : initialiser Git
git init
Étape 3 : ajouter les fichiers
git add -A
Étape 4 : créer le premier commit
git commit -m "Initial commit - bestehendes Projekt"
Étape 5 : connecter le dépôt distant
git remote add origin https://github.com/user/projekt.git
# oder:
git remote add origin https://gitlab.com/user/projekt.git
Étape 6 : créer ou renommer la branche
git branch -M main
Étape 7 : envoyer les fichiers
git push -u origin main
Votre projet existant complet se trouve désormais dans le dépôt.
Scénario 2 : le dépôt contient déjà des fichiers, par exemple README ou .gitignore
De nombreux dépôts GitHub et GitLab contiennent déjà des fichiers tels qu’un README.md ou des exemples de configuration. Dans ce cas, il est plus simple de commencer par cloner le dépôt.
Étape 1 : renommer le dossier du projet
mv projekt projekt.bkp
Étape 2 : cloner le dépôt
git clone https://github.com/user/projekt.git projekt
ou
git clone https://gitlab.com/user/projekt.git projekt
Étape 3 : copier les anciens fichiers dans le nouveau dépôt
cp -a projekt.bkp/. projekt/
Étape 4 : ajouter les fichiers à Git
cd projekt
git add -A
Étape 5 : créer le commit
git commit -m "Import bestehendes Projekt"
Étape 6 : envoyer les modifications
git push -u origin main
Aperçu des principales commandes Git et Linux
| Tâche | Commande | Description |
|---|---|---|
| Créer un dépôt Git | git init | Crée un nouveau dépôt Git |
| Ajouter des fichiers | git add -A | Ajoute tous les fichiers à l’index |
| Enregistrer un commit | git commit -m « Text » | Crée une version des modifications |
| Connecter le remote | git remote add origin URL | Relie le dépôt local au dépôt distant |
| Cloner le dépôt | git clone URL | Télécharge un dépôt distant |
| Définir la branche | git branch -M main | Crée ou définit la branche main |
| Effectuer un push | git push -u origin main | Transfère le code vers le remote |
| Copier un dossier | cp -a alt/. neu/ | Copie les fichiers avec leurs permissions |
| Renommer un dossier | mv alt neu | Renomme des fichiers ou des répertoires |
Bien rédiger les messages de commit
De bons messages de commit rendent l’historique clair et compréhensible. Une structure propre est devenue une bonne pratique.
Conseils pour de bons messages de commit
- Utilisez l’impératif : « Add », « Fix », « Update »
- Rédigez un message court et compréhensible
- Ajoutez si nécessaire des explications facultatives sur une deuxième ligne
- Évitez les termes imprécis comme « Update », « Fixes » ou « Modification »
Exemples
- Add initial project structure
- Fix menu alignment on mobile
- Update dependencies
- Remove deprecated plugin
Que sont les Gitmojis ?
Gitmoji est un projet communautaire qui fournit des emojis pour les messages de commit. Ils permettent d’identifier immédiatement l’objectif d’un commit.
| Emoji | Signification |
|---|---|
| 🎉 (:tada:) | Démarrage du projet |
| 🐛(:bug:) | Correction de bug |
| ✨(:sparkles:) | Nouvelle fonctionnalité |
| 🔧(:wrench:) | Modifications de configuration |
| 🔥(:fire:) | Suppression de code ou de fichiers |
| 📝(:memo:) | Documentation |
Ces ajouts sont facultatifs, mais rendent souvent l’historique des commits plus clair et moune.
Conseils, astuces et bonnes pratiques
Quelques conseils éprouvés pour versionner des projets existants :
- Utilisez systématiquement un fichier
.gitignorepour exclure les fichiers inutiles - Ne suivez jamais les gros dossiers de téléversement ni les répertoires de cache
- Utilisez des branches pour les nouvelles fonctionnalités
- Créez régulièrement de petits commits plutôt que d’énormes commits regroupés
- Utilisez des clés SSH avec GitHub ou GitLab pour travailler plus facilement
- Avant chaque push, vérifiez avec
git statusque tout est correct
FAQ
Puis-je utiliser Git pour tous les projets ?
Oui. Git convient aux sites web, bases de données, scripts, sauvegardes, applications web et à bien d’autres projets.
Dois-je versionner les images et les fichiers téléversés ?
Non. Ils se trouvent généralement sur l’espace web ou un CDN et non dans le dépôt.
Que faire en cas de conflit ?
Git marque les zones concernées, qui doivent être corrigées manuellement.
Puis-je utiliser plusieurs dépôts distants ?
Oui. Un projet peut avoir plusieurs remotes, par exemple GitHub et GitLab simultanément.
Glossaire
Dépôt Git
Structure de projet centrale ou locale qui conserve les versions.
GitHub / GitLab
Plateformes d’hébergement de dépôts Git.
Commit
Modification enregistrée avec un message.
Push
Transfère les modifications locales vers le dépôt distant.
Clone
Télécharge un dépôt existant.
Branche
Ligne de développement parallèle pour de nouvelles fonctionnalités.
Index
Zone de préparation entre le dossier de travail et le commit.
Cet article a été traduit à l’aide de l’IA.