В этом руководстве описаны инструкции по установке для среды разработки на macOS. Для руководств по развертыванию в продакшене см.: Install Discourse in production with the official supported instructions
Итак, вы хотите настроить Discourse на macOS для хакерства и разработки?
Мы будем исходить из того, что на вашем Mac не установлены Ruby/Rails/Postgres/Redis. Начнем 
!
Установка зависимостей 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 будет доступен в вашей домашней папке.
Инициализация Discourse
Перейдите в папку Discourse:
cd ~/discourse
Установите необходимые гемы
bundle install
Установите JS-зависимости
pnpm install
Далее выполните эти команды для настройки локального экземпляра Discourse:
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
Запустите серверы Rails + Ember, у вас есть два варианта.
Вариант 1: используя два отдельных окна/вкладки терминала, запустите Rails и сборщик фронтенда отдельно через
bundle exec rails server
и
bin/dev --only ember
Вариант 2: используя только одно окно/вкладку терминала:
bin/dev # запускает Pitchfork и сборщик фронтенда вместе
Теперь вы должны иметь возможность перейти по адресу http://localhost:3000, чтобы увидеть вашу локальную установку Discourse. (Обратите внимание, что первая загрузка может занять до минуты, так как сервер разогревается.)
Вы также можете попробовать запустить тесты:
bundle exec rake autospec
Все (или почти все) тесты должны пройти успешно.
Создание нового администратора
Чтобы создать нового администратора, выполните следующую команду:
RAILS_ENV=development bundle exec rake admin:create
Следуйте подсказкам для создания учетной записи администратора.
Настройка почты
Запустите MailHog:
mailhog
Поздравляем! Теперь вы администратор собственной установки Discourse!
Удачного хакерства! Чтобы начать, ознакомьтесь с Руководством для начинающих по созданию плагинов Discourse.
Этот документ находится под контролем версий — предложить изменения можно на github.