Guide du débutant sur Git - Comment démarrer et créer votre premier référentiel

Si vous êtes développeur et que vous souhaitez vous familiariser avec Git et GitHub, cet article est fait pour vous.

Après une brève introduction sur ce qu'est Git et comment l'utiliser, vous pourrez créer et travailler sur un projet GitHub.

Qu'est-ce que Git?

Git est un logiciel libre et open source créé par Linus Torvalds en 2005. Cet outil est un système de contrôle de version initialement développé pour fonctionner avec plusieurs développeurs sur le noyau Linux.

De nombreux systèmes de contrôle existent, comme CVS, SVN, Mercurial et autres, mais aujourd'hui Git est le logiciel standard pour le contrôle de version.

Contrôle de version, non?

Si vous êtes nouveau dans le monde du développement, ces mots ne vous diront rien. Cependant, ne vous inquiétez pas après ce court paragraphe, vous saurez exactement ce qu'est un « système de contrôle de version (VCS) ».

Le contrôle de version est un système de gestion qui prend en compte les modifications que vous avez effectuées sur un fichier ou un ensemble de fichiers ( exemple: un projet de code). Avec ce système, les développeurs peuvent collaborer et travailler ensemble sur le même projet.

Un système de branche est porté par le contrôle de version et permet aux développeurs de travailler individuellement sur une tâche ( exemple: Une branche, une tâche ou une branche, un développeur) avant de regrouper toutes les modifications apportées par les collaborateurs dans la branche principale.

Toutes les modifications apportées par les développeurs sont tracées et enregistrées dans un historique. Il peut être avantageux de suivre les modifications apportées par chaque collaborateur.

Où trouver les dépôts Git

Si vous souhaitez commencer à utiliser Git, vous devez savoir où héberger vos référentiels. Il existe de nombreuses plateformes d'hébergement sur lesquelles vous pouvez mettre votre code gratuitement. Certaines options ne sont pas gratuites, mais la plupart du temps vous n'en avez pas besoin sauf dans des cas spécifiques.

