[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."}

Détails techniques

Cette rubrique présente les détails techniques d’implémentation du déploiement de pipeline dans Commerce 2.2 et versions ultérieures. Les améliorations peuvent être divisées en plusieurs domaines :

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

Avant de commencer, passez en revue les Conditions préalables pour les systèmes de développement, de version et de production.

Gestion de la configuration

Pour vous permettre de synchroniser et de gérer la configuration de vos systèmes de développement et de production, utilisez le schéma 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 se trouver dans le contrôle de code source.

Définissez la configuration partagée dans Admin sur votre système de développement (ou Adobe Commerce sur l’infrastructure cloud intégration) et écrivez la configuration dans 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 ne doit pas se trouver dans le contrôle de code source.

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

Cette commande écrit également les paramètres sensibles dans 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’administration. En d’autres termes, ces paramètres ne peuvent pas être modifiés dans l’administration.
Utilisez la commande magento config:set ou magento config:set --lock pour modifier les paramètres des fichiers config.php ou env.php.

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 de pipeline pour gérer la configuration.

Système de développement

Sur votre système de développement, vous apportez des modifications à la configuration dans l’Administration 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 envoyez-le au 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.

Créer un système

Le système de build 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 ; seule la base de code Commerce est nécessaire.

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 de code source et définissez des paramètres de configuration sensibles et spécifiques au système à l’aide de la ligne de commande ou des variables d’environnement.

Sur votre système de production :

Commandes de gestion de la configuration

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

Exemples de gestion de la 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.

Modifier le paramètre régional par défaut

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

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

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

Modification de plusieurs paramètres de configuration

Cette section aborde la modification des configurations suivantes :

Une fois la modification effectuée dans l’administration, exécutez bin/magento app:config:dump sur votre système de développement. Cette fois, toutes vos modifications ne sont pas écrites dans config.php ; en fait, seuls le site web, le magasin et la vue du magasin sont écrits dans ce fichier, comme le montrent les fragments de code ci-dessous.

config.php

config.php contient :

Tableau websites :

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

Tableau groups :

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

Tableau stores :

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

Tableau payment :

      '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 de domaine d’e-mail est écrit dans 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 d’exploitation à 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>