Skip to content

Latest commit

 

History

History
117 lines (81 loc) · 4.38 KB

migration_v1.2_to_v1.3.md

File metadata and controls

117 lines (81 loc) · 4.38 KB
Raw

A partir de la version 1.3, le déploiement de GeoPaysages est réalisé avec Docker. Pour migrer GeoPaysages depuis des versions précédentes, il faut donc installer une nouvelle instance de GeoPaysages avec Docker et y intégrer la base de données de la version précédente.

Modifications majeures

Il s'agit-là d'une simple information, les étapes à entreprendre ne commencent qu'au paragraphe Migrer la DB.

Installer une nouvelle instance de GeoPaysages en suivant la documentation d'installation.

Migrer la DB

L'objectif est de remplacer la DB livrée avec la nouvelle version par l'ancienne DB.
Lorsqu'on redémarre les containers, le schéma de la DB est mis à jour via Alembic.
L'ancienne base est alors prête à être utilisée dans la nouvelle version.

  • Faire un dump de l'ancienne DB
    pg_dump -U <username> -Fc -f <destination_file> <db_name>
    ex. pg_dump -U geopaysages -Fc -f ./geopaysages_1_2.dump geopaysages

  • Atteindre la racine du dossier de la nouvelle version

  • Démarrer les containers de la nouvelle version
    Attention : dans le fichier ./docker/.env, choisir un autre port que celui de l'ancienne DB ou se déconnecter de l'ancienne
    ./docker/docker.sh up -d

  • Copier le dump dans le container de la DB

    • Version récente de Docker Compose :
      ./docker/docker.sh cp <chemin_vers_geopaysages_1_2.dump> db:/geopaysages_1_2.dump
    • Version ancienne de Docker Compose :
      Trouver le nom du container de la DB
      docker ps -f "name=geopaysages_db"
      Copier la valeur sous la colonne "NAMES", sera probablement "geopaysages_db_1"
      docker cp <chemin_vers_geopaysages_1_2.dump> <nom_container_ci_dessus>:/geopaysages_1_2.backup

  • Entrer dans le container de la DB
    ./docker/docker.sh exec db /bin/bash

  • Se connecter à la DB avec PSQL
    psql -U geopaysages -d postgres

  • Fermer les connexions à la DB geopaysages
    SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE pid <> pg_backend_pid() AND datname = 'geopaysages';

  • Supprimer la DB existante
    DROP DATABASE geopaysages;

  • Quitter psql
    exit

  • Créer une DB vide
    createdb -U geopaysages geopaysages

  • Et enfin restaurer votre ancienne DB
    pg_restore -U geopaysages --no-owner --dbname geopaysages geopaysages_1_2.backup

  • Quitter le container de la DB
    exit

  • Redémarrer le backend
    ./docker/docker.sh restart backend

Vos données sont à jour.

Migrer les medias

  • Copier le contenu de data/images dans custom/upload/images: 
    cd ~/data
mv images/* ../geopaysages/custom/upload/images/
  • Copier le contenu de data/notice-photo dans custom/upload/notice-photo : 
    cd ~/data
mv notice-photo/* ../geopaysages/custom/upload/notice-photo/

A ce stade, l'application doit avoir un aspect normal.

Migrer les personnalisations

1. Migrer les traductions

Le plus simple est de refaire vos modifications dans le nouveau fichier de traduction :
custom/i18n/fr/LC_MESSAGES/messages.po

Voir la doc de personnalisation

2. Le bloc d'introduction

Avant il était dans la table conf de la base de données, via la clé home_intro. Maintenant il s'agit d'un template jinja.

Voir la doc de personnalisation

3. La page présentation (/about)

Avant elle était dans la table conf de la base de données via les clés
page_about_title, page_about_content et page_about_published.

Maintenant il s'agit d'un template jinja.

Voir la doc de personnalisation

4. Les pages supplémentaires

Il s'agissait de pages créées de façon standard :

  • Un template jinja dans /backend/tpl/
  • Une route dans backend/routes.py
  • Sûrement un lien dans backend/tpl/layout.html
  • Peut-être des traductions dans backend/i18n/fr/LC_MESSAGES/messages.po

Le procédé a peu changé, tout se passe dans le dossier custom
Voir la doc de personnalisation