Voici les trois services d'hébergement Git les plus populaires:

  • GitHub : propriété récemment de Microsoft - Lancé en 2008 (31 millions d'utilisateurs en octobre 2018).
  • GitLab : propriété de GitLab Inc. - Lancé en 2011.
  • BitBucket : propriété d'Atlassian - Lancé en juin 2008.
Remarque: les plateformes d'hébergement sont disponibles de deux manières, sur le cloud (hébergé en ligne) ou auto-installées sur votre serveur (hébergement privé).

Pourquoi utiliser Git en tant que développeur

Cet outil est incontournable pour les développeurs du monde entier. Voici une liste des avantages de cet outil:

  • Fini les copies, lorsque vous avez terminé votre travail sur une mise à jour importante de votre application ou une correction de bogue, il vous suffit de « pousser » votre projet en ligne pour le sauvegarder.
  • Supprimer et casser votre code; il vous suffit de taper une commande pour revenir à la version précédente et continuer votre travail.
  • Travaillez avec vos amis sans envoyer d'e-mail avec le projet compressé chaque fois que le code change.
  • Vous pouvez vous permettre d'oublier ce que vous avez fait. Une simple commande est nécessaire pour vérifier vos modifications depuis la dernière fois que vous avez enregistré votre travail.

Je viens de vous expliquer les principaux avantages si vous n'utilisez pas Git pour le moment. Crois moi; cet outil peut devenir primordial. Par exemple, vous pouvez configurer les services pour qu'ils fonctionnent avec Git et déployer et tester automatiquement votre code.

Maintenant, pratiquons avec Git et GitHub

Maintenant que vous savez ce que sont Git et Github, il est temps de vous entraîner avec des exercices concrets.

Après ces exercices, vous pourrez créer et gérer vos projets via GitHub avec toutes les fonctionnalités de base de Git.

Remarque: j'ai choisi GitHub comme service d'hébergement pour Git car c'est le plus utilisé au monde. N'ayez pas peur; la procédure est tout à fait la même sur les autres services. S'il vous plaît rappelez-vous que cet article prend en considération que vous connaissez à toutes les commandes de base SHELL. Sinon, certaines parties de cet article seront déroutantes.

Étape # 1 - Il est temps de commencer!

Vous avez hâte de commencer? Faisons le!

Ce premier exercice n'est pas très compliqué; il est divisé en deux étapes. L'installation de Git et la création de compte GitHub.

une. Création de compte GitHub

Pour créer votre compte, vous devez vous connecter sur la page principale de GitHub et remplir le formulaire d'inscription.

Rien de plus! Vous êtes officiellement un nouveau membre de GitHub!

b. Installation de Git

Vous devez maintenant installer les outils Git sur votre ordinateur. Il existe différents logiciels Git, mais il est préférable d'installer le logiciel de base pour commencer. Nous utiliserons la ligne de commande pour communiquer avec GitHub.

Une fois que vous êtes plus à l'aise avec la ligne de commande, vous pouvez télécharger le logiciel Git avec une interface utilisateur.

  • Pour Ubuntu:

Tout d'abord, mettez à jour vos packages:

$ sudo apt update

Ensuite, installez Git avec apt-get:

$ sudo apt-get install git

Enfin, vérifiez que Git est correctement installé:

$ git --version
  • Pour MacOSX:

Tout d'abord, téléchargez le dernier programme d'installation de Git pour Mac.

Ensuite, suivez les instructions sur votre écran.

Enfin, ouvrez un terminal et vérifiez que Git est correctement installé:

$ git --version
  • Pour les fenêtres:

Tout d'abord, téléchargez le dernier programme d'installation de Git pour Windows.

Ensuite, suivez les instructions sur votre écran (vous pouvez laisser les options par défaut).

Enfin, ouvrez un terminal (exemple: powershell ou git bash) et vérifiez que Git est correctement installé:

$ git --version
  • Pour tous les utilisateurs:

Une dernière étape est nécessaire pour terminer correctement l'installation! Vous devez exécuter dans votre terminal les commandes suivantes avec vos informations pour définir un nom d'utilisateur et une adresse e-mail par défaut lorsque vous allez enregistrer votre travail:

$ git config --global user.name "Gaël Thomas" $ git config --global user.email "[email protected]"

Étape # 2 - Votre premier projet GitHub!

Maintenant que vous êtes prêt, vous pouvez revenir à la page principale de GitHub et cliquer sur l' icône « + » dans la barre de menu.

Une fois que vous avez cliqué sur ce bouton, un nouveau menu apparaît avec une entrée « Nouveau référentiel ». Clique dessus!

La page de création du référentiel apparaîtra. Choisissez un nom sympa pour votre premier référentiel et mettez une petite description avant de cliquer sur le bouton « Créer un référentiel ».

Remarque: dans le contexte de cet article, veuillez ne pas cocher «Initialiser ce référentiel avec un README». Nous créerons un fichier «README» plus tard!

Bien joué! Votre premier référentiel GitHub est créé. Si vous souhaitez voir tous vos référentiels, vous devez cliquer sur votre photo de profil dans la barre de menu puis sur « Vos référentiels ».

Étape # 3 - Une bonne couverture

Il est temps d'apporter votre première modification à votre référentiel. Que pensez-vous de créer une couverture, une sorte de texte de bienvenue?

une. Une version locale de votre projet

Votre première mission est d'obtenir une copie du référentiel sur votre ordinateur. Pour ce faire, vous devez « cloner » le référentiel. Sur la page du référentiel, vous devez obtenir l' adresse « HTTPS ».

Une fois que vous avez l'adresse des référentiels, vous devez utiliser votre terminal (via des commandes shell) pour vous déplacer à l'endroit où vous souhaitez placer la copie du répertoire (par exemple vous pouvez vous déplacer dans votre dossier « Documents »). Lorsque vous êtes prêt, vous pouvez entrer:

$ git clone [HTTPS ADDRESS]

Cette commande fera une copie locale du référentiel hébergé à l'adresse donnée.

Maintenant, votre référentiel est sur votre ordinateur. Vous devez y emménager avec:

$ cd [NAME OF REPOSITORY]
Remarque: lorsque vous clonez, Git créera un référentiel sur votre ordinateur. Si vous le souhaitez, vous pouvez accéder à votre projet avec l'interface utilisateur de l'ordinateur.

b. Repository edition

Now you can create a file named “README.md” in your folder (through the terminal or user interface on your computer). I’m not giving you any more details about this step, nothing in particular. Open your folder and add a file as if it were a standard folder.

If you want to do something cool, copy and paste this template in your “README.md” file. You can replace information between the hooks to personalize the output.

### My first repository is awesome! I'm [PSEUDO/NAME] and here it's my first GitHub repository. If you see this file on my project, it's because I'm learning Git. My mood: > [MOOD NAME] My favorite color: > [COLOR NAME] Thank you so much for reading! ☺

c. Let’s share our work!

Now that you have modified your project, you need to save it. This process is called committing.

To do this, get back to your terminal. If you have closed it, go back in your folder.

Lorsque vous souhaitez enregistrer votre travail, quatre étapes sont nécessaires. Ces étapes sont appelées: « status », « add », « commit » et « push ». J'ai préparé une procédure standard que vous devez exécuter chaque fois que vous souhaitez enregistrer votre travail.

Remarque: toutes les étapes suivantes doivent être effectuées dans votre projet.
  • « Status »: La première chose que vous devez faire une fois votre travail est de vérifier les fichiers que vous avez modifiés. Pour ce faire, vous pouvez taper la commande suivante pour faire apparaître une liste de modifications:
$ git status
  • « Ajouter »: à l'aide de la liste des modifications, vous pouvez ajouter tous les fichiers que vous souhaitez télécharger avec la commande suivante:
$ git add [FILENAME] [FILENAME] [...]

Dans notre cas, nous allons ajouter « README.md » car nous voulons sauvegarder ce fichier.

$ git add README.md
Remarque: Si vous tapez à nouveau «git status», le «README.md» apparaîtra maintenant en vert. Cela signifie que nous avons correctement ajouté le fichier.
  • « Commit »: Maintenant que nous avons ajouté les fichiers de notre choix, nous devons écrire un message pour expliquer ce que nous avons fait. Ce message peut être utile plus tard si nous voulons vérifier l'historique des modifications. Voici un exemple de ce que nous pouvons mettre dans notre cas.
$ git commit -m "Added README.md with good description in it."
  • « Push »: vous y êtes, vous pouvez désormais mettre votre travail en ligne! Si vous tapez la commande suivante, tout votre travail sera mis en ligne et visible directement sur la page du référentiel.
$ git push origin master

Tu l'as fait! Si vous revenez sur votre page de référentiel sur GitHub, vous allez dans votre fichier « README.md » avec un bel aperçu de celui-ci.

Commandes utiles pour Git

You are still missing some essential commands as a beginner with Git. Here is a list that will be useful to you during your project.

  • Display the history of commits (all modifications made on the project).
$ git log
  • Revert back all your changes since the last commit.
$ git checkout .
  • Revert all changes on a specific file since the last commit.
$ git checkout [FILENAME]
  • Display the last changes on a file since the last commit.
$ git diff [FILENAME]
  • Remove all unexpected files in your project (not committed).
$ git clean -dfx
  • Add all files and make a commit at the same time.
$ git commit -am [MESSAGE]

What’s next?

In the next part of this beginner’s guide, you will discover these three topics:

  • What is a good commit message.
  • Why it's essential.
  • A checklist to write your commit messages.

-> A Beginner’s Guide to Git — How to Write a Good Commit Message

Conclusion

I hope that you’ve found this guide and examples on Git/GitHub helpful! If you have any questions or feedback, feel free to ask.

Don't miss my content by following me on Twitter and Instagram.

You can find other articles like this on my website: herewecode.io.

Want more?

  • Each week get a motivational quote with some advice, a short tutorial into a few slides, and one developer's picture on Instagram.
  • Sign-up for the newsletter and get the latest articles, courses, tutorials, tips, books, motivation, and other exclusive content.