Это руководство содержит инструкции по установке в среде разработки. Для руководства по установке в продакшене см.: Install Discourse in production with the official supported instructions
Итак, вы хотите настроить Discourse на Ubuntu или Debian для хакерства и разработки?
Мы будем исходить из того, что вы работаете локально и на вашей системе Ubuntu или Debian не установлены Ruby/Rails/Postgres/Redis. Приступим!
Требования
Мы рекомендуем иметь как минимум 4 ГБ ОЗУ и 2 ядра процессора.
Текущая совместимость:
| ОС | Совместимость |
|---|---|
| Debian 11 | |
| Crostini (Linux on 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"
[/details]
Инициализация Discourse
Перейдите в папку Discourse:
cd ~/discourse
Установите необходимые гемы
source ~/.bashrc
bundle install
Установите JS-зависимости
pnpm install
Теперь, когда вы успешно установили гемы, выполните следующие команды:
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.