Accessibilité

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

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 status affiche à nouveau « working tree clean » (ou seulement vos modifications remises par git stash pop).
  • git log -1 affiche la dernière modification publiée sur GitHub.
  • Le site s'affiche et le tableau de bord fonctionne.

Dépannage

SymptômeCause probableSolution
Your local changes … would be overwritten by mergeFichier modifié en ligne et sur GitHubSuivre l'étape 3
fatal: not a git repositoryVous n'êtes pas dans le dossier du siteTaper cd ~/www
CONFLICT (content) après git stash popLa même partie du fichier a changé des deux côtésVoir l'encadré de l'étape 3
Le site n'a pas changéCache du navigateurCmd + Maj + R, ou navigation privée

Sécurité et bonnes pratiques

  • Toujours git status avant git 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.

Pour aller plus loin