Documentation gitlab

Sommaire

Emetteur        1

Objet        3

Un peu d’histoire        3

Git        3

GitLab        3

Pourquoi utiliser un système de suivi de version ?        3

Configuration de l’environnement de travail        4

Installation de Git        4

Création d’un compte GitLab        5

Configuration de Git        5

La création d’un repository et premiers commits        6

Git init - Initialisation d’un répertoire        6

Git add / Git commit - Ajout d’un fichier à l’Index et premier Commit        7

Git push - Enregistrement des modification sur le répertoire distant        7

Git pull – Récupérer des modifications du répertoire distant        8

Annexes        9

Cheat Sheet des commandes de base        9

Créer et cloner un repertoire        9

Ajouter et supprimer des fichiers        9

Synchronisation et Commit        9

Les branches        10

Merge des branches        10

Tagging        10

Restauration        10

Objet

Ce document décrit l’installation, l’utilisation basique et les commandes essentielles afin d’utiliser l’outil de versionning Git avec GitLab.

Un peu d’histoire

Git

Git est un système de gestion de version OpenSource développé à partir d’avril 2005 par Linus Torvalds (et maintenu depuis par Junio Hamano). Il a pour objectif de répertorier les changements apportés au code source d’un logiciel durant son développement.

La dernière version actuellement en service est la version 2.25.

GitLab

GitLab est un outil Web DevOps fournissant un système de management de répertoire Git, un Wiki, un système de ticketing ainsi qu’une solution d’intégration et de déploiement continue (CI/CD). La société a été fondée en 2013 par Sytse Sijbrandij et Dmitriy Zaporozhets.

Pourquoi utiliser un système de suivi de version ?

1. Tout d’abord, il permet d’enregistrer les modifications de fichiers au fil du temps
2. Il permet d’être réversible, c’est-à-dire de pouvoir comparer avec une version antérieure, et si besoin, d’y retourner
3. Il permet de documenter les modifications (c’est là l’importance des messages de commit, et de la signature de ceux-ci.)
4. Il permet un travail collaboratif efficace

Configuration de l’environnement de travail

Installation de Git

Il est tout d’abord nécessaire d’installer Git sur le poste de travail : https://git-scm.com

[pic 2]

Pour ce tutoriel, l’installation se fera avec les paramètres d’installation par défaut.

Création d’un compte GitLab

Afin de pouvoir effectuer notre versionning sur GitLab, nous devons en premier lieu nous y inscrire : https://gitlab.com

[pic 3]

Configuration de Git

Il faut désormais paramétrer Git en Local. On ouvre donc l’invite de commande GitBash, et nous y rentrons ces deux commandes :

Git config --global user.name “Nom”

Git config --global user.email

Elles permettront de vous identifier lors des futurs commit que vous allez effectuer.

La création d’un repository et premiers commits

Git init - Initialisation d’un répertoire

• Créons tout d’abords un projet sur GitLab, que nous appellerons « MonPremierRepo »

[pic 4]

[pic 5]

• Nous instancions un nouveau dossier sur notre poste de travail local que nous appellerons également « MonPremierRepo ».

• Nous nous plaçons dans notre dossier de projet grâce à la commande :

Cd F:\MonPremierRepo

• Nous le déclarons comme répertoire local Git :

Git init

• Puis nous le connectons à notre répertoire distant sur GitLab :

Git remote add origin <URL du Projet>

Git add / Git commit - Ajout d’un fichier à l’Index et premier Commit

• Nous y créons un fichier « test.txt » dans notre dossier « MonPremierRepo » où nous écrirons simplement « test ».

• Nous ajoutons les changements effectués en local à l’Index :

Git add *  

• Puis nous faisons un commit de ces changements :

Git commit -m « Mon Premier Commit »

Git push - Enregistrement des modification sur le répertoire distant

• Pour finir, nous faisons un push vers le répertoire distant

Git push origin master

Une boîte de dialogue apparaît, il faut y renseigner vos identifiants GitLab

[pic 6]

• Nous vérifions donc sur GitLab, et effectivement, notre fichier est bien présent

[pic 7]

Git pull – Récupérer des modifications du répertoire distant

• Nous créons maintenant sur GitLab un fichier « Test2.txt »

• Nous allons récupérer ce fichier dans notre répertoire local grâce à la commande :

Git pull

• Après vérification, le fichier créé sur GitLab est bien présent dans notre répertoire local

[pic 8]

Annexes

Cheat Sheet des commandes de base

Créer et cloner un repertoire

# Créer un nouveau répertoire

Git init

# Cloner un repertoire local

Git clone /path/to/repository

# Cloner un repertoire distant

Git clone username@host:/path/to/repository

...