[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Configuration du stockage distant pour Commerce sur les infrastructures cloud

À partir du package ece-tools 2002.1.5, vous pouvez utiliser une variable d’environnement pour activer le module de stockage distant ; toutefois, le module de stockage distant offre une prise en charge limitée d’Adobe Commerce sur les infrastructures cloud. Adobe ne peut pas résoudre entièrement les problèmes liés au service de carte 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édias dans un conteneur de stockage distant persistant à l’aide d’un service de stockage tel qu’AWS S3. Activez le module de stockage à distance pour améliorer les performances des projets cloud avec des configurations multi-serveurs complexes qui doivent partager des ressources. Voici un exemple de configuration de stockage distant à 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 d’une variable avec l’interface de ligne de commande Cloud

Définissez la variable REMOTE_STORAGE en tant que variable au niveau de l’environnement de 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é d’utiliser uniquement le stockage distant sur certains environnements, par exemple en excluant l’utilisation du stockage distant dans l’environnement d’intégration.

Pour ajouter la variable de stockage distant à l’aide de l’interface de ligne de commande 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 prend une chaîne JSON pour configurer le stockage distant. 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 une variable avec l’interface web de Project

Vous pouvez également utiliser l'interface Web de Project pour ajouter la variable à l'environnement approprié.

Pour ajouter la variable de stockage distant à l'aide de l'interface Web de Project :

Utiliser l’authentification facultative

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

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é dans le compartiment S3.

Synchroniser le stockage distant

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

Pour démarrer la synchronisation :

bin/magento remote-storage:sync

Configuration Fastly

Si vous choisissez d’utiliser la solution de stockage à distance avec un projet d’infrastructure cloud Adobe Commerce, suivez les conseils de Amazon S3 dans la documentation Fastly pour 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 Fastly à 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 le stockage distant pour les projets cloud avec les tâches suivantes :