GitHub à l'ETML

Voici le document crée à l'ETML. Ce document vous expliquera les termes liés à Git et GitHub.
Il vous servira de tutoriel et de document théorique sur les différents termes et commandes Git.

Table de matières

• Pull Request | Fork
  • 1. Pull request
    • 1.1 Git bash
    • 1.2 GitKraken
    • 1.3 GitHub
  • 2. Fork
    • 2.1 GitKraken
    • 2.2 GitHub
• Termes Git
  • 1. Branch
  • 2. Commit
  • 3. Pull
  • 4. Push
  • 5. Fetch
  • 6. Origin
  • 7. Upstream
  • 8. Stage
  • 9. Tag
• Créateurs

Pull Request | Fork

1. Pull Request

Les pull requests sont la façon dont on vérifie les modifications du code source dans une branche. Quand on ouvre une pull request, on peut visualiser et collaborer sur les modifications de code avant le merge.

1.1 Git bash

Commande sur git bash :

git request-pull [-p] <start> <url> [<end>]

1.2 GitKraken

1.3 GitHub

• Aller dans la section "Pull requests" du dépôt.
• Appuyez sur "New pull request".
• Sélectionnez les branches à comparés

• Après cela, mettez votre commentaire et créer la pull request.

2. Fork

Un fork est une copie d'un dépôt. Cela permet de faire des modifications sur un dépôt sans que le dépôt principal soit affecté.

2.1 GitKraken

• Cloner le dépôt initial.
• Ajouter un remote.
• Forkez le dépôt.
• Le lien de référence avec la marche à suivre complète :
  https://support.gitkraken.com/working-with-repositories/fork/

2.2 GitHub

• Aller sur dépôt initial.
• En haut à droite un bouton "Fork" est présent.
• Vous appuyez dessus.

Termes Git

1. Branch

Une branch est essentiellement un ensemble unique de modification de code avec un nom unique. Chaque repo peut avoir une ou plusieurs branch. La branch principale qui s’appelle master, dans laquelle toutes les modifications sont finalement fusionnées. Il s’agit de la version officielle du projet et celle qu’on voit quand on visite le repo du projet.

Lien de référence :
https://www.atlassian.com/fr/git/tutorials/using-branches

1.1 Git bash

Créer la branch et switch immédiatement dedans :

git checkout -b <branch-name>

Push la branch local sur le dépôt distant :

git push -u <remote> <branch-name>

2. Commit

À un niveau général, Git peut être considéré comme un utilitaire de gestion de la chronologie. Les commits constituent les piliers d'une chronologie de projet Git. Cela interagit dans le dépôt local, ce qui ne nécessite aucune interaction avec d'autres dépôts Git. On peut y ajouter une description de l'ajout effectué en local, afin de l'envoyer dans le dépôt distant.

Lien de référence :
https://www.atlassian.com/fr/git/tutorials/saving-changes/git-commit

2.1 Git bash

Faire un commit avec git bash :

git commit -m "commit message"

3. Pull

Les pull requests sont une fonctionnalité facilitant la collaboration des développeurs avec Git Kraken. Elles fournissent une interface conviviale pour discuter des changements proposés avant de l’intégrer au projet officiel.

Lien de référence :
https://www.atlassian.com/fr/git/tutorials/syncing/git-pull

3.1 Git bash

Faire un pull avec git bash :

git pull

4. Push

Le push est la commande la plus couramment utilisée pour publier des changements locaux et les charger vers un dépôt centralisé. Après qu’un dépôt local a été modifié, un push est exécuté pour partager les changements avec les membres de l’équipe distants.

Lien de référence :
https://www.atlassian.com/fr/git/tutorials/syncing/git-push

4.1 Git bash

Faire un push avec git bash :

- git push
- git push <remote> <branch>

5. Fetch

Le fetch permet, tout comme le pull, de télécharger le dépôt distant dans une copie locale. La seule difference est que fetch ne télécharge pas les métadonnées associées à un projet. C'est à dire qu'il ne met pas à jour les fichiers déjà présents dans le dépôt local.

Lien de référence :
https://www.atlassian.com/fr/git/tutorials/syncing/git-fetch

5.1 Git bash

Faire un fetch avec git bash :

- git fetch <remote>
- git fetch <remote> <branch>

6. Origin

C'est l'origine du dépôt et non pas le nom d'une branche. Comme dans une arborescence de fichier :
- Origin/NomDeLaBranche

7. Upstream

Upstream définit l'emplacement que le dépôt local contient. Imaginons que j'ai un dépot avec 2 branches :
- Origin/master
- Origin/Dev
Depuis le dépôt local, si je clone le dépôt distant, le upstream, donc le "lien" du dépôt distant (Dépôt + branche) sera déjà défini.

Lien de référence :
https://www.atlassian.com/git/tutorials/git-forks-and-upstreams

7.1 Git bash

Faire un upstream avec git bash :

git push --set-upstream origin master 

8. Stage

Le stage est une zone tampon, autrement dit il stock temporerement les fichiers modifiés dans une liste d'attente afin d'être ajouté par le prochain commit.

Lien de référence :
https://www.atlassian.com/fr/git/tutorials/saving-changes

8.1 Git bash

Faire un stage avec git bash :

git add .

9. Tag

Le tag est un balisage pour marquer des points soécifiques de l'historique Git.Les tags sont généralement utilisés pour capturer un point de l'historique .utilisé pour une version marquée (c.-à-d., v1.0.1).

Lien de référence :
https://www.atlassian.com/fr/git/tutorials/inspecting-a-repository/git-tag

9.1 Git bash

Faire un tag avec git bash :

git tag <tagname>

Createurs

• David Dieperink
• Alexis Rojas
• Stefan Petrovic
• Thomas Rey
• Damien Loup