DocumentaçãoCommerceGuia do Commerce na infraestrutura em nuvem

VCL personalizado para ignorar o cache do Fastly

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Desenvolvedor

Você pode criar um trecho de VCL personalizado para ignorar o cache do Fastly e solucionar problemas no tráfego de solicitação para o servidor de origem. Por exemplo, você pode criar um trecho para determinar se os problemas do site são causados por cache ou para solucionar problemas de cabeçalhos.

Você pode configurar o trecho para ignorar o cache rápido de solicitações de um endereço IP ou URL específico.

NOTE
Antes de mesclar a configuração de VCL personalizada em um ambiente de produção, certifique-se de testar o código no ambiente de preparo.

Pré-requisitos:

  • Seu ambiente deve ser configurado para usar o Fastly CDN. Consulte Configurar serviços do Fastly.

  • Verifique se você está executando a versão mais recente do módulo CDN Fastly para o Magento 2. Consulte Atualizar o Módulo Fastly.

  • Verifique a configuração do ambiente para o serviço Fastly. Consulte Verificar cache rápido.

  • Você deve ter credenciais de Administrador para acessar os ambientes de Preparo e Produção.

Para ignorar o cache do Fastly com base no endereço IP ou na URL:

  1. Faça logon no Administrador.

  2. Clique em Lojas > Configurações > Configuração > Avançado > Sistema.

  3. Expanda Cache de Página Inteira > Configuração Rápida > Trechos de VCL Personalizados.

  4. Clique em Criar trecho personalizado.

  5. Adicione os valores do trecho de VCL:

    • Nome — bypass_fastly

    • Tipo — recv

    • Prioridade — 5

    • VCL conteúdo do trecho —

      O exemplo a seguir ignora o Fastly para um endereço IP específico:

      code language-conf 
      if (client.ip == "<Your IPv4 IP address>" || client.ip == "<Your IPv6 IP address>") {
  return(pass);
}

      O exemplo a seguir ignora o Fastly para um padrão de URL específico:

      code language-conf 
      if (req.url ~ "/media/feeds/GoogleShoppingHiVisNew.xml") {  return (pass);}

      Para uma correspondência exata de URL, use o operador == em vez do operador ~. Consulte a [Referência de VCL do Fastly] para obter detalhes.

  6. Clique em Criar.

    Criar/Ignorar Fastly no trecho do VCL

  7. Depois que a página for recarregada, clique em Carregar VCL para Fastly na seção Configuração Fastly.

  8. Depois que o upload for concluído, atualize o cache de acordo com a notificação na parte superior da página.

    O Fastly valida a versão atualizada do VCL durante o processo de upload. Se a validação falhar, edite o trecho de VCL personalizado para corrigir os problemas. Em seguida, carregue o VCL novamente.

Depois de adicionar o trecho VCL, você pode usar comandos cURL para enviar solicitações ao servidor de origem a partir do endereço IP ou URL especificado, conforme mostrado no exemplo a seguir:

curl -svo /dev/null www.example.com/index.html

Em seguida, inspecione a resposta para solucionar problemas com o conteúdo não armazenado em cache.

NOTE
Em vez de carregar manualmente trechos de VCL personalizados, você pode adicionar trechos ao diretório $MAGENTO_CLOUD_APP_DIR/var/vcl_snippets_custom em seu ambiente. Os trechos neste diretório são carregados automaticamente quando você clica em carregar VCL para Fastly no Commerce Admin. Consulte Implantação automatizada de trechos de VCL personalizados no módulo Fastly CDN para obter a documentação do Magento 2.

Modificar o trecho de VCL personalizado

  1. Faça logon no Administrador.

  2. Clique em Lojas > Configurações > Configuração > Avançadas > Sistema.

  3. Expanda Cache de Página Inteira > Configuração Rápida > Trechos de VCL Personalizados.

    Gerenciar trechos de VCL personalizados

  4. Na coluna Ação, clique no ícone de configurações ao lado do trecho a ser editado.

  5. Depois que a página for recarregada, clique em Carregar VCL para Fastly na seção Configuração Fastly.

  6. Depois que o upload for concluído, atualize o cache de acordo com a notificação na parte superior da página.

WARNING
A opção Custom VCL snippets UI mostra apenas os trechos adicionados pelo Administrador do Adobe Commerce. Se você adicionar trechos usando a API Fastly, use a API para gerenciá-los.

Excluir o trecho de VCL personalizado

  1. Faça logon no Administrador.

  2. Clique em Lojas > Configurações > Configuração > Avançadas > Sistema.

  3. Expanda Cache de Página Inteira > Configuração Rápida > Trechos de VCL Personalizados.

    Gerenciar trechos de VCL personalizados

  4. Na coluna Ação, clique no ícone de lixeira ao lado do trecho a ser excluído.

  5. Na próxima janela modal, clique em DELETE e ative uma nova versão.

WARNING
A opção Custom VCL snippets UI mostra apenas os trechos adicionados pelo Administrador do Adobe Commerce. Se você adicionar trechos usando a API Fastly, use a API para gerenciá-los.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26