Configurazione vernice avanzata

Ultimo aggiornamento: 15 luglio 2024

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

Vernice offre diverse funzioni che impediscono ai clienti di riscontrare lunghi ritardi e timeout quando il server Commerce non funziona correttamente. Queste funzionalità possono essere configurate nel file default.vcl. In questo argomento vengono descritte le aggiunte fornite da Commerce nel file VCL (Vernice Configuration Language) scaricato dall'amministratore.

Per informazioni dettagliate sull'utilizzo del linguaggio di configurazione vernice, vedere il manuale di riferimento vernice.

Verifica stato

La funzione di controllo dello stato di vernice esegue un polling nel server Commerce per determinare se sta rispondendo in modo tempestivo. Se risponde normalmente, il contenuto fresco viene rigenerato dopo la scadenza del periodo Time to Live (TTL). In caso contrario, vernice fornisce sempre contenuti non aggiornati.

Commerce definisce il seguente controllo di integrità predefinito:

.probe = {
    .url = "/pub/health_check.php";
    .timeout = 2s;
    .interval = 5s;
    .window = 10;
    .threshold = 5;
    }

Ogni 5 secondi, questo controllo di integrità chiama lo script pub/health_check.php. Questo script controlla la disponibilità del server, di ogni database e di Redis (se installato). Lo script deve restituire una risposta entro 2 secondi. Se lo script determina che una di queste risorse non è disponibile, restituisce un codice di errore HTTP 500. Se questo codice di errore viene ricevuto in sei tentativi su dieci, il backend viene considerato non integro.

Lo script health_check.php si trova nella directory pub. Se la directory principale di Commerce è pub, assicurarsi di cambiare il percorso nel parametro url da /pub/health_check.php a health_check.php.

Per ulteriori informazioni, consulta la documentazione sui controlli di integrità della vernice.

Modalità di tolleranza

La modalità di tolleranza consente a Varnish di mantenere un oggetto nella cache oltre il suo valore TTL. La vernice può quindi fornire il contenuto scaduto (non aggiornato) mentre recupera una nuova versione. Questo migliora il flusso del traffico e riduce i tempi di caricamento. Viene utilizzato nelle seguenti situazioni:

  • Quando il backend Commerce è integro, ma una richiesta richiede più tempo del normale
  • Quando il backend Commerce non è integro.

La subroutine vcl_hit definisce il modo in cui Vernice risponde a una richiesta per gli oggetti che sono stati memorizzati nella cache.

Quando il backend Commerce è integro

Quando i controlli di integrità determinano che il backend di Commerce è integro, Vernice controlla se il tempo rimane nel periodo di tolleranza. Il periodo di tolleranza predefinito è di 300 secondi, ma un commerciante può impostare il valore dall'amministratore come descritto in Configurare Commerce per l'utilizzo di vernice. Se il periodo di tolleranza non è scaduto, Vernice distribuisce il contenuto non aggiornato e aggiorna l'oggetto in modo asincrono dal server Commerce. Se il periodo di tolleranza è scaduto, Vernice fornisce il contenuto non aggiornato e aggiorna in modo sincrono l'oggetto dal backend di Commerce.

Il periodo di tempo massimo per il quale Vernice fornisce un oggetto non aggiornato è la somma del periodo di tolleranza (300 secondi per impostazione predefinita) e del valore TTL (86400 secondi per impostazione predefinita).

Per modificare il periodo di tolleranza predefinito dall'interno del file default.vcl, modificare la riga seguente nella subroutine vcl_hit:

if (obj.ttl + 300s > 0s) {

Quando il backend Commerce non è integro

Se il backend di Commerce non risponde, Vernice fornisce contenuto non aggiornato dalla cache per tre giorni (o come definito in beresp.grace) più il TTL rimanente (che per impostazione predefinita è di un giorno), a meno che il contenuto memorizzato nella cache non venga eliminato manualmente.

Modalità Saint

La modalità Saint esclude i backend non integri per un periodo di tempo configurabile. Di conseguenza, i backend non integri non possono servire il traffico quando si utilizza Vernice come load balancer. La modalità Saint può essere utilizzata con la modalità grace per consentire una gestione complessa di server back-end non integri. Ad esempio, se un server back-end non è integro, i nuovi tentativi possono essere instradati a un altro server. Se tutti gli altri server non sono attivi, distribuire oggetti memorizzati nella cache non aggiornati. Gli host back-end in modalità saint e i periodi di sospensione attività sono definiti nel file default.vcl.

La modalità Saint può essere utilizzata anche quando le istanze di Commerce vengono portate offline singolarmente per eseguire attività di manutenzione e aggiornamento senza influire sulla disponibilità del sito Commerce.

Prerequisiti per la modalità Saint

Designare un computer come installazione principale. Su questo computer installare l'istanza principale di Commerce, del database mySQL e di Vernice.

Su tutti gli altri computer, l'istanza di Commerce deve avere accesso al database mySQL del computer primario. Anche i computer secondari devono avere accesso ai file dell'istanza Commerce primaria.

In alternativa, il controllo delle versioni dei file statici può essere disattivato su tutti i computer. È possibile accedervi dall'amministratore in Archivi > Impostazioni > Configurazione > Avanzate > Sviluppo > Impostazioni file statici > Firma file statici = No.

Infine, tutte le istanze di Commerce devono essere in modalità di produzione. Prima dell'avvio di Vernice, cancellare la cache su ogni istanza. In Amministrazione, passare a Sistema > Strumenti > Gestione cache e fare clic su Svuota cache di Magento. Per cancellare la cache, puoi anche eseguire il seguente comando:

bin/magento cache:flush