Tutorial: Erstellen Sie eine CloudFront Funktion, die Schlüsselwerte enthält

Dieses Tutorial zeigt Ihnen, wie Sie Schlüsselwerte in eine CloudFront Funktion einbeziehen. Schlüsselwerte sind Teil eines Schlüssel-Wert-Paares. Sie nehmen den Namen (aus dem Schlüssel-Wert-Paar) in den Funktionscode auf. Wenn die Funktion ausgeführt wird, wird der Name CloudFront durch den Wert ersetzt.

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 KeyValueStore.

Inhalt

• Voraussetzungen
• Erstellen Sie den Schlüsselwertspeicher
• Fügen Sie Schlüssel-Wert-Paare zum Schlüssel-Wert-Speicher hinzu
• Ordnen Sie den Schlüsselwertspeicher der Funktion zu
• Testen und veröffentlichen Sie den Funktionscode

Voraussetzungen

Wenn Sie mit CloudFront Funktionen und dem Schlüsselwertspeicher noch nicht vertraut sind, empfehlen wir Ihnen, das Tutorial unter zu befolgen. Tutorial: Erstellen Sie eine einfache Funktion mit CloudFront Funktionen

Nachdem Sie dieses 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 Sie den Schlüsselwertspeicher

Erstellen Sie zunächst den Schlüsselwertspeicher, der für Ihre Funktion verwendet werden soll.

Um den Schlüsselwertspeicher zu erstellen

1. 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.

2. 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.

3. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CloudFront Konsole unter. https://console.aws.amazon.com/cloudfront/v4/home

4. Wählen Sie im Navigationsbereich Funktionen und dann die KeyValueStoresRegisterkarte aus.

5. Wählen Sie Erstellen KeyValueStore und geben Sie die folgenden Felder ein:

   • Geben Sie einen Namen und (optional) eine Beschreibung für den Shop ein.

   • Lassen Sie den S3-URI leer. In diesem Tutorial geben Sie die Schlüssel-Wert-Paare manuell ein.

6. Wählen Sie Erstellen. 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.

Fügen Sie Schlüssel-Wert-Paare zum Schlüssel-Wert-Speicher hinzu

Fügen Sie als Nächstes manuell eine Liste von Schlüssel-Wert-Paaren zum Schlüssel-Wert-Speicher hinzu, den Sie zuvor erstellt haben.

Um Schlüssel-Wert-Paare zum Schlüssel-Wert-Speicher hinzuzufügen

1. Wählen Sie im Abschnitt Schlüssel-Wert-Paare die Option Schlüssel-Wert-Paare hinzufügen aus.

2. Wählen Sie Paar hinzufügen und geben Sie dann einen Schlüssel und einen Wert ein. Klicken Sie auf das Häkchen, um Ihre Änderungen zu bestätigen, und wiederholen Sie diesen Schritt, um weitere hinzuzufügen.

3. 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.

Ordnen Sie den Schlüsselwertspeicher der Funktion zu

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.

Um den Schlüsselwertspeicher mit der Funktion zu verknüpfen

1. Wählen Sie im Navigationsbereich Funktionen aus. Die Registerkarte Funktionen wird standardmäßig oben angezeigt.

2. Wählen Sie den Funktionsnamen und wählen Sie im KeyValueStore Abschnitt Zugeordnet die Option Vorhandenes zuordnen aus KeyValueStore.

3. Wählen Sie den Schlüsselwertspeicher aus und klicken Sie auf Zuordnen KeyValueStore.

Anmerkung

Sie können jeder Funktion nur einen Schlüsselwertspeicher zuordnen.

Testen und veröffentlichen Sie den Funktionscode

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.

• Ändern Sie die Funktion und ihren Schlüsselwertspeicher so, dass sie ein neues Schlüssel-Wert-Paar enthalten.

• Ändern Sie den Wert eines Schlüssel-Wert-Paares.

Um den Funktionscode zu testen und zu veröffentlichen

1. Weitere Informationen zum Testen einer Funktion finden Sie unter Funktionen testen. Stellen Sie sicher, dass Sie die Funktion in der DEVELOPMENT-Phase testen.

2. 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.

   Beim Veröffentlichen wird die Version der Funktion von der DEVELOPMENT Bühne in die Live-Phase CloudFront kopiert. 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 Funktionen veröffentlichen.