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 à distance, vous pouvez stocker les fichiers multimédias dans le pub/media et importer/exporter des fichiers dans var du répertoire de stockage d’objets distants pour tirer parti du redimensionnement d’image côté serveur.

INFO
Le stockage à distance est disponible uniquement pour Commerce version 2.4.2 et ultérieure. Voir Notes de mise à jour 2.4.2.
INFO
Le module de stockage à distance dispose des limité prise en charge sur Adobe Commerce sur l’infrastructure cloud. Adobe ne peut pas résoudre entièrement les problèmes liés au service d’adaptateur de stockage tiers. Voir Configuration du stockage à distance pour l’infrastructure Commerce on Cloud pour obtenir des conseils sur l’implémentation du stockage à distance pour les projets cloud.

image de schéma

Options de stockage distant

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

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

La variable 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 :
fichier: désactive le stockage distant et utilise le système de fichiers local.
aws-s3: utilisez la variable Amazon Simple Storage Service (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. A adaptateur de stockage vous permet de vous connecter à un service de stockage et de stocker vos fichiers n’importe où. 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 remote-storage paramètres avec Commerce setup Commandes de l’interface de ligne de commande. 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 le 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 du stockage à distance pour l’infrastructure Commerce on Cloud.

Limites

Le stockage à distance et le stockage dans la base de données ne peuvent pas être activés simultanément. Désactivez le stockage dans la base de données si vous utilisez 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 référentiel magento-coding-standard.

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 media vers le stockage distant.

./magento2ce/bin/magento remote-storage:sync
INFO
La commande sync migre uniquement les fichiers dans la variable pub/media répertoire, not les fichiers d’importation/exportation dans la variable var répertoire . Voir Importation/exportation planifiée dans le Guide de l’utilisateur de Commerce 2.4.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c