Dla administratorów
← Wszystkie tematy

Kopia zapasowa i odtwarzanie

Codzienna kopia zapasowa bazy danych i kopia na żądanie, dlaczego kopiować je poza serwer razem z MASTER_KEY i jak odtworzyć zrzut.

W instalacji na własnym serwerze wszystko, co ważne, jest w bazie danych: ustawienia, wytyczne, źródła wiedzy, wiadomości, szkice i zaszyfrowane sekrety. Kopię zapasową robisz więc z bazy danych – i z pliku .env z MASTER_KEY.

Co zabezpieczyć

  1. Bazę danych – draften sam zapisuje jej zrzuty do folderu backups/ (zobacz niżej); ty dbasz o to, żeby zrzuty trafiły poza serwer.
  2. .env, przede wszystkim MASTER_KEY – poza serwerem, w bezpiecznym miejscu. Bez niego nie odczytasz z bazy danych kluczy API, dostępu do skrzynek ani klientów logowania; kopia zapasowa byłaby bezużyteczna. My go nie mamy.

Zrzut bazy danych zawiera pocztę klientów. Chroń go tak jak samą skrzynkę.

Kopie zapasowe, które robi draften

draften zapisuje zrzut bazy danych do folderu backups/ w katalogu instalacji:

Kopie codzienne i na żądanie liczą się osobno od kopii sprzed aktualizacji: przechowywanych jest 7 ostatnich z nich, a obok nich 3 ostatnie kopie sprzed aktualizacji. Karta pokazuje siedem ostatnich kopii – kiedy powstały, jakiego są rodzaju, z jakiej wersji i jaki mają rozmiar.

Ustawienia można zmienić w .env:

ZmiennaDo czego
DRAFTEN_DAILY_BACKUPSile kopii codziennych i na żądanie przechowywać (domyślnie 7); 0 wyłącza kopię codzienną, kopia na żądanie dalej się wykonuje
DRAFTEN_BACKUP_AT, DRAFTEN_TIMEZONEgodzina codziennej kopii i jej strefa czasowa (domyślnie 01:00, Europe/Prague); godzina ustawiona w interfejsie ma pierwszeństwo
DRAFTEN_BACKUPSile kopii sprzed aktualizacji przechowywać (domyślnie 3)

Bez updatera

Kopie codzienne i przycisk obsługuje updater. Gdy w instalacji nie działa, tę samą kopię robi polecenie:

./draften backup

Na kopię codzienną uruchamiaj je z crona, na przykład o pierwszej w nocy (ścieżkę zastąp katalogiem swojej instalacji):

0 1 * * * cd /srv/draften && ./draften backup

Kopie w backups/ nie są poza serwerem

Leżą na tym samym dysku co baza danych – gdy stracisz dysk albo serwer, stracisz także je. Kopiuj folder backups/ razem z .env w inne miejsce, tak jak robią to twoje pozostałe kopie zapasowe, albo rób kopię całego serwera po codziennej kopii (czyli po 01:00 albo po ustawionej przez ciebie godzinie).

Na kopie w backups/ nie wpływa okres przechowywania danych: zrzut zawiera to, co było w bazie danych, gdy powstał.

Odtwarzanie

Każdy zrzut w backups/ ma w nazwie czas i wersję, która wtedy działała: <time>-<version>.backup.sql.gz przy kopiach codziennych i na żądanie, <time>-<version>.sql.gz przy kopiach sprzed aktualizacji. Zatrzymaj workery, wczytaj zrzut i uruchom wersję z jego nazwy:

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

Wszystko, co wydarzyło się w draften po utworzeniu zrzutu, przepada.

Na nowym serwerze najpierw zainstaluj draften i wpisz do .env MASTER_KEY z czasu, gdy powstał zrzut.

Wymiana klucza szyfrowania

MASTER_KEY można wymienić bez przerwy – w interfejsie (Instalacja → Instalacja → Klucz szyfrowania → Wymień klucz szyfrowania, wymaga updatera) albo poleceniem:

./draften rotate-key

Nowy klucz najpierw zapisuje się do .env, kontenery przejmują go jeden po drugim, a wszystko, co zapisano, zostaje nim zaszyfrowane od nowa. Stary klucz zostaje w .env jako MASTER_KEY_PREVIOUS, dopóki backups/ zawiera zrzuty sprzed wymiany – tylko on może je otworzyć. draften odmówi kolejnej wymiany, dopóki taki zrzut istnieje. Kopie codzienne sprzed wymiany znikają najpóźniej po 7 dniach, kopie sprzed aktualizacji dopiero po trzech kolejnych aktualizacjach.

Po wymianie od razu skopiuj nowy .env poza serwer. Nowy klucz nigdy nie trafia do interfejsu; jest tylko w .env na serwerze.

Uwaga

Wersja tekstowa