Estratégia de Backup do Odoo

Visão Geral

Um backup completo do Odoo deve incluir tanto o banco de dados PostgreSQL quanto o filestore (anexos, imagens). Esta habilidade abrange procedimentos de backup manual e automatizado, armazenamento externo e a sequência correta de restauração para colocar uma instância Odoo inativa de volta online.

Quando Usar Esta Habilidade

• Configurando uma estratégia de backup para uma instância Odoo em produção.
• Automatizando backups diários com scripts shell e cron.
• Restaurando o Odoo após uma falha de servidor ou evento de corrupção de dados.
• Diagnosticando um backup falho ou restauração corrompida.

Como Funciona

1. Ativar: Mencione @odoo-backup-strategy e descreva seu ambiente de servidor.
2. Gerar: Receba um script de backup completo, adaptado à sua configuração.
3. Restaurar: Obtenha instruções passo a passo de restauração para qualquer cenário de falha.

Exemplos

Exemplo 1: Backup Manual do Banco de Dados + Filestore

#!/bin/bash
# backup_odoo.sh

DATE=$(date +%Y%m%d_%H%M%S)
DB_NAME="odoo"
DB_USER="odoo"
FILESTORE_PATH="/var/lib/odoo/.local/share/Odoo/filestore/$DB_NAME"
BACKUP_DIR="/backups/odoo"

mkdir -p "$BACKUP_DIR"

# Step 1: Dump the database
pg_dump -U $DB_USER -Fc $DB_NAME > "$BACKUP_DIR/db_$DATE.dump"

# Step 2: Archive the filestore
tar -czf "$BACKUP_DIR/filestore_$DATE.tar.gz" -C "$FILESTORE_PATH" .

echo "✅ Backup complete: db_$DATE.dump + filestore_$DATE.tar.gz"

Exemplo 2: Automatizar com Cron (diariamente às 2h)

# Run: crontab -e
# Add this line:
0 2 * * * /opt/scripts/backup_odoo.sh >> /var/log/odoo_backup.log 2>&1

Exemplo 3: Upload para S3 (após o backup)

# Add to backup script after tar command:
aws s3 cp "$BACKUP_DIR/db_$DATE.dump"        s3://my-odoo-backups/db/
aws s3 cp "$BACKUP_DIR/filestore_$DATE.tar.gz" s3://my-odoo-backups/filestore/

# Optional: Delete local backups older than 7 days
find "$BACKUP_DIR" -type f -mtime +7 -delete

Exemplo 4: Procedimento Completo de Restauração

# Step 1: Stop Odoo
docker compose stop odoo  # or: systemctl stop odoo

# Step 2: Recreate and restore the database
# (--clean alone fails if the DB doesn't exist; drop and recreate first)
dropdb -U odoo odoo 2>/dev/null || true
createdb -U odoo odoo
pg_restore -U odoo -d odoo db_YYYYMMDD_HHMMSS.dump

# Step 3: Restore the filestore
FILESTORE=/var/lib/odoo/.local/share/Odoo/filestore/odoo
rm -rf "$FILESTORE"/*
tar -xzf filestore_YYYYMMDD_HHMMSS.tar.gz -C "$FILESTORE"/

# Step 4: Restart Odoo
docker compose start odoo

# Step 5: Verify — open Odoo in the browser and check:
#   - Can you log in?
#   - Are recent records visible?
#   - Are file attachments loading?

Melhores Práticas

• ✅ Fazer: Teste restaurações mensalmente em um ambiente de staging — um backup que você nunca restaurou não é um backup.
• ✅ Fazer: Siga a regra 3-2-1: 3 cópias, 2 tipos de mídia diferentes, 1 cópia externa (por exemplo, S3 ou um servidor remoto).
• ✅ Fazer: Faça backup imediatamente antes de cada atualização do Odoo — este é o seu ponto de rollback.
• ✅ Fazer: Verifique a integridade do backup: pg_restore --list backup.dump deve ser concluído sem erros.
• ❌ Não fazer: Fazer backup apenas do banco de dados sem o filestore — todos os anexos e imagens estarão faltando após a restauração.
• ❌ Não fazer: Armazenar backups no mesmo disco ou no mesmo servidor do Odoo — uma falha de disco ou servidor destrói ambos.
• ❌ Não fazer: Executar pg_restore --clean em um banco de dados inexistente — sempre crie o banco de dados primeiro.

Limitações

• Não cobre backups integrados do Odoo.sh — Odoo.sh tem seu próprio sistema de backup acessível pelo painel.
• Este script assume uma configuração Odoo de banco de dados único. Instâncias com múltiplos bancos de dados exigem um loop sobre todos os bancos de dados.
• O caminho do filestore pode diferir entre instalações (volume Docker vs. bare-metal). Sempre verifique o caminho com odoo-bin shell antes de executar uma restauração.
• Filestores grandes (100GB+) podem exigir ferramentas de backup incremental como rsync ou restic em vez de arquivos tar.gz completos.