このガイドは 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
必要な 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 と Ember CLI を個別に実行します:
bundle exec rails server
および
bin/ember-cli
オプション 2: 1 つのターミナルタブ/ウィンドウのみを使用します:
bin/ember-cli -u # Pitchfork サーバーをバックグラウンドで実行します
これで、http://localhost:4200 にアクセスしてローカルの Discourse インストールを確認できるようになりました。(最初の読み込みには、サーバーがウォームアップするため最大 1 分かかる場合があります。)
また、以下のコマンドでテストを実行することもできます:
bundle exec rake autospec
すべての(またはほぼすべての)テストが合格するはずです。
新しい管理者アカウントの作成
新しい管理者アカウントを作成するには、以下のコマンドを実行します:
RAILS_ENV=development bundle exec rake admin:create
プロンプトに従って管理者アカウントを作成します。
メール設定の構成
MailHog を実行します:
mailhog
おめでとうございます!これで、ご自身の Discourse インストールの管理者となりました!
ハッキングを楽しんでください!始めるには、Discourse プラグイン作成の初心者ガイドをご覧ください。
このドキュメントはバージョン管理されています。変更を提案する場合は GitHub まで。