DocumentazioneCommerceGuida di Commerce su infrastruttura Cloud

VCL personalizzato per ignorare la Fastly Cache

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
  • Sviluppatore

Puoi creare uno snippet VCL personalizzato per ignorare la cache Fastly e risolvere eventuali problemi di traffico delle richieste al server di origine. Ad esempio, puoi creare uno snippet per determinare se i problemi del sito sono causati dalla memorizzazione in cache o per risolvere i problemi relativi alle intestazioni.

Puoi configurare il frammento di codice in modo da evitare il caching Fastly per le richieste provenienti da un indirizzo IP o un URL specifico.

NOTE
Prima di unire la configurazione VCL personalizzata in un ambiente di produzione, assicurati di testare il codice nell’ambiente di staging.

Prerequisiti:

  • L’ambiente deve essere configurato per utilizzare la rete CDN Fastly. Vedere Configurare Fastly Services.

  • Assicurati di eseguire la versione più recente del modulo CDN Fastly per il Magento 2. Consulta Aggiornare il modulo Fastly.

  • Verifica la configurazione dell’ambiente per il servizio Fastly. Vedi Controlla Fastly caching.

  • Per accedere agli ambienti di staging e produzione è necessario disporre delle credenziali di amministratore.

Per ignorare la cache Fastly in base all'indirizzo IP o all'URL:

  1. Accedi all'amministratore.

  2. Fai clic su Archivi > Impostazioni > Configurazione > Avanzate > Sistema.

  3. Espandi Cache a pagina intera > Configurazione rapida > Snippet VCL personalizzati.

  4. Fare clic su Crea snippet personalizzato.

  5. Aggiungi i valori dello snippet VCL:

    • Nome - bypass_fastly

    • Tipo - recv

    • Priorità - 5

    • VCL contenuto frammento —

      L’esempio che segue bypassa Fastly per un indirizzo IP specifico:

      code language-conf 
      if (client.ip == "<Your IPv4 IP address>" || client.ip == "<Your IPv6 IP address>") {
  return(pass);
}

      L’esempio che segue bypassa Fastly per un pattern URL specifico:

      code language-conf 
      if (req.url ~ "/media/feeds/GoogleShoppingHiVisNew.xml") {  return (pass);}

      Per ottenere una corrispondenza URL esatta, utilizzare l'operatore == anziché l'operatore ~. Per informazioni dettagliate, vedere [Fastly VCL reference].

  6. Fai clic su Crea.

    Crea snippet VCL con bypass veloce

  7. Dopo il ricaricamento della pagina, fai clic su Carica VCL in Fastly nella sezione Fastly Configuration.

  8. Al termine del caricamento, aggiorna la cache in base alla notifica nella parte superiore della pagina.

    Convalida in breve la versione VCL aggiornata durante il processo di caricamento. Se la convalida non riesce, modifica il frammento VCL personalizzato per risolvere eventuali problemi. Quindi, carica nuovamente il file VCL.

Dopo aver aggiunto lo snippet VCL, è possibile utilizzare i comandi cURL per inviare le richieste al server di origine dall'indirizzo IP o dall'URL specificato, come illustrato nell'esempio seguente:

curl -svo /dev/null www.example.com/index.html

Quindi, esamina la risposta per la risoluzione dei problemi relativi al contenuto non memorizzato in cache.

NOTE
Anziché caricare manualmente snippet VCL personalizzati, è possibile aggiungere snippet alla directory $MAGENTO_CLOUD_APP_DIR/var/vcl_snippets_custom nell'ambiente. I frammenti in questa directory vengono caricati automaticamente quando si fa clic su carica VCL in Fastly in Commerce Admin. Consulta Distribuzione automatizzata di snippet VCL personalizzati nel modulo Fastly CDN per la documentazione del Magento 2.

Modificare lo snippet VCL personalizzato

  1. Accedi all'amministratore.

  2. Fai clic su Archivi > Impostazioni > Configurazione > Avanzate > Sistema.

  3. Espandi Cache a pagina intera > Configurazione rapida > Snippet VCL personalizzati.

    Gestione snippet VCL personalizzati

  4. Nella colonna Azione fare clic sull'icona delle impostazioni accanto al frammento da modificare.

  5. Dopo il ricaricamento della pagina, fai clic su Carica VCL in Fastly nella sezione Fastly Configuration.

  6. Al termine del caricamento, aggiorna la cache in base alla notifica nella parte superiore della pagina.

WARNING
L'opzione dell'interfaccia utente Snippet VCL personalizzati mostra solo i frammenti aggiunti tramite l'amministratore Adobe Commerce. Se aggiungi snippet utilizzando l'API Fastly, utilizza l'API per gestirli.

Elimina lo snippet VCL personalizzato

  1. Accedi all'amministratore.

  2. Fai clic su Archivi > Impostazioni > Configurazione > Avanzate > Sistema.

  3. Espandi Cache a pagina intera > Configurazione rapida > Snippet VCL personalizzati.

    Gestione snippet VCL personalizzati

  4. Nella colonna Azione, fai clic sull'icona del cestino accanto allo snippet da eliminare.

  5. Nella finestra modale successiva, fai clic su DELETE e attiva una nuova versione.

WARNING
L'opzione dell'interfaccia utente Snippet VCL personalizzati mostra solo i frammenti aggiunti tramite l'amministratore Adobe Commerce. Se aggiungi snippet utilizzando l'API Fastly, utilizza l'API per gestirli.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26