Strategie zur Bereitstellung von AEM Edge-Funktionen auf Edge Delivery Services
Auf Edge Delivery Services wird eine AEM Edge-Funktion an eine Site gebunden und jede Site wird einer Git-Verzweigung zugeordnet. Ein Programm erhält genau drei AEM Edge Function-Instanzen mit einem festen Budget, unabhängig davon, wie viele Verzweigungen Ihr Repository hat. Planen Sie Ihre Verzweigungsstrategie rund um dieses Budget, bevor Sie es in Ihren Veröffentlichungsprozess integrieren.
Umfang der AEM Edge-Funktionen
Jede Site-, Produktions-, Staging- und Entwicklungsinstanz wird einer festen Verzweigung (main, stage bzw. dev) zugeordnet und erhält eine eigene AEM Edge Function-Instanz.
Code über Ihre Sites bewerben
In Edge Delivery Services sind Ihre CDN-Konfiguration (edgeFunctions.yaml und cdn.yaml) und Ihr AEM Edge-Funktions-Code im selben AEM Edge Functions-Projekt-Repository verfügbar. Die allgemeinen Schritte zum Weiterleiten von Code an die nächste Site sind:
-
Führen Sie Ihre Konfigurations- und AEM Edge-Funktionscode-Änderungen in der der Ziel-Site zugeordneten Verzweigung zusammen (z. B.
devinstage). -
Überprüfen Sie in Cloud Manager, ob die Edge Delivery Services-Konfigurations-Pipeline die zusammengeführte Verzweigung verwendet.
-
Führen Sie die Edge Delivery-Konfigurations-Pipeline aus, um die
edgeFunctions.yaml- undcdn.yamlbereitzustellen. -
Überprüfen Sie, ob der CLI-Kontext (oder das CI/CD-System) die zusammengeführte Verzweigung verwendet und die gewünschte Site mit dem
aio aem edge-functions info-Befehl auswählt. -
Führen Sie
aio aem edge-functions deploy <name>aus (über die CLI oder das CI/CD-System), um den Funktions-Code auf der Zielsite bereitzustellen.
Verwalten von geheimen Daten über Sites hinweg
Edge Delivery Services verfügt über eine Konfigurations-Pipeline pro Programm, nicht eine pro Site. Die Entwicklungs-, Staging- und Produktions-Sites nutzen sie alle gemeinsam, sodass Sie nicht denselben Variablennamen dreimal mit drei verschiedenen Werten hinzufügen können.
Öffnen Sie in Cloud Manager die Edge Delivery-Konfigurations-Pipeline des Programms und wählen Sie Variablen anzeigen/bearbeiten aus. Fügen Sie pro Site ein Geheimnis hinzu, sodass die drei Sites nie miteinander kollidieren, z. B. DEV_TRIPS_API_TOKEN, STAGE_TRIPS_API_TOKEN und MAIN_TRIPS_API_TOKEN. Die genauen Schritte finden Sie unter Verwenden von Konfigurationen und Geheimnissen.
Nicht geheime Konfigurationen funktionieren unabhängig von der Site gleich: Sie deklarieren sie direkt in edgeFunctions.yaml, die für Git bestimmt sind. Die genauen Schritte finden Sie unter Verwenden von Konfigurationen und Geheimnissen.
Planen Sie Ihr SDLC rund um den Site-Bereich
- Testen Sie die Funktionslogik auf dem
devvor der Zusammenführung mitstageodermain. - Allen geheimen Daten und Variablennamen das Präfix ihrer Site (
DEV_,STAGE_,MAIN_) voranzustellen, da eine Konfigurations-Pipeline alle drei Sites bedient. - Nachverfolgen der Konfiguration und geheimen Drift zwischen Sites als Teil Ihrer Veröffentlichungs-Checkliste, nicht als Nachgedanke.