cClaude.rocks ☕ Le blog

[Nouvelles technologies du libre, sciences et coups de gueule…]

Menu

La gestion du code source (« SCM » / « Source Code Management ») est utilisée pour suivre les modifications apportées à un référentiel de code source. Un « SCM » suit un historique des modifications apportées à une base de code et aide à résoudre les conflits lors de la fusion des mises à jour de plusieurs contributeurs. La notion de « SCM » est également synonyme de contrÎle de version.

git est actuellement l’outil le plus utilisĂ© pour ce type de tache. Les notions derriĂšres la gestion de code source Ă©tant assez compliquĂ©e, git n’est pas un outil simple Ă  apprĂ©hender.

Je vous propose les commandes de base pour vous permettre de faire le minimum avec cet outil.


ඏ

Prérequis

Le client git est nĂ©cessaire, voir le billet 🌳 Installation de git.


ඏ

Configuration du client git

Aprùs l’installation du client git, vous devez le configurer à minima avec :

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

NotĂ© que cette configuration est globale au sens de l’utilisateur du systĂšme et donc commune Ă  tous les projets de l’utilisateur courant.


ඏ

Création du projet

Le but de cet article n’étant pas de faire le tour de toutes les fonctionnalitĂ©s de l’outil, on supposera que le projet existe dĂ©jĂ .

Par ailleurs, tous les serveurs git que je connais propose aujourd’hui d’initialiser les dĂ©pĂŽts (gĂ©nĂ©ralement au moins avec un fichier README.md) ce qui permet d’ignorer l’initialisation depuis le client.


ඏ

RĂ©cupĂ©rer un projet (qui existe et qui n’est pas vide)

Cette opĂ©ration n’est Ă  faire qu’une seule fois par projet.

git clone "URL_HTTPS_DONNÉE_PAR_LE_SERVEUR_GIT"

Sur le serveur vous trouverez deux types d’URLs :

  • L’une au format https plus simple Ă  utiliser mais moins sĂ©curisĂ©,
  • et l’autre au format ssh (si vous avez dĂ©jĂ  une clĂ© ssh configurer votre clĂ©e publique dans le serveur et prenez cette solution).

La différence entre ces deux solutions étant la maniÚre de vous authentifier auprÚs du serveur, dans ce billet nous utiliserons le mode https pour ne pas avoir à parler de clé ssh.

Vous devrez donc utiliser quelque chose comme :

git clone https://git.domain.org/une_organisation/un_projet.git

Cela téléchargera le dépÎt associé dans le dossier un_projet et vous positionnera dans la branche principale du projet (généralement nommée main ou master).

Vous pouvez maintenant modifier le projet avec les outils de votre choix.


ඏ

Prise en compte de vos modifications

Vous allez effectuer une sĂ©rie de modifications sur 1 ou plusieurs fichiers, Ă  priori on considĂšre que ce que vous allez mettre dans le dĂ©pĂŽt est fonctionnel, vos modifications doivent donc ĂȘtre consistantes.

Cela se fait en deux opérations :

  • Vous devez dire a git quelles modifications vous souhaitez qu’il prenne en compte, cela se fait Ă  l’aide de *git add 


  • Et enfin lui dire que c’est bon vous avez fini de lui donner la liste de modification et que lĂ  il doit prendre une photo de la situation.


SĂ©lectionner les modifications Ă  prendre en compte

(Cette opération peut se faire sans réseau)

Vous pouvez ĂȘtre amenĂ© Ă  faire plusieurs fois cette opĂ©ration de suite.

Pour ajouter un nouveau fichier ou un prendre en compte une modification d’un fichier existant:

git add chemin/nom-fichier

Pour ajouter tous les fichiers ayant changé :

git add .

Prendre la photo des modifications

(Cette opération peut se faire sans réseau)

Pour ajouter vos modifications dans le dépÎt local, vous devez utiliser :

git commit -m "Un message utile !"

Vous aurez d’autres modifications Ă  faire qu’il faudra sĂ©lectionner (git add 
) et mettre sur la mĂȘme photo (on parle de « commit ») (git commit 
).
Et ainsi de suite



ඏ

Envoyer vers le serveur

(Cette opération nécessite un accÚs réseau)

Pour « pousser » vos modifications vers le serveur, afin de rendre votre travail visible aux autres personnes, utilisez :

git push

ඏ

RĂ©cupĂ©rer version de quelqu’un d’autres

Pour récupérer les modifications sur le serveur et les ajouter au graphe des modifications connues localement (mais cela ne les rend pas visibles) :

git fetch -v # (cette opération nécessite un accÚs réseau)

Rendre visibles les modifs sur les fichiers locaux (de votre branche courante) :

git pull

ඏ

La commande pour savoir oĂč on en est :

git status

ඏ

La commande permettant de voir ce que vous avez changé :

git diff

ඏ

La commande permettant de voir l’histoire du dĂ©pĂŽt :

git log

ඏ

 Disclaimer

Ces commandes ne vous permettent pas d’utiliser git correctement, cela vous permet juste de l’utiliser à minima.

Il y a en particulier la notion de branche qui a Ă©tĂ© totalement ignorĂ©e ici et qui est pourtant fondamentale et un intĂ©rĂȘt majeur de l’outil.


ඏ

Liens

኿


â„č 2006 - 2024 | 🏠 Accueil du domaine | 🏡 Accueil du blog