Table des matières

Backdrop CMS

Sources :

Mises à jour

Core update

La mise à jour du Core effectue également celle des modules compris dans la distribution. Tous les éléments concernés figurent dans le sous-répertoire core de l'archive de mise à jour. Si d'autres fichiers1) doivent également être mis à jour, ils seront indiqués dans les notes de mise à jour (release notes).

  1. lire les notes de mise à jour (mise à jour possible de certains fichiers2) en dehors du Core)
  2. passer le site en mode maintenance
  3. dans le root directory,
    1. renommer le répertoire core en core-old
    2. effectuer une sauvegarde du répertoire de configuration, selon le schéma actif3) :
      • répertoire config hors DocumentRoot
        ou4) sous-répertoire ~/files/config_[hash-code]
  4. dans un répertoire temporaire
    1. télécharger l'archive de mise à jour (.zip)
    2. extraire l'archive >>> entraîne la création du répertoire “backdrop”
    3. déplacer le sous répertoire “core” dans le root directory
  5. lancer la mise à jour : https://mon-site/core/update.php
  6. si tout s'est bien passé
    1. supprimer les sauvegarde du core et de la configuation: core-old et config.tgz
    2. supprimer l'archive de mise à jour et son extraction
    3. remettre le site en mode consultation

Commandes typiques

À adapter au contexte d'hébergement. 

>>> pointer le navigateur sur https://mon-site/admin/config/system/site-information
cd ~user/domains/domain.tld/tmp
wget https://github.com/backdrop/backdrop/releases/download/x.yy.z/backdrop.zip
unzip backdrop.zip
mv ../public_html/core ../public_html/core-old
mv backdrop/core/ ../public_html/
tar czf config.tgz ../config⇒   /// autocomplétion
          (tar czf config.tgz ../public_html/files/config_[hash-code])   /// avant 1.30.0
    ////// si OK après update.php effectué (https://mon-site/core/update.php)
rm -Rf backdrop backdrop.zip config.tgz ../public_html/core-old

Modules update

Sauf mention particulière, les modules se mettent à jour par une simple suppression du répertoire ad hoc et remplacement par le répertoire extrait.

Pour des modules légers tels que mimemail, site_map et xmlsitemap, le plus simple est de les téléverser manuellement.

La procédure est alors la suivante :

  1. passer le site en mode maintenance
  2. depuis la page des mises à jour, télécharger les zip sur le poste de travail
    1. si le serveur de mise à jour est H.S. aller sur la page des modules de Backdrop CMS
  3. extraire localement les contenus des zip (chaque zip contient un répertoire éponyme)
  4. lire la documentation
  5. sur le serveur, supprimer (rm -Rf <liste> les répertoires obsolètes cd ~user/domains/domain.tld/public_html/modules
  6. copier les répertoires des mises à jour depuis le poste de travail sur le serveur.
  7. actualiser la page des mises à jour
  8. remettre le site en mode consultation

Commandes typiques

À adapter au contexte d'hébergement. Ici, en téléchargement sur le serveur sans passer par la station de travail. 

cd ~user/domains/domain.tld/public_html/modules
ls -d */
rm -R <liste des répertoires de modules à mettre à jour>
cd ~user/domains/domain.tld/tmp
              //// pour tous les modules à mettre à jour
wget <url du zip du module>
unzip mon-module.zip -d ../public_html/modules/
rm mon-module.zip

Fichiers hors Core

Certaines mises à jour affectent des fichiers extérieurs au Core tels que .htaccess, robots.txt ou settings.php qui figurent à la racine de l'arborescence de la mise à jour. Les fichiers concernés sont indiqués dans les notes de mise jour. La mise à jour du Core, telle que décrite précédemment, ne fait pas la mise à jour de ces fichiers.

Pour chaque fichier, l'utilisatrice se trouve dans deux cas de figure. Le fichier installé (en cours d'utilisation) est :

  1. le fichier fournit pas la distribution,
  2. une version personnalisée.

Dans le premier cas, il suffit de remplacer le fichier installé par celui figurant dans la mise à jour.

Dans le second cas, il faudra reporter les éléments de configuration personnalisés dans la nouvelle version du fichier concerné (fusion) avant de remplacer le fichier installé. Il n'existe pas de méthode universelle permettant d'automatiser cette fusion5).

En pratique

Dans la vraie vie, je fais les modifications à la main, depuis une station de travail. Pour les fichiers concernés :

  1. téléchargement des fichiers installés
  2. téléchargement de l'archive de mise à jour
  3. diff sur les fichiers
  4. selon les modifications à apporter :
    • fusion des fichiers en local, puis téléversement des fichiers fusionnés sur le serveur
      ou
    • modification directe des fichiers installés
1)
Tels.htaccess, robots.txt, settings.php…
2)
settings.php, .htaccess, robots.txt…
3)
Tel que défini dans la section Configuration storage du fichier settings.php.
4)
Selon Configuration storage du fichier settings.php.
5)
Sauf changement majeur, une fusion par diff/patch est envisageable mais Backdrop CMS ne définissant pas ce que serait un « changement majeur », il est risqué d'automatiser intégralement la mise à jour. Une approche semi-automatisée reste possible : analyse des différences par diff, contrôle visuel puis application des modification par patch si cela fait sens.