Как установить discourse на ubuntu

Обновлено: 08.07.2024

Установка Discourse на основе Docker и базовая настройка под Ubuntu (16.04)

Этот документ используется для руководства по установке и базовой настройке Discourse на основе Docker под Ubuntu (номер версии: 16.04).
Автор: Крис Мао (Цзыбинь)
Дата: 28 февраля 2018 г.

Справка

Установка Docker

1. Установите зависимые компоненты

2. Установите сертификат CA

3. Добавить хранилище Docker

4. Обновите список источников.

5. Установите версию Docker CE.

6. Проверьте версию Docker, чтобы убедиться, что установка прошла успешно.

7. Настройте функцию самозапуска Docker при загрузке.

Дискурсивная установка

1. Создайте каталог для установки.

2. Загрузите исходный код в каталог/var/discourse

3. Выполните команду установки.

подсказка:
В процессе установки, если он появляетсяPort 80 appears to already be in useУказывает, что порт 80 на текущем компьютере занят другими программами. В большинстве случаев он должен быть занят Apache. Используйте следующий метод, чтобы изменить порт прослушивания Apache.

Далее идет относительно долгий процесс ожидания . Сделайте чашку кофе и смотрите ^ _ ^

После завершения установки вы можете напрямую использовать настроенное доменное имя или IP-адрес для доступа к Discourse в браузере. Если вы видите в браузере следующий интерфейс, это означает, что Discourse успешно установлен.

подсказка:
Если это система Ubuntu, установленная в VMware, убедитесь, чтоСетевой адаптер виртуальной машины использует режим моста, В противном случае компьютеры в локальной сети, кроме хоста, не смогут получить доступ к виртуальной машине.

Если веб-страницу не удается открыть, проверьте, закрыт ли брандмауэр Ubuntu.

подсказка:
Для выключения брандмауэра можно использовать следующую команду.

Setup Administrater Account

После успешной установки Discourse нам нужно использовать "DISCOURSE_DEVELOPER_EAILSЛюбой из адресов электронной почты в параметре зарегистрирует учетную запись и автоматически станет администратором. Если вы не получили письмо активации учетной записи, проверьте правильность конфигурации раздела SMTP в файле конфигурации. Кроме того, вы можете вручную создать учетную запись администратора с помощью следующей команды .

Установка плагина Discourse

2. Перекомпилируйте контейнер Docker.

Конфигурация дискурса

После успешной установки Discourse мы можем настроить его в соответствии с реальными требованиями. Следующие конфигурации не в порядке.

User Localization

Установить путь:admin/site_settings/category/basic
Проверьте параметр "разрешить локаль пользователя"

Logo Icon

Выполните поиск по теме "Ресурсы для дизайна сайта"
Загрузите файл логотипа, который хотите использовать, на веб-сайт, ответив
Получить URL-адрес загруженного изображения
Откройте admin / site_settings / category / required и вставьте URL-адрес изображения, полученного на предыдущем шаге, в параметр «URL-адрес логотипа».

Таким же образом вы также можете установить «маленький URL логотипа», «дайджест URL логотипа», «URL мобильного логотипа», «URL значка», «URL большого значка», «URL значка сенсорного экрана Apple».

Disable Anonymous

Установить путь:admin/site_settings/category/login
Проверьте параметр "требуется вход в систему"

Change Homepage

Установить путь:admin/site_settings/category/basic
Изменить параметры "top menuПорядок пунктов меню на главной странице в "

Media iFrame

Define Groups

Установить путь:admin/groups/custom

Bulk User Invites

Если Discourse настроен как относительно частный веб-сайт, который не позволяет пользователям регистрировать свои собственные учетные записи для входа, администратору необходимо создать их вручную. Вот способ создания учетных записей пользователей партиями.

Подготовьте файл CSV со следующими требованиями к формату:
1. Каждому пользователю отведена отдельная строка, последовательность столбцов следующая:Почта Адрес,группа пользователей,Номер темы
2. Убедитесь, что адрес электронной почты действителен.
3. Если вам нужно связать несколько групп пользователей для одного пользователя, используйте точку с запятой (;) в режиме английского языка для разделения, напримерgroup_1;group_2;group_3
4. Если группа пользователей и номер темы пусты, после адреса электронной почты нельзя использовать разделители.

Пример файла:

После входа в систему с учетной записью администратора откройте страницу приглашения пользователя (путь доступаu/admin/invited/pending), загрузите файл списка пользователей, чтобы завершить работу с приглашением пользователя. Каждый пользователь получит электронное письмо с приглашением для выполнения последующих действий по созданию учетной записи.

