Varnish VCL Magento 2.4.8: gerar o default.vcl com ACL de purge e probe

Quase todo default.vcl que me mandam pra revisar veio de um post de 2019, e o estrago é sempre o mesmo par: o botão de limpar cache do admin não chega no Varnish, e quando o PHP-FPM cai o Varnish segue servindo página como se a loja estivesse de pé. Falta a ACL de purge e falta o probe. O Magento monta esse arquivo com os dois no lugar.

Gere o VCL pelo próprio bin/magento

cd /var/www/loja
bin/magento varnish:vcl:generate 
  --access-list=localhost 
  --access-list=127.0.0.1 
  --backend-host=127.0.0.1 
  --backend-port=8080 
  --grace-period=300 
  --export-version=7 
  --output-file=/tmp/default.vcl

sudo varnishd -C -f /tmp/default.vcl > /dev/null 
  && sudo cp /tmp/default.vcl /etc/varnish/default.vcl 
  && sudo systemctl restart varnish

Três detalhes que fazem o arquivo sair errado. O --access-list é opção de array do Symfony: com --access-list="localhost,127.0.0.1" o Magento escreve "localhost,127.0.0.1"; como entrada única na ACL e o VCL nem compila — repita a flag por IP. O --export-version no 2.4.8 aceita só 6 e 7; outro valor devolve Unsupported varnish version, e instalação mais velha da linha 2.4 nem tem o template 7. E o --output-file vai pro /tmp porque o bin/magento roda como usuário do site e não escreve em /etc/varnish. O varnishd -C só compila e joga fora, serve de conferência; o restart esvazia o cache inteiro, faça fora do pico.

O probe e o purge

No arquivo gerado, dentro do bloco backend default, tem um .probe apontando pra /health_check.php — o pub/health_check.php da instalação, que abre conexão com o banco e responde 200 só se a loja estiver viva. Sem ele o Varnish nunca marca o backend como doente. Confira com varnishadm backend.list: tem que sair Healthy. O --backend-port=8080 pressupõe o nginx escutando em 8080 e o Varnish na 80.

Já o --access-list vira a ACL purge, que autoriza o método PURGE. Falta dizer pro Magento pra onde mandar essa requisição, senão o botão do admin limpa só o cache local:

bin/magento setup:config:set --http-cache-hosts=127.0.0.1:80
bin/magento config:set system/full_page_cache/caching_application 2
bin/magento cache:flush

Se travou nisso e precisa de ajuda, me chama aqui.

Dúvidas? Faça um comentário logo abaixo ou envie uma mensagem clicando aqui.

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *