Fastly-Services konfigurieren

Fastly ist für Adobe Commerce in Staging- und Produktionsumgebungen der Cloud-Infrastruktur erforderlich.

Fastly arbeitet mit Varnish zusammen, um schnelle Caching-Funktionen und ein Content Delivery Network (CDN) für statische Assets bereitzustellen. Fastly bietet auch eine Web Application Firewall (WAF), um Ihre Site- und Cloud-Infrastruktur zu sichern. Um Ihre Site und Cloud-Infrastruktur vor bösartigem Traffic und Angriffen zu schützen, leiten Sie den gesamten eingehenden Site-Traffic über Fastly.

NOTE
Fastly ist in Integrationsumgebungen nicht verfügbar.

Führen Sie die folgenden Schritte aus, um Fastly früh in Ihrem Site-Entwicklungsprozess zu aktivieren, zu konfigurieren und zu testen, um einen sicheren Zugriff auf Ihre Site zu ermöglichen.

  • Schnelle Anmeldedaten für Staging- und Produktionsumgebungen
  • Schnelles CDN-Caching aktivieren
  • Hochladen von Fastly VCL-Snippets
  • DNS-Konfiguration aktualisieren, um Traffic an den Fastly-Service zu leiten
  • Schnelles Caching testen
NOTE
Nachdem Sie die anfängliche Fastly-Konfiguration aktiviert und überprüft haben, können Sie die Konfiguration anpassen. Sie können beispielsweise zusätzliche Optionen wie Bildoptimierung, Edge-Module und benutzerdefinierten VCL-Code aktivieren. Siehe Anpassen der Cache-Konfiguration.

Abrufen von Fastly-Anmeldedaten

Während der Projektbereitstellung fügt Adobe Ihr Projekt zum Fastly Service-Konto für Adobe Commerce in der Cloud-Infrastruktur hinzu und erstellt Fastly-Kontoanmeldeinformationen für die Starter master- und Pro-Staging- und Produktionsumgebungen. Jede Umgebung verfügt über eindeutige Anmeldeinformationen.

Sie benötigen die Fastly-Anmeldedaten, um Fastly CDN-Services vom Administrator zu konfigurieren und Fastly-API-Anfragen zu senden.

NOTE
Mit Adobe Commerce in der Cloud-Infrastruktur können Sie nicht direkt auf Fastly Admin zugreifen. Verwenden Sie den Administrator, um die Fastly-Konfiguration für Ihre Umgebungen zu überprüfen und zu aktualisieren. Wenn Sie ein Problem nicht mit den Fastly-Funktionen in Admin beheben können, reichen Sie ein Adobe Commerce-Support-Ticket ein.

Verwenden Sie die folgenden Methoden, um die Fastly-Service-ID und das API-Token für Ihre Umgebung zu finden und zu speichern:

So zeigen Sie Ihre Fastly-Anmeldedaten an:

Die Methode zum Anzeigen von Anmeldeinformationen unterscheidet sich bei Pro- und Starter-Projekten.

  • Freigegebenes Verzeichnis mit IaaS-Mount: Bei Pro-Projekten wird SSH verwendet, um eine Verbindung zu Ihrem Server herzustellen und die Fastly-Anmeldeinformationen aus der /mnt/shared/fastly_tokens.txt-Datei abzurufen. Staging- und Produktionsumgebungen verfügen über eindeutige Anmeldeinformationen. Sie müssen die Anmeldeinformationen für jede Umgebung abrufen.

  • Lokaler Arbeitsbereich: Verwenden Sie in der Befehlszeile die magento-cloud-CLI, um Umgebungsvariablen aufzulisten und zu überprüfen Fastly.

    code language-bash
    magento-cloud variable:get -e <environment-ID>
    
  • Cloud Console - Überprüfen Sie die folgenden Umgebungsvariablen in der Umgebungskonfiguration.

    • CONFIG__DEFAULT__SYSTEM__FULL_PAGE_CACHE__FASTLY__FASTLY_API_KEY

    • CONFIG__DEFAULT__SYSTEM__FULL_PAGE_CACHE__FASTLY__FASTLY_SERVICE_ID

