Configuration du vernis avancé

Varnish fournit plusieurs fonctionnalités qui empêchent les clients de subir de longs délais et dépassements de délai lorsque le serveur Commerce ne fonctionne pas correctement. Ces fonctionnalités peuvent être configurées dans le fichier default.vcl. Cette rubrique décrit les ajouts que Commerce fournit dans le fichier VCL (Varnish Configuration Language) que vous téléchargez depuis l’administrateur.

Pour plus d’informations sur l’utilisation du langage de configuration de vernis, voir le manuel de référence de vernis .

Contrôle de l’intégrité

La fonction de contrôle de l’intégrité de Varnish interroge le serveur Commerce pour déterminer s’il répond en temps voulu. S’il répond normalement, le contenu neuf est régénéré après l’expiration de la période de temps d’activation (TTL). Sinon, Varnish diffuse toujours du contenu obsolète.

Commerce définit le contrôle de l’intégrité par défaut suivant :

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

Toutes les 5 secondes, ce contrôle de l’intégrité appelle le script pub/health_check.php. Ce script vérifie la disponibilité du serveur, de chaque base de données et de Redis (s’il est installé). Le script doit renvoyer une réponse dans les 2 secondes. Si le script détermine que l’une de ces ressources est hors service, il renvoie un code d’erreur HTTP 500. Si ce code d’erreur est reçu dans six tentatives sur dix, le serveur principal est considéré comme malsain.

Le script health_check.php se trouve dans le répertoire pub. Si votre répertoire racine Commerce est pub, veillez à modifier le chemin d’accès dans le paramètre url de /pub/health_check.php à health_check.php.

Pour plus d’informations, consultez la documentation Vérification de l’intégrité Varnish .

Mode de grâce

Le mode Grace permet à Varnish de garder un objet en cache au-delà de sa valeur TTL. Le vernis peut ensuite diffuser le contenu obsolète (obsolète) lorsqu’il récupère une nouvelle version. Cela améliore le flux du trafic et réduit les temps de chargement. Il est utilisé dans les situations suivantes :

La sous-routine vcl_hit définit la manière dont Varnish répond à une demande d’objets qui ont été mis en cache.

Lorsque le serveur principal Commerce est sain

Lorsque les contrôles de l’intégrité déterminent que le serveur principal Commerce est sain, Varnish vérifie si le temps reste dans la période de grâce. La période de grâce par défaut est de 300 secondes, mais un commerçant peut définir la valeur de l’administrateur comme décrit dans la section Configurer Commerce pour utiliser le vernis. Si la période de grâce n’a pas expiré, Varnish diffuse le contenu obsolète et actualise de manière asynchrone l’objet à partir du serveur Commerce. Si la période de grâce a expiré, Varnish diffuse le contenu obsolète et actualise de manière synchrone l’objet à partir du serveur principal Commerce.

La durée maximale pendant laquelle Varnish diffuse un objet obsolète est la somme de la période de grâce (300 secondes par défaut) et de la valeur TTL (86 400 secondes par défaut).

Pour modifier la période de grâce par défaut dans le fichier default.vcl, modifiez la ligne suivante dans la sous-routine vcl_hit :

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

Lorsque le serveur principal Commerce n’est pas sain

Si le serveur principal Commerce n’est pas réactif, Varnish diffuse du contenu obsolète du cache pendant trois jours (ou tel que défini dans beresp.grace) plus le reste de la durée de vie (qui, par défaut, est d’un jour), sauf si le contenu mis en cache est purgé manuellement.

Mode Saint

Le mode Saint exclut les arrière-plans malsains pendant une durée configurable. Par conséquent, les arrière-plans malsains ne peuvent pas traiter le trafic lors de l’utilisation de Varnish comme équilibreur de charge. Le mode Saint peut être utilisé avec le mode de grâce pour permettre une gestion complexe des serveurs principaux malsains. Par exemple, si un serveur principal n’est pas sain, les reprises peuvent être routées vers un autre serveur. Si tous les autres serveurs sont en panne, alors diffusez des objets mis en cache obsolètes. Les hôtes principaux du mode saint et les périodes de blackout sont définis dans le fichier default.vcl .

Le mode Saint peut également être utilisé lorsque les instances Commerce sont mises hors ligne individuellement pour effectuer des tâches de maintenance et de mise à niveau sans affecter la disponibilité du site Commerce.

Prérequis du mode Saint

Désignez une machine comme installation principale. Sur cette machine, installez l’instance principale de Commerce, de la base de données mySQL et de Varnish.

Sur tous les autres ordinateurs, l’instance Commerce doit avoir accès à la base de données mySQL de l’ordinateur principal. Les machines secondaires doivent également avoir accès aux fichiers de l’instance Commerce principale.

Vous pouvez également désactiver le contrôle de version des fichiers statiques sur tous les ordinateurs. Vous pouvez y accéder à partir de l’administrateur sous Magasins > Paramètres > Configuration > Avancé > Développeur > Paramètres des fichiers statiques > Signer les fichiers statiques = Non.

Enfin, toutes les instances Commerce doivent être en mode de production. Avant le démarrage de Varnish, effacez le cache de chaque instance. Dans l’administrateur, accédez à Système > Outils > Gestion du cache et cliquez sur Vider le cache du Magento. Vous pouvez également exécuter la commande suivante pour effacer le cache :

bin/magento cache:flush

Installation

Le mode Saint ne fait pas partie du package vernis principal. Il s'agit d'un vmod dont le contrôle de version doit être téléchargé et installé séparément. Par conséquent, vous devez recompiler le vernis à partir de la source, comme décrit dans les instructions d’installation de votre version du vernis.

Après avoir recompilé, vous pouvez installer le module de mode Saint. En général, procédez comme suit :

Pour plus d’informations sur l’installation du module Saint mode, reportez-vous à la section Collection de modules vernis.

Exemple de fichier VCL

L’exemple de code suivant illustre le code qui doit être ajouté à votre fichier VCL pour activer le mode saint. Placez les instructions import et les définitions backend en haut du fichier.

import saintmode;
import directors;

backend default1 {
    .host = "192.168.0.1";
    .port = "8080";
    .first_byte_timeout = 600s;
    .probe = {
        .url = "/pub/health_check.php";
        .timeout = 2s;
        .interval = 5s;
        .window = 10;
        .threshold = 5;
    }
}

backend default2 {
    .host = "192.168.0.2";
    .port = "8080";
    .first_byte_timeout = 600s;
    .probe = {
        .url = "/pub/health_check.php";
        .timeout = 2s;
        .interval = 5s;
        .window = 10;
        .threshold = 5;
    }
}

sub vcl_init {
    # Instantiate sm1, sm2 for backends tile1, tile2
    # with 10 blacklisted objects as the threshold for marking the
    # whole backend sick.
    new sm1 = saintmode.saintmode(default1, 10);
    new sm2 = saintmode.saintmode(default2, 10);

    # Add both to a director. Use sm0, sm1 in place of tile1, tile2.
    # Other director types can be used in place of random.
    new magedirector = directors.random();
    magedirector.add_backend(sm1.backend(), 1);
    magedirector.add_backend(sm2.backend(), 1);
}

sub vcl_backend_fetch {
    # Get a backend from the director.
    # When returning a backend, the director will only return backends
    # saintmode says are healthy.
    set bereq.backend = magedirector.backend();
}

sub vcl_backend_response {
    if (beresp.status >= 500) {
        # This marks the backend as sick for this specific
        # object for the next 20s.
        saintmode.blacklist(20s);
        # Retry the request. This will result in a different backend
        # being used.
        return (retry);
    }
}