Tutorial: creazione di una funzione CloudFront che includa valori delle chiavi - Amazon CloudFront

Tutorial: creazione di una funzione CloudFront che includa valori delle chiavi

Questo tutorial mostra come includere valori delle chiavi con la funzione CloudFront. I valori delle chiavi fanno parte di una coppia chiave-valore. Il nome (della coppia chiave-valore) viene incluso nel codice della funzione. Quando la funzione viene eseguita, CloudFront sostituisce il nome con il valore.

Le coppie chiave-valore sono variabili memorizzate in un archivio di valori delle chiavi. Se vi utilizzi una chiave (anziché valori a codifica fissa), la funzione è più flessibile. Puoi modificare il valore della chiave senza dover implementare modifiche al codice. Le coppie chiave-valore possono anche ridurre le dimensioni della funzione. Per ulteriori informazioni, consulta Amazon CloudFront KeyValueStore.

Prerequisiti

Se non hai familiarità con le Funzioni CloudFront e l’archivio di valori delle chiavi, ti consigliamo di seguire il tutorial in Tutorial: Creazione di una funzione semplice con Funzioni CloudFront.

Dopo aver completato il tutorial, puoi seguirlo per estendere la funzione che hai creato. Per questo tutorial, ti consigliamo di creare prima l’archivio di valori delle chiavi.

Creazione dell’archivio di valori delle chiavi

Innanzitutto, crea l’archivio di valori delle chiavi da utilizzare per la funzione.

Come creare l’archivio di valori delle chiavi
  1. Pianifica le coppie chiave-valore da includere nella funzione. Annota i nomi delle chiavi. Le coppie chiave-valore da utilizzare in una funzione devono trovarsi in un unico archivio di valori delle chiavi.

  2. Decidi l'ordine di lavoro. Puoi procedere in due modi:

    • Crea un archivio di valori delle chiavi e aggiungi coppie chiave-valore. Quindi puoi creare (o modificare) la funzione e incorporare i nomi delle chiavi.

    • In alternativa, puoi creare (o modificare) la funzione e incorporare i nomi delle chiavi da utilizzare. Quindi, crea un archivio di valori delle chiavi e aggiungi le coppie chiave-valore.

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

  4. Nel riquadro di navigazione, scegli Funzioni, quindi seleziona la scheda KeyValueStores.

  5. Scegli Crea KeyValueStore e completa i campi seguenti:

    • Immetti un nome e una descrizione (facoltativa) per l’archivio.

    • Lascia vuoto il campo URI S3. In questo tutorial le coppie chiave-valore verranno inserite manualmente.

  6. Seleziona Create (Crea). Viene visualizzata la pagina dei dettagli relativa al nuovo archivio di valori delle chiavi. Questa pagina include una sezione Coppie chiave-valore che al momento è vuota.

Aggiunta di coppie chiave-valore all’archivio di valori delle chiavi

Successivamente, aggiungi manualmente un elenco di coppie chiave-valore all’archivio di valori delle chiavi creato in precedenza.

Come aggiungere coppie chiave-valore all’archivio di valori delle chiavi
  1. Nella sezione Coppie chiave-valore, scegli Aggiungi coppie chiave-valore.

  2. Scegli Aggiungi coppia e quindi inserisci una chiave e un valore. Seleziona il segno di spunta per confermare le modifiche e ripeti questa fase per aggiungerne altre.

  3. Al termine, scegli Salva modifiche per salvare le coppie chiave-valore nell’archivio di valori delle chiavi. Nel finestra di dialogo di conferma, seleziona Fatto.

Ora hai un archivio di valori delle chiavi che contiene un gruppo di coppie chiave-valore.

Associazione dell’archivio di valori delle chiavi alla funzione

Ora hai creato l'archivio di valori delle chiavi. Hai inoltre creato o modificato una funzione che include i nomi delle chiavi dall'archivio di valori delle chiavi. Ora puoi associare l'archivio di valori delle chiavi e la funzione. È possibile creare tale associazione dall'interno della funzione.

Come associare l’archivio di valori delle chiavi alla funzione
  1. Nel riquadro di navigazione, seleziona Funzioni. Per impostazione predefinita, la scheda Funzioni viene visualizzata in alto.

  2. Scegli il nome della funzione e nella sezione KeyValueStore associato, scegli Associa KeyValueStore esistente.

  3. Seleziona l’archivio di valori delle chiavi e scegli Associa KeyValueStore.

Nota

Puoi associare un solo archivio di valori delle chiavi a ciascuna funzione.

Test e pubblicazione del codice della funzione

Dopo aver associato l’archivio dei valori delle chiavi alla funzione, puoi testare e pubblicare il codice della funzione. È sempre consigliabile testare il codice della funzione a ogni modifica, anche per le seguenti operazioni:

  • Associazione dell'archivio di valori delle chiavi alla funzione

  • Modifica la funzione e il rispettivo archivio di valori delle chiavi per includere una nuova coppia chiave-valore.

  • Modifica il valore di una coppia chiave-valore.

Come eseguire il test e pubblicare il codice della funzione
  1. Per ulteriori informazioni su come testare una funzione, consulta Test delle funzioni. Verifica di aver scelto di testare la funzione nella fase DEVELOPMENT.

  2. Pubblica la funzione quando hai tutto pronto per utilizzarla (con le coppie chiave-valore nuove o modificate) in un ambiente LIVE.

    Quando esegui la pubblicazione, CloudFront copia la versione della funzione dalla fase DEVELOPMENT alla fase live. La funzione ha il nuovo codice ed è associata all'archivio di valori delle chiavi. Non è necessario ripetere l'associazione nella fase live.

    Per ulteriori informazioni su come pubblicare una funzione, consulta Pubblicazione di funzioni.