Данное руководство содержит инструкции по установке в среде разработки. Для руководства по установке в продакшн-среде см.: Install Discourse in production with the official supported instructions
Итак, вы хотите настроить Discourse на Ubuntu или Debian для разработки и экспериментов?
Мы исходим из того, что вы работаете локально и у вас не установлены Ruby/Rails/Postgres/Redis на вашей системе Ubuntu или Debian. Давайте начнем!
Требования
Рекомендуется иметь как минимум 4 ГБ ОЗУ и 2 ядра процессора.
Текущая совместимость:
| ОС | Совместимость |
|---|---|
| Debian 11 |  |
| Crostini (Linux в ChromeOS) | |
| Ubuntu 22.04 или новее | |
Установка зависимостей Discourse
В вашей системе должны быть установлены следующие пакеты:
- Git
- rbenv или asdf
- ruby-build
- Ruby (последняя стабильная версия)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- MailHog**
- ImageMagick**
** опционально
Теперь, когда зависимости Discourse установлены, перейдем к установке самого Discourse.
Клонирование Discourse
Склонируйте репозиторий Discourse в папку ~/discourse:
git clone https://github.com/discourse/discourse.git ~/discourse
~ обозначает домашнюю папку, поэтому исходный код Discourse будет доступен в вашей домашней папке.
Настройка базы данных
Создайте роль с тем же именем, что и имя пользователя вашей Linux-системы:
cd /tmp && sudo -u postgres createuser -s "$USER"
Инициализация Discourse
Перейдите в папку Discourse:
cd ~/discourse
Установите необходимые gems:
source ~/.bashrc
bundle install
Установите зависимости JS:
pnpm install
Теперь, когда gems успешно установлены, выполните следующие команды:
bin/rails db:create
bin/rails db:migrate
RAILS_ENV=test bin/rails db:create db:migrate
Запустите Rails и сборщик фронтенда:
bin/dev
Если изображения не отображаются, используйте вместо этого следующую команду:
(вы также можете указать IP-адрес, если работаете на удаленном сервере)
DISCOURSE_HOSTNAME=localhost UNICORN_LISTENER=localhost:3000 bin/dev
Теперь вы должны иметь возможность перейти по адресу http://localhost:3000, чтобы увидеть вашу локальную установку Discourse.
Создание нового администратора
Чтобы создать нового администратора, выполните следующую команду:
bin/rails admin:create
Следуйте подсказкам, и новая учетная запись администратора будет создана.
Настройка почты
Запустите MailHog:
mailhog
Поздравляем! Теперь вы администратор вашей собственной установки Discourse!
Удачной разработки! Чтобы начать, ознакомьтесь с Руководством для начинающих по созданию плагинов Discourse.
Последний раз проверено @blake 2023-04-03T06:00:00Z
Этот документ находится под контролем версий — предлагайте изменения на GitHub.