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

Configura archiviazione remota

Il modulo Archiviazione remota consente di memorizzare i file multimediali e pianificare le importazioni e le esportazioni in un contenitore di archiviazione remota persistente utilizzando un servizio di archiviazione, ad esempio AWS S3.

Per impostazione predefinita, l'applicazione Adobe Commerce memorizza i file multimediali nello stesso file system che contiene l'applicazione. Ciò è inefficiente per configurazioni complesse e con più server e può comportare un peggioramento delle prestazioni durante la condivisione delle risorse. Con il modulo Archiviazione remota è possibile archiviare i file multimediali nella directory pub/media e importare/esportare i file nella directory var dell'archivio oggetti remoto per sfruttare il ridimensionamento delle immagini lato server.

recommendation-more-help

Non è possibile abilitare contemporaneamente l'archiviazione del database e nell'archiviazione remota. È necessario disabilitare l'archiviazione del database prima di abilitare l'archiviazione remota.

bin/magento config:set system/media_storage_configuration/media_database 0

L'abilitazione dell'archiviazione remota potrebbe influire sull'esperienza di sviluppo consolidata. Ad esempio, alcune funzioni dei file PHP potrebbero non funzionare come previsto. È necessario applicare l'utilizzo di Commerce Framework per le operazioni sui file. L'elenco delle funzioni native PHP non consentite è disponibile nell'archivio magento-coding-standard.

INFO
  • L’archiviazione remota è disponibile solo per Commerce versione 2.4.2 e successive. Consulta le 2.4.2 note sulla versione.

  • Il modulo di archiviazione remota dispone del supporto limitato su Adobe Commerce nell'infrastruttura cloud. Adobe non è in grado di risolvere completamente i problemi relativi al servizio adattatore di archiviazione di terze parti. Consulta Configurare l'archiviazione remota per Commerce sull'infrastruttura cloud per informazioni sull'implementazione dell'archiviazione remota per i progetti cloud.

Diagramma dello schema di configurazione dellarchiviazione remota che illustra la relazione tra larchiviazione locale e quella cloud

Opzioni di archiviazione remota

È possibile configurare l'archiviazione remota utilizzando l'opzione remote-storage con il comando CLI setup. L'opzione remote-storage utilizza la sintassi seguente:

--remote-storage-<parameter-name>="<parameter-value>"

parameter-name fa riferimento al nome del parametro specifico dell'archiviazione remota. Nella tabella seguente sono elencati i parametri disponibili per la configurazione dell'archiviazione remota:

Parametro della riga di comando
Nome parametro
Descrizione
Valore predefinito
remote-storage-driver
driver
Nome scheda
Valori possibili:
file: disabilita l'archiviazione remota e utilizza il file system locale
aws-s3: utilizza il servizio Amazon Simple Storage (Amazon S3)
nessuno
remote-storage-bucket
bucket
Archiviazione oggetto o nome contenitore
nessuno
remote-storage-prefix
prefisso
Prefisso facoltativo (posizione all'interno dell'archivio oggetti)
vuoto
remote-storage-region
area geografica
Nome regione
nessuno
remote-storage-key
chiave di accesso
Chiave di accesso opzionale
vuoto
remote-storage-secret
chiave segreta
Chiave segreta opzionale
vuoto

Adattatori di storage

Il percorso di archiviazione predefinito si trova nel file system locale. Un adattatore di archiviazione consente di connettersi a un servizio di archiviazione e di archiviare i file ovunque. Commerce supporta la configurazione dei seguenti servizi di archiviazione:

Abilita archiviazione remota

È possibile installare lo storage remoto durante un'installazione di Adobe Commerce o aggiungere lo storage remoto a un'istanza di Commerce esistente. Gli esempi seguenti illustrano ogni metodo utilizzando un set di parametri remote-storage con comandi CLI di Commerce setup. È necessario fornire almeno lo spazio di archiviazione driver, bucket e region.

  • Esempio: installare Commerce con l’archiviazione remota

    code language-bash
    bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
  • Esempio: abilitare l'archiviazione remota su Commerce esistente

    code language-bash
    bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
TIP
Per Adobe Commerce sull'infrastruttura cloud, vedere Configurare l'archiviazione remota per Commerce sull'infrastruttura cloud.

Migrare i contenuti

Dopo aver abilitato l'archiviazione remota per una scheda specifica, è possibile utilizzare CLI per migrare i file media esistenti nell'archiviazione remota.

./magento2ce/bin/magento remote-storage:sync
INFO
Il comando sync esegue la migrazione solo dei file nella directory pub/media, not i file di importazione/esportazione nella directory var. Vedi Importazione/esportazione pianificata nella Guida utente di Commerce 2.4.
386822bd-e32c-40a8-81c2-ed90ad1e198c