Это руководство содержит инструкции по установке в среде разработки. Для руководства по установке в продакшене см.: Install Discourse in production with the official supported instructions
Итак, вы хотите настроить Discourse на Ubuntu или Debian, чтобы работать с ним и разрабатывать?
Мы предполагаем, что вы работаете локально и не устанавливали Ruby/Rails/Postgres/Redis на вашей системе Ubuntu или Debian. Начнем!
Требования
Мы рекомендуем иметь как минимум 4 ГБ ОЗУ и 2 ядра CPU.
Текущая совместимость:
| ОС | Совместимость |
|---|---|
| Debian 11 | |
| Crostini (Linux на ChromeOS) | |
| Ubuntu 22.04 или новее |
Установка зависимостей Discourse
Вам понадобятся следующие пакеты на вашей системе:
- Git
- rbenv или asdf
- ruby-build
- Ruby (последняя стабильная версия)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- libvips
- 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.