DokumentationCommerceHandbuch zu Commerce für Cloud

Benutzerdefinierte VCL zur Umgehung des Fastly-Cache

Letzte Aktualisierung: 31. Januar 2025
  • Themen:
  • Cloud
  • Cache

Erstellt für:

  • Admin
  • Entwickler

Sie können ein benutzerdefiniertes VCL-Snippet erstellen, um den Fastly-Cache zu umgehen, damit Sie den Anfragedatenverkehr an den Ursprungsserver beheben können. Sie können beispielsweise einen Ausschnitt erstellen, um zu ermitteln, ob Site-Probleme durch das Caching verursacht werden, oder um Kopfzeilen zu beheben.

Sie können das Snippet so konfigurieren, dass das Fastly-Caching für Anfragen von einer bestimmten IP-Adresse oder URL umgangen wird.

NOTE
Stellen Sie vor dem Zusammenführen einer benutzerdefinierten VCL-Konfiguration in einer Produktionsumgebung sicher, dass Sie den Code in der Staging-Umgebung testen.

Voraussetzungen:

  • Ihre Umgebung muss für die Verwendung des Fastly CDN konfiguriert sein. Siehe Fastly-Services konfigurieren.

  • Stellen Sie sicher, dass Sie die neueste Version des Fastly CDN-Moduls für Magento 2 ausführen. Siehe Upgrade des Fastly-.

  • Überprüfen Sie die Umgebungskonfiguration für den Fastly-Service. Siehe Prüfen von Fastly-Caching.

  • Sie müssen über Administratorberechtigungen verfügen, um auf die Staging- und Produktionsumgebungen zugreifen zu können.

Um den Fastly-Cache basierend auf der IP-Adresse oder URL zu umgehen:

  1. Anmelden beim Administrator.

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

  3. Erweitern Sie Vollständiger Seitencache > Fastly-Konfiguration > Benutzerdefinierte VCL-Snippets.

  4. Klicken Sie Benutzerdefiniertes Snippet erstellen.

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

    • Name — bypass_fastly

    • Typ — recv

    • Priorität — 5

    • VCL Snippet-Inhalt —

      Im folgenden Beispiel wird Fastly für eine bestimmte IP-Adresse umgangen:

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

      Im folgenden Beispiel wird Fastly für ein bestimmtes URL-Muster umgangen:

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

      Verwenden Sie für eine exakte URL-Übereinstimmung den ==-Operator anstelle des ~-Operators. Einzelheiten finden Sie in [Fastly VCL]Referenz.

  6. Klicken Sie Erstellen.

    Erstellen eines VCL-Snippets unter Umgehung von Fastly

  7. Nachdem die Seite neu geladen wurde, klicken Sie im Abschnitt Fastly-Konfiguration auf VCL zu Fastly.

  8. Aktualisieren Sie nach Abschluss des Uploads den Cache entsprechend 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 alle Probleme zu beheben. Laden Sie dann die VCL erneut hoch.

Nachdem Sie den VCL-Ausschnitt hinzugefügt haben, können Sie cURL-Befehle verwenden, um von der angegebenen IP-Adresse oder URL aus Anfragen an den Ursprungs-Server 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 Snippets zum $MAGENTO_CLOUD_APP_DIR/var/vcl_snippets_custom in Ihrer Umgebung hinzufügen. Snippets in diesem Verzeichnis werden automatisch hochgeladen, wenn Sie im Commerce-Admin auf VCL zu Fastly hochladen) klicken. Siehe Automatisierte Bereitstellung benutzerdefinierter VCL-Snippets im Fastly CDN-Modul für die Magento 2-Dokumentation.

Ändern des benutzerdefinierten VCL-Snippets

  1. Anmelden beim Administrator.

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

  3. Erweitern Sie Vollständiger Seitencache > Fastly-Konfiguration > Benutzerdefinierte VCL-Snippets.

    Verwalten benutzerdefinierter VCL-Snippets

  4. Klicken Sie in Spalte Aktion“ auf das Einstellungssymbol neben dem Snippet, das bearbeitet werden soll.

  5. Nachdem die Seite neu geladen wurde, klicken Sie im Abschnitt Fastly-Konfiguration auf VCL zu Fastly.

  6. Aktualisieren Sie nach Abschluss des Uploads den Cache entsprechend der Benachrichtigung oben auf der Seite.

WARNING
Die Benutzeroberflächenoption „Benutzerdefinierte VCL Ausschnitte“ zeigt nur die Ausschnitte an, die über die Adobe Commerce-Admin 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. Anmelden beim Administrator.

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

  3. Erweitern Sie Vollständiger Seitencache > Fastly-Konfiguration > Benutzerdefinierte VCL-Snippets.

    Verwalten benutzerdefinierter VCL-Snippets

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

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

WARNING
Die Benutzeroberflächenoption „Benutzerdefinierte VCL Ausschnitte“ zeigt nur die Ausschnitte an, die über die Adobe Commerce-Admin hinzugefügt wurden. Wenn Sie Snippets mit der Fastly-API hinzufügen, verwenden Sie die API, um sie zu verwalten.
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938