Tutorial: Erstellen einer CloudFront-Funktion, die Schlüsselwerte enthält
In diesem Tutorial erfahren Sie, wie Sie Schlüsselwerte in die CloudFront-Funktion einbeziehen. Schlüsselwerte sind Teil eines Schlüssel-Wert-Paars. Sie nehmen den Namen (aus dem Schlüssel-Wert-Paar) in den Funktionscode auf. Wenn die Funktion ausgeführt wird, ersetzt CloudFront den Namen durch den Wert.
Schlüssel-Wert-Paare sind Variablen, die in einem Schlüsselwertspeicher gespeichert werden. Wenn Sie in Ihrer Funktion einen Schlüssel verwenden (anstelle von hartkodierten Werten), ist Ihre Funktion flexibler. Sie können den Wert des Schlüssels ändern, ohne Codeänderungen vornehmen zu müssen. Schlüssel-Wert-Paare können auch die Größe Ihrer Funktion reduzieren. Weitere Informationen finden Sie unter Amazon CloudFront Schlüsselwertspeicher.
Inhalt
Voraussetzungen
Wenn Sie mit den Funktionen und dem Schlüsselwertspeicher von CloudFront noch nicht vertraut sind, empfehlen wir Ihnen, dem Tutorial unter Tutorial: Erstellen einer einfachen Funktion mit CloudFront Functions zu folgen.
Nachdem Sie das Tutorial abgeschlossen haben, können Sie diesem Tutorial folgen, um die von Ihnen erstellte Funktion zu erweitern. Für dieses Tutorial empfehlen wir, dass Sie zuerst den Schlüsselwertspeicher erstellen.
Erstellen des Schlüsselwertspeichers
Erstellen Sie zunächst den Schlüsselwertspeicher, der für Ihre Funktion verwendet werden soll.
So erstellen Sie den Schlüsselwertspeicher
-
Planen Sie die Schlüssel-Wert-Paare, die Sie in die Funktion aufnehmen möchten. Notieren Sie sich die Schlüsselnamen. Die Schlüssel-Wert-Paare, die Sie in einer Funktion verwenden möchten, müssen sich in einem einzigen Schlüsselwertspeicher befinden.
-
Entscheiden Sie sich, in welcher Reihenfolge Sie vorgehen möchten. Es gibt zwei Vorgehensweisen:
-
Erstellen Sie einen Schlüsselwertspeicher und fügen Sie dem Speicher Schlüssel-Wert-Paare hinzu. Dann die Funktion erstellen (oder ändern) und die Schlüsselnamen integrieren.
-
Oder: Die Funktion erstellen (oder ändern) und die zu verwendenden Schlüsselnamen integrieren. Erstellen Sie dann einen Schlüsselwertspeicher und fügen Sie die Schlüssel-Wert-Paare hinzu.
-
Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home
. -
Wählen Sie im Navigationsbereich Funktionen und dann die Registerkarte KeyValueStores aus.
-
Wählen Sie KeyValueStore erstellen aus und füllen Sie die folgenden Felder aus:
-
Geben Sie für den Speicher einen Namen und (optional) eine Beschreibung ein.
-
Lassen Sie den S3-URI leer. In diesem Tutorial geben Sie die Schlüssel-Wert-Paare manuell ein.
-
-
Wählen Sie Erstellen aus. Die Seite mit den Details für den neuen Schlüsselwertspeicher wird angezeigt. Diese Seite enthält den Abschnitt Schlüssel-Wert-Paare, der derzeit leer ist.
Hinzufügen von Schlüssel-Wert-Paaren zum Schlüsselwertspeicher
Als Nächstes fügen Sie dem zuvor erstellten Schlüssel-Wert-Speicher manuell eine Liste von Schlüssel-Wert-Paaren hinzu.
So fügen Sie dem Schlüsselwertspeicher Schlüssel-Wert-Paare hinzu
-
Wählen Sie im Abschnitt Schlüssel-Wert-Paare die Option Schlüssel-Wert-Paare hinzufügen aus.
-
Wählen Sie Paar hinzufügen und geben Sie dann einen Namen und einen Wert ein. Wählen Sie das Häkchen aus, um Ihre Änderungen zu bestätigen, und wiederholen Sie diesen Schritt, um weitere Paare hinzuzufügen.
-
Wenn Sie fertig sind, wählen Sie Änderungen speichern, um die Schlüssel-Wert-Paare im Schlüsselwertspeicher zu speichern. Wählen Sie im Bestätigungsdialogfeld die Option Fertig aus.
Sie haben jetzt einen Schlüsselwertspeicher, der eine Gruppe von Schlüssel-Wert-Paaren enthält.
Zuordnen des Schlüsselwertspeichers zur Funktion
Sie haben jetzt den Schlüsselwertspeicher erstellt. Weiterhin haben Sie eine Funktion erstellt oder geändert, die die Schlüsselnamen aus dem Schlüsselwertspeicher enthält. Sie können jetzt den Schlüsselwertspeicher und die Funktion verknüpfen. Sie erstellen diese Zuordnung innerhalb der Funktion.
So ordnen Sie den Schlüsselwertspeicher der Funktion zu
-
Wählen Sie im Navigationsbereich Funktionen aus. Die Registerkarte Funktionen wird standardmäßig oben angezeigt.
-
Wählen Sie den Funktionsnamen und im Abschnitt Zugeordneter KeyValueStore die Option Vorhandenen KeyValueStore zuordnen aus.
-
Wählen Sie den Schlüsselwertspeicher und die Option KeyValueStore zuordnen aus.
Anmerkung
Sie können jeder Funktion nur einen Schlüsselwertspeicher zuordnen.
Testen und Veröffentlichen des Funktionscodes
Nachdem Sie den Schlüsselwertspeicher mit Ihrer Funktion verknüpft haben, können Sie den Funktionscode testen und veröffentlichen. Sie sollten den Funktionscode jedes Mal testen, wenn Sie ihn ändern, auch wenn Sie Folgendes tun:
-
Der Funktion einen Schlüsselwertspeicher zuordnen.
-
die Funktion und ihren Schlüsselwertspeicher so ändern, dass sie ein neues Schlüssel-Wert-Paar enthalten
-
den Wert eines Schlüssel-Wert-Paares ändern
So testen und veröffentlichen Sie den Funktionscode
-
Weitere Informationen zum Testen einer Funktion finden Sie unter Testfunktionen. Stellen Sie sicher, dass Sie die Funktion in der
DEVELOPMENT-Phase testen. -
Veröffentlichen Sie die Funktion, wenn Sie bereit sind, die Funktion (mit den neuen oder überarbeiteten Schlüssel-Wert-Paaren) in einer
LIVE-Umgebung zu verwenden.Wenn Sie die Funktion veröffentlichen, kopiert CloudFront die Version der Funktion von der
DEVELOPMENT-Phase in die Live-Phase. Die Funktion hat den neuen Code und ist dem Schlüsselwertspeicher zugeordnet. (Die Zuordnung muss in der Live-Phase nicht erneut ausgeführt werden.)Weitere Informationen zum Veröffentlichen einer Funktion finden Sie unter Veröffentlichen von Funktionen.