NOTE
Wenn Sie die Fastly-Anmeldedaten für die Staging- oder Produktionsumgebungen nicht finden können, wenden Sie sich an Ihren technischen Berater für Adobe-Kunden (CTA).

Schnelles Caching aktivieren

Sie benötigen die folgenden Komponenten, um Fastly-Services zu aktivieren und zu konfigurieren:

So aktivieren Sie das schnelle CDN-Caching in der Staging- und Produktionsumgebung:

  1. Anmelden beim Administrator.

  2. Klicken Sie auf Stores > Einstellungen > Konfiguration > Erweitert > System und erweitern Sie Vollständiger Seitencache.

    Erweitern Sie auf Fastly

  3. Entfernen Sie im Abschnitt Caching die Auswahl aus Systemwert verwenden und wählen Sie dann Fastly CDN aus der Dropdown-Liste aus.

    Schnell wählen

  4. Erweitern Sie Fastly Configuration und wählen Caching-Optionen.

  5. Klicken Sie nach dem Konfigurieren der Caching Optionen oben der Seite auf „Konfiguration speichern“.

  6. Löschen Sie den Cache gemäß der Benachrichtigung.

  7. Fahren Sie mit der Konfiguration von Fastly fort, indem Sie zurück zu Stores > Einstellungen > Konfiguration > Erweitert > System > Fastly Configuration.

Testen von Fastly-Anmeldedaten

  1. Navigieren Sie in der Admin Stores > Einstellungen > Konfiguration > Erweitert > System > Fastly Configuration.

  2. Fügen Sie bei Bedarf die Werte Fastly-Service ID und API-Token für Ihre Projektumgebung hinzu.

    Fastly Anmeldedaten-Administrator

    note note
    NOTE
    Wählen Sie nicht den Link aus, um das Fastly-API-Token zu erstellen. Verwenden Sie stattdessen die Fastly-Anmeldedaten (Service-ID und API-Token) von Adobe bereitgestellt von Adobe.
  3. Klicken Sie Testanmeldeinformationen.

  4. Wenn der Test erfolgreich ist, klicken Sie Konfiguration speichern und löschen Sie dann den Cache.

    Wenn der Test fehlschlägt, stellen Sie sicher, dass die richtigen Werte für Service-ID und API-Token mit den Anmeldeinformationen für die aktuelle Umgebung übereinstimmen.

    Wenn der Test erneut fehlschlägt, reichen Sie ein Adobe Commerce-Support-Ticket ein oder wenden Sie sich an Ihren Adobe-Kundenbetreuer. Geben Sie bei Pro-Projekten die URLs für Ihre Produktions- und Staging-Sites an. Geben Sie für Einstiegsprojekte die URLs für Ihre Master- und Staging-Site an.

NOTE
Anweisungen zum Ändern der Fastly-API-Token-Anmeldeinformationen für eine Staging- oder Produktionsumgebung finden Sie unter Ändern der Fastly-Anmeldeinformationen.

VCL zu Fastly hochladen

Laden Sie nach dem Aktivieren des Fastly-Moduls den StandardVCL-Code auf die Fastly-Server hoch. Dieser Code bietet eine Reihe von VCL-Snippets, die die Konfigurationseinstellungen angeben, um das Caching und andere Fastly CDN-Services für Ihre Adobe Commerce in der Cloud-Infrastruktur zu aktivieren.

NOTE
Fastly-Caching-Services funktionieren erst, wenn Sie den ersten Upload des Fastly-VCL-Codes auf die Staging- und Produktions-Sites von Adobe Commerce abgeschlossen haben.

Hochladen der Fastly-VCL:

  1. Klicken Sie im Abschnitt Fastly auf VCL in Fastly hochladen wie in der folgenden Abbildung dargestellt.

    Laden Sie eine Magento VCL auf Fastly hoch

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

Bereitstellen von SSL-/TLS-Zertifikaten

