Configurare i servizi Fastly
Fastly è richiesto per Adobe Commerce sugli ambienti di staging e produzione dell’infrastruttura cloud.
Fastly funziona con Varnish per fornire funzionalità di caching veloci e una rete per la distribuzione di contenuti (CDN) per le risorse statiche. Fastly fornisce anche un firewall per applicazioni web (WAF) per proteggere il sito e l’infrastruttura cloud. Per proteggere il sito e l’infrastruttura Cloud da traffico e attacchi dannosi, indirizza tutto il traffico del sito in ingresso tramite Fastly.
Completa i passaggi seguenti per abilitare, configurare e testare Fastly nelle prime fasi del processo di sviluppo del sito per abilitare l’accesso sicuro al sito.
- Ottenere credenziali rapide per gli ambienti di staging e produzione
- Abilita caching Fastly CDN
- Carica snippet VCL Fastly
- Aggiorna la configurazione DNS per indirizzare il traffico al servizio Fastly
- Test Fastly caching
Ottieni credenziali rapide
Durante il provisioning del progetto, Adobe aggiunge il progetto all'account Fastly Service per Adobe Commerce sull'infrastruttura cloud e crea le credenziali dell'account Fastly per gli ambienti Starter master
e Pro Staging and Production. Ogni ambiente dispone di credenziali univoche.
È necessario disporre delle credenziali Fastly per configurare i servizi CDN Fastly dall’amministratore e inviare le richieste API Fastly.
Utilizza i seguenti metodi per trovare e salvare l’ID servizio Fastly e il token API per il tuo ambiente:
Per visualizzare le credenziali Fastly:
Il metodo di visualizzazione delle credenziali è diverso per i progetti Pro e Starter.
-
Directory condivisa montata su IaaS: nei progetti Pro, utilizzare SSH per connettersi al server e ottenere le credenziali Fastly dal file
/mnt/shared/fastly_tokens.txt
. Gli ambienti di staging e produzione dispongono di credenziali univoche. È necessario ottenere le credenziali per ogni ambiente. -
Area di lavoro locale: dalla riga di comando, utilizzare la CLI
magento-cloud
per elencare ed esaminare le variabili di ambiente Fastly.code language-bash magento-cloud variable:get -e <environment-ID>
-
Cloud Console - Controllare le seguenti variabili di ambiente nella Configurazione ambiente.
-
CONFIG__DEFAULT__SYSTEM__FULL_PAGE_CACHE__FASTLY__FASTLY_API_KEY
-
CONFIG__DEFAULT__SYSTEM__FULL_PAGE_CACHE__FASTLY__FASTLY_SERVICE_ID
-
Abilita Fastly caching
Per abilitare e configurare i servizi Fastly sono necessari i seguenti componenti:
-
Versione più recente di Fastly CDN per il modulo del Magento 2 installato negli ambienti di staging e produzione. Vedi Aggiorna Fastly.
-
Credenziali rapide per Adobe Commerce negli ambienti di staging e produzione dell'infrastruttura cloud
Per abilitare il caching Fastly CDN in staging e produzione:
-
Accedi all'amministratore.
-
Fai clic su Archivi > Impostazioni > Configurazione > Avanzate > Sistema ed espandi Cache a pagina intera.
-
Nella sezione Caching dell'applicazione, rimuovere la selezione da Usa valore di sistema, quindi selezionare Fastly CDN dall'elenco a discesa.
-
Espandere Fastly Configuration e scegliere le opzioni di memorizzazione nella cache.
-
Dopo aver configurato le opzioni di caching, fai clic su Salva configurazione nella parte superiore della pagina.
-
Cancella la cache in base alla notifica.
-
Continua a configurare Fastly tornando a Archivi > Impostazioni > Configurazione > Avanzate > Sistema > Configurazione Fastly.
Verifica credenziali veloci
-
In Admin, passa a Archivi > Impostazioni > Configurazione > Avanzate > Sistema > Configurazione rapida.
-
Se necessario, aggiungi i valori Fastly Service ID e API token per l'ambiente del progetto.
note note NOTE Non selezionare il collegamento per creare il token API Fastly. Utilizza invece le credenziali Fastly (ID servizio e token API) fornite da Adobe fornite da Adobe. -
Fare clic su Verifica credenziali.
-
Se il test ha esito positivo, fare clic su Salva configurazione e quindi cancellare la cache.
Se il test non riesce, verifica che i valori corretti dell’ID servizio e del token API corrispondano alle credenziali per l’ambiente corrente.
Se il test non riesce di nuovo, invia un ticket di supporto Adobe Commerce o contatta il rappresentante del tuo account Adobe. Per i progetti Pro, includi gli URL per i siti di produzione e staging. Per i progetti iniziali, includere gli URL per il sito
Master
e di gestione temporanea.
Carica VCL in Fastly
Dopo aver abilitato il modulo Fastly, caricare il codice VCL predefinito nei server Fastly. Questo codice fornisce una serie di snippet VCL che specificano le impostazioni di configurazione per abilitare il caching e altri servizi Fastly CDN per l’infrastruttura Adobe Commerce su cloud.
Per caricare Fastly VCL:
-
Nella sezione Fastly Configuration, fare clic su Upload VCL to Fastly come illustrato nella figura seguente.
-
Al termine del caricamento, aggiorna la cache in base alla notifica nella parte superiore della pagina.
Provisioning dei certificati SSL/TLS
Adobe fornisce un certificato SSL/TLS crittografato e convalidato dal dominio per gestire il traffico HTTPS protetto da Fastly. Adobe fornisce un certificato per ogni ambiente Pro Production, Staging e Starter Production per proteggere tutti i domini in tale ambiente. Per informazioni dettagliate sul certificato fornito, consulta Certificati SSL (TLS) di Adobe per Adobe Commerce sull'infrastruttura cloud.
Per abilitare i certificati SSL/TLS per gli ambienti Adobe Commerce, l’automazione Adobe completa i seguenti passaggi:
- Convalida la proprietà del dominio
- Esegue il provisioning di un certificato SSL/TLS crittografato che copre domini principali e sottodomini specifici per gli archivi
- Carica il certificato nell’ambiente Cloud quando il sito è attivo
Questa automazione richiede l'aggiornamento della configurazione DNS del sito per fornire informazioni di convalida del dominio. Utilizza uno dei seguenti metodi:
- Convalida DNS-Per i siti attivi, aggiorna la configurazione DNS con i record CNAME che puntano al servizio Fastly
- Record CNAME di verifica ACME-Aggiorna la configurazione DNS con i record CNAME di verifica ACME forniti da Adobe per ogni dominio nell'ambiente
Al termine della convalida del dominio, Adobe esegue il provisioning del certificato Let's Encrypt TLS/SSL e lo carica negli ambienti di staging o produzione live. Questo processo può richiedere fino a 12 ore. È consigliabile completare gli aggiornamenti della configurazione DNS con diversi giorni di anticipo per evitare ritardi nello sviluppo e nell’avvio del sito.
Aggiornare la configurazione DNS con le impostazioni di sviluppo
Durante il processo di configurazione iniziale di Fastly, è possibile utilizzare i seguenti URL per configurare e testare il caching Fastly negli ambienti di staging e produzione:
-
Per Pro Staging e Produzione:
mcprod.<your-domain>.com
mcstaging.<your-domain>.com
-
Solo per la produzione iniziale:
mcprod.<your-domain>.com
Questi URL predefiniti di preproduzione sono disponibili dopo il provisioning del progetto. Il valore per "your-domain"
è il nome di dominio specificato durante il processo di onboarding.
Per instradare il traffico dagli URL dell’archivio al servizio Fastly, aggiorna la configurazione DNS. Quando aggiorni la configurazione, Adobe esegue automaticamente il provisioning dei certificati SSL/TLS richiesti e li carica negli ambienti Cloud. Questo provisioning può richiedere fino a 12 ore.
Prerequisiti:
- Abilita il modulo Fastly.
- Carica il codice VCL Fastly predefinito.
- Fornisci un elenco dei domini principali e secondari per ciascun ambiente da Adobe, oppure invia un ticket di supporto Adobe Commerce.
- Attendi la conferma che i domini specificati siano stati aggiunti agli ambienti cloud.
- Nei progetti Starter, aggiungi i domini alla configurazione del servizio Fastly. Vedi Gestione domini.
- Per informazioni sull'aggiornamento della configurazione DNS, verificare con il registrar DNS il metodo corretto per il servizio di dominio.
Per aggiornare la configurazione DNS per lo sviluppo:
-
Puntare gli URL di preproduzione al servizio Fastly aggiungendo record CNAME:
prod.magentocloud.map.fastly.net
, ad esempio:table 0-row-2 1-row-2 2-row-2 Dominio o sottodominio CNAME mcprod.your-domain.com prod.magentocloud.map.fastly.net mcstaging.your-domain.com prod.magentocloud.map.fastly.net Quando i record CNAME sono live, Adobe esegue il provisioning dei certificati e carica i certificati SSL/TLS.
note note NOTE Se si prevede di utilizzare i domini APEX ( your-domain.com
) per il sito di produzione, è necessario configurare i record degli indirizzi DNS (record A) in modo che puntino agli indirizzi IP del server Fastly. Vedi Aggiorna configurazione DNS con impostazioni di produzione. -
Aggiungi i record CNAME di richiesta ACME per la convalida del dominio e il preprovisioning dei certificati SSL/TLS di produzione, ad esempio:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Dominio o sottodominio CNAME _acme-challenge.your-domain.com 0123456789abcdef.validation.magento.cloud _acme-challenge.www.your-domain.com 9573186429stuvwx.validation.magento.com _acme-challenge.mystore.your-domain.com 1234567898zxywvu.validation.magento.cloud _acme-challenge.subdomain.your-domain.com 1098765743lmnopq.validation.magento.cloud note note NOTE I record di verifica ACME in questo esempio sono segnaposto che non sono destinati al provisioning dei siti di staging e produzione di Adobe Commerce. Ottieni le informazioni corrette sui record di verifica ACME per il tuo progetto contattando Adobe. Dopo l’aggiunta dei record CNAME, Adobe convalida i domini e esegue il provisioning del certificato SSL/TLS per l’ambiente. Quando aggiorni la configurazione DNS per instradare il traffico da questi domini al servizio Fastly, Adobe carica il certificato nell’ambiente.
-
Aggiorna l’URL di base di Adobe Commerce.
-
Utilizza SSH per accedere all’ambiente di produzione.
code language-bash magento-cloud ssh
-
Utilizza Cloud CLI per modificare l’URL di base per il tuo archivio.
code language-bash php bin/magento setup:store-config:set --base-url="https://mcstaging.your-domain.com/"
note note NOTE In alternativa all'utilizzo di Cloud CLI, è possibile aggiornare l'URL di base da Admin -
-
Riavvia il browser Web.
-
Verifica il tuo sito web.
Test Fastly caching
Dopo aver completato le modifiche alla configurazione DNS, utilizzare lo strumento della riga di comando cURL per verificare che Fastly Cache funzioni.
Per controllare le intestazioni di risposta:
-
In un terminale, utilizza il seguente comando
curl
per testare l'URL live del sito:code language-bash curl -vo /dev/null -H Fastly-Debug:1 https://<live-URL>
Se non hai impostato una route statica o completato la configurazione DNS per i domini sul sito live, utilizza il flag
--resolve
, che ignora la risoluzione dei nomi DNS.code language-bash curl -vo /dev/null -H Fastly-Debug:1 --resolve <live-URL-hostname>:443:<live-IP-address>
-
Nella risposta, verifica le intestazioni per assicurarti che Fastly funzioni. Dovresti visualizzare le seguenti intestazioni univoche nella risposta:
code language-http < Fastly-Magento-VCL-Uploaded: yes < X-Cache: HIT, MISS
Se i valori delle intestazioni non sono corretti, vedere Risolvere gli errori nelle intestazioni di risposta per informazioni sulla risoluzione dei problemi.
Aggiornare il modulo Fastly
Fastly aggiorna la rete CDN Fastly per il modulo Magento 2 per risolvere i problemi, migliorare le prestazioni e fornire nuove funzioni.
È consigliabile aggiornare il modulo Fastly negli ambienti di staging e produzione alla versione più recente.
Dopo aver aggiornato il modulo, è necessario caricare il codice VCL per applicare le modifiche alla configurazione del servizio Fastly.
Per verificare la versione del modulo CDN Fastly per il Magento 2:
-
Passa alla directory principale dell’ambiente Cloud.
-
Utilizza Composer per controllare la versione installata.
code language-bash composer show *fastly*
-
Se la versione più recente non è installata, completare la procedura per aggiornare il modulo Fastly.
Per aggiornare il modulo Fastly:
-
Nell'ambiente di integrazione locale, utilizzare le seguenti informazioni del modulo per aggiornare il modulo Fastly.
code language-text module name: fastly/magento2 repository: https://github.com/fastly/fastly-magento2.git
-
Invio degli aggiornamenti all'ambiente di staging.
-
Accedi all'amministratore per l'ambiente di staging per caricare il codice VCL.
-
Verifica Fastly Services nel sito di gestione temporanea di Adobe Commerce.
Dopo aver verificato i servizi Fastly sul sito di staging, ripeti il processo di aggiornamento nell’ambiente di produzione.