Em uma instalação no seu próprio servidor, tudo o que importa está no banco de dados: configurações, instruções, fontes de conhecimento, mensagens, rascunhos e os segredos criptografados. Por isso você faz backup do banco de dados – e do arquivo .env com a MASTER_KEY.
Do que fazer backup
- Do banco de dados – o próprio draften faz o dump dele na pasta
backups/(veja abaixo); você garante que os dumps saiam do servidor. - Do
.env, sobretudo daMASTER_KEY– fora do servidor, em um lugar seguro. Sem ela, você não consegue ler do banco de dados as chaves de API, os acessos às caixas de e-mail nem os clientes de login; o backup seria inútil. Nós não a temos.
Um dump do banco de dados contém os e-mails dos clientes. Proteja-o como a própria caixa de e-mail.
Os backups que o draften faz
O draften salva um dump do banco de dados na pasta backups/ do diretório da instalação:
- todos os dias – às 01:00 no horário de Praga, ou no horário que você definir em Instalação → Instalação, no cartão Backups do banco de dados. Se o servidor estava desligado nesse horário, o backup é feito assim que ele voltar. Se falhar, uma nova tentativa é feita uma hora depois e o cartão mostra o motivo.
- sob demanda – com o botão Fazer backup agora no mesmo cartão. O progresso aparece em Solicitações como “Backup do banco de dados”.
- antes de cada atualização – para que também as mudanças no banco de dados possam ser desfeitas.
Os backups diários e os sob demanda são contados separadamente dos feitos antes das atualizações: ficam os 7 últimos deles e, ao lado, os 3 últimos backups de antes de uma atualização. O cartão mostra os sete últimos backups – quando foram feitos, o tipo, a versão e o tamanho.
As configurações podem ser alteradas no .env:
| Variável | Para quê |
|---|---|
DRAFTEN_DAILY_BACKUPS | quantos backups diários e sob demanda manter (padrão 7); 0 desativa o diário, o backup sob demanda continua sendo feito |
DRAFTEN_BACKUP_AT, DRAFTEN_TIMEZONE | o horário do backup diário e o fuso horário dele (padrão 01:00, Europe/Prague); um horário definido na interface tem prioridade |
DRAFTEN_BACKUPS | quantos backups de antes de uma atualização manter (padrão 3) |
Sem o updater
Os backups diários e o botão são trabalho do updater. Quando a instalação não tem o updater rodando, o mesmo backup é feito com:
./draften backup
Para um backup diário, execute-o pelo cron, por exemplo à uma da manhã (substitua o caminho pelo diretório da sua instalação):
0 1 * * * cd /srv/draften && ./draften backup
Os backups em backups/ não estão fora do servidor
Eles ficam no mesmo disco que o banco de dados – se você perder o disco ou o servidor, perde os backups também. Copie a pasta backups/ junto com o .env para outro lugar, como fazem os seus outros backups, ou faça backup do servidor inteiro depois do backup diário (ou seja, depois das 01:00 ou do horário que você definiu).
Os backups em backups/ não são afetados pela retenção de dados: um dump guarda o que havia no banco de dados quando foi feito.
Restauração
Cada dump em backups/ traz no nome o horário e a versão que estava rodando naquele momento: <time>-<version>.backup.sql.gz para os backups diários e os sob demanda, <time>-<version>.sql.gz para os de antes de uma atualização. Pare os workers, carregue o dump e inicie a versão que está no nome dele:
docker compose stop worker
gunzip -c backups/<dump>.sql.gz | docker compose exec -T db sh -c 'mariadb -uroot -p"$MARIADB_ROOT_PASSWORD"'
./draften update <version> --no-backup
Tudo o que aconteceu no draften depois que o dump foi feito se perde.
Em um servidor novo, instale primeiro o draften e coloque no .env a MASTER_KEY da época em que o dump foi feito.
Trocar a chave de criptografia
A MASTER_KEY pode ser trocada sem interrupção – na interface (Instalação → Instalação → Chave de criptografia → Trocar a chave de criptografia, requer o updater) ou com o comando:
./draften rotate-key
A nova chave é gravada primeiro no .env, os contêineres a assumem um a um e tudo o que está guardado é criptografado de novo com ela. A chave antiga fica no .env como MASTER_KEY_PREVIOUS enquanto backups/ tiver dumps de antes da troca – só ela consegue abri-los. O draften recusa uma nova troca enquanto existir um dump desses. Os backups diários de antes da troca somem em no máximo 7 dias; os de antes de uma atualização, só depois de mais três atualizações.
Depois da troca, copie o novo .env para fora do servidor na hora. A nova chave nunca chega à interface; ela está só no .env do servidor.
Atenção
- O volume
db-dataé o banco de dados em uso. Nunca remova a instalação comdocker compose down -vse não tiver um dump recente fora do servidor. - A pasta
data/não guarda a verdade – ali ficam só o log e os relatórios do worker. - Você sempre pode conferir na interface: o cartão Status da instalação na página Instalação mostra se a
MASTER_KEYestá definida, e o cartão Backups do banco de dados, quando foi feito o último backup. Na linha de comando,./draften statusmostra o mesmo.