Tutorial: crea una CloudFront funzione che includa valori chiave

Questo tutorial mostra come includere i valori chiave nella CloudFront funzione. I valori chiave fanno parte di una coppia chiave-valore. Il nome (dalla 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 chiave. 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.

Indice

• Prerequisiti
• Crea il Key Value Store
• Aggiungi coppie chiave-valore all'archivio chiave-valore
• Associa l'archivio di valori chiave alla funzione
• Testate e pubblicate il codice della funzione

Prerequisiti

Se non conosci CloudFront le funzioni di Functions e l'archivio di valori chiave, ti consigliamo di seguire il tutorial in. Tutorial: crea una funzione semplice con CloudFront Functions

Dopo aver completato il tutorial, puoi seguire questo tutorial per estendere la funzione che hai creato. Per questo tutorial, ti consigliamo di creare prima l'archivio di valori chiave.

Crea il Key Value Store

Innanzitutto, crea l'archivio di valori chiave da utilizzare per la tua funzione.

Per creare l'archivio di valori chiave

1. Pianificate 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 chiave-valore.

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

   • Create un archivio chiave-valore e aggiungete coppie chiave-valore all'archivio. 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 chiave e aggiungi le coppie chiave-valore.

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

4. Nel riquadro di navigazione, scegli Funzioni, quindi scegli la KeyValueStoresscheda.

5. Scegli Crea KeyValueStore e inserisci i seguenti campi:

   • Inserisci un nome e una descrizione (opzionale) per il negozio.

   • Lascia vuoto l'URI S3. In questo tutorial inserirai manualmente le coppie chiave-valore.

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

Aggiungi coppie chiave-valore all'archivio chiave-valore

Quindi, aggiungi manualmente un elenco di coppie chiave-valore all'archivio chiave-valore creato in precedenza.

Per aggiungere coppie chiave-valore all'archivio chiave-valore

1. Nella sezione Coppie chiave-valore, scegli Aggiungi coppie chiave-valore.

2. Scegli Aggiungi coppia, quindi inserisci una chiave e un valore. Scegli il segno di spunta per confermare le modifiche e ripeti questo passaggio per aggiungerne altre.

3. Al termine, scegli Salva modifiche per salvare le coppie chiave-valore nell'archivio chiave-valore. Nella finestra di dialogo di conferma, scegli Fine.

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

Associa l'archivio di valori chiave 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.

Per associare l'archivio di valori chiave alla funzione

1. Nel riquadro di navigazione, seleziona Funzioni. Per impostazione predefinita, la scheda Funzioni viene visualizzata in alto.

2. Scegliete il nome della funzione e nella KeyValueStore sezione Associato, scegliete Associa esistente KeyValueStore.

3. Seleziona l'archivio di valori chiave e scegli Associa KeyValueStore.

Nota

È possibile associare solo un archivio di valori chiave a ciascuna funzione.

Testate e pubblicate il codice della funzione

Dopo aver associato il key value store alla funzione, è possibile 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

• Modificate la funzione e il relativo archivio di valori chiave per includere una nuova coppia chiave-valore.

• Modifica il valore di una coppia chiave-valore.

Per testare e pubblicare il codice della funzione

1. Per ulteriori informazioni su come testare una funzione, consulta Funzioni di test. Verifica di aver scelto di testare la funzione nella fase DEVELOPMENT.

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

   Quando CloudFront pubblicate, copia la versione della funzione dallo DEVELOPMENT stage al live stage. 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 Funzioni di pubblicazione.