Создание резервной копии

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

Для создания резервных копий PostgreSQL в iEXExchanger используется инструмент iEX DB Backup. Он экспортирует основную базу приложения, базу Laravel Pulse и дополнительные базы PostgreSQL.

Каждая новая резервная копия проверяется перед сохранением и получает manifest с контрольной суммой SHA-256. Это позволяет убедиться, что файл не повреждён и относится к нужному профилю.

Где находится инструмент

Основная команда:

Подключение к серверу по SSH

tools/db-backup/iex-db-backup

Пример конфигурации:

tools/db-backup/db-backup.example.json

Рабочая конфигурация:

tools/db-backup/db-backup.json

Стандартный каталог резервных копий:

storage/app/backups/database/

Логи:

storage/logs/db-backup/

Все команды рекомендуется выполнять из корня Backend-проекта.

Для FASTPANEL путь обычно выглядит так:

Файлы сайта в FastPanel

/var/www/SITE_OWNER/data/www/app.example.com

Для чего нужен iEX DB Backup

Через инструмент можно:

• создать резервную копию основной базы приложения;
• отдельно сохранить базу Laravel Pulse;
• подключить дополнительные базы PostgreSQL;
• создать сжатый .sql.gz;
• получить обычный .sql;
• добавить метку к имени файла;
• сохранить копию в стандартный или отдельный каталог;
• проверить SQL-файл без подключения к рабочей базе;
• сверить SQL-файл с manifest;
• проверить контрольную сумму SHA-256;
• выполнить контрольное восстановление в пустую базу;
• настроить автоматическое копирование через CRON.

Инструмент не выполняет:

• изменение Laravel .env;
• Product Updates;
• Laravel migrations;
• очистку рабочей базы;
• включение режима обслуживания;
• удаление старых копий;
• перезапись существующих backup-файлов.

iEX DB Backup сохраняет только базу данных.

Файлы Backend и Frontend, .env, изображения, пользовательские загрузки и содержимое каталога storage необходимо резервировать отдельно.

Как работает резервное копирование

После запуска инструмент:

1. загружает конфигурацию;
2. получает реквизиты выбранного профиля;
3. проверяет подключение к PostgreSQL;
4. запускает pg_dump;
5. создаёт временный SQL-файл;
6. проверяет содержимое SQL;
7. вычисляет SHA-256;
8. создаёт manifest;
9. публикует готовую резервную копию.

PostgreSQL экспортируется через транзакционно согласованный снимок. Приложение может продолжать работу, а все данные внутри резервной копии будут относиться к одному состоянию базы.

Если проверка не пройдена, файл не считается готовой резервной копией.

Существующие файлы не перезаписываются.

Что создаётся

Для каждого профиля создаются два файла:

Файл	Назначение
<имя>.sql.gz	Сжатая SQL-копия PostgreSQL
<имя>.sql.gz.manifest.json	Manifest с информацией о резервной копии

По умолчанию файлы сохраняются в отдельный UTC-каталог:

storage/app/backups/database/YYYYMMDDTHHMMSSZ/

Пример:

storage/app/backups/database/20260719T030000Z/
├── main-postgresql-app_example_com_pg-before-update.sql.gz
├── main-postgresql-app_example_com_pg-before-update.sql.gz.manifest.json
├── pulse-postgresql-pulse_pg-before-update.sql.gz
└── pulse-postgresql-pulse_pg-before-update.sql.gz.manifest.json

Каталог создаётся с правами:

0700

SQL-файлы и manifest создаются с правами:

0600

Manifest содержит:

• имя профиля;
• название профиля;
• метку запуска;
• тип базы данных;
• тип сжатия;
• размер файла;
• SHA-256;
• количество таблиц;
• количество индексов;
• первичные ключи;
• уникальные ограничения;
• внешние ключи;
• количество строк.

Перед началом

Убедитесь, что:

• PostgreSQL 18 установлен и работает;
• Backend iEXExchanger подключён к PostgreSQL;
• вы знаете пользователя Backend-сайта;
• в корне проекта находятся .env и artisan;
• каталог tools/db-backup/ присутствует;
• в .env указаны рабочие реквизиты PostgreSQL;
• на сервере установлен pg_dump;
• на диске достаточно свободного места.

Go на сервер устанавливать не требуется. Launcher автоматически выбирает бинарный файл для архитектуры сервера.

Поддерживаются:

• Linux amd64;
• Linux arm64;
• macOS arm64.

