Обновление модулей личного кабинета

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

На странице «Администрирование | Обновление системы» доступен перечень установленных модулей и их текущая версия.

Содержание

Режим обслуживания

При обновлении приложения рекомендуется его переводить в режим обслуживания. В терминале перейдите в директорию установки приложения выполните следующую команду:

php artisan down

В случае успешного выполнения команды должен быть следующий ответ:

Application is now in maintenance mode.

Команда переведет приложение в режим обслуживания. Если зайти в само приложение, то будет отображаться сообщение 503 SERVICE UNAVAILABLE.

Для того, чтобы вернуть приложение в обычный режим необходимо выполнить команду:

php artisan up

В случае успешного выполнения команды должен быть следующий ответ:

Application is now live.

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

Для создания резервной копии БД в терминале выполните следующую команду:

mysqldump -u user -p database | gzip > filename.sql.gz

Где user - имя пользователя БД, database - название базы данных, filename - имя файла.

Обновление

Обновление должно происходить от имени того пользователя, для которого добавлены открытый и закрытый ключи доступа к репозиторию (см. Создание ключей доступа). В противном случае будет отказано в доступе и обновление не будет осуществлено.

Не запускайте Composer от имени root/super user.

Подробнее.

Откройте терминал и перейдите в директорию установки приложения.

  1. Выполните команду:

    composer update --no-dev

    Дождитесь завершения обновления.

  1. Выполните миграции:

    php artisan migrate

    В режиме production будет запрошено подтверждение на выполнение операции. Если в обновлении нет миграций будет выведено сообщение Nothing to migrate.

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

Компиляция ресурсов

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

npm run prod

Порядок действий при обновлении

В терминале перейти в директорию установки приложения.

  1. Перевести приложение в режим обслуживания:

    php artisan down

  2. Выполнить обновление:

    composer update --no-dev

  3. Выполнить миграции:

    php artisan migrate

  4. Пересобрать ресурсы:

    npm run prod

  5. Очистить кэш:

    php artisan route:clear

    php artisan cache:clear

    php artisan view:clear

    php artisan config:clear

  6. Вернуть приложение в рабочий режим:

    php artisan up

Возмоджные ситуации при обновлении и их решение описаны в разделе «Устранение проблем»