Backup da loja Magento: o que a cópia precisa conter para a loja voltar a vender

Backup só do banco da loja Magento basta?

Não. O banco guarda produtos, clientes, pedidos e a maior parte da configuração, mas a loja que vende depende de mais peças: as imagens, o código com módulos e tema, as versões exatas das dependências, as credenciais do ambiente e a configuração do servidor. Restaurar só o banco numa instalação nova devolve os dados sem a loja em volta deles.

A ferramenta de backup do próprio Magento já separava código, mídia e banco em três arquivos, e deixava de fora as pastas var e pub/static. Essa ferramenta está marcada como obsoleta pela Adobe desde as versões 2.1.16, 2.2.7 e 2.3.0, com a recomendação de usar outras tecnologias de backup. O recorte continua útil: uma loja Magento tem partes diferentes, e cada uma precisa estar em algum lugar da cópia.

Aqui o assunto é o que a cópia precisa conter. A prova de que ela restaura é o teste trimestral do calendário de manutenção preventiva.

O que incluir no backup da loja Magento: as oito partes

Sobre o pub/media no backup do Magento: as fotos de produto e as imagens de categorias e blocos ficam nessa pasta, e não no banco. Um dump perfeito, sem ela, devolve o catálogo inteiro sem imagem.

Chave de criptografia do env.php no backup: a armadilha mais cara

O Magento guarda alguns dados no banco criptografados com a chave que fica em app/etc/env.php, no item crypt/key (é o mesmo lugar na 2.4.8 e na 2.4.9). No código da 2.4.8-p4, por exemplo, entram nessa lista a senha do SMTP configurada no admin, credenciais de módulos de frete e de pagamento, as chaves do reCAPTCHA, a configuração de 2FA de cada administrador e os segredos das integrações OAuth.

Restaurar o banco com um env.php sem a chave original dá uma loja que abre, mas não consegue ler esses valores: o envio pelo SMTP falha, o módulo de frete ou de pagamento não autentica e as integrações precisam de credenciais novas. Três cuidados:

• guarde uma cópia do env.php com acesso restrito e fora de qualquer pasta pública;
• a cada troca de chave com bin/magento encryption:key:change, faça uma cópia nova do env.php: a antiga não tem a chave nova, e a Adobe lembra que ela é necessária para decifrar os dados;
• não versione o env.php nem o auth.json; a documentação do Composer recomenda manter o auth.json no .gitignore.

O que não precisa entrar no backup do Magento

Algumas pastas são geradas a partir do código e do banco. Copiar essas pastas só aumenta o tamanho e a duração do backup:

• var/cache e var/page_cache: cache, recriado com a loja em uso;
• generated: classes geradas pela compilação;
• pub/static: arquivos publicados pelo deploy de estáticos;
• índice do OpenSearch: refeito pela reindexação a partir do banco.

O detalhe é que reconstruir leva tempo. Compilação, deploy de estáticos e reindexação entram na conta da restauração, e com catálogo grande isso pesa. Já var/log e var/report não são necessários para a loja voltar, mas guardar alguns dias deles ajuda a investigar o que aconteceu.

Backup da hospedagem ou snapshot do Adobe Commerce Cloud substituem o seu?

O backup da hospedagem cobre a loja Magento? Pode cobrir, mas cada hospedagem define o próprio serviço. Confirme por escrito:

1. O banco é copiado com dump consistente ou só como cópia de arquivos com o banco rodando?
2. pub/media e app/etc entram na cópia?
3. A cópia fica fora do servidor e fora da mesma conta?
4. Por quantos dias ela é mantida, quem restaura e em quanto tempo?

O snapshot do Adobe Commerce Cloud substitui o backup? Em parte. Pela documentação da Adobe, o snapshot inclui o banco e os volumes montados (var, pub/media, app/etc), mas não o código, que já está no repositório git do projeto, e não pode ser baixado. Snapshot manual existe nos ambientes Starter e nos de integração do Pro, e fica guardado por sete dias. Staging e Production do Pro recebem backups automáticos para recuperação de desastre; o suporte da Adobe entrega o snapshot, mas a restauração do banco fica com você. A base de conhecimento da Adobe avisa ainda que esse snapshot não substitui o backup que a loja deve criar antes de um upgrade.

Se quiser essa conferência feita na sua loja, ela está no que o suporte Magento 2 cobre.