Mettre à jour le site avec git pull sans écraser ses modifications
Récupérer sur le serveur la dernière version du code publiée sur GitHub, en vérifiant d'abord avec git status que les contenus modifiés en ligne depuis le tableau de bord ne seront pas perdus.
- Type
- Procédure
- Niveau
- Débutant
- Durée
- 10 min
- Système
- AlwaysData (Linux)
- Outil
- Git
- Versions testées
- Git 2
Objectif
Mettre à jour le site en ligne avec la dernière version du dépôt GitHub, sans perdre les fiches, réalisations ou textes modifiés directement dans le tableau de bord /admin.
Prérequis
- Une connexion SSH au serveur : Se connecter en SSH à AlwaysData
- Savoir ce qu'est Git
Le risque à connaître
Le tableau de bord enregistre vos modifications dans les fichiers data/*.json du serveur. Ces mêmes fichiers existent aussi sur GitHub. Si un fichier a été modifié des deux côtés, git pull refuse de continuer, pour ne rien écraser :
error: Your local changes to the following files would be overwritten by merge:
data/kb.json
Please commit your changes or stash them before you merge.
Remarque Les comptes (data/admin.json), l'audience et la supervision sont exclus de Git (.gitignore). Une mise à jour ne les touche jamais.
Étapes
Étape 1 : se connecter et aller dans le dossier du site
ssh <compte>@ssh-<compte>.alwaysdata.net
cd www
Étape 2 : regarder ce qui a changé sur le serveur
git status
Résultat attendu, cas simple : « nothing to commit, working tree clean ». Rien n'a été modifié en ligne : passez directement à l'étape 4.
Si des fichiers apparaissent en rouge sous « Changes not staged for commit » (par exemple modified: data/kb.json), ce sont vos modifications faites dans le tableau de bord. Passez à l'étape 3.
Étape 3 : sauvegarder avant tout
Faites une copie datée du dossier de données, hors du site :
cp -r data ~/sauvegarde-data-$(date +%Y-%m-%d)
Puis mettez vos modifications de côté, récupérez la nouvelle version et remettez vos modifications par-dessus :
git stash
git pull
git stash pop
Résultat attendu git stash pop se termine sans le mot « CONFLICT ». Vos modifications et celles de GitHub sont réunies.
Attention Si « CONFLICT » s'affiche, ne paniquez pas : rien n'est perdu, votre copie de l'étape 3 existe. Tapez git checkout -- data puis git stash drop pour garder la version de GitHub, puis refaites vos modifications dans le tableau de bord, ou demandez de l'aide en envoyant le fichier sauvegardé.
Étape 4 : récupérer la nouvelle version
git pull
Résultat attendu La liste des fichiers modifiés, ou « Already up to date. » s'il n'y avait rien de nouveau.
Étape 5 : vérifier puis quitter
Rechargez le site dans le navigateur avec Cmd + Maj + R (pour ignorer le cache), puis :
exit
Vérification
git statusaffiche à nouveau « working tree clean » (ou seulement vos modifications remises pargit stash pop).git log -1affiche la dernière modification publiée sur GitHub.- Le site s'affiche et le tableau de bord fonctionne.
Dépannage
| Symptôme | Cause probable | Solution |
|---|---|---|
Your local changes … would be overwritten by merge | Fichier modifié en ligne et sur GitHub | Suivre l'étape 3 |
fatal: not a git repository | Vous n'êtes pas dans le dossier du site | Taper cd ~/www |
CONFLICT (content) après git stash pop | La même partie du fichier a changé des deux côtés | Voir l'encadré de l'étape 3 |
| Le site n'a pas changé | Cache du navigateur | Cmd + Maj + R, ou navigation privée |
Sécurité et bonnes pratiques
- Toujours
git statusavantgit pull. - Gardez quelques sauvegardes de
data/; supprimez les plus anciennes de temps en temps. - Pour éviter le problème, modifiez le contenu soit en ligne, soit dans les fichiers du dépôt, mais pas les deux à la fois.