Tutorial: crea una funzione semplice con CloudFront Functions

Questo tutorial mostra come iniziare a usare CloudFront Functions. Puoi creare una semplice funzione che reindirizza il visualizzatore a un URL diverso e che restituisca anche un'intestazione di risposta personalizzata.

Indice

• Prerequisiti
• Creazione della funzione
• Verifica la funzione

Prerequisiti

Per utilizzare CloudFront Functions, è necessaria una distribuzione. CloudFront Se non disponi di un account, consulta Inizia con una CloudFront distribuzione di base.

Creazione della funzione

Puoi utilizzare la CloudFront console per creare una semplice funzione che reindirizza il visualizzatore a un URL diverso e restituisce anche un'intestazione di risposta personalizzata.

Per creare una funzione CloudFront

1. Accedi a AWS Management Console e apri la CloudFront console all'indirizzohttps://console.aws.amazon.com/cloudfront/v4/home.

2. Nel riquadro di navigazione, scegli Funzioni, quindi scegli Crea funzione.

3. Nella pagina Crea funzione, in Nome, inserisci un nome di funzione come MyFunctionName.

4. (Facoltativo) In Descrizione, inserite una descrizione per la funzione, ad esempioSimple test function.

5. Per Runtime, mantieni la JavaScript versione selezionata di default.

6. Scegli Crea funzione.

7. Copia il seguente codice di funzione. Questo codice funzione reindirizza il visualizzatore a un URL diverso e restituisce anche un'intestazione di risposta personalizzata.

   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. Per il codice Function, incolla il codice nell'editor di codice per sostituire il codice predefinito.

9. Seleziona Salvataggio delle modifiche.

10. (Facoltativo) È possibile testare la funzione prima di pubblicarla. Questo tutorial non descrive come testare una funzione. Per ulteriori informazioni, consulta Funzioni di test.

11. Scegli la scheda Pubblica, quindi scegli la funzione Pubblica. È necessario pubblicare la funzione prima di poterla associare alla CloudFront distribuzione.

12. Successivamente, è possibile associare la funzione a un comportamento di distribuzione o cache. Nella MyFunctionNamepagina, scegli la scheda Pubblica.

    avvertimento

    Nei passaggi seguenti, scegli una distribuzione o un comportamento della cache da utilizzare per i test. Non associate questa funzione di test a un comportamento di distribuzione o cache utilizzato in produzione.

13. Scegliere Add Association (Aggiungi associazione).

14. Nella finestra di dialogo Associa, scegliete una distribuzione e/o un comportamento della cache. Per Tipo di evento, mantenete il valore predefinito.

15. Scegliere Add Association (Aggiungi associazione).

    La tabella Distribuzione associata mostra la distribuzione associata.

16. Attendere alcuni minuti affinché la distribuzione associata finisca la distribuzione. Per verificare lo stato della distribuzione, seleziona la distribuzione nella tabella Distribuzioni associate, quindi scegli Visualizza distribuzione.

    Quando lo stato della distribuzione è Distribuito, sarà possibile verificare che la funzione funziona.

Verifica la funzione

Dopo aver distribuito la funzione, puoi verificare che funzioni per la tua distribuzione.

Per verificare la funzione

1. Nel tuo browser web, accedi al nome di dominio della tua distribuzione (ad esempio,https://d111111abcdef8.cloudfront.net).

   La funzione restituisce un reindirizzamento al browser, quindi il browser passa automaticamente a https://aws.amazon.com/cloudfront/.

2. In una finestra della riga di comando, puoi utilizzare uno strumento come curl inviare una richiesta al nome di dominio della tua distribuzione.

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

   Nella risposta, vengono visualizzati la risposta di reindirizzamento (302 Found) e le intestazioni di risposta personalizzate aggiunte dalla funzione. La tua risposta potrebbe essere simile all'esempio seguente.

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