Пишу краткую документацию для администраторов форумов Discourse, которые я помог настроить. Что-то упустил?

Что ж, вот полностью автоматически переведённое руководство:

Убедитесь, что вы готовы к любым непредвиденным ситуациям

Настоятельно рекомендуется, помимо локальных резервных копий (хранящихся на том же сервере, что и форум), иметь копию этих резервных копий на другом сервере или в облаке[1].

Также полезно хранить копию файла /var/discourse/containers/app.yml в надёжном месте[2]. Этот необязательный файл пригодится в случае переустановки форума или миграции на другой сервер.

Если у вас возникнут серьёзные сомнения по какому-либо вопросу, свяжитесь со мной.

Обновления

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

Через интерфейс

Выполняйте обновления, когда в панели администратора появляется грустный красный смайлик (это означает, что доступно важное обновление).
Обновления выполняются по адресу https://tonforum.fr/admin/upgrade

Иногда процесс состоит из двух этапов: сначала необходимо обновить «Docker_Manager», прежде чем можно будет обновить остальное:

Через командную строку

Иногда обновление необходимо выполнять через командную строку (страница администратора Discourse сообщит об этом, если это потребуется).

  1. Подключитесь к серверу через SSH
  2. Пересоберите форум (пересборка всегда обновляет Discourse), используя следующую команду:
  3. /var/discourse/launcher rebuild app
    
  4. Время от времени, убедившись, что форум работает корректно, может быть полезно удалить неиспользуемые образы Docker (остатки от предыдущих обновлений), чтобы освободить место на диске:
    /var/discourse/launcher cleanup
    

Что делать, если форум перестал работать?

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

/var/discourse/launcher rebuild app

Что делать, если форум всё ещё не работает после пересборки?

Обратитесь ко мне или опубликуйте сообщение на официальном форуме поддержки.

Расположение важных файлов на сервере

app.yml

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

/var/discourse/containers/app.yml

mail-receiver.yml

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

/var/discourse/containers/mail-receiver.yml

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

Файлы резервных копий находятся здесь:

/var/discourse/shared/standalone/backups/default

Важные страницы в панели администратора форума:

Страницы, которые могут быть полезны :technologist:

Темы и компоненты

Они содержат, среди прочего, пользовательские CSS и HTML:

https://tonforum.fr/admin/config/customize/themes

Логи

Электронная почта

Полезно для отладки:

https://tonforum.fr/admin/email-logs

Действия персонала

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

https://tonforum.fr/admin/logs/staff_action_logs

Логи ошибок

Могут дать подсказки, когда возникает проблема, причина которой неочевидна.

https://tonforum.fr/logs/

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

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

https://tonforum.fr/admin/backups

Ресурсы

https://meta.discourse.org : официальная поддержка, не стесняйтесь публиковать сообщения там, участники и разработчики рады помочь
https://ask.discourse.com : чат-бот, обученный на данных поддержки Discourse, удивительно эффективно отвечает на вопросы (да, действительно)


  1. Если я установил ваш форум, ваши резервные копии автоматически копируются в мой Google Диск, но в идеале в будущем они должны сохраняться в пространстве, за которое отвечаете вы. Обсудим это однажды :smile: ↩︎

  2. Он содержит идентификатор и пароль почтового сервера, а также адрес электронной почты администратора (на самом деле мой). ↩︎

3 лайка