このガイドはmacOS開発環境のインストール手順について説明しています。本番環境のガイドについては、こちらを参照してください: Install Discourse in production with the official supported instructions
macOSでDiscourseを設定して、ハッキングや開発を行いたいと考えていますか?
ここでは、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サーバーを起動します。ここでは2つのオプションがあります。
オプション 1: 2つの別々のターミナルタブ/ウィンドウを使用し、Railsとフロントエンドバンドラーを以下のように個別に実行します
bundle exec rails server
および
bin/dev --only ember
オプション 2: 1つのターミナルタブ/ウィンドウのみを使用します:
bin/dev # Pitchforkとフロントエンドバンドラーを一緒に実行します
これで http://localhost:3000 にアクセスして、ローカルのDiscourseインストールを確認できるはずです。(初回の読み込みはサーバーのウォームアップにより最大1分かかる場合があります。)
また、スペックの実行を試すこともできます:
bundle exec rake autospec
すべてのテスト(またはほぼすべてのテスト)がパスするはずです。
新しい管理者の作成
新しい管理者を作成するには、以下のコマンドを実行します:
RAILS_ENV=development bundle exec rake admin:create
プロンプトに従って管理者アカウントを作成します。
メールの設定
MailHogを実行します:
mailhog
おめでとうございます! これで、あなた自身のDiscourseインストールの管理者になりました!
ハッキングを楽しんでください! 始めるために、Discourseプラグイン作成の入門ガイド をご覧ください。
このドキュメントはバージョン管理されています - 変更提案は github で行ってください。