Discourse — это платформа для обсуждений с открытым исходным кодом. Ее можно использовать в качестве списка рассылки, форума для обсуждения или тематического чата. В этом обучающем руководстве мы установим Discourse в изолированной среде с помощью Docker, приложения для контейнеризации.
Прежде чем начать, нам нужно настроить следующее:
Примечание. Discourse требует наличия файла подкачки при использовании 1 ГБ оперативной памяти. Хотя использование файла подкачки в целом рекомендуется для систем с использованием традиционных жестких дисков, ее использование с SSD-накопителями может со временем вызывать ухудшение работы аппаратного обеспечения. В связи с этим мы не рекомендуем использовать подкачку с DigitalOcean или с любым другим провайдером, использующим SSD-накопители. Использование подкачки может повлиять на надежность соответствующего аппаратного обеспечения у вас и ваших соседей. Поэтому мы рекомендуем использовать не менее 2 ГБ оперативной памяти для запуска Discourse в DigitalOcean Droplet. Дополнительную информацию по использованию подкачки см. в статье Добавление области подкачки в Ubuntu 18.04.
Когда все предварительные требования будут выполнены, мы можем перейти к установке Discourse.
Вам потребуются права root в течение всего процесса настройки и инициализации, поэтому сначала необходимо переключиться на root shell.
- sudo -s
Затем создайте директорию /var/discourse
, где будут храниться все связанные с Discourse файлы.
- mkdir /var/discourse
Затем клонируйте официальный образ Docker Discourse в /var/discourse
.
- git clone https://github.com/discourse/discourse_docker.git /var/discourse
Когда все необходимые нам файлы будут в наличии, мы сможем перейти к настройке и инициализации.
Перейдите в директорию /var/discourse
, где хранятся файлы Discourse.
- cd /var/discourse
Отсюда вы сможете запустить скрипт настройки.
- ./discourse-setup
Вам придется ответить на следующие вопросы:
Введите имя хоста, которое вы хотите использовать для Discourse, например, discourse.your_domain.com
, заменив your_domain.com
на имя вашего домена. Вам обязательно нужно использовать доменное имя, поскольку IP-адрес не будет работать при отправке электронных писем.
Выберите адрес электронной почты, который вы хотите использовать для учетной записи администратора Discourse. Он может не иметь никакой связи с вашим доменом Discourse, в качестве адреса может использоваться любой удобный адрес электронной почты.
Обратите внимание, что этот адрес электронной почты будет использоваться в качестве адреса администратора Discourse по умолчанию, когда первый пользователь зарегистрируется, указав этот адрес электронной почты. Вам потребуется этот адрес электронной почты позже при настройке Discourse из веб-панели управления.
Адрес сервера SMTP?
Имя пользователя SMTP?
Порт SMTP?
Пароль SMTP?
Введите данные вашего сервера SMTP для этих вопросов. Если вы используете Mailgun, адрес сервера SMTP будет smtp.mailgun.org
, а в качестве имени пользователя и пароля необходимо использовать учетные данные SMTP для вашего домена на вкладке доменов.
После этого вам будет предложено подтвердить все настройки, которые вы только что ввели. После подтверждения ваших настроек скрипт сгенерирует файл конфигурации под названием app.yml
, а затем стартует процесс инициализации.
Примечание. Если вам потребуется изменить или исправить эти настройки после инициализации, внесите изменения в файл /containers/app.yml
и выполните ./launcher rebuild app
. В противном случае изменения не вступят в силу.
Инициализация занимает от 2 до 8 минут, после чего ваш экземпляр будет запущен! Давайте перейдем к созданию учетной записи администратора.
Перейдите на домен Discourse в предпочитаемом вами браузере, чтобы просмотреть веб-страницу Discourse.
При получении ошибки 502 Bad Gateway, подождите минуту или две, а затем обновите страницу; возможно, Discourse еще не стартовал.
После загрузки страницы нажмите синюю кнопку Регистрация. Вы увидите форму под названием Регистрация учетной записи администратора со следующими полями:
Затем нажмите синюю кнопку Регистрация в форме для отправки данных. Вы увидите диалог с надписью Подтвердите ваш адрес электронной почты. Проверьте папку входящих сообщений почты и найдите письмо подтверждения. Если вы не получили письмо, воспользуйтесь кнопкой Отправить письмо активации повторно. Если вам все равно не удалось зарегистрировать новую учетную запись администратора, ознакомьтесь с контрольным списком устранения проблем электронной почты.
После регистрации учетной записи администратора будет запущен мастер настройки, который поможет выполнить базовую конфигурацию Discourse. Вы можете выполните ее сейчас или нажать Возможно позже, чтобы пропустить.
После использования или пропуска мастера настройки вы увидите ряд тем и краткое руководство по началу работы для администратора (с названием READ ME FIRST), в котором содержатся советы по дальнейшей настройке вашей установки Discourse.
Настройка выполнена! Если вам потребуется обновить Discourse в будущем, вы можете воспользоваться командной строкой, получив последнюю версию кода из репозитория Git и выполнив пересборку приложения, например, следующим образом:
- cd /var/discourse
- git pull
- ./launcher rebuild app
Также вы можете выполнить обновление в браузере, указав http://discourse.your_domain.com/admin/upgrade
в адресной строке, нажав Обновить до последней версии и следуя инструкциям.
Теперь вы можете осуществлять управление вашим форумом Discourse и разрешить регистрацию пользователей. Дополнительную информацию о возможностях Discourse см. на странице информации о Discourse.
Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.
This textbox defaults to using Markdown to format your answer.
You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!