Détails techniques

Cette rubrique aborde les détails techniques de mise en oeuvre du déploiement du pipeline dans Commerce 2.2 et versions ultérieures. Les améliorations peuvent être réparties dans les domaines suivants :

Cette rubrique traite également du workflow recommandé pour le déploiement du pipeline et fournit quelques exemples pour vous aider à comprendre son fonctionnement.

Avant de commencer, consultez les Conditions préalables requises pour votre développement, création et systèmes de production.

Gestion des configurations

Pour vous permettre de synchroniser et de gérer la configuration de vos systèmes de développement et de production, utilisez le modèle de remplacement suivant.

Comme le montre le diagramme, les valeurs de configuration sont utilisées dans l'ordre suivant :

Gestion de la configuration partagée

La configuration partagée est stockée dans app/etc/config.php, qui doit être dans le contrôle de code source.

Définissez la configuration partagée dans le système Admin de votre développement (ou Adobe Commerce sur l’infrastructure cloud integration) et écrivez la configuration sur config.php à l’aide de la commande magento app:config:dump.

Gestion de la configuration spécifique au système

La configuration spécifique au système est stockée dans app/etc/env.php, qui doit et non être dans le contrôle source.

Définissez la configuration spécifique au système dans l’administrateur de votre système de développement (ou d’intégration d’Adobe Commerce sur l’infrastructure cloud) et écrivez la configuration sur env.php à l’aide de la commande magento app:config:dump.

Cette commande écrit également des paramètres sensibles sur env.php.

Gestion de la configuration sensible

La configuration sensible est également stockée dans app/etc/env.php.

Vous pouvez gérer la configuration sensible de l'une des manières suivantes :

Paramètres de configuration verrouillés dans l’administrateur

Tous les paramètres de configuration de config.php ou env.php sont verrouillés dans l’administrateur ; c’est-à-dire que ces paramètres ne peuvent pas être modifiés dans l’administrateur.
Utilisez la commande magento config:set ou magento config:set --lock pour modifier les paramètres des fichiers config.php ou env.php.

L’administrateur Commerce

L’administrateur présente le comportement suivant en mode de production :

Installation et suppression de cron

Dans la version 2.2 pour la première fois, nous vous aidons à configurer votre tâche cron en fournissant la commande magento cron:install. Cette commande configure un crontab en tant qu’utilisateur exécutant la commande.

Vous pouvez également supprimer crontab à l’aide de la commande magento cron:remove.

Workflow de déploiement de pipeline recommandé

Le diagramme suivant montre comment nous vous recommandons d’utiliser le déploiement du pipeline pour gérer la configuration.

Système de développement

Sur votre système de développement, vous effectuez des modifications de configuration dans l’administrateur et générez la configuration partagée, app/etc/config.php et la configuration spécifique au système, app/etc/env.php. Vérifiez le code Commerce et la configuration partagée dans le contrôle de code source et poussez-le vers le serveur de génération.

Vous devez également installer des extensions et personnaliser le code Commerce sur le système de développement.

Sur votre système de développement :

Après avoir exécuté les commandes pour effacer les ressources, Commerce génère des fichiers de travail.

Système de création

Le système de génération compile le code et génère des fichiers d’affichage statiques pour les thèmes enregistrés dans Commerce. Il n’a pas besoin d’une connexion à la base de données Commerce ; il n’a besoin que du code base Commerce.

Sur votre système de génération :

Système de production

Sur votre système de production (c’est-à-dire votre boutique en ligne), vous extrayez les ressources générées et les mises à jour de code du contrôle source, et définissez des paramètres de configuration spécifiques au système et sensibles à l’aide de la ligne de commande ou des variables d’environnement.

Sur votre système de production :

Commandes de gestion des configurations

Nous fournissons les commandes suivantes pour vous aider à gérer la configuration :

Exemples de gestion de configuration

Cette section présente des exemples de gestion de la configuration afin que vous puissiez voir comment les modifications sont apportées à config.php et env.php.

Modification des paramètres régionaux par défaut

Cette section présente la modification apportée à config.php lorsque vous modifiez l’unité de poids par défaut à l’aide de l’option Admin (Magasins > Paramètres > Configuration > Général > Général > Options de paramètres régionaux).

Après avoir apporté la modification à l’administrateur, exécutez bin/magento app:config:dump pour écrire la valeur sur config.php. La valeur est écrite dans le tableau general sous locale comme le montre le fragment de code suivant de config.php :

'general' =>
    array (
        'locale' =>
        array (
            'code' => 'en_US',
            'timezone' => 'America/Chicago',
            'weight_unit' => 'kgs'
        )
    )

Modification de plusieurs paramètres de configuration

Cette section explique comment effectuer les modifications de configuration suivantes :

Après avoir apporté la modification à l’administrateur, exécutez bin/magento app:config:dump sur votre système de développement. Cette fois-ci, toutes vos modifications ne sont pas écrites sur config.php ; en fait, seules la vue de site web, de magasin et de magasin sont écrites dans ce fichier comme le montrent les fragments suivants.

config.php

config.php contient :

websites array :

      'new' =>
      array (
        'website_id' => '2',
        'code' => 'new',
        'name' => 'New website',
        'sort_order' => '0',
        'default_group_id' => '2',
        'is_default' => '0',
      ),

groups array :

      2 =>
      array (
        'group_id' => '2',
        'website_id' => '2',
        'code' => 'newstore',
        'name' => 'New store',
        'root_category_id' => '2',
        'default_store_id' => '2',
      ),

stores array :

     'newview' =>
      array (
        'store_id' => '2',
        'code' => 'newview',
        'website_id' => '2',
        'group_id' => '2',
        'name' => 'New store view',
        'sort_order' => '0',
        'is_active' => '1',
      ),

payment array :

      'payment' =>
      array (
        'paypal_express' =>
        array (
          'active' => '0',
          'in_context' => '0',
          'title' => 'PayPal Express Checkout',
          'sort_order' => NULL,
          'payment_action' => 'Authorization',
          'visible_on_product' => '1',
          'visible_on_cart' => '1',
          'allowspecific' => '0',
          'verify_peer' => '1',
          'line_items_enabled' => '1',
          'transfer_shipping_options' => '0',
          'solution_type' => 'Mark',
          'require_billing_address' => '0',
          'allow_ba_signup' => 'never',
          'skip_order_review_step' => '1',
        ),

env.php

Le paramètre de configuration par défaut spécifique au système du domaine de messagerie est écrit sur app/etc/env.php.

Les paramètres PayPal ne sont écrits dans aucun fichier, car la commande bin/magento app:config:dump n’écrit pas de paramètres sensibles. Vous devez définir les paramètres PayPal sur le système de production à l’aide des commandes suivantes :

bin/magento config:sensitive:set paypal/wpp/api_username <username>

bin/magento config:sensitive:set paypal/wpp/api_password <password>