4.0 KiB
Executable File
Versionner son code avec Git
Git est un logiciel de gestion de version.
Interfaces et serveurs
Git permet de stocker et sauvegarder des documents ainsi que leurs versions précédentes sur un serveur prévu à cet effet. Les plus connus sont :
Certains de ces services proposent des fonctionnalités avancés de suivi des bugs, d’automatisation des tâches, etc.
::: info
Les trois premiers proposent un compte gratuit largement suffisant pour un usage classique.
Le dernier est à installer sois-même sur un serveur.
:::
Utilisation locale
Installtion
MacOs
Git est inclus dans MacOs, mais vous devez installer les command line tools avant de pouvoir l'utiliser.
:::warning Attention
Si c'est la première fois que vous tentez d'utiliser le terminal ou certaines commandes, MacOS vous demandera d'installer les command line tools. C'est une suite d'outils indispensable pour utiliser certaines fonctionnalités en ligne de commande (dans un terminal).
Vous pouvez déclencher cette installation via la commande xcode-select --install
:::
Windows
Git doit être installé via un exécutable windows téléchargeable ici.
Outils
Afin de créer et gérer un dépôt de documents (généralement un dossier contenant le code source de notre projet), il est nécessaire d’utiliser un terminal. Il est possible d’utiliser le terminal intégré à son logiciel de développement ou celui de son système d’exploitation :
- terminal sur MacOS et linux
- powershell sur Windows
Authentification du serveur
Pour éviter d’avoir à renseigner le mot de passe de son compte github, gitlab, gitea à chaque fois, il est recommandé d’utiliser une clé SSH. Ce protocole permet une authentification en arrière plan de votre machine auprès du serveur.
Afin de générer une clé, renseignez et validez la commande suivant dans le terminal :
ssh-keygen -t ed25519 -C "VOTRE_EMAIL"
Ne renseignez pas de mot/phrase de passe. Vous devriez recevoir une réponse du terminal contenant la localisation de la clé sur votre ordinateur ainsi qu’une “empreinte” de clé.
::: details Exemple d’empreinte
The key fingerprint is:
SHA256://wlS3vSWCovCYh+Y5LbtlS1Ee4nr0e3mTOmFq7//us test@mail.fr
The key’s randomart image is:
+--[ED25519 256]--+
| . |
| . . |
| + |
| o o |
| .S.. + . |
| . .o. =. o|
| . .. ...o=*=|
| +o= o+==%o|
| .*oo .BO@E*|
+----[SHA256]-----+
:::
Vous devez ensuite récupérer la clé publique, généralement id_ed25519.pub, copier son contenu et le coller dans les paramètres de votre compte github, gitlab, etc.
Création d’un dépôt
Les étapes de création d’un dépôt sont quasiment systématiquement les mêmes :
- ouvrir le dossier de travail dans le terminal
- taper la commande
git init - se rendre sur son serveur git en ligne
- créer un nouveau dépôt vide depuis l’interface
Envoyer des fichiers vers le serveur
Maintenant que le dépôt est créé, il faut faire le lien entre votre projet local et dépôt sur le serveur. À l’intérieur du dépôt distant vide, vous devriez trouver des commandes fournies par le serveur. Ces commandes peuvent-être copiées/collées dans l’ordre dans le terminal.
- ajouter le serveur comme dépôt distant
git remote add origin git@github.com:USER/REPO.git
- demander à git de suivre tous les fichiers du dossier
git add .
- ajouter et figer l’état des fichiers suivis avec un commentaire
git commit -m "COMMENTAIRE"
- envoyer les fichiers sur le serveur
git push origin main
::: tip À chaque fois que vous souhaitez envoyer des modifications, répétez les étapes 2 à 4 :::