GitHub est l’une des plateformes les plus populaires pour le contrôle de version et la collaboration en ligne. Il permet aux développeurs du monde entier de partager, suivre et gérer leurs projets de manière transparente et efficace. Dans ce tutoriel, nous allons découvrir les bases de GitHub, les commandes essentielles de Git, et comment utiliser GitHub pour collaborer sur des projets de développement logiciel.

Qu’est-ce que GitHub ?

GitHub est une plateforme d’hébergement pour le contrôle de version, basée sur Git, un système de gestion de versions décentralisé. Il permet aux développeurs de gérer leurs projets, de collaborer en temps réel, et de versionner leur code.

En plus de son utilisation comme dépôt de code, GitHub offre de nombreuses fonctionnalités comme des issues, des pull requests, des actions GitHub pour l’automatisation et des pages GitHub pour héberger des sites statiques.

Installation de Git et Configuration de GitHub

Avant d’utiliser GitHub, vous devez installer Git et configurer votre compte GitHub.

1. Installer Git

Pour commencer, installez Git sur votre machine. Selon votre système d’exploitation :

• Windows : Téléchargez et installez Git depuis le site officiel : Git for Windows.
• macOS : Utilisez Homebrew pour installer Git :brew install git
• Linux : Utilisez le gestionnaire de paquets de votre distribution. Par exemple, sur Ubuntu :sudo apt install git

2. Configurer Git

Une fois Git installé, vous devez configurer votre nom d’utilisateur et votre adresse e-mail (qui seront associés aux commits).

Exécutez ces commandes dans le terminal :

git config --global user.name "Votre Nom"
git config --global user.email "votre.email@example.com"

Création d’un Compte GitHub

1. Rendez-vous sur GitHub.com et créez un compte gratuit.
2. Une fois inscrit, connectez-vous à votre compte.

Premiers Pas avec GitHub

1. Créer un Nouveau Dépôt

Un dépôt (ou « repository ») est un espace où votre code source est stocké. Pour créer un nouveau dépôt sur GitHub :

1. Connectez-vous à votre compte GitHub.
2. Cliquez sur le bouton « New » dans le coin supérieur gauche.
3. Donnez un nom à votre dépôt, choisissez s’il doit être public ou privé, et initialisez-le avec un fichier README.md (optionnel).
4. Cliquez sur Create repository.

2. Cloner un Dépôt GitHub

Une fois votre dépôt créé, vous pouvez le cloner sur votre machine locale pour commencer à y travailler. Copiez l’URL de votre dépôt (en HTTP ou SSH), puis exécutez la commande suivante dans votre terminal :

git clone https://github.com/votre-utilisateur/nom-du-depot.git

Cela va créer une copie locale de votre dépôt sur votre machine.

Travailler avec Git et GitHub

Une fois que vous avez cloné un dépôt, vous pouvez commencer à y travailler en local, puis synchroniser vos modifications avec GitHub.

1. Vérifier l’état des fichiers

Avant de commencer à modifier des fichiers, vous pouvez vérifier l’état des fichiers dans votre dépôt local avec la commande :

git status

Cela vous montre quels fichiers ont été modifiés, ajoutés ou supprimés.

2. Ajouter des Fichiers au Suivi

Pour ajouter des fichiers au suivi de Git, utilisez la commande suivante :

git add <fichier>

Vous pouvez ajouter tous les fichiers modifiés avec :

git add .

3. Effectuer un Commit

Un commit est une capture de l’état de votre projet à un moment donné. Après avoir ajouté vos fichiers, vous pouvez faire un commit :

git commit -m "Message décrivant les changements"

4. Pousser (Push) les Modifications sur GitHub

Une fois vos commits effectués localement, vous devez envoyer (pousser) vos modifications sur GitHub avec la commande suivante :

git push origin main

Cela enverra vos commits vers la branche principale (main) de votre dépôt sur GitHub.

5. Tirer (Pull) les Modifications depuis GitHub

Si vous travaillez avec d’autres personnes, il est important de récupérer leurs modifications. Pour cela, utilisez la commande :

git pull origin main

Cela récupère les modifications de la branche principale de votre dépôt GitHub.

Collaborer avec GitHub

GitHub facilite la collaboration en équipe grâce à plusieurs fonctionnalités. Voici les principales :

1. Branches

Les branches permettent de travailler sur des fonctionnalités ou des corrections sans affecter la branche principale (main ou master). Pour créer une nouvelle branche, utilisez la commande suivante :

git checkout -b ma-nouvelle-branche

Cela crée et vous bascule sur la nouvelle branche. Une fois les modifications effectuées, vous pouvez les pousser sur GitHub et créer une pull request pour fusionner les changements.

2. Pull Requests (PR)

Une pull request est une proposition de modification d’une branche dans un autre dépôt. Elle permet aux membres de l’équipe de revoir les changements avant qu’ils ne soient intégrés.

Pour créer une pull request :

1. Poussez vos changements sur une branche distante.
2. Allez sur GitHub, et vous verrez une option pour créer une pull request.
3. Donnez un titre et une description de vos changements.
4. Soumettez la pull request pour qu’elle soit examinée par les autres.

3. Issues

Les issues sont des tickets de suivi pour gérer les bugs, les fonctionnalités et les tâches dans un projet. Pour créer une issue :

1. Allez dans l’onglet Issues de votre dépôt GitHub.
2. Cliquez sur New Issue.
3. Décrivez le problème ou la tâche à accomplir, puis soumettez-le.

GitHub Actions

GitHub Actions est une fonctionnalité puissante permettant d’automatiser les flux de travail. Par exemple, vous pouvez configurer des actions pour exécuter des tests ou déployer votre application chaque fois que vous poussez des modifications sur GitHub.

Voici un exemple simple de fichier de workflow pour exécuter des tests :

name: Node.js CI

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Setup Node.js
        uses: actions/setup-node@v2
        with:
          node-version: '14'
      - name: Install dependencies
        run: npm install
      - name: Run tests
        run: npm test

Chaque fois que vous poussez sur la branche main, ce workflow exécutera les tests de votre projet.

Conclusion

GitHub est un outil essentiel pour la gestion de versions et la collaboration sur des projets de développement logiciel. En maîtrisant les commandes Git de base et les fonctionnalités de GitHub, vous serez capable de gérer efficacement vos projets, de collaborer avec d’autres développeurs et de tirer parti des nombreuses fonctionnalités offertes par la plateforme.

Dans ce tutoriel, nous avons couvert les bases de GitHub, y compris la création de dépôts, les commandes Git essentielles, la gestion des branches et la collaboration via des pull requests et des issues. GitHub est un outil puissant pour les développeurs, et avec ces connaissances, vous êtes prêt à l’utiliser pour améliorer votre flux de travail de développement !