BearPass

Appearance

Администрирование ​

Резервное копирование ​

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

Можно делать полный бэкап папки с БД (path/to/bearpass/database).
Либо делать бэкап отдельной БД

shell
docker exec -i bearpass_database /bin/bash -c "PGPASSWORD=<ПАРОЛЬ ОТ БД> pg_dump --username bear_pass bear_pass" > dump_`date +%d-%m-%Y"_"%H_%M_%S`.sql

Пароли в базе хранятся в зашифрованном виде, бэкап базы без ключа шифрования бесполезен. Ключ хранится в файле .env в корне проекта path/to/bearpass/app (ENCRYPTION_KEY=...), создается один раз при установке и не меняется.

Ключ шифрования не стоит хранить рядом с бэкапами базы данных.

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

Из директории docker:

  1. Остановите контейнеры: docker compose down
  2. Запустите только контейнер БД: docker compose up -d database
  3. Очистите существующие данные БД
shell
docker compose exec -T database psql --username bear_pass bear_pass -c "drop schema public cascade; create schema public;"
  1. Выполните команду восстановления данных из дампа:
shell
   docker exec -i bearpass_database /bin/bash -c "PGPASSWORD=ваш_пароль_от_бд psql --username bear_pass bear_pass" < /путь/до/дампа/dump.sql
  1. Перезапустите контейнеры: docker compose up -d

Обновление продукта ​

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

С помощью веб-интерфейса ​

  1. С помощью веб-интерфейса панели администрирования (Администрирование - Настройки - Обновление продукта)

  2. Обновите страницу браузера с открытым приложением.

Ручное обновление ​

  1. Перейдите в директорию с docker-файлами.
shell
cd /opt/bearpass/docker/

Примечание

Путь до файлов с приложением/opt/bearpass/ может отличаться, подставляйте в команду актуальный для Вашей системы

  1. Остановите контейнеры
shell
docker compose down
  1. Актуализируйте docker-файлы до последней версии
shell
git pull
  1. Запустите контейнеры
shell
docker compose up -d
  1. Актуализируйте файлы с приложением
shell
cd /opt/bearpass/app/ && git pull
  1. Выполните установку последних пакетов и миграций базы данных
shell
cd cd /opt/bearpass/docker/ &&
docker compose exec -u www-data app sh -c "cd /var/www/bearpass && composer install --no-dev -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
composer dump-autoload
php artisan migrate --seed --no-interaction --force
php artisan optimize:clear"