Dettagli tecnici

Questo argomento illustra i dettagli tecnici dell’implementazione della pipeline in Commerce 2.2 e versioni successive. I miglioramenti possono essere suddivisi nelle seguenti aree:

In questo argomento viene inoltre illustrato il flusso di lavoro consigliato per la distribuzione della pipeline e vengono forniti alcuni esempi per comprendere il funzionamento.

Prima di iniziare, controlla i Prerequisiti per i sistemi di sviluppo, generazione e produzione.

Gestione della configurazione

Per consentire la sincronizzazione e la gestione della configurazione dei sistemi di sviluppo e produzione, utilizzare il seguente schema di sostituzione.

Come illustrato nel diagramma, i valori di configurazione vengono utilizzati nell'ordine seguente:

Gestire la configurazione condivisa

La configurazione condivisa è archiviata in app/etc/config.php, che deve trovarsi nel controllo del codice sorgente.

Imposta la configurazione condivisa nell'Admin nel tuo sistema di sviluppo (o Adobe Commerce sull'infrastruttura cloud integrazione) e scrivi la configurazione in config.php utilizzando il comando magento app:config:dump.

Gestire la configurazione specifica del sistema

La configurazione specifica del sistema è archiviata in app/etc/env.php, che dovrebbe non essere nel controllo del codice sorgente.

Imposta la configurazione specifica del sistema nell'Admin nel tuo sistema di sviluppo (o Adobe Commerce sull'integrazione dell'infrastruttura cloud) e scrivi la configurazione su env.php utilizzando il comando magento app:config:dump.

Questo comando scrive anche le impostazioni sensibili in env.php.

Gestire la configurazione sensibile

La configurazione sensibile è archiviata anche in app/etc/env.php.

Puoi gestire la configurazione sensibile in uno dei seguenti modi:

Impostazioni di configurazione bloccate in Amministrazione

Tutte le impostazioni di configurazione in config.php o env.php sono bloccate nell'amministratore, ovvero non possono essere modificate nell'amministratore.
Utilizzare il comando magento config:set o magento config:set --lock per modificare le impostazioni nei file config.php o env.php.

L’Amministratore Commerce

Durante la modalità di produzione, l’amministratore mostra il seguente comportamento:

Installare e rimuovere cron

Nella versione 2.2, per la prima volta, ti aiutiamo a configurare il processo cron fornendo il comando magento cron:install. Questo comando imposta una scheda cronologica come utente che esegue il comando.

È inoltre possibile rimuovere la scheda cronologica utilizzando il comando magento cron:remove.

Flusso di lavoro di distribuzione della pipeline consigliato

Il diagramma seguente mostra come si consiglia di utilizzare la distribuzione della pipeline per gestire la configurazione.

Sistema di sviluppo

Nel sistema di sviluppo, è possibile apportare modifiche alla configurazione nell'amministratore e generare la configurazione condivisa, app/etc/config.php e la configurazione specifica del sistema, app/etc/env.php. Controlla il codice Commerce e la configurazione condivisa nel controllo del codice sorgente e inviala al server di build.

Devi anche installare le estensioni e personalizzare il codice Commerce sul sistema di sviluppo.

Sul sistema di sviluppo:

Dopo aver eseguito i comandi per cancellare le risorse, Commerce genera i file di lavoro.

Genera sistema

Il sistema di build compila il codice e genera file di visualizzazione statica per i temi registrati in Commerce. Non è necessaria una connessione al database di Commerce, ma solo la base di codice Commerce.

Sul sistema di build:

Sistema di produzione

Nel sistema di produzione (ovvero nel tuo archivio live), puoi estrarre le risorse generate e gli aggiornamenti del codice dal controllo del codice sorgente e impostare impostazioni di configurazione specifiche del sistema e sensibili utilizzando la riga di comando o le variabili di ambiente.

Sul sistema di produzione:

Comandi di gestione della configurazione

Per facilitare la gestione della configurazione, vengono forniti i seguenti comandi:

Esempi di gestione della configurazione

In questa sezione vengono illustrati alcuni esempi di gestione della configurazione che consentono di visualizzare le modifiche apportate a config.php e env.php.

Modificare le impostazioni internazionali predefinite

In questa sezione viene illustrata la modifica apportata a config.php quando si modifica l'unità di misura predefinita utilizzando l'Admin (Stores > Settings > Configuration > General > General > Locale Options).

Dopo aver apportato la modifica in Admin, eseguire bin/magento app:config:dump per scrivere il valore in config.php. Il valore viene scritto nell'array general in locale, come mostra il seguente snippet da config.php:

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

Modificare diverse impostazioni di configurazione

Questa sezione descrive come apportare le seguenti modifiche alla configurazione:

Dopo aver apportato la modifica in Admin, esegui bin/magento app:config:dump sul tuo sistema di sviluppo. Questa volta non tutte le modifiche sono state scritte in config.php. In effetti, solo le visualizzazioni del sito Web, dello store e dello store vengono scritte nel file come mostrato nei frammenti seguenti.

config.php

config.php contiene:

Array websites:

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

Array groups:

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

Array stores:

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

Array 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

L'impostazione di configurazione predefinita specifica per il sistema del dominio e-mail è scritta in app/etc/env.php.

Le impostazioni PayPal non vengono scritte in nessun file perché il comando bin/magento app:config:dump non scrive impostazioni sensibili. È necessario impostare le impostazioni PayPal sul sistema di produzione utilizzando i seguenti comandi:

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

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