Для получения дополнительной информации см.Официальные форумы。

Bulk Add to Group

Установить путь:admin/groups/bulk

подсказка:
Эта функция действительна только для пользовательских групп.

Если для установки Discourse вы используете чистую операционную систему Ubuntu Server 20.04, вам необходимо выполнить некоторые первоначальные настройки ОС вашего сервера. А именно, добавьте в систему свою учётную запись с правами на использование sudo. Также, настройте интерфейс брандмауэра UFW для возможности подключения к вашему VPS через OpenSSH. И ещё вам нужно развернуть в вашей системе программное обеспечение для работы с контейнерами Docker. После завершения подготовительных работ можно переходить к установке Discourse.

Установка Discourse

На первом шаге по установке Discourse необходимо загрузить образ Docker Discourse. Для этого создайте директорию /var/discourse и запустите клонирование образа в созданный каталог:

Далее, перейдя в директорию /var/discourse запустите установочный скрипт:

В ходе установки необходимо указать системе:

После подтверждения введённых значений скрипт запустит установку Discourse.

В результате своей работы установщик создаст конфигурационный файл /containers/app.yml . Вы можете вносить в этот файл какие-либо коррективы при помощи текстового редактора в случае, если у вас появится необходимость изменить настройки Discourse. Для вступления изменений в силу используйте инструкцию:

Настройка Discourse

На открывшейся странице перейдите по ссылке регистрации:

Заполните форму, ещё раз нажмите кнопку Register и подтвердите ваш E-mail.

После завершения регистрации система запустит визард по настройке конфигурации Discourse. Работу мастера можно пропустить отложив на более позднее время нажатием кнопки Maybe Later.

После завершения работы мастера вы должны увидеть начальную страницу со списком некоторых тем и разделом READ ME FIRST: Admin Quick Start Guide.

Вместо заключения

В своём руководстве по установке разработчики Discourse настоятельно рекомендуют периодически проверять обновления безопасности операционной системы вашего VPS. В Ubuntu Server 20.04 это можно делать запуском команды:

Также, официальная документация содержит рекомендацию использовать более сложные пароли для пользователя root. Настроить сложность парольной политики можно при помощи пакета libpam-cracklib :

И ещё в Ubuntu есть возможность блокировать на 10 минут IP-адреса, с которых совершено более трёх попыток ввода пароля:

На этом установка и первоначальная настройка закончены. Теперь у вас есть возможность управлять вашим форумом или чатом, построенном на программной платформе Discourse.

Discourse – это открытая платформа для коммуникаций и совместной работы. Данное руководство поможет установить Discourse на виртуальный выделенный сервер Ubuntu 14.04.

Требования

Предварительно настроенный 64-битный сервер Ubuntu 14.04.
Команда Discourse рекомендует использовать 1 Гб RAM для маленьких сообществ и минимум 2 Гб RAM для больших сообществ. В таких случаях в системах, использующих обычные жесткие диски, можно настроить своп. Однако своп на SSD-накопителях может со временем ухудшить работу оборудования. Чтобы добавить своп на Ubuntu 14.04, читайте эту статью.
Доменное имя или IP-адрес.
Не-root пользователь с доступом к команде sudo.
Бесплатный аккаунт Mandrill и учётные данные SMTP.

1: Установка Git

Открытая система управления версиями Git понадобится для загрузки исходных файлов Discourse.

Прежде всего, следует обновить систему.

sudo apt-get update
sudo apt-get upgrade

После этого установите Git:

sudo apt-get install git

2: Установка Docker

После этого нужно установить Docker. Эта программа позволит поместить Discourse в изолированное окружение.

Примечание: Docker – это открытый проект, предназначенный контейнеризации и запуска приложений. Больше информации о Docker можно найти здесь.

Инсталлятор Docker можно найти по этой ссылке:

Добавьте учётную запись не-root пользователя в группу docker. Тогда этот пользователь сможет запускать контейнеры Docker:

sudo usermod -aG docker 8host

Выйдите из системы и войдите снова, чтобы обновить настройки:

3: Загрузка Discourse

Создайте каталог для хранения файлов Discourse, /var/discourse:

sudo mkdir /var/discourse

Затем клонируйте образ Discourse в этот каталог:

4: Настройка Discourse

Теперь нужно выполнить начальную настройку Discourse.

Откройте каталог /var/discourse:

Скопируйте файл samples/standalone.yml в каталог containers под названием app.yml:

