Перейти к содержанию

Восстановление из резервной копии

Данный раздел описывает процедуру восстановления данных для кластера TeamStorm в случае системного сбоя.

ВНИМАНИЕ

Для восстановления работы кластера нужно установить "чистую" версию TeamStorm

Перед восстановлением убедитесь, что cистема чистая и работает корректно

Восстановление данных из резервной состоит из двух шагов и выполняется в порядке, обратном созданию резервных копий.

  1. Восстановление разделов docker-контейнеров.

  2. Восстановление баз данных Postgres из ранее созданных дампов.

Восстановление разделов docker-контейнеров

Для восстановления разделов контейнеров кластера нужно иметь привилегии пользователя root, так как по-умолчанию только root имеет доступ к этим разделам файловой структуры.

  1. Создайте временную директорию и перейдите в нее. Затем скопируйте сюда архив, содержащий разделы контейнеров докер:

    root@server: /root/ $ mkdir /tmp/volumes_backup
root@server: /root/ $ cd /tmp/volumes_backup
root@server: /tmp/volumes_backup/ $ scp backup-server:/teamstorm/volumes_backup.tgz .
root@server: /tmp/volumes_backup/ $ tar -xzvf volumes_backup.tgz
teamstorm_minio
teamstorm_ssl-volume
teamstorm_trusted-certificates-volume
root@server: /tmp/volumes_backup/ $ rm -f volumes_backup.tgz

  2. Перенесите директории в папку c разделами docker. По умолчанию это /var/lib/docker/volumes/.

    mv teamstorm_minio \
    teamstorm_ssl-volume \
    teamstorm_trusted-certificates-volume \
    /var/lib/docker/volumes/

ВНИМАНИЕ

Пользователь root больше не нужен, остальные операции можно делать из-под "обычного" пользователя

Восстановление баз данных PostgreSQL из дампов

Данная процедура описывает баз данных PostgreSQL из предварительно созданных дампов. Процедура автоматизирована и для запуска нужно выполнить следующие действия:

  1. Перейдите в директорию scripts, которая находится внутри директории с артефактами TeamStorm:

    user@server: ~/teamstorm $ cd scripts
user@server: ~/teamstorm/scripts $ ls -lha
total 28
drwxrwxr-x 3 user user 4096 Feb 02 13:24 ./
drwxrwxr-x 4 user user 4096 Feb 02 13:23 ../
-rwxrwx--- 1 user user 1270 Feb 02 11:22 copy_backup.sh*
-rwxrwx--- 1 user user 1275 Feb 02 11:22 db_backup.sh*
-rwxrwx--- 1 user user 1652 Feb 02 11:22 db_restore.sh*
-rw-rw-r-- 1 user user 1737 Feb 02 11:22 postgres-init.sql

  2. Создайте здесь директорию dumps, сохраните туда архив и распакуйте его:

    user@server: ~/teamstorm/scripts $ mkdir dumps
user@server: ~/teamstorm/scripts $ ls -lha
total 28
drwxrwxr-x 3 user user 4096 Feb 02 13:24 ./
drwxrwxr-x 4 user user 4096 Feb 02 13:23 ../
-rwxrwx--- 1 user user 1270 Feb 02 11:22 copy_backup.sh*
-rwxrwx--- 1 user user 1275 Feb 02 11:22 db_backup.sh*
-rwxrwx--- 1 user user 1652 Feb 02 11:22 db_restore.sh*
drwxr-xr-x 2 user user 4096 Feb 02 13:26 dumps/
-rw-rw-r-- 1 user user 1737 Feb 02 11:22 postgres-init.sql
user@server: ~/teamstorm/scripts $ scp backup-server:/teamstorm/teamstorm_2025-02-02_04-00-00_backup.tgz ./dumps/
user@server: ~/teamstorm/scripts $ cd dumps
user@server: ~/teamstorm/scripts/dumps/ $ tar -xzvf teamstorm_2025-02-02_04-00-00_backup.tgz
...
user@server: ~/teamstorm/scripts $ cd ..

  3. Запустите скрипт db_restore.sh, указав целевую директорию и общий суффикс, состоящий из временной метки и расширения, например, для файлов:

    ```shell
teamstorm_migrations_db_2025-02-02_04-00-00.bak
teamstorm_attachment_db_2025-02-02_04-00-00.bak
teamstormdb_2025-02-02_04-00-00.bak
...
```

Общим суффикcом будет 2025-02-02_04-00-00.bak. Таким образом, команда для восстановления будет выглядеть следующим образом:

```shell
user@server: ~/teamstorm/scripts $ ./db_restore.sh ./dumps 2025-02-02_04-00-00.bak
```

ВНИМАНИЕ

Обращайте внимание на лог восстановления, при необходимости перенаправьте поток вывод в файл для дальнейшего анализа.

Пример успешного восстановления:

```shell
...
Recovering from backup: container: teamstorm-database_service-1 teamstormdb teamstormdb_02-02-2025_04_00.bak
UPDATE 1
pg_terminate_backend
----------------------
t
t
t
t
(4 rows)

DROP DATABASE
CREATE DATABASE
```

Пример неудачной попытки восстановления из несуществующего дампа.

```shell
Recovering from backup: container: teamstorm-database_service-1 teamstorm_migrations_db teamstorm_migrations_db_02-02-2025_04_00.bak
lstat /home/tester/deploy/teamstorm/scripts/dumps/teamstorm_migrations_db_02-02-2025_04_00.bak:
no such file or directory
UPDATE 1
pg_terminate_backend
----------------------
(0 rows)

DROP DATABASE
CREATE DATABASE
pg_restore: error: could not open input file "/teamstorm_migrations_db_02-02-2025_04_00.bak":
No such file or directory
```

После успешного восстановления перезапустите кластер teamstorm:

```shell
docker compose -p teamstorm restart
```

Процесс по восстановлению для кластера TeamStorm успешно завершен.

Убедитесь в работоспособности приложения после восстановления.