Adobe bietet ein Domain-validiertes Let's Encrypt SSL/TLS-Zertifikat, um sicheren HTTPS-Traffic von Fastly zu bedienen. Adobe stellt ein Zertifikat für jede Pro-Produktions-, Staging- und Starter-Produktionsumgebung bereit, um alle Domains in dieser Umgebung zu sichern. Ausführliche Informationen zum bereitgestellten Zertifikat finden Sie unter Adobe von SSL (TLS)-Zertifikaten für Adobe Commerce in der Cloud-Infrastruktur.

NOTE
Sie können Ihr eigenes TLS- oder SSL-Zertifikat bereitstellen, anstatt das von Adobe bereitgestellte Let's Encrypt-Zertifikat zu verwenden. Dieser Prozess erfordert jedoch zusätzliche Arbeit bei der Einrichtung und Wartung. Um diese Option auszuwählen, reichen Sie ein Adobe Commerce-Support-Ticket ein oder arbeiten Sie mit Adobe, um benutzerdefinierte, gehostete Zertifikate zu Ihrer Adobe Commerce in Cloud-Infrastrukturumgebungen hinzuzufügen.

Um die SSL/TLS-Zertifikate für Adobe Commerce-Umgebungen zu aktivieren, führt die Adobe-Automatisierung die folgenden Schritte aus:

  • Validiert den Domain-Besitz
  • Stellt ein SSL-/TLS-Zertifikat zur Verschlüsselung bereit, das die angegebenen Top-Level- und Subdomains für Ihre Stores abdeckt
  • Lädt das Zertifikat in die Cloud-Umgebung hoch, wenn die Site live ist

Für diese Automatisierung müssen Sie die DNS-Konfiguration für Ihre Site aktualisieren, um Informationen zur Domain-Validierung bereitzustellen. Verwenden Sie eine der folgenden Methoden:

  • DNS-Validierung-Aktualisieren Sie Ihre DNS-Konfiguration für Live-Sites mit CNAME-Einträgen, die auf den Fastly-Service verweisen.
  • ACME Challenge CNAME-Einträge - Aktualisieren Sie Ihre DNS-Konfiguration mit den von Adobe für jede Domain in Ihrer Umgebung bereitgestellten ACME Challenge CNAME-Einträgen.
TIP
Wenn Sie über eine nicht aktive Produktions-Domain verfügen, verwenden Sie die CNAME-Einträge der ACME-Herausforderung für die Domain-Validierung. Durch frühzeitiges Hinzufügen der Einträge zu Ihrer DNS-Konfiguration kann Adobe das SSL-/TLS-Zertifikat mit den richtigen Domains bereitstellen, bevor die Site gestartet wird. Bevor Sie mit der Produktion beginnen, müssen Sie diese Platzhalterdatensätze durch die von Adobe bereitgestellten CNAME-Datensätze ersetzen.

Nach Abschluss der Domain-Validierung stellt Adobe das TLS/SSL-Zertifikat für die Verschlüsselung bereit und lädt es in Live-Staging- oder Produktionsumgebungen hoch. Dieser Vorgang kann bis zu 12 Stunden dauern. Es wird empfohlen, die DNS-Konfigurationsaktualisierungen mehrere Tage im Voraus abzuschließen, um Verzögerungen bei der Site-Entwicklung und dem Site-Launch zu vermeiden.

DNS-Konfiguration mit Entwicklungseinstellungen aktualisieren

Während des anfänglichen Fastly-Einrichtungsprozesses können Sie die folgenden URLs verwenden, um das Fastly-Caching in Staging- und Produktionsumgebungen zu konfigurieren und zu testen:

  • Für Pro Staging und Produktion:

    • mcprod.<your-domain>.com
    • mcstaging.<your-domain>.com
  • Nur für die Erstproduktion:

    • mcprod.<your-domain>.com

Diese standardmäßigen Vorproduktions-URLs sind verfügbar, nachdem Ihr Projekt bereitgestellt wurde. Der Wert für "your-domain" ist der Domain-Name, den Sie während des Onboarding-Prozesses angegeben haben.

NOTE
Sie können keine benutzerdefinierte Domain für eine Nicht-Produktionsumgebung in Starter-Projekten angeben.