sudo cp samples/standalone.yml containers/app.yml

Отредактируйте параметры Discourse в файле app.yml:

sudo nano containers/app.yml

Найдите раздел env и укажите в нём свой адрес электронной почты, домен и учётные данные SMTP.

В частности изменить нужно следующие строки:

db_shared_buffers: "128MB"
UNICORN_WORKERS: 2

Примечание: Вышеперечисленные изменения необходимо внести настройки Discourse, иначе форум Discourse не будет работать.

Сохраните и закройте app.yml.

5: Запуск Discourse

Для начала нужно обеспечить программе Docker доступ ко всем необходимым внешним ресурсам. Откройте настройки

Docker в файле /etc/default/docker:

sudo nano /etc/default/docker

Раскомментируйте DOCKER_OPTS, чтобы программа Docker использовала DNS Google.

sudo service docker restart

Примечание: Если не внести поправку в настройки DNS, при запуске может возникнуть ошибка:

fatal: unable to access 'https://github.com/SamSaffron/pups.git/': Could not resolve host: github.com"

Затем соберите Discourse и инициализируйтесь при помощи учётных данных, установленных в предыдущем разделе. Перейдите в каталог:

sudo ./launcher bootstrap app

Выполнение данной команды займёт около 8 минут. Если команда предложит создать SSH-ключ, нажмите Y.

После этого запустите Discourse:

sudo ./launcher start app

Установка Discourse завершена.

6: Доступ к Discourse

Откройте домен или IP-адрес, внесённый ранее в настройки Discourse, в браузере. На экране появится приветственная страница Discourse.

Если вместо этого браузер выдаёт ошибку 502 Bad Gateway, подождите пару минут и обновите страницу.

7: Создание учётной записи администратора

Чтобы зарегистрировать новый аккаунт Discourse, нажмите кнопку Sign Up. Введите адрес электронной почты, указанный в строке DISCOURSE_DEVELOPER_EMAILS. После этого аккаунт автоматически получит права администратора.

Зарегистрировав аккаунт, откройте его. На экране появятся Staff topics и Admin Quick Start Guide. В этом мануале можно найти рекомендации по настройке и использованию Discourse.

Чтобы получить доступ к панели администратора, добавьте в ссылку раздел /admin.

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

Также можно создать аккаунт администратора при помощи консоли (инструкции – здесь), однако это может стать причиной простоя сайта.

Чтобы обновить Discourse, откройте /admin/upgrade и следуйте инструкциям.

Установка Discourse на Ubuntu 16.04

Платформа открытого типа для совместной работы и коммуникации

Что такое Discourse? Это платформа открытого типа, предназначенная для совместной работы, а также коммуникации. Ее получится использовать для чатов, форумов и рассылок. Мы поможем вам поставить Discourse посредством Docker в изолированную среду.

Что же потребуется для инсталляции?

Мы начнем с установки панели VestaCP

Разверните оболочку root для начала загрузки Discourse. Это делается с помощью:

Теперь нужно создать каталог /var/discourse для хранения файлов:

Вам придется провести операцию клонирования образа платформы в созданную папку:

Следующее действие — запуск и настройка Discourse

Вам предстоит открыть ранее сделанный каталог с помощью кода:

В нем нужно запустить сценарий настроек:

По мере установки, на экран будут выводиться вопросы:

Последнее действие — регистрация администраторского аккаунта

Откройте доменное имя Discource в браузере. Вы увидите на экране вот такие строки:

Для создания администраторского аккаунта кликните по кнопке Register. Далее вам придется заполнить форму Register Admin Account:

Нажав кнопку Register, вы сможете принять введенные данные. Вам выведется диалоговое окно с запросом на подтверждение адреса электронной почты. Зайдите в свой ящик и найдите письмо со ссылкой по которой нужно будет перейти.

После подтверждения вы увидите запуск мастера настройки. Если вы хотите это сделать позже, то кликните по Maybe Later. Либо следуйте указаниям Discourse для базовой настройки панели. Вы увидите Quick Start Guide с полезными советами. После настройки платформа Discourse будет готова к работе.

Если хотите обновить версию, загрузите ее с помощью командной строки из Git, а также выполните сборку с помощью:

Вы также сможете обновиться прямо из браузера. Наберите:

Вам предстоит нажать на Upgrade to the Latest Version чтобы началась инсталляция. Мастер настройки поможет вам на этапе установки. После этого вы сможете пользоваться возможностями Discourse: например, приглашать других участников.

Читайте также: