site_sync.sh

1. Предпроверка: ssh-доступ, наличие mysqldump/pg_dump, каталога сайта и временного каталога на источнике; при RESTORE=yes — доступ к локальной БД.
2. Дамп на источнике (если DB_DUMP=yes): дамп БД с gzip во временный файл. Если gzip на источнике нет, дамп делается без сжатия (см. REMOTE_COMPRESS). Пароль БД не передаётся в аргументах и не виден в ps.
3. Скачивание: rsync во временный .partial, проверка размера и gzip -t (несжатый дамп сжимается локально), затем переименование в <БД>_ГГГГ-ММ-ДД_ЧЧММСС.sql.gz. Временный дамп на источнике удаляется.
4. Ротация: хранятся KEEP_DUMPS последних дампов.
5. Файлы: rsync каталога сайта (с опциональным --delete и исключениями).
6. Развёртывание (если RESTORE=yes): заливка скачанного дампа в локальную БД.

Порядок намеренно такой: сначала дамп, потом файлы. При любой ошибке скрипт останавливается, развёртывание не выполняется, уже скачанный дамп остаётся.

На сервере, где запускается скрипт (приёмник)

• bash, ssh (OpenSSH), rsync; gzip — если делается дамп БД
• для RESTORE=yes: клиент БД — mysql/mariadb или psql
• для SSH_AUTH=sshpass: пакет sshpass (для key и plain не нужен)

На сервере-источнике

• sh и rsync (всегда)
• для дампа БД (DB_DUMP=yes): mysqldump (или mariadb-dump) либо pg_dump; gzip желателен, но не обязателен
• для дампа: доступный на запись временный каталог (REMOTE_TMP_DIR, по умолчанию /tmp) с местом под дамп (без gzip — под несжатый)

cp site_sync.conf.example /etc/site_sync.conf
chmod 600 /etc/site_sync.conf
nano /etc/site_sync.conf          # заполнить параметры

chmod +x site_sync.sh
./site_sync.sh -c /etc/site_sync.conf --check   # проверка без изменений
./site_sync.sh -c /etc/site_sync.conf           # первый боевой запуск

Без аргументов скрипт читает site_sync.conf из своего каталога. Конфиг можно передать флагом -c или первым позиционным аргументом.

Минимальный конфиг для сайта без БД

SSH_HOST='example.com'
SSH_USER='deploy'
SSH_AUTH='key'
SSH_KEY='/root/.ssh/id_ed25519'
DB_DUMP='no'
REMOTE_SITE_DIR='/var/www/mysite'
LOCAL_SITE_DIR='/var/www/mysite'
RSYNC_DELETE='yes'
LOG_FILE='/var/log/site_sync_mysite.log'

Настройка ключа

ssh-keygen -t ed25519 -f /root/.ssh/id_ed25519 -N ''
ssh-copy-id -i /root/.ssh/id_ed25519.pub -p 22 deploy@example.com

# каждые 30 минут
*/30 * * * * /opt/site_sync/site_sync.sh /etc/site_sync.conf

# раз в сутки в 03:15
15 3 * * * /opt/site_sync/site_sync.sh /etc/site_sync.conf

Скрипт сам добавляет стандартные каталоги в PATH (в cron он обычно урезан). Если задан LOG_FILE, весь обычный вывод идёт в файл, а ошибки дополнительно уходят в stderr — cron пришлёт письмо (если настроен MAILTO). Одновременный запуск двух экземпляров блокируется.

• Блокировка: каталог LOCAL_BACKUP_DIR/.site_sync.lock с PID; устаревшая блокировка (процесса нет) снимается автоматически.
• Целостность дампа: код возврата mysqldump/pg_dump и gzip проверяются на источнике; локально — совпадение размера и gzip -t. Битый дамп не попадёт в хранилище и не вытеснит хорошие при ротации.
• Чистка: временные файлы на источнике и локальные .partial удаляются при любом завершении, включая ошибки и сигналы.
• Ротация затрагивает только файлы вида <БД>_ГГГГ-ММ-ДД_ЧЧММСС.sql.gz; остальное в каталоге не трогается.
• Защита от ошибок конфига: проверка обязательных параметров и типов, запрет LOCAL_SITE_DIR=/ и системных каталогов (/etc, /usr, /var, $HOME и др.), запрет заливки в БД источника.
• Источник без gzip: при REMOTE_COMPRESS=auto дамп создаётся без сжатия, передаётся с rsync -z и сжимается на приёмнике; в хранилище лежит обычный .sql.gz. Целостность проверяется кодом возврата дампа, размером и gzip -t.
• Ранние проверки: доступ к локальной БД (при RESTORE=yes), свободное место под дамп и наличие нужных утилит на источнике проверяются до тяжёлых операций.
• Исключения и --delete: файлы, попавшие под RSYNC_EXCLUDES, на приёмнике не удаляются.
• Локальная БД: для MySQL БД создаётся автоматически (CREATE DATABASE IF NOT EXISTS, при наличии прав). Для PostgreSQL БД должна существовать заранее.
• Формат конфига: файл с Windows-переводами строк (CRLF) отклоняется с подсказкой, как конвертировать.
• Каталог для askpass-помощника (режим plain) подбирается автоматически, если /tmp смонтирован с noexec.
• rsync код 24 («файл исчез при передаче») на живом сайте считается нормой и ошибкой не является.
• MySQL: развёртывание не атомарно. Для PostgreSQL дамп заливается одной транзакцией (--single-transaction).

• Не удалось подключиться по ssh — запустите с --check, проверьте хост, порт, ключ, SSH_STRICT_HOST_KEY. Для проверки вручную: ssh -p PORT USER@HOST.
• mysqldump: Unknown option '--no-tablespaces' или наоборот «Access denied; need PROCESS privilege» — подберите REMOTE_DUMP_OPTS (для MySQL 8 нередко нужно добавить --no-tablespaces; MariaDB этой опции не знает).
• На MariaDB 11+ нет mysqldump — задайте REMOTE_DUMP_BIN='mariadb-dump' и LOCAL_CLIENT_BIN='mariadb'.
• SSH_AUTH=sshpass требует установленный sshpass — установите пакет или переключитесь на plain.
• Уже запущен другой экземпляр — предыдущий запуск ещё идёт; если завис, проверьте процесс по PID из LOCAL_BACKUP_DIR/.site_sync.lock/pid.
• Лог — смотрите файл LOG_FILE; при его отсутствии весь вывод идёт в stdout.