Tutorial: Creazione di una funzione semplice con Funzioni CloudFront - Amazon CloudFront
PrerequisitiCreazione della funzioneVerifica della funzione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tutorial: Creazione di una funzione semplice con Funzioni CloudFront

Questo tutorial illustra come iniziare a utilizzare Funzioni CloudFront. Puoi creare una semplice funzione che reindirizza il visualizzatore a un URL diverso e che restituisce anche un’intestazione di risposta personalizzata.

Prerequisiti

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

Creazione della funzione

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

Come creare una funzione CloudFront

  1. Accedi alla Console di gestione AWS e apri la console CloudFront all'indirizzo https://console.aws.amazon.com/cloudfront/v4/home.

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

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

  4. (Facoltativo) In Descrizione, immetti una descrizione per la funzione, ad esempio Simple test function.

  5. Per Runtime, mantieni la versione JavaScript selezionata predefinita.

  6. Scegli Crea funzione.

  7. Copia il codice funzione riportato di seguito. 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 Codice funzione, incolla il codice nell’editor di codice per sostituire il codice predefinito.

  9. Scegli Save changes (Salva modifiche).

  10. (Facoltativo) Puoi testare la funzione prima di pubblicarla. In questo tutorial non viene descritto come testare una funzione. Per ulteriori informazioni, consulta Test delle funzioni.

  11. Scegli la scheda Pubblica, quindi seleziona funzione Pubblica. Devi pubblicare la funzione prima di poterla associare alla distribuzione CloudFront.

  12. Quindi, puoi associare la funzione a una distribuzione e al comportamento cache. Nella pagina MyFunctionName, seleziona la scheda Pubblica.

    avvertimento

    Nella procedura seguente, seleziona una distribuzione o un comportamento cache utilizzati per il test. Non associare questa funzione di test a una distribuzione o comportamento cache utilizzati in produzione.

  13. Scegliere Add Association (Aggiungi associazione).

  14. Nella finestra di dialogo Associa, seleziona una distribuzione e/o un comportamento cache. Per Tipo di evento, mantieni 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, selezionala nella tabella Distribuzioni associate e scegli Visualizza distribuzione.

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

Verifica della funzione

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

Come verificare la funzione

  1. Nel browser web, vai al nome di dominio della 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 per inviare una richiesta al nome di dominio della 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. L’aspetto della risposta potrebbe essere simile a quella del seguente esempio.

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