DocumentazioneCommerceGuida di Commerce sul cloud

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Struttura del progetto

Last update: Fri Jan 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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:

File
Descrizione
/.magento/routes.yaml
File di configurazione che reindirizza www al dominio apex e applicazione php per il server HTTP. Vedere Configurare le route.
/.magento/services.yaml
File di configurazione che definisce un'istanza MySQL (MariaDB), Redis e OpenSearch o un Elasticsearch. Vedere Configurare i servizi.
/app
La 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-hotfixes
Utilizzato per patch personalizzate.
/update
Cartella di servizio utilizzata dal modulo di supporto.
.gitignore
Specificare quali file e directory ignorare. Vedi .gitignore riferimento.
.magento.app.yaml
Un file di configurazione che definisce le proprietà per generare l’applicazione. Vedere Configurare l'applicazione.
.magento.env.yaml
File 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.json
Recupera Adobe Commerce e gli script di configurazione per preparare l’applicazione. Vedi Pacchetti richiesti.
composer.lock
Memorizza le dipendenze di versione per ogni pacchetto. Vedi Pacchetti richiesti.
magento-vars.php
Utilizzato 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.

    code language-json 
    "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.

    code language-bash 
    git rm -r --cached .

  5. Aggiungere e confermare le modifiche.

    code language-bash 
    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