Проверьте версию инструмента:

./tools/db-backup/iex-db-backup --version

Проверьте pg_dump:

pg_dump --version

Для PostgreSQL 18 рекомендуется использовать:

pg_dump 18

Проверка точного файла:

/usr/lib/postgresql/18/bin/pg_dump --version

Инструкция по установке PostgreSQL 18:

Подключение PostgreSQL

Запускайте iEX DB Backup от пользователя Backend-сайта, а не от root.

Так резервные копии, временные файлы и логи получат правильного владельца.

---

Какие базы сохраняются

Для каждой базы используется отдельный профиль.

1

Основная база приложения

Профиль main сохраняет основную базу iEXExchanger:

"main": {
  "enabled": true,
  "optional": false,
  "label": "Основная база приложения",
  "env": "main"
}

Реквизиты берутся из стандартных параметров Laravel:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=app_example_com_pg
DB_USERNAME=app_example_com_pg
DB_PASSWORD=CHANGE_ME
DB_SSLMODE=disable

2

База Laravel Pulse

Профиль pulse сохраняет базу Laravel Pulse:

"pulse": {
  "enabled": true,
  "optional": true,
  "label": "База Laravel Pulse",
  "env": "pulse"
}

Реквизиты берутся из:

PULSE_DB_CONNECTION=pgsql-pulse
PULSE_DB_HOST=127.0.0.1
PULSE_DB_PORT=5432
PULSE_DB_DATABASE=pulse_pg
PULSE_DB_USERNAME=pulse_pg
PULSE_DB_PASSWORD=CHANGE_ME
PULSE_DB_SSLMODE=disable

Параметр:

"optional": true

позволяет пропустить недоступный Pulse при выполнении общей команды:

./tools/db-backup/iex-db-backup export \
  --profile all

Пропуск профиля будет показан в результате команды.

Если отдельно запустить:

./tools/db-backup/iex-db-backup export \
  --profile pulse

при недоступной базе Pulse команда завершится ошибкой.

Если Laravel Pulse не используется

Отключите профиль:

"pulse": {
  "enabled": false,
  "optional": true,
  "label": "База Laravel Pulse",
  "env": "pulse"
}

После этого команда с --profile all обработает только остальные включённые профили.

---

Пошаговое создание резервной копии

1

Перейдите в Backend-проект

Для FASTPANEL:

Файлы сайта в FastPanel

cd /var/www/имя_пользователя_backend/data/www/app.ваш_домен

Пример:

cd /var/www/example_usr/data/www/app.example.com

Проверьте текущий каталог:

pwd

Проверьте обязательные файлы:

ls -la artisan .env tools/db-backup

Проверьте права на запуск:

ls -la tools/db-backup/iex-db-backup*

Если право на запуск потерялось после загрузки или распаковки архива:

chmod 755 tools/db-backup/iex-db-backup*

2

Создайте конфигурацию

Если db-backup.json ещё не существует:

cp tools/db-backup/db-backup.example.json \
  tools/db-backup/db-backup.json

Установите приватные права:

chmod 600 tools/db-backup/db-backup.json

Для стандартного проекта используйте:

{
  "version": 1,
  "profiles": {
    "main": {
      "enabled": true,
      "optional": false,
      "label": "Основная база приложения",
      "env": "main"
    },
    "pulse": {
      "enabled": true,
      "optional": true,
      "label": "База Laravel Pulse",
      "env": "pulse"
    }
  }
}

Проверьте права:

ls -la tools/db-backup/db-backup.json

Ожидаемый результат:

-rw-------

db-backup.json может содержать пароли.

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

Если конфигурация уже существует, не перезаписывайте её. Сначала проверьте текущие профили и сохраните защищённую копию.

3

Проверьте конфигурацию

Выполните:

./tools/db-backup/iex-db-backup config-check \
  --profile all

Команда проверит:

• структуру db-backup.json;
• права конфигурационного файла;
• параметры из .env;
• подключения к PostgreSQL;
• доступность профилей;
• количество найденных объектов.

Успешный результат заканчивается сообщением:

All selected profiles completed successfully.

config-check не создаёт резервную копию и не изменяет данные.

4

Создайте резервную копию

Для основной базы и Laravel Pulse:

./tools/db-backup/iex-db-backup export \
  --profile all \
  --tag before-update

Только для основной базы:

./tools/db-backup/iex-db-backup export \
  --profile main \
  --tag manual

