DokumentationCommerceHandbuch zu Commerce mit Cloud Infrastructure

Benutzerdefinierte VCL zum Umgehen des Fastly-Cache

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

Erstellt für:

  • Admin
  • Entwickler

Sie können ein benutzerdefiniertes VCL-Snippet erstellen, um den Fastly-Cache zu umgehen, damit Sie die Fehlerbehebung für den Anforderungs-Traffic auf dem Herkunftsserver durchführen können. Sie können beispielsweise ein Snippet erstellen, um festzustellen, ob Site-Probleme durch Caching verursacht werden, oder um Kopfzeilen zu beheben.

Sie können das Snippet so konfigurieren, dass es die schnelle Zwischenspeicherung für Anforderungen von einer bestimmten IP-Adresse oder URL umgeht.

NOTE
Bevor Sie die benutzerdefinierte VCL-Konfiguration in einer Produktionsumgebung zusammenführen, sollten Sie den Code in der Staging-Umgebung testen.

Voraussetzungen:

So umgehen Sie den Schnellcache basierend auf IP-Adresse oder URL:

  1. Melden Sie sich beibeim Administrator an.

  2. Klicken Sie auf Stores > Einstellungen > Konfiguration > Erweitert > System.

  3. Erweitern Sie Vollständiger Seiten-Cache > Fastly Configuration > Custom VCL Snippets.

  4. Klicken Sie auf Benutzerdefiniertes Snippet erstellen.

  5. Fügen Sie die VCL-Snippet-Werte hinzu:

    • Name — bypass_fastly

    • Typ — recv

    • Priorität — 5

    • VCL Snippet-Inhalt —

      Das folgende Beispiel umgeht Fastly für eine bestimmte IP-Adresse:

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

      Das folgende Beispiel umgeht Fastly für ein bestimmtes URL-Muster:

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

      Verwenden Sie für eine exakte URL-Übereinstimmung den Operator == anstelle des Operators ~ . Weitere Informationen finden Sie unter Fastly VCL-Referenz .

  6. Klicken Sie auf Erstellen.

    VCL-Snippet schnell umgehen

  7. Klicken Sie nach dem Neuladen der Seite im Abschnitt Schnelle Konfiguration auf VCL auf Fastly hochladen .

  8. Nach Abschluss des Uploads aktualisieren Sie den Cache gemäß der Benachrichtigung oben auf der Seite.

    Validiert die aktualisierte VCL-Version während des Upload-Prozesses schnell. Wenn die Validierung fehlschlägt, bearbeiten Sie Ihr benutzerdefiniertes VCL-Snippet, um Probleme zu beheben. Laden Sie dann die VCL erneut hoch.

Nachdem Sie das VCL-Snippet hinzugefügt haben, können Sie cURL-Befehle verwenden, um Anfragen von der angegebenen IP-Adresse oder URL an den Herkunftsserver zu senden, wie im folgenden Beispiel gezeigt:

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

Überprüfen Sie dann die Antwort, um Probleme mit nicht zwischengespeicherten Inhalten zu beheben.

NOTE
Anstatt benutzerdefinierte VCL-Snippets manuell hochzuladen, können Sie in Ihrer Umgebung Snippets zum Ordner "$MAGENTO_CLOUD_APP_DIR/var/vcl_snippets_custom"hinzufügen. Snippets in diesem Verzeichnis werden automatisch hochgeladen, wenn Sie in Commerce Admin auf VCL auf Fastly hochladen klicken. Informationen zu Magento 2 finden Sie unter Bereitstellung automatisierter benutzerdefinierter VCL-Snippets im Fastly CDN-Modul.

Ändern des benutzerdefinierten VCL-Snippets

  1. Melden Sie sich beibeim Administrator an.

  2. Klicken Sie auf Stores > Einstellungen > Konfiguration > Erweitert > System.

  3. Erweitern Sie Vollständiger Seiten-Cache > Fastly Configuration > Custom VCL Snippets.

    Verwalten benutzerdefinierter VCL-Snippets

  4. Klicken Sie in der Spalte Aktion auf das Einstellungssymbol neben dem zu bearbeitenden Snippet.

  5. Klicken Sie nach dem Neuladen der Seite im Abschnitt Schnelle Konfiguration auf VCL auf Fastly hochladen .

  6. Nach Abschluss des Uploads aktualisieren Sie den Cache gemäß der Benachrichtigung oben auf der Seite.

WARNING
Die UI-Option Benutzerdefinierte VCL-Snippets zeigt nur die Snippets an, die über den Adobe Commerce-Administrator hinzugefügt wurden. Wenn Sie Snippets mit der Fastly API hinzufügen, verwenden Sie die API, um sie zu verwalten.

Löschen des benutzerdefinierten VCL-Snippets

  1. Melden Sie sich beibeim Administrator an.

  2. Klicken Sie auf Stores > Einstellungen > Konfiguration > Erweitert > System.

  3. Erweitern Sie Vollständiger Seiten-Cache > Fastly Configuration > Custom VCL Snippets.

    Verwalten benutzerdefinierter VCL-Snippets

  4. Klicken Sie in der Spalte Aktion auf das Papierkorbsymbol neben dem zu löschenden Ausschnitt.

  5. Klicken Sie im nächsten modalen Fenster auf DELETE und aktivieren Sie eine neue Version.

WARNING
Die UI-Option Benutzerdefinierte VCL-Snippets zeigt nur die Snippets an, die über den Adobe Commerce-Administrator hinzugefügt wurden. Wenn Sie Snippets mit der Fastly API hinzufügen, verwenden Sie die API, um sie zu verwalten.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26