Guida introduttiva a VCL personalizzato

Fastly supporta una versione personalizzata del linguaggio di configurazione della vernice (VCL) per adattare la configurazione del servizio Fastly alle tue esigenze.

I snippet VCL personalizzati sono blocchi di logica VCL aggiunti alla versione VCL attiva caricata sul sito Adobe Commerce. Un frammento VCL personalizzato modifica la risposta dei servizi di memorizzazione nella cache rapida al traffico di richiesta. Ad esempio, puoi aggiungere uno snippet VCL personalizzato per consentire il traffico delle richieste solo dagli indirizzi IP dei client specificati. In alternativa, crea uno snippet per bloccare il traffico proveniente da siti web noti per l’invio di spam di riferimento ai siti Adobe Commerce.

Snippet VCL personalizzati, generati, compilati e trasmessi a tutte le cache Fastly, vengono caricati e attivati senza tempi di inattività del server.

Fastly supporta due tipi di snippet VCL personalizzati:

È consigliabile utilizzare snippet VCL personalizzati con dizionari di Edge ed elenchi di controllo di accesso (ACL) per memorizzare i dati utilizzati nel codice personalizzato.

I dati del dizionario e dell’ACL vengono distribuiti nei nodi Fastly Edge, accessibili da un’area all’altra della rete. Inoltre, i dati possono essere aggiornati dinamicamente in tutta la rete senza richiedere la ridistribuzione del codice VCL per l’ambiente di staging o produzione.

Esercitazione

Questa esercitazione ed esempi illustrano l’utilizzo di snippet VCL personalizzati regolari con dizionari di Edge e ACL di Edge per personalizzare la configurazione del servizio Fastly per Adobe Commerce. Per informazioni più dettagliate, consulta la documentazione Fastly:

Puoi creare e gestire snippet VCL personalizzati dall’amministratore di Adobe Commerce o utilizzando l’API Fastly:

Esempio di codice snippet VCL

L’esempio seguente mostra lo snippet VCL personalizzato (formato JSON) che filtra il traffico in base all’indirizzo IP del client:

{
  "service_id": "FASTLY_SERVICE_ID",
  "version": "{Editable Version #}",
  "name": "apply_acl",
  "priority": "100",
  "dynamic": "1",
  "type": "hit",
  "content": "if ((client.ip ~ {ACLNAME}) && !req.http.Fastly-FF){ error 403; }"
}

La logica VCL nel campo content esegue le azioni seguenti:

Nella tabella seguente vengono forniti i dettagli sui dati chiave per i snippet VCL personalizzati. Per maggiori dettagli, consulta il riferimento a snippet VCL nella documentazione di Fastly.

Gestisci VCL personalizzato da amministratore

È possibile aggiungere snippet VCL personalizzati dalla sezione Configurazione rapida > Snippet VCL personalizzati nell'amministratore.

La visualizzazione Snippet VCL personalizzati mostra solo i frammenti aggiunti tramite l'amministratore. Se vengono aggiunti snippet utilizzando l'API Fastly, utilizza l'API per gestirli.

Gli esempi seguenti mostrano come creare e gestire snippet VCL personalizzati dall’amministratore e utilizzare i moduli Fastly Edge e i dizionari Edge:

Gestire VCL tramite l’API

La procedura dettagliata seguente illustra come creare file di snippet VCL regolari e aggiungerli alla configurazione del servizio Fastly utilizzando l’API Fastly. È possibile creare e gestire i frammenti dall'applicazione terminal. Non è necessaria una connessione SSH in un ambiente specifico.

Prerequisiti:

Aggiungi snippet VCL

Questo tutorial illustra i passaggi di base per aggiungere snippet personalizzati utilizzando l’API Fastly.

Prerequisiti

Passaggio 1: individuare la versione VCL attiva

Utilizza l'operazione Fastly API get version per ottenere il numero di versione VCL attivo:

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/active

Nella risposta JSON, annota il numero di versione VCL attivo restituito nella chiave number, ad esempio "number": 99. Il numero di versione è necessario quando clonate il file VCL per la modifica.

{
  "testing": false,
  "locked": true,
  "number": 99,
  "active": true,
  "service_id": "872zhjyxhto5SIRb3GAE0",
  "staging": false,
  "created_at": "2019-01-29T22:38:53Z",
  "deleted_at": null,
  "comment": "Magento Module uploaded VCL",
  "updated_at": "2019-01-29T22:39:06Z",
  "deployed": false
}

Salva il numero di versione attivo in una variabile di ambiente di base da utilizzare nelle richieste API successive:

export FASTLY_VERSION_ACTIVE=<Version>

Passaggio 2: clonare la versione VCL attiva e tutti i frammenti

Prima di poter aggiungere o modificare snippet VCL personalizzati, è necessario creare una copia della versione VCL attiva per la modifica. Utilizza l'operazione clone dell'API Fastly:

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/$FASTLY_VERSION_ACTIVE/clone -X PUT

Nella risposta JSON, il numero di versione viene incrementato e il valore della chiave active è false. È possibile modificare localmente la nuova versione VCL inattiva.

{
  "testing": false,
  "locked": false,
  "number": 100,
  "active": false,
  "service_id": "vW2bLFWhhto5SIRb3GAE0",
  "staging": false,
  "created_at": "2019-01-29T22:38:53Z",
  "deleted_at": null,
  "comment": "Magento Module uploaded VCL",
  "updated_at": "2019-01-29T22:39:06Z",
  "deployed": false
}

Salva il nuovo numero di versione in una variabile di ambiente bash da utilizzare nei comandi successivi:

export FASTLY_EDIT_VERSION=<Version>

Passaggio 3: creare uno snippet VCL personalizzato

Crea e salva il codice VCL personalizzato in un file JSON con il contenuto e il formato seguenti:

{
  "name": "<name>",
  "dynamic": "0",
  "type": "<type>",
  "priority": "100",
  "content": "<code all in one line>"
}

I valori includono:

Passaggio 4: aggiungere lo snippet VCL alla configurazione Fastly

Utilizzare l'operazione Fastly API create snippet per aggiungere lo snippet VCL personalizzato alla versione VCL.

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/$FASTLY_EDIT_VERSION/snippet -H 'Content-Type: application/json' -X POST --data @<filename.json>

<filename.json> è il nome del file preparato nel passaggio precedente. Ripetete questo comando per ogni frammento VCL.

Se ricevi una risposta 500 Internal Server Error dal servizio Fastly, controlla la sintassi del file JSON per assicurarti di caricare un file valido.

Passaggio 5: Convalidare e attivare snippet VCL personalizzati

Dopo aver aggiunto uno snippet VCL personalizzato, Fastly inserisce lo snippet nella versione VCL che si sta modificando. Per applicare le modifiche, completare i passaggi seguenti per convalidare il codice dello snippet VCL e attivare la versione VCL.

Riferimento rapido API per snippet VCL

Questi esempi di richieste API utilizzano variabili di ambiente esportate per fornire le credenziali di autenticazione con Fastly. Per informazioni dettagliate su questi comandi, vedere Riferimento API Fastly.