DocumentationCommerceGuide de configuration

PaaS uniquement

Exemple d'utilisation d'une configuration partagée

Dernière mise à jour : 15 juillet 2024
  • Rubriques :
  • Configuration

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Cet exemple montre comment modifier les paramètres suivants de votre système de développement, mettre à jour le fichier de configuration partagé config.php dans votre système de génération et mettre en oeuvre les mêmes paramètres dans votre système de production :

  • Fuseau horaire
  • Unité de poids

Ces paramètres sont disponibles dans l’administrateur de Magasins > Paramètres > Configuration > Général > Général.

Vous pouvez suivre la même procédure pour configurer des paramètres qui ne sont pas sensibles et qui ne sont pas spécifiques au système dans les références suivantes :

  • Autres références de chemins de configuration
  • Référence des chemins de configuration des paiements
  • Référence sur les chemins de configuration de l’extension Commerce Enterprise B2B

Avant de commencer

Avant de commencer, configurez les autorisations et la propriété du système de fichiers comme décrit dans la section Conditions préalables pour le développement, la création et les systèmes de production.

Hypothèses

Cette rubrique fournit un exemple de modification de la configuration du système de production. Si vous le souhaitez, vous pouvez choisir différentes options de configuration.

Pour les besoins de cet exemple, nous supposons que :

  • Vous utilisez le contrôle source Git
  • Le système de développement est disponible dans un référentiel distant Git nommé mconfig
  • Votre branche de travail Git est nommée m2.2_deploy

Étape 1 : définir la configuration dans le système de développement

Pour définir le fuseau horaire et les unités de poids dans votre système de développement :

  1. Connectez-vous à l’administrateur.

  2. Cliquez sur Magasins > Paramètres > Configuration > Général > Général.

  3. Dans le volet de droite, développez Options de paramètres régionaux.

    La figure suivante illustre un exemple.

    Définir les options de paramètres régionaux dans le système de développement

  4. Dans la liste Fuseau horaire, cliquez sur GMT+00:00 (UTC).

  5. Décochez la case Utiliser la valeur système en regard du champ Unité de poids.

  6. Dans la liste Unité de poids, cliquez sur kgs.

  7. Cliquez sur Enregistrer la configuration.

  8. Si vous y êtes invité, videz le cache.

Étape 2 : mise à jour de la configuration partagée

Générez le fichier de configuration partagé, app/etc/config.php, dans votre système de développement et transférez-le à l’aide du contrôle de code source vers votre système de génération, comme indiqué dans cette section.

PaaS uniquement

Pour mettre à jour la configuration :

  1. Connectez-vous à votre système de développement en tant que propriétaire du système de fichiers ou passez à .

  2. Modifiez la racine de l’application et exécutez la commande dump .

    cd <Magento root dir>
    php bin/magento app:config:dump
    

    Par exemple, si Commerce est installé dans /var/www/html/magento2, saisissez :

    cd /var/www/html/magento2
    php bin/magento app:config:dump
    
  3. Vérifiez que app/etc/config.php a été mis à jour.

    git status
    

    Exemple de réponse :

    On branch m2.2_deploy
    Changed but not updated:
      (use "git add <file>..." to update what will be committed)
      (use "git checkout -- <file>..." to discard changes in working directory)
           modified:   app/etc/config.php
    
    WARNING
    N’envoyez pas les modifications apportées aux répertoires generated, pub/media ou pub/static vers le contrôle source. Vous générez ces fichiers sur votre système de génération. Le système de développement comporte probablement du code, des thèmes, etc., qui ne sont pas prêts à être utilisés dans le système de production.
  4. Enregistrez vos modifications sur app/etc/config.php uniquement pour le contrôle de code source.

    git add app/etc/config.php && git commit -m "Updated shared configuration" && git push mconfig m2.2_deploy
    

Étape 3 : Mettre à jour votre système de génération et générer des fichiers

Maintenant que vous avez validé vos modifications dans la configuration partagée pour le contrôle de code source, vous pouvez extraire ces modifications dans votre système de création, compiler du code et générer des fichiers statiques. La dernière étape consiste à extraire ces modifications dans votre système de production. Par conséquent, la configuration de votre système de production correspond à votre système de développement.

PaaS uniquement

Pour mettre à jour le système de génération :

  1. Connectez-vous au système de génération en tant que propriétaire du système de fichiers.

  2. Modifiez le répertoire racine de l’application.

    cd <Magento root dir>
    
  3. Extrayez les modifications vers app/etc/config.php à partir du contrôle source.

    git pull mconfig m2.2_deploy
    
  4. Compilez du code.

    bin/magento setup:di:compile
    
  5. Une fois le code compilé, générez des fichiers d’affichage statiques.

    bin/magento setup:static-content:deploy -f
    
  6. Vérifiez les modifications dans le contrôle de code source.

    git add -A && git commit -m "Updated files on build system" && git push mconfig m2.2_deploy
    

Étape 4 : mise à jour du système de production

La dernière étape du processus consiste à mettre à jour votre système de production à partir du contrôle source. Cela récupère toutes les modifications que vous avez apportées à vos systèmes de développement et de création, ce qui signifie que votre système de production est entièrement à jour.

PaaS uniquement

Pour mettre à jour le système de production :

  1. Connectez-vous au système de production en tant que propriétaire du système de fichiers.

  2. Passez à la racine de l’application et activez le mode de maintenance.

    cd <Magento root dir>
    
    bin/magento maintenance:enable
    

    Pour obtenir des options supplémentaires, telles que la possibilité de définir une liste blanche des adresses IP, voir magento maintenance:enable.

  3. Arrêtez tous les programmes de travail de file d’attente en cours d’exécution en définissant cron_run sur false dans app/etc/env.php comme suit :

    'cron_consumers_runner' => [
            'cron_run' => false
        ]
    
  4. Mettez à jour la configuration.

    bin/magento app:config:import
    
  5. Enfin, kill tout processus client actif.

    kill <PID>
    

    Où PID est l’ID de processus à supprimer, par exemple :

    kill 1234
    
  6. Extrayez le code du contrôle source.

    git pull mconfig m2.2_deploy
    
  7. Mettez à jour la configuration.

    bin/magento app:config:import
    
  8. Nettoyez le cache.

    bin/magento cache:clean
    
  9. Mode de maintenance de fin.

    bin/magento maintenance:disable
    

Vérification des modifications dans l’administrateur

Pour vérifier que ces paramètres ne sont pas modifiables dans l’Admin :

  1. Connectez-vous à l’administrateur.

  2. Cliquez sur Magasins > Paramètres > Configuration > Général > Général.

  3. Dans le volet de droite, développez Options de paramètres régionaux.

    Les options que vous venez de définir s’affichent comme suit :

    Options de configuration non modifiables dans l’Admin

INFO
Pour modifier un paramètre verrouillé dans l’administrateur, utilisez la commande magento config:set --lock.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c