Aktualisieren Sie Ihre DNS-Konfiguration, um Traffic von Ihren Store-URLs zum Fastly-Service zu leiten. Wenn Sie die Konfiguration aktualisieren, stellt Adobe automatisch die erforderlichen SSL-/TLS-Zertifikate bereit und lädt sie in Ihre Cloud-Umgebungen hoch. Diese Bereitstellung kann bis zu 12 Stunden dauern.

NOTE
Wenn Sie bereit sind, Ihre Produktions-Site zu starten, müssen Sie die DNS-Konfiguration erneut aktualisieren, um Ihre Produktions-Domains auf den Fastly-Service zu verweisen und zusätzliche Konfigurationsaufgaben durchzuführen. Siehe Checkliste starten.

Voraussetzungen:

  • Aktivieren Sie das Fastly-Modul.
  • Laden Sie den Standard-Fastly-VCL-Code hoch.
  • Stellen Sie eine Liste der Top-Level- und Subdomains für jede Umgebung zum Adobe bereit oder senden Sie ein Adobe Commerce-Support-Ticket.
  • Warten Sie auf die Bestätigung, dass die angegebenen Domains zu Ihren Cloud-Umgebungen hinzugefügt wurden.
  • Fügen Sie bei Einstiegsprojekten die Domains zu Ihrer Fastly-Service-Konfiguration hinzu. Siehe Verwalten von Domains.
  • Informationen zum Aktualisieren der DNS-Konfiguration finden Sie bei Ihrer DNS-) nach der richtigen Methode für Ihren Domain-Dienst.

So aktualisieren Sie Ihre DNS-Konfiguration für die Entwicklung:

  1. Verweisen Sie Vorproduktions-URLs auf den Fastly-Service, indem Sie CNAME-Einträge hinzufügen: prod.magentocloud.map.fastly.net, z. B.:

    table 0-row-2 1-row-2 2-row-2
    Domain oder Subdomain CNAME
    mcprod.your-domain.com prod.magentocloud.map.fastly.net
    mcstaging.your-domain.com prod.magentocloud.map.fastly.net

    Wenn die CNAME-Einträge live sind, stellt Adobe Zertifikate bereit und lädt die SSL-/TLS-Zertifikate hoch.

    note note
    NOTE
    Wenn Sie planen, Apex-Domains (your-domain.com) für Ihre Produktions-Website zu verwenden, müssen Sie DNS-Adresseinträge (A-Einträge) so konfigurieren, dass sie auf die Fastly-Server-IP-Adressen verweisen. Siehe Aktualisieren der DNS-Konfiguration mit Produktionseinstellungen.
  2. Fügen Sie CNAME-Einträge mit ACME-Challenge für die Domain-Validierung und die Vorbereitstellung von SSL-/TLS-Produktionszertifikaten hinzu, z. B.:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Domain oder Subdomain 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
    Die ACME-Challenge-Datensätze in diesem Beispiel sind Platzhalter, die nicht für die Bereitstellung Ihrer Adobe Commerce-Staging- und Produktions-Sites vorgesehen sind. Holen Sie sich die richtigen Informationen zu ACME Challenge-Einträgen für Ihr Projekt, indem Sie sich an Adobe wenden.

    Nach dem Hinzufügen der CNAME-Einträge validiert Adobe die Domains und stellt das SSL-/TLS-Zertifikat für die Umgebung bereit. Wenn Sie die DNS-Konfiguration aktualisieren, um Traffic von diesen Domains zum Fastly-Service zu leiten, lädt Adobe das Zertifikat in die Umgebung hoch.

  3. Aktualisieren Sie die Adobe Commerce-Basis-URL.

    • Verwenden Sie SSH, um sich bei der Produktionsumgebung anzumelden.

      code language-bash
      magento-cloud ssh
      
    • Verwenden Sie die Cloud-CLI, um die Basis-URL für Ihren Store zu ändern.

      code language-bash
      php bin/magento setup:store-config:set --base-url="https://mcstaging.your-domain.com/"
      
    note note
    NOTE
    Als Alternative zur Verwendung der Cloud-CLI können Sie die Basis-URL von Admin aktualisieren
  4. Starten Sie den Webbrowser neu.

  5. Testen Sie Ihre Website.