Только для Laravel Pulse:

./tools/db-backup/iex-db-backup export \
  --profile pulse \
  --tag manual

Для всех выбранных профилей используется один UTC-каталог и одна метка запуска.

5

Проверьте результат

После успешного экспорта должно появиться:

All selected profiles completed successfully.

Проверьте код завершения:

echo $?

Успешный код:

0

Возьмите фактический путь к созданному файлу из результата команды и выполните:

./tools/db-backup/iex-db-backup inspect \
  --file storage/app/backups/database/<UTC>/<BACKUP>.sql.gz \
  --require-manifest

Пример:

./tools/db-backup/iex-db-backup inspect \
  --file storage/app/backups/database/20260719T030000Z/main-postgresql-app_example_com_pg-before-update.sql.gz \
  --require-manifest

При необходимости укажите ожидаемый профиль:

./tools/db-backup/iex-db-backup inspect \
  --profile main \
  --file /secure/backups/main-postgresql-app_example_com_pg-before-update.sql.gz \
  --require-manifest

6

Сохраните копию вне сервера

Для каждого профиля сохраните оба файла:

*.sql.gz
*.sql.gz.manifest.json

Подходящие места хранения:

• отдельный backup-сервер;
• защищённое объектное хранилище;
• локальный защищённый компьютер;
• другой физический диск.

Не храните единственную резервную копию на сервере с проектом.

При повреждении диска или потере доступа к серверу копия может быть утрачена вместе с рабочей базой.

---

Проверка резервной копии

Команда inspect не подключается к рабочей базе и ничего в ней не изменяет.

Она проверяет:

• файл является обычным файлом;
• файл не является символической ссылкой;
• gzip-поток не повреждён;
• SQL относится к PostgreSQL;
• размер файла;
• SHA-256;
• соответствие manifest;
• имя файла;
• профиль;
• количество таблиц;
• индексы;
• первичные ключи;
• уникальные ограничения;
• внешние ключи;
• команды COPY;
• количество строк;
• отсутствие запрещённых управляющих SQL-команд.

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

SQL artifact valid: ...
Manifest: profile=main, label="Основная база приложения"
Engine=postgresql, compression=gzip, bytes=...
Inventory: tables=..., indexes=..., PK=..., UNIQUE=..., FK=..., rows=...

Наличие .sql.gz ещё не подтверждает успешное создание копии.

Должны выполняться все условия:

• экспорт завершился кодом 0;
• показано All selected profiles completed successfully;
• рядом создан manifest;
• inspect завершился успешно.

Хранение SQL и manifest

SQL и manifest необходимо хранить вместе:

main.sql.gz
main.sql.gz.manifest.json

Не переименовывайте только один файл.

Неправильно:

backup.sql.gz
main.sql.gz.manifest.json

Manifest содержит исходное имя SQL-файла. Если переименовать только один файл, проверка завершится ошибкой.

Оба файла можно переместить в другой каталог, сохранив их имена.

Проверка старого SQL без manifest

Старый доверенный SQL-файл можно проверить без manifest:

./tools/db-backup/iex-db-backup inspect \
  --file database/legacy_dump.sql

В результате будет показано:

Manifest: absent

Для такого файла нельзя использовать:

--require-manifest

Для новых резервных копий всегда сохраняйте manifest.

Метки резервных копий

Параметр --tag добавляет понятную метку в имя SQL-файла и manifest:

./tools/db-backup/iex-db-backup export \
  --profile all \
  --tag before-product-update

Примеры:

before-product-update
before-migration
before-release-11.3.0
manual
scheduled
incident-copy

Допускаются:

• латинские буквы;
• цифры;
• точка;
• дефис;
• подчёркивание.

Максимальная длина — 64 байта.

Используйте латиницу без пробелов, двоеточий и слешей.

Форматы резервных копий

1

Сжатая резервная копия

По умолчанию используется gzip:

./tools/db-backup/iex-db-backup export \
  --profile main \
  --compression gzip \
  --tag manual

Результат:

*.sql.gz
*.sql.gz.manifest.json

Для большинства проектов рекомендуется использовать этот формат.

2

Обычный SQL-файл

Чтобы получить несжатый .sql:

./tools/db-backup/iex-db-backup export \
  --profile main \
  --compression none \
  --tag manual \
  --output storage/app/backups/manual/main.sql

При --compression gzip имя должно заканчиваться на .gz.

