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.

NOTE
Fastly non è disponibile negli ambienti di integrazione.

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
NOTE
Dopo aver abilitato e verificato la configurazione Fastly iniziale, puoi personalizzarla. Ad esempio, puoi abilitare opzioni aggiuntive quali ottimizzazione immagine, moduli edge e codice VCL personalizzato. Vedi Personalizzare la configurazione della cache.

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.

NOTE
Con Adobe Commerce sull’infrastruttura cloud, non è possibile accedere direttamente a Fastly Admin. Utilizza l’amministratore per rivedere e aggiornare la configurazione Fastly per i tuoi ambienti. Se non riesci a risolvere un problema utilizzando le funzionalità Fastly nell'amministratore, invia un ticket di supporto Adobe Commerce.

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

NOTE
Se non riesci a trovare le credenziali Fastly per gli ambienti di staging o produzione, contatta il tuo Adobe Customer Technical Advisor (CTA).

Abilita Fastly caching

Per abilitare e configurare i servizi Fastly sono necessari i seguenti componenti:

Per abilitare il caching Fastly CDN in staging e produzione:

  1. Accedi all'amministratore.

  2. Fai clic su Archivi > Impostazioni > Configurazione > Avanzate > Sistema ed espandi Cache a pagina intera.

    Espandi per selezionare Fastly

  3. Nella sezione Caching dell'applicazione, rimuovere la selezione da Usa valore di sistema, quindi selezionare Fastly CDN dall'elenco a discesa.

    Scegli in modo rapido

  4. Espandere Fastly Configuration e scegliere le opzioni di memorizzazione nella cache.

  5. Dopo aver configurato le opzioni di caching, fai clic su Salva configurazione nella parte superiore della pagina.

  6. Cancella la cache in base alla notifica.

  7. Continua a configurare Fastly tornando a Archivi > Impostazioni > Configurazione > Avanzate > Sistema > Configurazione Fastly.

Verifica credenziali veloci

  1. In Admin, passa a Archivi > Impostazioni > Configurazione > Avanzate > Sistema > Configurazione rapida.

  2. Se necessario, aggiungi i valori Fastly Service ID e API token per l'ambiente del progetto.

    Amministratore credenziali veloci

    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.
  3. Fare clic su Verifica credenziali.

  4. 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.

NOTE
Per istruzioni su come modificare le credenziali del token Fastly API per un ambiente di staging o produzione, vedere Modifica credenziali Fastly.

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.

NOTE
I servizi di Fastly caching funzionano solo dopo aver completato il caricamento iniziale del codice Fastly VCL nei siti di staging e produzione di Adobe Commerce.

Per caricare Fastly VCL:

  1. Nella sezione Fastly Configuration, fare clic su Upload VCL to Fastly come illustrato nella figura seguente.

    Carica un Magento VCL in Fastly

  2. 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.

NOTE
Puoi fornire un certificato TLS o SSL personalizzato invece di utilizzare il certificato Let's Encrypt fornito da Adobe. Tuttavia, questo processo richiede un lavoro aggiuntivo per l'impostazione e la manutenzione. Per scegliere questa opzione, invia un ticket di supporto Adobe Commerce o collabora con Adobe per aggiungere certificati personalizzati in hosting al tuo Adobe Commerce negli ambienti dell’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
TIP
Se il dominio di produzione non è attivo, utilizzare i record CNAME di verifica ACME per la convalida del dominio. L’aggiunta anticipata dei record alla configurazione DNS consente ad Adobe di eseguire il provisioning del certificato SSL/TLS con i domini corretti prima dell’avvio del sito. Prima di avviare l’attività di produzione, devi sostituire questi record segnaposto con i record CNAME forniti da Adobe.

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.

NOTE
Non è possibile specificare un dominio personalizzato per un ambiente non di produzione in progetti Starter.

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.

NOTE
Quando sei pronto per avviare il sito di produzione, devi aggiornare nuovamente la configurazione DNS per indirizzare i domini di produzione al servizio Fastly e completare attività di configurazione aggiuntive. Vedi Elenco di controllo di Launch.

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:

  1. 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.
  2. 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.

  3. 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
  4. Riavvia il browser Web.

  5. 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:

  1. 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>
    
  2. 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.

WARNING
Se hai personalizzato il codice VCL Fastly predefinito con una versione personalizzata, l’aggiornamento del modulo Fastly sovrascrive le modifiche. Se sono stati aggiunti snippet VCL personalizzati con nomi univoci, tali modifiche vengono mantenute durante il processo di aggiornamento. Come best practice, aggiorna l’ambiente di staging e convalida le modifiche prima di applicarle all’ambiente di produzione.

Per verificare la versione del modulo CDN Fastly per il Magento 2:

  1. Passa alla directory principale dell’ambiente Cloud.

  2. Utilizza Composer per controllare la versione installata.

    code language-bash
    composer show *fastly*
    
  3. Se la versione più recente non è installata, completare la procedura per aggiornare il modulo Fastly.

Per aggiornare il modulo Fastly:

  1. 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
    
  2. Invio degli aggiornamenti all'ambiente di staging.

  3. Accedi all'amministratore per l'ambiente di staging per caricare il codice VCL.

  4. 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.

TIP
In caso di problemi con i servizi Fastly negli ambienti Adobe Commerce, consulta la Risoluzione dei problemi Fastly di Adobe Commerce.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26