DocumentazioneCommerceGuida di Commerce sul cloud

Solo PaaS

Struttura del progetto

Ultimo aggiornamento: 31 gennaio 2025
  • Argomenti:
  • Cloud

Creato per:

  • Amministratore
  • Sviluppatore

Un progetto Adobe Commerce su infrastruttura cloud include file essenziali per le credenziali e la configurazione dell’applicazione. Questi file sono disponibili in come modello in base alla versione di Adobe Commerce. Visualizzare i modelli cloud basati sulla versione di Adobe Commerce nell'archivio GitHub magento/magento-cloud.

Nella tabella seguente sono descritti i file inclusi in un progetto cloud:

FileDescrizione
/.magento/routes.yamlFile di configurazione che reindirizza www al dominio apex e applicazione php per il server HTTP. Vedere Configurare le route.
/.magento/services.yamlFile di configurazione che definisce un'istanza MySQL (MariaDB), Redis e OpenSearch o un Elasticsearch. Vedere Configurare i servizi.
/appLa cartella code è utilizzata per i moduli personalizzati. La cartella design è utilizzata per temi personalizzati. La cartella etc contiene i file di configurazione per l'applicazione.
/m2-hotfixesUtilizzato per patch personalizzate.
/updateCartella di servizio utilizzata dal modulo di supporto.
.gitignoreSpecificare quali file e directory ignorare. Vedi .gitignore riferimento.
.magento.app.yamlUn file di configurazione che definisce le proprietà per generare l’applicazione. Vedere Configurare l'applicazione.
.magento.env.yamlFile di configurazione per le fasi di build, distribuzione e post-distribuzione. Il pacchetto ece-tools include un esempio di questo file. Consulta Configurare gli ambienti.
composer.jsonRecupera Adobe Commerce e gli script di configurazione per preparare l’applicazione. Vedi Pacchetti richiesti.
composer.lockMemorizza le dipendenze di versione per ogni pacchetto. Vedi Pacchetti richiesti.
magento-vars.phpUtilizzato per definire più archivi e siti utilizzando variabili.
NOTE
Quando si inviano le modifiche locali al server remoto, lo script di distribuzione utilizza i valori definiti dai file di configurazione nella directory .magento, quindi lo script elimina la directory e il relativo contenuto. Questo non influisce sull’ambiente di sviluppo locale.

Directory radice dell'applicazione

La posizione della directory radice dell'applicazione dipende dall'ambiente.

  • Integrazione Starter e Pro: /app
  • Avvio produzione: /<project-ID>
  • Staging Pro: /<project-ID>_stg
  • Produzione Pro: /<project-ID>

Directory scrivibili

Gli ambienti remoti di integrazione, staging e produzione sono di sola lettura. Le directory seguenti sono solo directory scrivibili per motivi di sicurezza:

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
Negli ambienti di produzione e staging, ogni nodo nel cluster a tre nodi dispone di una directory /tmp non condivisa con gli altri nodi.

Ignora file

È presente un file .gitignore di base con l'archivio dei progetti di Adobe Commerce su infrastruttura cloud. Vedi il file .gitignore più recente nell'archivio cloud di magento. Per aggiungere un file incluso nell'elenco .gitignore, è possibile utilizzare l'opzione -f (forza) durante la gestione temporanea di un commit:

git add <path/filename> -f

Cambia modello base

Puoi utilizzare i seguenti passaggi per modificare la struttura di un progetto esistente in modo che rifletta il modello base più recente per Adobe Commerce sull’infrastruttura cloud.

  1. Clonare il progetto su una workstation locale.

  2. Aggiornare il file composer.json con i valori seguenti per la sezione extra.

    "extra": {
        "magento-force": true
        "magento-deploystrategy": "copy"
    }
    
  3. Aggiungi il file .gitignore progettato per il modello base. Ad esempio, se hai bisogno del file .gitignore per il modello versione 2.2.6, utilizza .gitignore per il file 2.2.6 come riferimento.

  4. Cancella la cache Git.

    git rm -r --cached .
    
  5. Aggiungere e confermare le modifiche.

    git add -A && git commit -m "Update base template"
    
WARNING
Il processo di distribuzione inizia quando si esegue un'unione, un push o una sincronizzazione dell'ambiente oppure quando si attiva una ridistribuzione manuale, durante la quale l'applicazione Commerce è in modalità manutenzione. Per un ambiente di produzione, Adobe consiglia di completare questo lavoro nelle ore non di punta per evitare interruzioni del servizio.
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938