Configuration du stockage distant

Le module Stockage distant offre la possibilité de stocker des fichiers multimédias et de planifier les imports et exports dans un conteneur de stockage distant persistant à l’aide d’un service de stockage, tel qu’AWS S3.

Par défaut, l’application Adobe Commerce stocke les fichiers multimédias dans le même système de fichiers que celui qui contient l’application. Cela n’est pas efficace pour les configurations multi-serveurs complexes et peut entraîner une dégradation des performances lors du partage des ressources. Avec le module de stockage distant, vous pouvez stocker des fichiers multimédias dans le répertoire pub/media et importer/exporter des fichiers dans le répertoire var du stockage d’objets distants afin de tirer parti du redimensionnement d’image côté serveur.

recommendation-more-help

Le stockage à distance et le stockage de base de données ne peuvent pas être activés en même temps. Vous devez désactiver le stockage de la base de données avant d’activer le stockage à distance.

bin/magento config:set system/media_storage_configuration/media_database 0

L’activation du stockage à distance peut affecter votre expérience de développement établie. Par exemple, certaines fonctions de fichier PHP peuvent ne pas fonctionner comme prévu. L’utilisation de Commerce Framework pour les opérations de fichier doit être appliquée. La liste des fonctions natives PHP interdites est disponible dans le référentiel magento-coding-standard .

INFO

image de schéma

Options de stockage distant

Vous pouvez configurer le stockage à distance à l’aide de l’option remote-storage avec la commande setup CLI. L’option remote-storage utilise la syntaxe suivante :

--remote-storage-<parameter-name>="<parameter-value>"

parameter-name fait référence au nom du paramètre de stockage distant spécifique. Le tableau suivant répertorie les paramètres disponibles pour la configuration du stockage à distance :

Paramètre de ligne de commande
Nom du paramètre
Description
Valeur par défaut
remote-storage-driver
conducteur
Nom de l’adaptateur
Valeurs possibles :
file : désactive le stockage distant et utilise le système de fichiers local
aws-s3 : utilisez le service de stockage simple Amazon (Amazon S3)
none
remote-storage-bucket
compartiment
Stockage d’objet ou nom du conteneur
none
remote-storage-prefix
préfixe
Préfixe facultatif (emplacement dans le stockage d’objets)
empty
remote-storage-region
region
Nom de la région
none
remote-storage-key
clé d'accès
Clé d’accès facultative
empty
remote-storage-secret
clé secrète
Clé secrète facultative
empty

Adaptateurs de stockage

L’emplacement de stockage par défaut se trouve dans le système de fichiers local. Un adaptateur de stockage vous permet de vous connecter à un service de stockage et de stocker vos fichiers où que vous soyez. Commerce prend en charge la configuration des services de stockage suivants :

Activer le stockage à distance

Vous pouvez installer un stockage distant lors d’une installation Adobe Commerce ou ajouter un stockage distant à une instance Commerce existante. Les exemples suivants montrent chaque méthode utilisant un ensemble de paramètres remote-storage avec des commandes d’interface de ligne de commande Commerce setup. Au minimum, vous devez fournir le stockage driver, bucket et region.

  • Exemple : installation de Commerce avec stockage à distance

    code language-bash
    bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
  • Exemple : activer le stockage à distance sur Commerce existant

    code language-bash
    bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
TIP
Pour Adobe Commerce sur l’infrastructure cloud, voir Configuration de l’espace de stockage distant pour Commerce sur l’infrastructure cloud.

Migration de contenu

Après avoir activé le stockage à distance pour un adaptateur spécifique, vous pouvez utiliser l’interface de ligne de commande pour migrer les fichiers media existants vers le stockage à distance.

./magento2ce/bin/magento remote-storage:sync
INFO
La commande sync migre uniquement les fichiers du répertoire pub/media, et non les fichiers d'import/export dans le répertoire var. Voir Import/Export planifié dans le Guide de l’utilisateur de Commerce 2.4.
386822bd-e32c-40a8-81c2-ed90ad1e198c