Tutorial: Erstellen Sie eine einfache Funktion mit CloudFront Funktionen

Dieses Tutorial zeigt Ihnen, wie Sie mit CloudFront Functions beginnen können. Sie können eine einfache Funktion erstellen, die den Betrachter zu einer anderen URL weiterleitet und die auch einen benutzerdefinierten Antwortheader zurückgibt.

Inhalt

• Voraussetzungen
• Erstellen der Funktion
• Überprüfen Sie die Funktion

Voraussetzungen

Um CloudFront Functions verwenden zu können, benötigen Sie eine CloudFront Distribution. Falls Sie keines haben, finden Sie weitere Informationen unter Beginnen Sie mit einer CloudFront Basisdistribution.

Erstellen der Funktion

Sie können die CloudFront Konsole verwenden, um eine einfache Funktion zu erstellen, die den Betrachter zu einer anderen URL weiterleitet und außerdem einen benutzerdefinierten Antwortheader zurückgibt.

Um eine CloudFront Funktion zu erstellen

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

2. Wählen Sie im Navigationsbereich Funktionen und dann Funktion erstellen aus.

3. Geben Sie auf der Seite Funktion erstellen in das Feld Name einen Funktionsnamen ein, z. MyFunctionNameB.

4. (Optional) Geben Sie unter Beschreibung eine Beschreibung für die Funktion ein, z. Simple test function B.

5. Behalten Sie für Runtime die ausgewählte JavaScript Standardversion bei.

6. Wählen Sie Funktion erstellen.

7. Kopieren Sie den folgenden Funktionscode. Dieser Funktionscode leitet den Betrachter auf eine andere URL um und gibt auch einen benutzerdefinierten Antwortheader zurück.

   function handler(event) {
       // NOTE: This example function is for a viewer request event trigger. 
       // Choose viewer request for event trigger when you associate this function with a distribution. 
       var response = {
           statusCode: 302,
           statusDescription: 'Found',
           headers: {
               'cloudfront-functions': { value: 'generated-by-CloudFront-Functions' },
               'location': { value: 'https://aws.amazon.com/cloudfront/' }
           }
       };
       return response;
   }

8. Fügen Sie für Funktionscode den Code in den Code-Editor ein, um den Standardcode zu ersetzen.

9. Wählen Sie Änderungen speichern aus.

10. (Optional) Sie können die Funktion testen, bevor Sie sie veröffentlichen. In diesem Tutorial wird nicht beschrieben, wie eine Funktion getestet wird. Weitere Informationen finden Sie unter Funktionen testen.

11. Wählen Sie die Registerkarte Veröffentlichen und dann die Funktion Veröffentlichen. Sie müssen die Funktion veröffentlichen, bevor Sie sie Ihrer CloudFront Distribution zuordnen können.

12. Als Nächstes können Sie die Funktion einem Verteilungs- oder Cache-Verhalten zuordnen. Wählen Sie auf der MyFunctionNameSeite die Registerkarte Veröffentlichen aus.

    Warnung

    Wählen Sie in den folgenden Schritten eine Verteilung oder ein Cache-Verhalten aus, das zum Testen verwendet wird. Ordnen Sie diese Testfunktion nicht einem Verteilungs- oder Cache-Verhalten zu, das in der Produktion verwendet wird.

13. Wählen Sie Add association.

14. Wählen Sie im Dialogfeld Zuordnen ein Verteilungs- und/oder ein Cache-Verhalten aus. Behalten Sie für Ereignistyp den Standardwert bei.

15. Wählen Sie Add association.

    In der Tabelle Zugeordnete Verteilungen wird die zugeordnete Verteilung angezeigt.

16. Warten Sie ein paar Minuten, bis die zugehörige Verteilung die Bereitstellung abgeschlossen hat. Um den Status der Verteilung zu überprüfen, wählen Sie die Verteilung in der Tabelle Zugeordnete Verteilungen aus und klicken Sie dann auf Verteilung anzeigen.

    Wenn der Status der Verteilung Bereitgestellt lautet, können Sie überprüfen, ob die Funktion funktioniert.

Überprüfen Sie die Funktion

Nachdem Sie die Funktion bereitgestellt haben, können Sie überprüfen, ob sie für Ihre Distribution funktioniert.

Um die Funktion zu überprüfen

1. Navigieren Sie in Ihrem Webbrowser zum Domainnamen Ihrer Distribution (z. B.https://d111111abcdef8.cloudfront.net).

   Die Funktion gibt eine Umleitung an den Browser zurück, sodass der Browser automatisch an weitergeleitet wir https://aws.amazon.com/cloudfront/.

2. In einem Befehlszeilenfenster können Sie beispielsweise ein Tool verwenden, curl um eine Anfrage an den Domainnamen Ihrer Distribution zu senden.

   curl -v https://d111111abcdef8.cloudfront.net/

   In der Antwort sehen Sie die Umleitungsantwort (302 Found) und die benutzerdefinierten Antwort-Header, die die Funktion hinzugefügt hat. Ihre Antwort könnte wie das folgende Beispiel aussehen.

   curl -v https://d111111abcdef8.cloudfront.net/
   > GET / HTTP/1.1
   > Host: d111111abcdef8.cloudfront.net
   > User-Agent: curl/7.64.1
   > Accept: */*
   >
   < HTTP/1.1 302 Found
   < Server: CloudFront
   < Date: Tue, 16 Mar 2021 18:50:48 GMT
   < Content-Length: 0
   < Connection: keep-alive
   < Location: https://aws.amazon.com/cloudfront/
   < Cloudfront-Functions: generated-by-CloudFront-Functions
   < X-Cache: FunctionGeneratedResponse from cloudfront
   < Via: 1.1 3035b31bddaf14eded329f8d22cf188c.cloudfront.net (CloudFront)
   < X-Amz-Cf-Pop: PHX50-C2
   < X-Amz-Cf-Id: ULZdIz6j43uGBlXyob_JctF9x7CCbwpNniiMlmNbmwzH1YWP9FsEHg==