Verwendung von Edge-Funktionsaktionen und Auslösern

Randfunktionen bestehen aus zwei Hauptkomponenten: Aktionen und Auslöser. Aktionen sind JavaScript Dateien, die die Logik definieren, die am Rand ausgeführt werden soll. Auslöser sind auf URLs basierende Routing-Regeln, die festlegen, wann und unter welchen Umständen diese Aktionen ausgeführt werden sollen. Auslöser verbinden bestimmte Anfragemuster (wie Domänen und Pfade) mit den entsprechenden Aktionen. Ohne einen entsprechenden Auslöser hat eine Aktion keine Auswirkungen auf den Verkehr.

Aktionen der Randfunktion

Aktionen werden in JavaScript geschrieben und benötigen einen Ereignislistener, um auf ein Auslöserereignis zu reagieren. Aktionen haben keinen Einfluss auf Ihren Datenverkehr, es sei denn, sie werden von einem Auslöser verwendet.

Unterschiede im Plan

Die Unterschiede bei der Arbeit mit Aktionen hängen von Ihrem Plan ab:

Standard-Pläne

  • Erlauben Sie nur eine Aktion pro Konto, die automatisch nach Ihrer Domain benannt wird (der Name kann nicht geändert werden).
  • Um eine Aktion zu aktualisieren, laden Sie eine neue JavaScript Datei hoch oder bearbeiten Sie den Code direkt im Editor. Das Hochladen einer neuen Datei ersetzt die bestehende Aktion.
  • Wenn Sie eine JavaScript Datei hochladen, wird der Name immer auf Ihren Domänennamen gesetzt.

Pläne für Unternehmen

  • Sie können eine unbegrenzte Anzahl von Skripten hochladen, jedes mit einem eigenen Namen, falls gewünscht.
  • Wenn Sie eine Aktion erstellen, können Sie einen benutzerdefinierten Namen angeben.
  • Beim Hochladen einer JavaScript Datei wird der Aktionsname aus dem Dateinamen übernommen.

Mit Aktionen arbeiten

Sie können Aktionen erstellen, hochladen, bearbeiten und verwalten, um die Logik zu definieren, die Ihre Edge-Funktion als Reaktion auf Auslöseereignisse ausführt. Die Konsole bietet Werkzeuge für jede der Hauptoperationen:

  • Erstellen einer Aktion- Klicken Sie auf Erstellen, um mit dem integrierten Code-Editor eine Aktion hinzuzufügen. Nachdem Sie Ihren JavaScript Code hinzugefügt haben, klicken Sie auf Speichern, um Ihre Aktion zu erstellen.

  • Lesen einer Aktion- Klicken Sie auf eine bestehende Aktion in der Aktionstabelle, um sie im Editor zu öffnen. So können Sie den Code einsehen, ohne Änderungen vorzunehmen.

  • Aktualisieren einer Aktion- Um eine Aktion zu ändern, öffnen Sie sie im Editor, indem Sie sie in der Liste anklicken. Nehmen Sie Ihre Änderungen vor und klicken Sie dann auf Speichern. Wenn Sie Ihre Änderungen speichern, wird die aktualisierte Aktion hochgeladen. Wenn die Aktion in Verwendung ist, werden die Aktualisierungen sofort wirksam.

  • Hochladen einer Aktion- Klicken Sie auf Hochladen, um eine JavaScript Datei hochzuladen. Beim Hochladen oder Erstellen einer Aktion mit demselben Namen wie eine vorhandene Aktion wird die vorhandene Aktion überschrieben. Benennen Sie die Aktionsdatei vor dem Hochladen um, oder geben Sie bei der Erstellung einen eindeutigen Namen ein, um dieses Verhalten zu vermeiden.

    Das Hochladen kann auch im Rahmen der Erstellung oder Aktualisierung einer Aktion verwendet werden, je nachdem, ob der Name bereits existiert.

  • Löschen einer Aktion- Um eine Aktion zu löschen, klicken Sie auf das Symbol „Löschen “ Symbol „Löschen“ in der Tabellenzeile für die ausgewählte Aktion. Eine Aktion kann nicht gelöscht werden, solange sie mit einem Auslöser verknüpft ist. Um die Aktion zu löschen, müssen Sie zunächst alle Auslöser entfernen, die sie verwenden. Die Spalte Verwendungen zeigt, wie viele Auslöser mit jeder Aktion verbunden sind.

  • Zuordnen eines Auslösers- Auslöser sind erforderlich, damit eine Aktion ausgeführt werden kann. Fügen Sie auf der Registerkarte Auslöser einen Auslöser hinzu und wählen Sie die Aktion aus der Liste der vorhandenen Aktionen aus. Die Spalte Verwendungen in der Aktionstabelle zeigt die Anzahl der Auslöser an, die derzeit mit jeder Aktion verknüpft sind.

Auslöser für die Randfunktion

Auslöser (Routen) bestimmen, wie der Domänenverkehr an Aktionen weitergeleitet wird. Sie verknüpfen URL Muster, die auf einer Domäne des Kontos basieren, mit einer vordefinierten Aktion. Das Muster URL muss die Domäne enthalten und kann Wildcards entweder als Präfix der Domäne oder am Ende des Pfades enthalten. Wenn kein Pfad angegeben wird, wird implizit ein / hinzugefügt. URL muster können keine Infix-Wildcards oder Abfrageparameter enthalten.

Unterschiede im Plan

Es gibt keine Unterschiede in der Funktionsweise der Auslöser in den verschiedenen Plänen. Alle Pläne unterstützen das Hinzufügen, Bearbeiten und Löschen von Auslösern.

Mit Auslösern arbeiten

Sie müssen eine Domäne hinzufügen, bevor Sie Auslöser hinzufügen. Auslöser legen fest, wie der Datenverkehr an Ihre Edge-Funktionsaktionen weitergeleitet wird. Ein Auslöser verbindet ein URL Muster mit einer bestehenden Aktion.

Auslöser können erstellt werden, auch wenn noch keine Aktionen vorhanden sind, aber sie rufen keine Logik auf, bis eine Aktion ausgewählt wird.

  • Hinzufügen eines Auslösers- Gehen Sie zur Registerkarte Auslöser und klicken Sie auf Auslöser hinzufügen. Geben Sie ein URL Muster ein und wählen Sie dann eine Aktion aus der Liste der vorhandenen Aktionen aus, die mit diesem Muster verknüpft werden soll. Dadurch wird die Verbindung zwischen einer Route und einer Aktion hergestellt.

    Um einen Triggerpfad aktiv zu halten, ohne eine Flankenfunktion auszuführen, aktivieren Sie Flankenfunktionen vermeiden. Wenn z. B. my-function gamma.cistest-load.com/* zugewiesen ist, Sie aber möchten, dass gamma.cistest-load.com/data umgangen wird, erstellen Sie einen separaten Auslöser für /data und aktivieren Sie die Funktion "Flanken vermeiden". Dadurch wird sichergestellt, dass der Pfad /data aktiv bleibt, ohne my-function aufzurufen.

  • Bearbeiten eines Auslösers- Klicken Sie auf das Symbol Bearbeiten Bearbeiten-Symbol in der Tabellenzeile des Auslösers, den Sie ändern möchten, nehmen Sie die Änderungen vor und klicken Sie dann auf Speichern Sie.

  • Löschen eines Triggers- Klicken Sie auf das Symbol Löschen Symbol löschen in der Tabellenzeile den Trigger, den Sie ändern möchten. Diese Aktion kann nicht rückgängig gemacht werden. Durch das Löschen eines Auslösers wird die Verbindung zwischen der Route und der Aktion aufgehoben.