Напускате Airtable? Пренесете базите си в Artavolo, проверени запис по запис. Вижте как

Резервни копия и възстановяване

Всяка инстанция на Artavolo може да създаде един шифрован архив, който съдържа всичко необходимо за нейното възстановяване: базата данни на приложението, базата с данни (по една таблица за всеки лист) и качените файлове. Enterprise изданието изпълнява това по график и може да копира архива в S3-съвместим контейнер.

Ключът за шифроване

Задайте BACKUP_ENCRYPTION_KEY преди първото резервно копие:

  • Docker: ARTAVOLO_BACKUP_ENCRYPTION_KEY в .env (openssl rand -hex 32), след това docker compose up -d.
  • LAMP: define('BACKUP_ENCRYPTION_KEY', '...'); в includes/config.php.

Пазете копие на ключа извън сървъра (мениджър на пароли, разпечатано в сейф). Архив не може да се отвори без него и няма начин за възстановяване. Смяната на ключа засяга само новите архиви; пазете старите ключове, докато пазите старите архиви.

Архивите са artavolo-backup-YYYYMMDD-HHMMSS.abk: AES-256-CTR със случаен IV, удостоверени с HMAC-SHA256 върху целия файл. Етикетът за цялост се проверява, преди да се дешифрира каквото и да е, така че грешен ключ или повреден файл се отхвърлят веднага.

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

От командния ред (във всяко издание):

# Docker
docker compose exec -u www-data app php utilities/backup.php
# LAMP
php utilities/backup.php

Опции: --no-uploads (само базите данни), --path=/mnt/backups, --keep=30 (срок на съхранение в дни), --no-s3, --plain (некриптиран zip, само за ръчно пренасяне на данни). Архивът се записва в data/backups/ (Docker: томът app_backups), освен ако не е зададен друг път.

От администрацията (Enterprise): Настройки → Резервни копия → „Стартирай резервно копие сега“. Същата страница настройва дневния график (час, по времето на сървъра), локалната папка, срока на съхранение, дали се включват качените файлове и S3-съвместимата цел. Cron задачата, която се доставя с инстанцията, стартира изпълнението в рамките на пет минути от избрания час. Неуспешно изпълнение праща имейл на всички администратори; всяко изпълнение се вижда в дневника на промените като backup.run или backup.failed.

Копирайте архивите извън хоста. С Docker: docker compose cp app:/var/www/html/data/backups ./backups. При S3 цел копирането става автоматично след всяко изпълнение; срокът на съхранение важи и там.

Проверка на архив

php utilities/restore.php artavolo-backup-20260911-030001.abk --dry-run

Това проверява етикета, дешифрира във временна папка, показва манифеста (версия, инстанция, време на създаване) и размера на всяка част, и премахва временните файлове. Правете го всеки месец и веднъж на тестова машина, за да докажете, че пълното възстановяване по-долу работи.

Възстановяване

Възстановяването замества двете бази данни, посочени в includes/config.php, и копира качените файлове върху текущите. Първо спрете уеб сървъра (или намалете контейнера на приложението до нула).

# Docker: a fresh stack with the same .env (same ARTAVOLO_BACKUP_ENCRYPTION_KEY)
docker compose up -d db
docker compose run --rm -u www-data app php utilities/restore.php /var/www/html/data/backups/artavolo-backup-20260911-030001.abk --yes
docker compose up -d

# LAMP
php utilities/restore.php /path/to/artavolo-backup-20260911-030001.abk --yes
php utilities/clear-cache.php

--no-uploads възстановява само базите данни, --no-database само качените файлове, --extract=/tmp/out разархивира, без да пипа инстанцията, --key=... подава ключа, когато config.php още не съществува. Възстановяването записва backup.restored в дневника на промените.

Възстановяване в инстанция, която работи с по-нова версия на приложението, се поддържа: след това изпълнете php utilities/migrate.php, за да се актуализира схемата.

Какво не е в архива

includes/config.php (съдържа идентификационни данни за базата данни и тайни; пазете го заедно с ключа), езиковите пакети в lang/, ако сте ги редактирали, и лицензионният ключ (също в базата данни, така че се възстановява с нея).

Въпрос, на който тези страници не отговарят? Пишете ни и ще ви отговорим по имейл, обикновено в рамките на един работен ден. Свържете се с нас