Git sur les serveurs BdE

L'ensemble des projets du BdE utilisent Git comme système de versionnement. Les dépôts son présent sur les machines concernées et une copie de chaque dépôt est conservée sur le GitLab du Crans, le propriétaire étant le groupe BdE.

L'ensemble des commandes qui suivent ne peuvent être entrées que dans un dépôt Git (Si vous essayez en dehors, git râlera).

Indiquer à Git son identité

Avant de commencer, il faut indiquer à Git qui va faire les modifications sur le dépôt avec le compte utilisé, afin de l'intégrer aux commits enregistrés.

Le plus simple est de configurer son identité pour tous les dépôts de la machine : ce réglage n'a besoin d'être fait qu'une seule fois. Cela peut être fait avec les commandes suivantes .

$ git config --global user.name "<prénom> <nom>"
$ git config --global user.email <adresse mail>

Avant de modifier des fichiers

Avant de pouvoir commencer à travailler, il faut déjà s'assurer que quelqu'un n'a pas laissé des modifications non sauvegardées dans le dépôts, et que le dépôt local est à jour avec le dépôt distant, s'il y en a un.

Vérifier que son dépôt est en phase avec un dépôt distant

• Des commits sur le dépôt local peuvent ne pas avoir été pushé. Pour le vérifier :

• $ git remote show

• Il est possible que d'autres gens aient travaillé sur le projet et aient apporté des changements qu'ils ont poussé vers le dépôt distant, il faut alors les importer :

• $ git pull

• Pour un mélange des deux cas précédents:

• • Ne pas abuser de cette méthode Un rebase foireux peut vite devenir compliqué à gérer !

• $ git pull --rebase

Commiter ses modifications aux fichiers versionnés

Lorsqu'un changement est apporté aux fichiers versionnés sur le serveur, il doivent être mis à l'index avant d'être commités pour qu'elles soient sauvegardées dans l'historique.

La commande git status permet d'indiquer les fichiers modifiés/non suivis.

Si les modifications du fichier chemin/vers/machin.conf doivent être ajouté à l'index, il faut et entrer la commande

$ git add chemin/vers/machin.conf

Plusieurs fichiers ou dossiers peuvent simultanément être ajoutés à l'index.

Une fois les modifications indexées, il faut les commiter pour enregistrer les modifications.

$ git commit

A ce moment un éditeur, en général nano, vim ou emacs, ouvre une zone d'édition où l'administrateur entre un message expliquant la modification concernée.

Une fois la modification enregistrée en local, il faut la pousser vers un dépôt distant, s'il y en a un.

$ git push

Liste des dépots Git du BdE

Tous les dépôts sont clonés depuis le GitLab Crans

• Note Kfet 2015 Serveur : Serveur de la Note (bde2-virt)
• Note Kfet 2015 Client : Client Django de la Note (bde2-virt)
• Scripts : Scripts utiles pour la vidéo et le calendrier (bde2-virt, videobde)
• Digicode : Projet de digicode pour les locaux associatifs (bde3, bde3-virt)

Ces dépôts peuvent être clonés par les membres du groupe BdE avec la commande

$ git clone https://gitlab.crans.org/bde/<nom du dépôt>.git

Pour aller plus loin...

Crans '''Nostalgie''' CVS Git au Crans