U instalace na vlastním serveru je všechno podstatné v databázi: nastavení, pokyny, zdroje znalostí, zprávy, koncepty i šifrovaná tajemství. Zálohujete tedy databázi — a soubor .env s klíčem MASTER_KEY.
Co zálohovat
- Databázi — draften ji sám ukládá do složky
backups/(viz níže); vy se postaráte, aby se výpisy dostaly mimo server. .env, hlavněMASTER_KEY— mimo server, na bezpečné místo. Bez něj z databáze nepřečtete API klíče, přístupy ke schránkám ani klienty pro přihlášení; záloha by byla k ničemu. My ho nemáme.
Výpis databáze obsahuje poštu zákazníků. Chraňte ho stejně jako samotnou schránku.
Zálohy, které dělá draften
draften ukládá výpis databáze do složky backups/ v adresáři instalace:
- každý den — v 01:00 pražského času, nebo v čase, který nastavíte ve Správě instalace → Instalace, v kartě Zálohy databáze. Když byl server v tu dobu vypnutý, záloha se udělá hned, jak znovu naběhne. Když se nepovede, zkusí se znovu za hodinu a karta ukáže proč.
- na požádání — tlačítkem Zálohovat teď v téže kartě. Průběh je vidět v Historii žádostí jako „Záloha databáze“.
- před každou aktualizací — aby šlo vrátit i změny v databázi.
Denní zálohy a zálohy na požádání se počítají zvlášť od záloh před aktualizací: drží se jich posledních 7 a vedle nich poslední 3 zálohy před aktualizací. Karta ukazuje posledních sedm záloh — kdy vznikly, jakého jsou druhu, z jaké verze a jak jsou velké.
V .env jde nastavení změnit:
| Proměnná | K čemu |
|---|---|
DRAFTEN_DAILY_BACKUPS | kolik denních záloh a záloh na požádání držet (výchozí 7); 0 denní zálohu vypne, na požádání se zálohuje dál |
DRAFTEN_BACKUP_AT, DRAFTEN_TIMEZONE | čas denní zálohy a jeho časové pásmo (výchozí 01:00, Europe/Prague); čas nastavený v rozhraní má přednost |
DRAFTEN_BACKUPS | kolik záloh před aktualizací držet (výchozí 3) |
Bez updateru
Denní zálohy a tlačítko obstarává updater. Když na instalaci neběží, udělá tutéž zálohu příkaz:
./draften backup
Na denní zálohu ho spouštějte z cronu, třeba v jednu ráno (cestu nahraďte adresářem své instalace):
0 1 * * * cd /srv/draften && ./draften backup
Zálohy v backups/ nejsou mimo server
Leží na stejném disku jako databáze — když přijdete o disk nebo server, přijdete i o ně. Kopírujte složku backups/ spolu s .env jinam, jak to dělají vaše ostatní zálohy, nebo zálohujte celý server až po denní záloze (tedy po 01:00, případně po čase, který jste nastavili).
Zálohy v backups/ nemění doba uchování dat: výpis drží, co v databázi bylo, když vznikl.
Obnova
Každý výpis v backups/ nese v názvu čas a verzi, která tehdy běžela: <čas>-<verze>.backup.sql.gz u denních záloh a záloh na požádání, <čas>-<verze>.sql.gz u záloh před aktualizací. Zastavte workery, nahrajte výpis a spusťte verzi z jeho názvu:
docker compose stop worker
gunzip -c backups/<výpis>.sql.gz | docker compose exec -T db sh -c 'mariadb -uroot -p"$MARIADB_ROOT_PASSWORD"'
./draften update <verze> --no-backup
Všechno, co se v draftenu stalo po vzniku výpisu, se tím ztratí.
Na novém serveru nejdřív draften nainstalujte a do .env vložte MASTER_KEY z doby, kdy výpis vznikl.
Výměna šifrovacího klíče
MASTER_KEY jde vyměnit bez výpadku — v rozhraní (Správa instalace → Instalace → Šifrovací klíč → Vyměnit šifrovací klíč, potřebuje updater), nebo příkazem:
./draften rotate-key
Nový klíč se nejdřív zapíše do .env, kontejnery si ho postupně vezmou a všechno uložené se jím znovu zašifruje. Starý klíč zůstane v .env jako MASTER_KEY_PREVIOUS, dokud jsou v backups/ výpisy z doby před výměnou — jen jím se dají otevřít. Další výměnu draften odmítne, dokud takový výpis existuje. Denní zálohy z doby před výměnou zmizí nejpozději po 7 dnech, zálohy před aktualizací až po třech dalších aktualizacích.
Po výměně si hned zkopírujte nový .env mimo server. Nový klíč se do rozhraní nikdy nedostane; je jen v .env na serveru.
Na co si dát pozor
- Svazek
db-dataje živá databáze. Nikdy nemažte instalaci příkazemdocker compose down -v, pokud nemáte čerstvý výpis mimo server. - Složka
data/pravdu nedrží — jsou v ní jen log a reporty workera. - V rozhraní si to vždy můžete ověřit: v kartě Stav instalace na stránce Instalace je vidět, jestli je
MASTER_KEYnastavený, a v kartě Zálohy databáze, kdy vznikla poslední záloha. Z příkazové řádky totéž ukáže./draften status.