Это руководство содержит инструкции по установке для среды разработки 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
- libvips
- MailHog**
- ImageMagick**
** необязательно
перезапустите терминал
Теперь, когда зависимости Discourse установлены, перейдем к установке самого Discourse.
Перезапустите терминал
Выход из оболочки и перезапуск терминала гарантирует, что пути к установленным пакетам будут правильно определены.
Клонируйте Discourse
Склонируйте репозиторий Discourse в папку ~/discourse:
git clone https://github.com/discourse/discourse.git ~/discourse
~ обозначает домашнюю папку, поэтому исходный код Discourse будет доступен в вашей домашней папке.
Инициализация Discourse
Перейдите в вашу папку Discourse:
cd ~/discourse
Установите необходимые gem-пакеты
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.