При --compression none окончание .gz использовать нельзя.

Не сохраняйте рабочую базу с клиентскими данными в каталоге database/ и не добавляйте её в Git.

Каталог database/ можно использовать только для очищенного установочного snapshot.

---

Выбор каталога

1

Стандартный каталог

Если --output не указан, файлы сохраняются в:

storage/app/backups/database/<UTC>/

Для большинства проектов рекомендуется использовать стандартный каталог.

2

Отдельный каталог

Чтобы сохранить копии в другом каталоге:

./tools/db-backup/iex-db-backup export \
  --profile all \
  --tag before-update \
  --output /secure/backups/iexexchanger/

При --profile all значение --output всегда считается каталогом.

Каталог должен:

• находиться вне public;
• быть доступен пользователю сайта;
• иметь приватные права;
• не быть символической ссылкой.

Создайте каталог:

mkdir -p /secure/backups/iexexchanger

Установите права:

chmod 700 /secure/backups/iexexchanger

Убедитесь, что пользователь Backend-сайта может записывать в этот каталог.

3

Точное имя файла

Точное имя можно указать только для одного профиля:

./tools/db-backup/iex-db-backup export \
  --profile main \
  --tag before-update \
  --output storage/app/backups/manual/main-before-update.sql.gz

Чтобы указать каталог для одного профиля, завершите путь символом /:

./tools/db-backup/iex-db-backup export \
  --profile main \
  --output storage/app/backups/manual/

Если файл уже существует, команда остановится:

refusing to overwrite existing backup

---

Прямое подключение к PostgreSQL

Если Laravel подключается через pooler, а pg_dump должен обращаться напрямую к PostgreSQL, добавьте в .env:

Файлы сайта в FastPanel

DB_DIRECT_HOST=127.0.0.1
DB_DIRECT_PORT=5432
DB_DIRECT_DATABASE=app_example_com_pg
DB_DIRECT_USERNAME=app_example_com_pg
DB_DIRECT_PASSWORD=CHANGE_ME
DB_DIRECT_SSLMODE=disable

Если параметры DB_DIRECT_* заполнены, инструмент использует их для экспорта основной базы.

Рабочее подключение Laravel при этом не изменяется.

Автоматическое резервное копирование

Автоматический запуск настраивается через CRON пользователя Backend-сайта.

Планировщик задач

Подготовьте каталог логов:

mkdir -p storage/logs/db-backup

chmod 700 storage/logs/db-backup

Откройте планировщик:

crontab -e

Для PostgreSQL 18 укажите путь к pg_dump:

IEX_DB_TOOL_PG_DUMP=/usr/lib/postgresql/18/bin/pg_dump

Пример ежедневного запуска в 03:15:

15 3 * * * cd /var/www/имя_пользователя_backend/data/www/app.example.com && umask 077 && /usr/bin/flock -n storage/framework/iex-db-backup.lock ./tools/db-backup/iex-db-backup export --profile all --tag scheduled >> storage/logs/db-backup/cron.log 2>&1

flock запрещает запуск второго процесса, если предыдущий ещё работает.

Для каждого запуска создаётся новый UTC-каталог. Существующие файлы не перезаписываются.

iEX DB Backup не удаляет старые копии автоматически.

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

Где находятся логи

Логи сохраняются в:

Файлы сайта в FastPanel

storage/logs/db-backup/

Пример:

storage/logs/db-backup/20260719T030000.000000000Z-export-all.log

Лог содержит:

• выполненную команду;
• выбранные профили;
• путь к конфигурации;
• путь к .env;
• путь к результату;
• прогресс;
• размер файла;
• SHA-256;
• итоговый статус.

Пароли в лог не записываются.

Каталог логов должен иметь права:

0700

Установите их при необходимости:

chmod 700 storage/logs/db-backup

Логи создаются с правами:

0600

Контрольное восстановление

Команда inspect проверяет SQL и manifest, но наиболее надёжная проверка — восстановление в отдельную пустую базу.

Не проверяйте восстановление на рабочей базе.

Создайте отдельную пустую базу, которая не используется приложением.

Создайте в FASTPANEL пустую PostgreSQL-базу:

app_example_com_restore_test

Добавьте в db-backup.json профиль:

