Pro administrátory
← Na rozcestník

Zálohy a obnova

Denní záloha databáze a záloha na požádání, proč je kopírovat mimo server spolu s MASTER_KEY a jak obnovit výpis.

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

  1. 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.
  2. .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:

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_BACKUPSkolik 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_BACKUPSkolik 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

Textová verze