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

Dieses Tutorial zeigt Ihnen, wie Sie Schlüsselwerte in CloudFront Funktionen 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, wird der Name durch den Wert CloudFront 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 des Schlüsselwertspeichers

• Hinzufügen von Schlüssel-Wert-Paaren zum Schlüsselwertspeicher

• Zuordnen des Schlüsselwertspeichers zur Funktion

• Testen und Veröffentlichen des Funktionscodes

Voraussetzungen

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

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

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 an AWS-Managementkonsole und öffnen Sie die CloudFront Konsole unterhttps://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 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.

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

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

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.

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

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 Bereich 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 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

1. Weitere Informationen zum Testen einer Funktion finden Sie unter Testfunktionen. 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 Veröffentlichen von Funktionen.