Schnelles Caching testen

Nachdem Sie die Änderungen an der DNS-Konfiguration vorgenommen haben, verwenden Sie das cURL-Befehlszeilen-Tool, um zu überprüfen, ob der Fastly-Cache funktioniert.

Überprüfen der Antwort-Header:

  1. Verwenden Sie in einem Terminal den folgenden curl-Befehl, um Ihre Live-Site-URL zu testen:

    code language-bash
    curl -vo /dev/null -H Fastly-Debug:1 https://<live-URL>
    

    Wenn Sie keine statische Route festgelegt oder die DNS-Konfiguration für die Domains auf Ihrer Live-Site abgeschlossen haben, verwenden Sie das --resolve-Flag, das die DNS-Namensauflösung umgeht.

    code language-bash
    curl -vo /dev/null -H Fastly-Debug:1 --resolve <live-URL-hostname>:443:<live-IP-address>
    
  2. Überprüfen Sie in der Antwort die Kopfzeilen, um sicherzustellen, dass Fastly funktioniert. In der Antwort sollten die folgenden eindeutigen Kopfzeilen angezeigt werden:

    code language-http
    < Fastly-Magento-VCL-Uploaded: yes
    < X-Cache: HIT, MISS
    

Wenn die Kopfzeilen nicht die richtigen Werte aufweisen, finden Sie unter Beheben von Fehlern in den Antwort-Kopfzeilen Hilfe zur Fehlerbehebung.

Upgrade des Fastly-Moduls

Fastly aktualisiert das Fastly CDN für Magento 2-Modul, um Probleme zu beheben, die Leistung zu steigern und neue Funktionen bereitzustellen.
Wir empfehlen Ihnen, das Fastly-Modul in Ihren Staging- und Produktionsumgebungen auf die neueste Version).

Nachdem Sie das Modul aktualisiert haben, müssen Sie den VCL-Code hochladen, um die Änderungen auf die Fastly-Service-Konfiguration anzuwenden.

WARNING
Wenn Sie den Standard-Fastly-VCL-Code mit einer benutzerdefinierten Version angepasst haben, überschreibt das Upgrade des Fastly-Moduls Ihre Änderungen. Wenn Sie benutzerdefinierte VCL-Snippets mit eindeutigen Namen hinzugefügt haben, bleiben diese Änderungen während des Aktualisierungsprozesses erhalten. Als Best Practice empfiehlt es sich, die Staging-Umgebung zu aktualisieren und die Änderungen zu validieren, bevor Sie Änderungen auf die Produktionsumgebung anwenden.

So überprüfen Sie die Version des Fastly CDN-Moduls für Magento 2:

  1. Wechseln Sie in das Stammverzeichnis Ihrer Cloud-Umgebung.

  2. Verwenden Sie Composer, um die installierte Version zu überprüfen.

    code language-bash
    composer show *fastly*
    
  3. Wenn die neueste Version nicht installiert ist, führen Sie die Schritte zum Upgrade des Fastly-Moduls aus.

So aktualisieren Sie das Fastly-Modul:

  1. Verwenden Sie in Ihrer lokalen Integrationsumgebung die folgenden Modulinformationen, um das Fastly-Modul zu aktualisieren.

    code language-text
    module name: fastly/magento2
    repository: https://github.com/fastly/fastly-magento2.git
    
  2. Pushen Sie Ihre Aktualisierungen in die Staging-Umgebung.

  3. Melden Sie sich bei der Admin für Ihre Staging-Umgebung an, um den VCL-Code hochzuladen.

  4. Überprüfen der FastlyServices auf der Adobe Commerce-Staging-Site.

Nachdem Sie die Fastly-Services auf der Staging-Site überprüft haben, wiederholen Sie den Upgrade-Prozess in der Produktionsumgebung.

TIP
Wenn Sie Probleme mit Fastly-Services in Ihren Adobe Commerce-Umgebungen haben, finden Sie weitere Informationen im Adobe Commerce Fastly-.
recommendation-more-help