Les méthodes pour ajouter des fichiers à votre projet GitLab

Ajouter un fichier sur GitLab : Les méthodes essentielles

Pourquoi ajouter des fichiers à votre projet ?

Dans le monde du développement, un projet vide n'est qu'une coquille. Les fichiers sont les briques qui composent votre application. Que ce soit du code source, de la documentation ou des fichiers de configuration, chaque ajout permet de faire progresser votre travail de manière concrète.

Imaginez que votre projet GitLab est un chantier de construction. Créer le dépôt était l'étape de préparation du terrain. Ajouter des fichiers sur GitLab, c'est commencer à poser les briques pour monter les murs. Plus vous ajoutez de fichiers organisés, plus votre "maison" logicielle prend forme et devient fonctionnelle.

Sur GitLab, il existe deux méthodes principales pour enrichir votre dépôt : passer par la ligne de commande (CLI) ou utiliser directement l'interface web de GitLab. Nous allons voir comment maîtriser ces deux approches.

Ajouter un fichier via la ligne de commande (CLI)

C'est la méthode préférée des développeurs car elle est rapide et permet d'automatiser beaucoup de tâches. C'est aussi la manière la plus propre de travailler quand vous avez déjà effectué le clonage du projet sur votre ordinateur.

Créer le fichier localement

Placez-vous dans le dossier de votre projet et utilisez la commande suivante pour créer un nouveau fichier vide :

touch mon_nouveau_fichier.txt

Vérifier la présence du fichier

Vous pouvez vérifier que le fichier a bien été créé en listant le contenu de votre répertoire :

ls -l

Résultat :

total 4
-rw-r--r-- 1 utilisateur groupe    0 Apr 21 16:20 mon_nouveau_fichier.txt
-rw-r--r-- 1 utilisateur groupe  150 Apr 21 15:45 README.md

Ajouter un fichier via l'interface Web

Parfois, vous avez juste besoin de faire une petite modification ou d'ajouter une note rapide sans vouloir ouvrir votre terminal. Pour cela, l'interface web de GitLab est idéale car elle inclut un éditeur de texte intégré permettant d'enregistrer des modifications en quelques clics.

Accéder au menu d'ajout

Depuis le tableau de bord de votre projet, cherchez le bouton avec le symbole + situé juste à côté du sélecteur de branche. Cliquez dessus et choisissez l'option New file.

"Le bouton plus permet d'effectuer des actions rapides sur le dépôt"

Rédiger le contenu

Donnez un nom à votre fichier (par exemple NewDemoFile) et écrivez votre texte dans l'éditeur. Pour valider l'ajout, vous devez descendre en bas de page et cliquer sur le bouton Commit changes.

"L'éditeur web est parfait pour des modifications textuelles simples"

Confirmation du succès

Une fois que vous avez validé, GitLab vous affiche un message de confirmation vert. Votre fichier est maintenant officiellement enregistré dans l'historique de votre projet.

Conclusion

Vous savez maintenant comment enrichir votre projet, que ce soit en mode expert avec le terminal ou de manière plus visuelle avec l'interface web. Gérer ses fichiers sur GitLab est la base du quotidien d'un développeur moderne.

Cependant, plus vous ajoutez de fichiers et de modifications, plus l'historique de votre projet peut devenir complexe. Parfois, il est nécessaire de "réorganiser" cet historique pour qu'il reste propre. C'est ce qu'on appelle l'opération de Rebase Git, que nous allons explorer dans le prochain chapitre.