DocumentazioneCommerceGuida alla configurazione

Solo PaaS

Esempio di utilizzo di una configurazione condivisa

Ultimo aggiornamento: 15 luglio 2024
  • Argomenti:
  • Configurazione

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

In questo esempio viene illustrato come modificare le impostazioni seguenti nel sistema di sviluppo, aggiornare il file di configurazione condiviso config.php nel sistema di build e implementare le stesse impostazioni nel sistema di produzione:

  • Fuso orario
  • Unità di peso

Queste impostazioni sono disponibili nell'Admin in Archivi > Impostazioni > Configurazione > Generale > Generale.

È possibile utilizzare la stessa procedura per configurare qualsiasi impostazione non sensibile e non specifica del sistema nei seguenti riferimenti:

  • Altri percorsi di configurazione di riferimento
  • Riferimento ai percorsi di configurazione dei pagamenti
  • Riferimento ai percorsi di configurazione dell’estensione Commerce Enterprise B2B

Prima di iniziare

Prima di iniziare, configurare le autorizzazioni e la proprietà del file system come descritto in Prerequisiti per i sistemi di sviluppo, compilazione e produzione.

Presupposti

Questo argomento fornisce un esempio di modifica della configurazione del sistema di produzione. Se lo desideri, puoi scegliere diverse opzioni di configurazione.

Ai fini del presente esempio, si assume quanto segue:

  • Usa il controllo del codice sorgente Git
  • Il sistema di sviluppo è disponibile in un archivio remoto Git denominato mconfig
  • Il ramo di lavoro Git è denominato m2.2_deploy

Passaggio 1: impostare la configurazione nel sistema di sviluppo

Per impostare il fuso orario e le unità di peso nel sistema di sviluppo:

  1. Accedi all’amministratore.

  2. Fai clic su Archivi > Impostazioni > Configurazione > Generale > Generale.

  3. Nel riquadro di destra espandere Opzioni internazionali.

    Nella figura seguente viene illustrato un esempio.

    Impostare le opzioni delle impostazioni locali nel sistema di sviluppo

  4. Dall'elenco Fuso orario, fare clic su GMT+00:00 (UTC).

  5. Deselezionare la casella di controllo Usa valore di sistema accanto al campo Unità di peso.

  6. Nell'elenco Unità di peso fare clic su kg.

  7. Fai clic su Salva configurazione.

  8. Se richiesto, svuotare la cache.

Passaggio 2: aggiornare la configurazione condivisa

Generare il file di configurazione condiviso app/etc/config.php nel sistema di sviluppo e trasferirlo utilizzando il controllo del codice sorgente nel sistema di compilazione, come descritto in questa sezione.

Solo PaaS

Per aggiornare la configurazione:

  1. Accedi al sistema di sviluppo come proprietario del file system o passa a tale proprietario.

  2. Passare alla radice dell'applicazione ed eseguire il comando dump.

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

    Se ad esempio Commerce è installato in /var/www/html/magento2, immettere:

    cd /var/www/html/magento2
    php bin/magento app:config:dump
    
  3. Conferma che app/etc/config.php è stato aggiornato.

    git status
    

    Risposta di esempio:

    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
    non inviare le modifiche alle directory generated, pub/media o pub/static al controllo del codice sorgente. Puoi generare questi file sul sistema di build. Il sistema di sviluppo ha probabilmente codice, temi e così via, che non sono pronti per essere utilizzati nel sistema di produzione.
  4. Archivia le modifiche apportate a app/etc/config.php solo nel controllo del codice sorgente.

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

Passaggio 3: aggiornare il sistema di generazione e generare i file

Dopo aver confermato le modifiche apportate alla configurazione condivisa nel controllo del codice sorgente, è possibile richiamarle nel sistema di generazione, compilare il codice e generare file statici. L’ultimo passaggio consiste nel richiamare tali modifiche nel sistema di produzione. Di conseguenza, la configurazione del sistema di produzione corrisponderà a quella del sistema di sviluppo.

Solo PaaS

Per aggiornare il sistema di compilazione:

  1. Accedi al sistema di build come proprietario del file system.

  2. Passare alla directory radice dell'applicazione.

    cd <Magento root dir>
    
  3. Estrarre le modifiche a app/etc/config.php dal controllo del codice sorgente.

    git pull mconfig m2.2_deploy
    
  4. Compila il codice.

    bin/magento setup:di:compile
    
  5. Dopo la compilazione del codice, generare i file di visualizzazione statica.

    bin/magento setup:static-content:deploy -f
    
  6. Controllare le modifiche apportate al controllo del codice sorgente.

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

Passaggio 4: aggiornare il sistema di produzione

L’ultimo passaggio del processo consiste nell’aggiornare il sistema di produzione dal controllo del codice sorgente. In questo modo vengono richiamate tutte le modifiche apportate ai sistemi di sviluppo e creazione, il che significa che il sistema di produzione è completamente aggiornato.

Solo PaaS

Per aggiornare il sistema di produzione:

  1. Accedi al sistema di produzione come proprietario del file system.

  2. Passa alla directory principale dell’applicazione e abilita la modalità di manutenzione.

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

    Per ulteriori opzioni, ad esempio la possibilità di impostare un indirizzo IP nella whitelist, vedere magento maintenance:enable.

  3. Arrestare i processi di lavoro in esecuzione impostando cron_run su false in app/etc/env.php nel modo seguente:

    'cron_consumers_runner' => [
            'cron_run' => false
        ]
    
  4. Aggiorna la configurazione.

    bin/magento app:config:import
    
  5. Infine, kill qualsiasi processo consumer attivo.

    kill <PID>
    

    Dove PID è l'ID processo da terminare, ad esempio:

    kill 1234
    
  6. Estrarre il codice dal controllo del codice sorgente.

    git pull mconfig m2.2_deploy
    
  7. Aggiorna la configurazione.

    bin/magento app:config:import
    
  8. Pulire la cache.

    bin/magento cache:clean
    
  9. Termina modalità di manutenzione.

    bin/magento maintenance:disable
    

Verificare le modifiche in Admin

Per verificare che queste impostazioni non siano modificabili in Admin:

  1. Accedi all’amministratore.

  2. Fai clic su Archivi > Impostazioni > Configurazione > Generale > Generale.

  3. Nel riquadro di destra espandere Opzioni internazionali.

    Le opzioni appena impostate vengono visualizzate come segue:

    Opzioni di configurazione non modificabili nellamministratore

INFO
Per modificare un'impostazione bloccata nell'amministratore, utilizzare il comando magento config:set --lock.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c