DocumentazioneCommercePlaybook di implementazione

Solo PaaS

Best practice per l’implementazione di contenuti statici

Ultimo aggiornamento: 5 maggio 2025
  • Argomenti:
  • Best practice

Creato per:

  • Esperto
  • Sviluppatore

Questo articolo descrive le best practice per la distribuzione di contenuti statici (SCD) in Adobe Commerce per evitare problemi in cui il contenuto statico non sarebbe disponibile sul sito web.

Prodotti e versioni interessati

Tutte le versioni supportate di:

  • Adobe Commerce sull’infrastruttura cloud
  • Adobe Commerce on-premise

Best practice

Per evitare un problema relativo alla mancata disponibilità del contenuto statico sul sito web, segui le best practice seguenti per assicurarti che il contenuto statico sia configurato e distribuito correttamente:

  1. Assicurati di seguire le linee guida per la distribuzione:

    • Per Adobe Commerce on-premise (tutte le versioni), consulta Panoramica della distribuzione nella documentazione per gli sviluppatori.
    • Per Adobe Commerce sull'infrastruttura cloud (tutte le versioni), consulta Processo di distribuzione cloud e Strategie di distribuzione dei contenuti statici nella documentazione per gli sviluppatori.
  2. Per l’infrastruttura cloud di Adobe Commerce (tutte le versioni), assicurati che gli strumenti ece siano nella versione più recente. Consulta: Aggiorna versione strumenti ece nella documentazione per gli sviluppatori.

  3. Per l’infrastruttura cloud di Adobe Commerce (tutte le versioni), assicurati che il contenuto statico sia distribuito durante la fase di build anziché di distribuzione. Consulta: Gestione della configurazione per le impostazioni dello store - Prestazioni della distribuzione di contenuti statici nella documentazione per gli sviluppatori.

  4. Assicurati di non avere processi cron con tempi di esecuzione lunghi e di non terminare i processi cron con tempi di esecuzione lunghi. I processi cron a esecuzione prolungata possono richiedere risorse della CPU e potenzialmente aumentare notevolmente i tempi di distribuzione.

  5. Per Adobe Commerce on-premise (tutte le versioni), verificare che il processo php in CLI abbia accesso alla directory pub/static. In caso contrario, potrebbe verificarsi un problema che impedirebbe a una distribuzione di contenuto statico di scrivere file in tale directory. Per ulteriori informazioni: Autorizzazioni di accesso ai file system nella documentazione per gli sviluppatori.

  6. Verificare che la directory generated non sia una directory condivisa tra le build. In caso contrario, le build potrebbero non riuscire in modo casuale. Per ulteriori informazioni:

    • Adobe Commerce on-premise (tutte le versioni): Dettagli tecnici nella documentazione per gli sviluppatori.
    • Adobe Commerce su infrastruttura cloud (tutte le versioni): Processo di distribuzione - Fase 2: build nella documentazione per gli sviluppatori.
  7. Verifica la strategia SCD. La strategia quick è quella predefinita. Per ulteriori informazioni:

    • Adobe Commerce on-premise (tutte le versioni): Strategie di distribuzione di file statici nella documentazione per gli sviluppatori.
    • Adobe Commerce sull'infrastruttura cloud (tutte le versioni): Distribuire le variabili - SCD_STRATEGY nella documentazione per gli sviluppatori.

Informazioni aggiuntive

Nella documentazione per gli sviluppatori:

  • Contenitore contenuto statico
  • Firma contenuto statico
  • Distribuisci variabili - STATIC_CONTENT_SYMLINK
  • Flusso di distribuzione
  • Distribuzione senza tempi di inattività
  • Ottimizza distribuzione cloud
754cbbf3-3a3c-4af3-b6ce-9d34390f3a60