Gestione configurazione archivio

Le configurazioni predefinite per l'archivio sono archiviate in config.xml per il modulo appropriato. Quando si modificano le impostazioni nel comando Commerce Admin o CLI bin/magento config:set, le modifiche vengono applicate al database di base, in particolare alla tabella core_config_data. Queste impostazioni sovrascrivono le configurazioni predefinite memorizzate nel file config.xml.

Le impostazioni dell'archivio, che fanno riferimento alle configurazioni nella sezione Archivi > Impostazioni > Configurazione dell'amministratore, vengono memorizzate nei file di configurazione della distribuzione in base al tipo di configurazione:

La gestione della configurazione consente di implementare impostazioni di archiviazione coerenti negli ambienti con tempi di inattività minimi tramite l’implementazione della pipeline. Il progetto Adobe Commerce on cloud infrastructure include il server di compilazione, gli script di compilazione e distribuzione e gli ambienti di distribuzione progettati tenendo presente la strategia di distribuzione della pipeline.

Schema di sostituzione configurazione

Tutte le configurazioni di sistema vengono impostate durante le fasi di generazione e distribuzione in base al seguente schema di sostituzione:

Per riepilogare, le variabili di ambiente sovrascrivono tutti gli altri valori.

Se la stessa impostazione è configurata in più posizioni, l’applicazione si basa sulla seguente gerarchia di configurazione per determinare quale valore applicare all’ambiente:

Immagine configurazione

È possibile utilizzare il comando ece-tools seguente per generare un file config.php contenente tutte le configurazioni dell'archivio correnti:

./vendor/bin/ece-tools config:dump

I dati "scaricati" nel file app/etc/config.php diventano bloccati, il che significa che il campo corrispondente nell'amministratore di Commerce diventa di sola lettura. Il file config.php include solo le impostazioni configurate. Non blocca i valori predefiniti. Il blocco solo dei valori aggiornati assicura inoltre che tutte le estensioni utilizzate negli ambienti di staging e produzione non si interrompano a causa di configurazioni di sola lettura, in particolare Fastly.

Dati sensibili

Tutte le configurazioni sensibili vengono esportate nel file app/etc/env.php quando si utilizza il comando bin/magento app:config:dump. È possibile impostare valori sensibili utilizzando il comando CLI: bin/magento config:sensitive:set. Consulta Impostazioni sensibili e specifiche dell'ambiente nella Guida delle estensioni Commerce PHP per scoprire come definire le impostazioni di configurazione sensibili o specifiche del sistema.

Vedere un elenco di impostazioni sensibili o specifiche del sistema nella Guida alla configurazione.

Prestazioni SCD

A seconda delle dimensioni dell’archivio, è possibile che sia presente un numero elevato di file di contenuto statico da distribuire. Normalmente, il contenuto statico viene distribuito durante la fase di distribuzione quando l’applicazione è in modalità Manutenzione. La configurazione ottimale consiste nel generare contenuto statico durante la fase di build. Vedere Scelta di una strategia di distribuzione.

Se dopo aver scaricato le configurazioni hai abilitato la gestione della configurazione, devi spostare le variabili SCD_* dalla fase di distribuzione alla fase di build per abilitare correttamente la generazione di contenuto statico durante la fase di build. Vedi Variabili di ambiente.

Prima della gestione della configurazione:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...
    REDIS_USE_SLAVE_CONNECTION: 1

Dopo aver abilitato Gestione configurazione:

Sposta le variabili SCD_* nella fase di build:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    REDIS_USE_SLAVE_CONNECTION: 1
  build:
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...

Procedura per gestire le impostazioni

Di seguito viene illustrata una panoramica di alto livello di questo processo:

Per configurare l'archivio e generare un file di configurazione:

Al termine della distribuzione, accedi all’amministratore dell’ambiente aggiornato per verificare le impostazioni. Continua a unire eventuali configurazioni aggiuntive agli ambienti di staging e produzione, in base alle esigenze.

Aggiorna configurazioni

Quando modifichi l'ambiente tramite l'amministratore ed esegui nuovamente il comando, le nuove configurazioni vengono aggiunte al codice nel file config.php.

Ripristina file di configurazione

Copie dei file app/etc/env.php e app/etc/config.php originali sono state create durante il processo di distribuzione e archiviate nella stessa cartella. Di seguito sono riportati i file BAK (backup file) e PHP (file originali) nella stessa cartella app/etc:

...
config.php.bak
di.xml
env.php.bak
vendor_path.php
config.php
db_schema.xml
env.php
...

Le configurazioni meno recenti utilizzavano il file app/etc/config.local.php. Consulta Eseguire la migrazione di configurazioni precedenti.

Per ripristinare i file di configurazione:

Migra configurazioni meno recenti

Se si esegue l'aggiornamento ad Adobe Commerce su infrastruttura cloud 2.2 o versione successiva, è possibile migrare le impostazioni dal file config.local.php al nuovo file config.php. Se le impostazioni di configurazione dell'amministratore corrispondono al contenuto del file, seguire le istruzioni per generare e aggiungere il file config.php.

In caso di differenze, è possibile aggiungere il contenuto del file config.local.php al nuovo file config.php:

Puoi completare questa migrazione solo una volta. Dopo la migrazione, utilizzare il file config.php.

Cambia impostazioni internazionali

È possibile modificare le impostazioni internazionali dell'archivio senza seguire un processo di importazione ed esportazione di configurazione complesso, se hai abilitato SCD_ON_DEMAND. Puoi aggiornare le impostazioni internazionali utilizzando l’amministratore.

È possibile aggiungere un'altra lingua all'ambiente di staging o produzione abilitando SCD_ON_DEMAND in un ramo di integrazione, generare un file config.php aggiornato con le nuove informazioni sulle impostazioni internazionali e copiare il file di configurazione nell'ambiente di destinazione.