"restore_test": {
  "enabled": true,
  "optional": false,
  "label": "Тестовое восстановление основной базы",
  "connection": {
    "driver": "pgsql",
    "host": "127.0.0.1",
    "port": 5432,
    "database": "app_example_com_restore_test",
    "username": "app_example_com_restore_test",
    "password": "CHANGE_ME",
    "socket": "",
    "tls": "",
    "sslmode": "disable",
    "admin": null
  }
}

Проверьте подключение:

./tools/db-backup/iex-db-backup config-check \
  --profile restore_test

Выполните восстановление:

./tools/db-backup/iex-db-backup import \
  --profile restore_test \
  --from-profile main \
  --expect-tag before-update \
  --file /secure/backups/main-postgresql-app_example_com_pg-before-update.sql.gz \
  --require-manifest \
  --yes

Параметры:

Параметр	Назначение
--profile restore_test	Пустая тестовая база
--from-profile main	Ожидаемый профиль исходной копии
--expect-tag before-update	Ожидаемая метка
--file	Путь к SQL-файлу
--require-manifest	Обязательная проверка manifest
--yes	Подтверждение восстановления

Если база содержит пользовательские объекты, команда остановится:

refusing to import into non-empty PostgreSQL backup profile

Инструмент не очищает базу автоматически.

Дополнительные базы PostgreSQL

Для дополнительной базы создайте отдельный профиль:

"archive_pg": {
  "enabled": true,
  "optional": false,
  "label": "Архивная PostgreSQL-база",
  "connection": {
    "driver": "pgsql",
    "host": "127.0.0.1",
    "port": 5432,
    "database": "archive_database",
    "username": "archive_user",
    "password": "CHANGE_ME",
    "socket": "",
    "tls": "",
    "sslmode": "disable",
    "admin": null
  }
}

Каждый профиль должен использовать только один источник реквизитов:

• "env": "main";
• "env": "pulse";
• "connection": {...}.

Одновременно указывать env и connection нельзя.

---

Запуск из другого каталога

Если команда запускается не из корня Backend, передайте абсолютные пути:

/var/www/имя_пользователя_backend/data/www/app.example.com/tools/db-backup/iex-db-backup export \
  --env /var/www/имя_пользователя_backend/data/www/app.example.com/.env \
  --config /var/www/имя_пользователя_backend/data/www/app.example.com/tools/db-backup/db-backup.json \
  --profile all \
  --tag manual

Для команды inspect Laravel-проект не требуется:

/absolute/path/iex-db-backup inspect \
  --file /secure/backups/main.sql.gz \
  --require-manifest

Хранение резервных копий

Пример базовой политики:

Тип копии	Срок хранения
Ежедневная	7–14 последних копий
Еженедельная	4–8 последних копий
Перед обновлением	До подтверждения стабильной работы
Внешняя копия	Минимум одна актуальная проверенная
Критическая версия	По внутренней политике проекта

Не удаляйте предыдущую копию, пока:

• новая копия не завершилась успешно;
• рядом не создан manifest;
• не выполнен inspect;
• файлы не сохранены вне основного сервера.

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

Частые вопросы

Нужно ли останавливать сайт?

Нет. pg_dump создаёт транзакционно согласованный снимок PostgreSQL. Приложение может продолжать работу во время экспорта.

Можно ли запускать инструмент от root?

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

Что делать, если Laravel Pulse не используется?

Отключите профиль:

"pulse": {
  "enabled": false
}

Достаточно ли наличия файла .sql.gz?

Нет. Рядом должен находиться manifest, экспорт должен завершиться кодом 0, а inspect — без ошибок.

Можно ли переименовать резервную копию?

SQL и manifest связаны именем файла. Не переименовывайте только один из них.

Можно ли хранить копию только на сервере?

Не рекомендуется. Минимум одна актуальная проверенная копия должна находиться вне основного сервера.

Можно ли проверить восстановление на рабочей базе?

Нет. Для проверки создайте отдельную пустую базу PostgreSQL.

Нужно ли создавать копию Laravel Pulse?

Если Pulse используется, рекомендуется сохранять его вместе с основной базой через:

--profile all

Если данные Pulse не нужны для восстановления проекта, профиль можно отключить.

Можно ли создать копию без сжатия?

Да. Используйте:

--compression none

Для обычного хранения рекомендуется gzip.

Частые ошибки

Конфигурация требует права 0600

Сообщение:

require 0600 or stricter

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

Исправьте права:

chmod 600 tools/db-backup/db-backup.json

Также проверьте, что файл не является символической ссылкой.

Не найден Laravel-проект

