Sources :

• Core Updates (en) (backdropcms.org)
• Updates vs Upgrades (en) (backdropcms.org)

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 fichiers¹⁾ 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 fichiers²⁾ 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 actif³⁾ :
      • répertoire config hors DocumentRoot
        ou⁴⁾ 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

À 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é
rm -Rf backdrop backdrop.zip config.tgz ../public_html/core-old

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

À 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

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 fusion⁵⁾.

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