Discourse – это открытая платформа для коммуникаций и совместной работы. Discourse можно использовать в качестве списка рассылки, форума или чата. Данное руководство поможет установить Discourse в изолированную среду с помощью приложения контейнеризации Docker.
Требования
- Сервер Ubuntu 16.04 (читайте руководство по начальной настройке).
- Пользователь с доступом к sudo.
- Предварительно установленное приложение Docker (инструкции по установке – здесь).
- Зарегистрированный домен.
- SMTP-сервер. Если вы не хотите настраивать собственный SMTP, можете воспользоваться сторонними сервисами, например, SparkPost.
- Рекомендованный объем оперативки – 2 Гб. Если у вас 1 Гб оперативной памяти, для корректной работы Discourse нужно создать своп-файл. Своп рекомендуется использовать на обычных жёстких дисках. На работе SSD-накопителей своп сказывается негативно и может привести к ухудшению производительности базового оборудования.
Читайте также:
Почему не стоит запускать собственный почтовый сервер
Как добавить swap в Ubuntu 16.04
1: Загрузка Discourse
Чтобы начать загрузку Discourse, нужно развернуть оболочку root.
sudo -s
Создайте каталог /var/discourse для хранения всех файлов Discourse.
mkdir /var/discourse
Клонируйте официальный образ Discourse в этот каталог:
git clone https://github.com/discourse/discourse_docker.git /var/discourse
2: Настройка и запуск Discourse
Откройте каталог /var/discourse:
cd /var/discourse
Запустите встроенный сценарий настройки:
./discourse-setup
Программа задаст вам несколько вопросов:
- Hostname for your Discourse? Введите имя хоста для Discourse (например, discourse.example.com). Используйте только доменное имя – IP-адрес невозможно использовать для отправки электронной почты.
- Email address for admin account? Укажите почтовый адрес администратора Discourse. Он не должен быть привязан к домену Discourse. Просто выберите любой удобный адрес электронной почты. Обратите внимание: первый пользователь, который в дальнейшем укажет этот адрес при регистрации, автоматически станет администратором.
- SMTP server address? SMTP user name? SMTP port? SMTP password? Укажите подробные данные о SMTP-сервере. Если вы используете SparkPost: адрес SMTP-сервера – smtp.sparkpostmail.com, имя пользователя – SMTP_Injection, порт – 587, пароль – API-ключ.
Примечание: Если в дальнейшем вам понадобится изменить или исправить эти параметры, отредактируйте файл /containers/app.yml и запустите ./launcher rebuild app. В противном случае изменения не вступят в силу.
Самозагрузка Discourse занимает от 2 до 8 минут. После этого нужно создать аккаунт администратора.
3: Регистрация администратора
Посетите домен Discourse в браузере. На экране появится страница:
Congratulations, you installed Discourse!
register a new account to get started
Если вы получили ошибку 502 Bad Gateway, подождите пару минут и обновите страницу – возможно, загрузка Discourse не была завершена.
Чтобы создать аккаунт администратора, нажмите кнопку Register и заполните форму Register Admin Account:
Email: В выпадающем меню выберите указанный ранее адрес электронной почты.
Username: Имя пользователя выберите самостоятельно.
Password: Придумайте сложный пароль.
Чтобы принять данные, нажмите кнопку Register. Вы увидите диалоговое окно с запросом Confirm your Email. Проверьте входящие и найдите письмо с подтверждением. Если вы не получили такое сообщение, нажмите Resend Activation Email. Если и после этого подтверждение не пришло на ваш адрес, обратитесь к этой странице.
После регистрации администратора запустится мастер настройки. Следуйте его указаниям, чтобы выполнить базовую настройку Discourse. Если вы хотите выполнить настройку позже, нажмите Maybe Later.
После этого на экране появится Admin Quick Start Guide, где вы найдёте полезные советы по настройке Discourse.
Платформа Discourse готова к работе. Чтобы обновить Discourse, с помощью командной строки загрузите последнюю версию кода из репозитория Git и соберите приложение:
cd /var/discourse
git pull
./launcher rebuild app
Также обновление можно выполнить с помощью браузера:
http://discourse.example.com/admin/upgrade
Нажмите Upgrade to the Latest Version и следуйте инструкциям мастера.
Заключение
Теперь вы можете пригласить в Discourse других пользователей. Чтобы больше узнать о функциях Discourse, посетите эту страницу.