Сообщение:

could not locate Laravel project

Перейдите в корень Backend:

cd /var/www/SITE_OWNER/data/www/app.example.com

Либо передайте точные пути через --env и --config.

Профиль отключён или не существует

Сообщение:

profile ... is not defined or is disabled

Проверьте имя профиля и настройку:

Laravel Pulse недоступен

Сообщение:

profile pulse is unavailable

Проверьте:

PULSE_DB_CONNECTION=
PULSE_DB_HOST=
PULSE_DB_PORT=
PULSE_DB_DATABASE=
PULSE_DB_USERNAME=
PULSE_DB_PASSWORD=

Если Pulse не используется, отключите профиль.

Не найден pg_dump

Сообщение:

required native tool "pg_dump" was not found

Для PostgreSQL 18 выполните:

IEX_DB_TOOL_PG_DUMP=/usr/lib/postgresql/18/bin/pg_dump \
  ./tools/db-backup/iex-db-backup export \
  --profile main \
  --tag manual

Для CRON укажите:

IEX_DB_TOOL_PG_DUMP=/usr/lib/postgresql/18/bin/pg_dump

Версия pg_dump не соответствует PostgreSQL

Сообщение:

server version mismatch

Проверьте версию:

/usr/lib/postgresql/18/bin/pg_dump --version

Используйте бинарный файл PostgreSQL 18:

IEX_DB_TOOL_PG_DUMP=/usr/lib/postgresql/18/bin/pg_dump

Резервная копия уже существует

Сообщение:

refusing to overwrite existing backup

Используйте другую метку:

./tools/db-backup/iex-db-backup export \
  --profile main \
  --tag manual-2

Не удаляйте старую копию до успешного создания и проверки новой.

Manifest не соответствует SQL

Сообщение:

backup manifest does not match SQL artifact

Возможные причины:

• SQL и manifest относятся к разным запускам;
• один из файлов повреждён;
• переименован только один файл;
• SQL был изменён после экспорта.

Используйте исходную пару файлов.

Неправильные права каталога логов

Сообщение:

backup log directory ... require 0700

Исправьте права:

chmod 700 storage/logs/db-backup

Недостаточно свободного места

Проверьте диск:

df -h

Проверьте размер резервных копий:

du -sh storage/app/backups/database

При необходимости сохраните копию на другом диске:

./tools/db-backup/iex-db-backup export \
  --profile all \
  --tag manual \
  --output /secure/backups/iexexchanger/

---

Доступные команды

Команда	Назначение
config-check	Проверить конфигурацию и подключения
export	Создать резервную копию
backup	Синоним export
inspect	Проверить SQL и manifest
import	Восстановить резервную копию
restore	Синоним import

Доступные параметры

Команда	Параметры
config-check	--profile, --env, --config, --version
export / backup	--profile, --env, --config, --output, --compression, --tag, --version
inspect	--file, --profile, --require-manifest, --version
import / restore	--profile, --from-profile, --expect-tag, --file, --require-manifest, --yes, --version

Параметры одной операции нельзя передавать другой.

Например, --file нельзя использовать с командой export.

Рекомендации

Для большинства проектов рекомендуется:

• использовать профили main и pulse;
• получать реквизиты из Laravel .env;
• использовать pg_dump версии 18;
• создавать копии в формате .sql.gz;
• добавлять понятные метки через --tag;
• проверять каждый SQL-файл через inspect;
• хранить SQL и manifest вместе;
• сохранять минимум одну копию вне сервера;
• настроить ежедневный запуск через CRON;
• периодически проверять восстановление;
• контролировать свободное место на диске.

Перед Product Updates используйте метку:

before-product-update

---

Коротко

iEX DB Backup создаёт резервные копии основной базы PostgreSQL, Laravel Pulse и дополнительных баз.

Стандартный порядок:

1. перейдите в Backend-проект;
2. создайте db-backup.json;
3. выполните config-check;
4. запустите export;
5. проверьте каждый файл через inspect;
6. сохраните SQL и manifest вне сервера.

Основные команды:

./tools/db-backup/iex-db-backup config-check --profile all

./tools/db-backup/iex-db-backup export \
  --profile all \
  --tag before-update

./tools/db-backup/iex-db-backup inspect \
  --file <ПУТЬ_К_BACKUP.sql.gz> \
  --require-manifest

Резервная копия считается готовой только после успешного inspect и сохранения файлов за пределами основного сервера.