Magento 2

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.

Post Recentes

Teste de carga no checkout com k6: o script, a leitura do resultado e a hora de parar

Um script k6 que coloca produto no carrinho e abre o checkout do WooCommerce, com thresholds que abortam o teste…

6 horas atrás

Descrição de produto no ChatGPT: o prompt com ficha técnica que não inventa medida

Com a ficha técnica colada no prompt e uma regra para marcar o que falta, o ChatGPT para de inventar…

22 horas atrás

Magento 2 config:set: gravar configuração só num website ou store view

Mude uma configuração apenas para um website pela linha de comando, com --scope e --scope-code, e entenda a herança que…

1 dia atrás

Capturar erro fatal no PHP com register_shutdown_function

Estouro de memória e timeout não caem no try/catch e a página fica branca. Registre um shutdown handler com error_get_last…

2 dias atrás

CLAUDE.md para projeto WordPress: as regras que evitam o Claude Code quebrar o tema

O CLAUDE.md que funciona em projeto WordPress é curto: versões, onde o Claude Code pode mexer, comandos do projeto e…

4 dias atrás

YouTube sem cookie: adiar o embed do vídeo e do Maps até o aceite

Seu banner de consentimento está certo, mas o vídeo incorporado grava cookie de terceiro no primeiro carregamento. Troque o domínio…

5 dias atrás