Configuration du stockage à distance pour Commerce sur l’infrastructure cloud

À partir du package ece-tools 2002.1.5, vous pouvez utiliser une variable d’environnement pour activer le module de stockage distant. Cependant, le module de stockage distant a une prise en charge limitée 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.

Variable d’environnement

La variable REMOTE_STORAGE est utilisée pendant la phase de déploiement d’un projet d’infrastructure cloud.

REMOTE_STORAGE

Configurez un adaptateur de stockage pour stocker les fichiers multimédia dans un conteneur de stockage distant persistant à l’aide d’un service de stockage, tel qu’AWS S3. Activez le module Stockage distant afin d’améliorer les performances sur les projets Cloud avec des configurations multi-serveurs complexes qui doivent partager des ressources. Voici un exemple de configuration de stockage à distance à l’aide du fichier .magento.env.yaml :

stage:
  deploy:
    REMOTE_STORAGE:
      driver: aws-s3 # Required
      prefix: cloud # Optional
      config:
        bucket: my-bucket # Required
        region: my-region # Required
        key: my-key # Optional
        secret: my-secret-key # Optional

Définition de la variable avec l’interface de ligne de commande de Cloud

Définissez la variable REMOTE_STORAGE en tant que variable de niveau environnementde sorte que les fichiers ne soient pas partagés entre les environnements de production, d’évaluation et d’intégration. La définition des variables au niveau de l’environnement offre la possibilité de n’utiliser que le stockage à distance dans certains environnements, comme exclure l’utilisation de l’environnement d’intégration du stockage à distance.

Pour ajouter la variable de stockage distant à l’aide de l’interface de ligne de commande de Cloud :

magento-cloud variable:create --level environment --name REMOTE_STORAGE --json true --inheritable false --value '{"driver":"aws-s3","prefix":"uat","config":{"bucket":"aws-bucket-id","region":"eu-west-1","key":"optional-key","secret":"optional-secret"}}'

Cela crée une variable REMOTE_STORAGE avec la configuration JSON spécifiée. La variable REMOTE_STORAGE utilise une chaîne JSON pour configurer le stockage à distance. Voici un exemple de configuration JSON :

{
  "driver": "aws-s3",
  "prefix": "uat",
  "config": {
    "bucket": "aws-bucket-id",
    "region": "aws-region-id",
    "key": "optional-key",
    "secret": "optional-secret"
  }
}

Une fois la configuration et le déploiement créés, les journaux de déploiement doivent inclure des informations sur la configuration du stockage distant, par exemple INFO: Remote storage driver set to: "aws-s3".

Définir la variable avec l’interface web du projet

Vous pouvez également utiliser l’interface web du projet pour ajouter la variable à l’environnement approprié.

Pour ajouter la variable de stockage distant à l’aide de l’interface web du projet :

Utilisation de l’authentification facultative

key et secret sont facultatifs. Lorsque vous créez la variable, vous pouvez masquer les key et secret en sélectionnant l’option sensitive . Avec ce paramètre, les valeurs ne sont pas visibles dans l’interface web. Voir Visibilité des variables dans le guide Commerce on Cloud Infrastructure.

Si vous souhaitez utiliser une autre méthode d’authentification, omettez les key et secret de la configuration JSON. Configurez la méthode d’authentification alternative et vérifiez que le serveur est autorisé à utiliser le compartiment S3.

Synchronisation de l’espace de stockage distant

Après avoir activé le module de stockage distant, synchronisez les fichiers multimédias actuels avec l’emplacement de magasin distant.

Pour démarrer la synchronisation :

bin/magento remote-storage:sync

Configuration rapide

Si vous choisissez d’utiliser la solution de stockage distant avec un projet d’infrastructure cloud Adobe Commerce, utilisez les instructions Amazon S3 de la documentation Fastly afin de vous assurer que l’optimisation des images Fastly fonctionne avec AWS S3.

Préparez-vous à utiliser vos informations d’identification Fastly. Sur les projets Pro, utilisez SSH pour vous connecter à votre serveur et obtenir les informations d’identification rapides à partir du fichier /mnt/shared/fastly_tokens.txt. Les environnements d’évaluation et de production disposent d’informations d’identification uniques. Vous devez obtenir les informations d’identification pour chaque environnement.

Continuez à configurer l’espace de stockage distant pour les projets cloud avec les tâches suivantes :