Sauvegarde et restauration du système de fichiers, du média et de la base de données

Dernière mise à jour : 2 novembre 2024
  • Rubriques :

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Cette commande permet de sauvegarder :

  • Le système de fichiers (à l’exclusion des répertoires var et pub/static)
  • Répertoire pub/media
  • La base

Les sauvegardes sont stockées dans le répertoire var/backups et peuvent être restaurées à tout moment à l’aide de la commande magento setup:rollback.

Après la sauvegarde, vous pouvez restaurer ultérieurement.

TIP
Pour Adobe Commerce sur les projets d’infrastructure cloud, voir Gestion des instantanés et des sauvegardes dans le guide Cloud.

Activation des sauvegardes

La fonction de sauvegarde est désactivée par défaut. Pour l’activer, saisissez la commande d’interface de ligne de commande suivante :

bin/magento config:set system/backup/functionality_enabled 1
WARNING
Avis d’obsolescence :
La fonctionnalité de sauvegarde est obsolète depuis les versions 2.1.16, 2.2.7 et 2.3.0. Nous vous recommandons d’étudier des technologies de sauvegarde supplémentaires et des outils de sauvegarde binaires (tels que Percona XtraBackup).

Définition de la limite des fichiers ouverts

La restauration d’une sauvegarde précédente peut échouer de manière silencieuse, ce qui entraîne l’écriture de données incomplètes dans le système de fichiers ou la base de données à l’aide de la commande magento setup:rollback.

Parfois, une longue chaîne de requête entraîne une insuffisance de mémoire de l’utilisateur en raison d’un trop grand nombre d’appels récursifs.

Comment définir les fichiers ouverts ulimit

Nous vous recommandons de définir les fichiers ouverts ulimit pour l’utilisateur du système de fichiers sur une valeur de 65536 ou plus.

Vous pouvez le faire sur la ligne de commande ou en faire un paramètre permanent pour l’utilisateur en modifiant son script shell.

Avant de poursuivre, si ce n’est pas déjà fait, passez à l’propriétaire du système de fichiers.

Commande :

ulimit -s 65536

Si nécessaire, vous pouvez définir cette valeur sur une valeur plus élevée.

NOTE
La syntaxe des fichiers ouverts ulimit dépend du shell UNIX que vous utilisez. Le paramètre précédent doit fonctionner avec CentOS et Ubuntu avec le conteneur Bash. Toutefois, pour macOS, le paramètre correct est ulimit -S 65532. Pour plus d’informations, consultez la page de gestion ou la référence du système d’exploitation.

Pour définir éventuellement la valeur dans le conteneur Bash de l’utilisateur :

  1. Si vous ne l’avez pas déjà fait, basculez vers le propriétaire du système de fichiers.

  2. Ouvrez /home/<username>/.bashrc dans un éditeur de texte.

  3. Ajoutez la ligne suivante :

    ulimit -s 65536

  4. Enregistrez vos modifications dans .bashrc et quittez l’éditeur de texte.

WARNING
Nous vous recommandons d’éviter de définir une valeur pour pcre.recursion_limit dans le fichier php.ini, car cela peut entraîner des restaurations incomplètes sans préavis d’échec.