開発用 Discourse の macOS へのインストール

[Discourse]

このガイドは 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 とフロントエンドバンドラーを個別に実行します。

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 でお知らせください。

[jamesmarkcook (James Cook)]

If anyone is getting failing specs with most of them being .count errors, then try the following:

RAILS_ENV=test bundle exec rake db:reset

I had a problem where development data somehow got into my test database and was causing lots of failures.

[henrikbg (Henrik Berg)]

Is it possible to reset a discourse completely?

[techAPJ (Arpit Jalan)]

@Henrik_B

Is it possible to reset a discourse completely?

Yes, do:

rake db:drop db:create db:migrate

Note that this will wipe everything and you will have to create your Admin user account again.

[Chaboi_3000]

Can someone assist me in how I can update my discourse?

/launcher rebuild app

returns an error.

[techAPJ (Arpit Jalan)]

./launcher rebuild app is for discourse_docker based production setup. To update local/development Discourse instance you need:

cd ~/discourse
git pull origin master

[Chaboi_3000]

@techAPJ

git pull origin master

I get this error @techAPJ,

error: Your local changes to the following files would be overwritten by merge:
	.gitignore
Please commit your changes or stash them before you merge.
Aborting

[techAPJ (Arpit Jalan)]

The error message is pretty clear:

Please commit your changes or stash them before you merge.

If you want to ignore your local changes, do:

git fetch origin
git reset --hard origin/master

[Decorbuz]

Ruby on Rails フォーラムのガイドを使っていて、現在はステップ 7 でつまずいています。

これはおそらくとても「初心者」的な質問だと思いますが、そのトピックにリンクされている実験的なブランチをどのように「指し示す」のでしょうか？いくつか試してみたのですが、毎回 Unknown command mini_racer, というメッセージが表示されてしまいます。

[blake (Blake Erickson)]

ここでは質問しても問題ありません。

このガイドでは、Ruby on Rails フォーラムで参照している、私たちが作成した特定の M1 向け手順 がいくつか含まれています。

@Decorbuz

これはおそらく非常に「初心者向け」な質問かもしれませんが、そのトピックでリンクされている実験用ブランチをどのように「指し示す」のでしょうか？

後で自分の M1 Air を確認する必要がありますし、最近新しい Mac をセットアップした同僚の方が、これがまだ必要かどうかをよりよく知っているかもしれません。しかし、ブランチを指し示す方法の例はステップ 7 にあります。

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

したがって、ローカルの discourse/Gemfile のこの行を編集します。

Gemfile

その後、bundle install を実行してください。

[Decorbuz]

@pfaffman

これらの手順に従わなかった場合（ステップ 7 がありませんが）、ここで質問するのはあまり適切ではありません。

元の投稿の一番上にリンクがあります。

Ruby on Rails フォーラムのトピックは数ヶ月も前に活動が止まっています。OP は 2 月以来アクティブになっておらず、助けを求めて寄せられたコメントにも返信していません。

ここには私を助けてくれる人がもっといます。念のため言っておきますね。

@blake

ステップ 7 にブランチを指し示す方法の例があります：

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

それをターミナルにコピーして試しましたが、以前と同じ Unknown command mini_racer, エラーが表示されました。

正直なところ、Ruby on Rails フォーラムのガイドはその点において私が望むほど明確ではありません。

あらかじめお詫び申し上げます…

[blake (Blake Erickson)]

@Decorbuz

それをターミナルにコピーして実行しましたが、以前と同じ「Unknown command mini_racer」エラーが表示されました。

それは実行するコマンドではありません。discourse ディレクトリ内にある「Gemfile」という実際のテキストファイルを編集する必要があります。

[Decorbuz]

@blake

discourse ディレクトリ内にある「Gemfile」という実際のテキストファイルを編集する必要があります。

ああ！

ありがとう！今すぐ試してみます。

個人的には、Ruby on Rails フォーラムのガイドを編集して、ステップ 7 についてさらに明確な説明を加えるべきだと思います。ただの個人的な意見ですが。

すぐ戻ります。少し待ってください…

[blake (Blake Erickson)]

急いで行かないといけないので申し訳ありませんが、m1 Mac向けのmini_racerの修正はマージされたと思います。私のm1 MacのGemfileを確認したところ、編集されていないので、ステップ7はスキップできると思います。

[Decorbuz]

ステップ 8 を実行したところ、「Could not locate Gemfile」というエラーが表示されました。

ステップ 7 は（おそらく）解決できたのですが、ステップ 8 でまだ問題が発生しており、上記のエラーが出力されます。

[blake (Blake Erickson)]

@Decorbuz

ステップ 8 を実行したところ、Could not locate Gemfile というエラーが表示されました。

bundle install を実行する際は、必ず discourse ディレクトリ内にいる必要があります。

@techAPJ

Discourse のクローン

Discourse リポジトリを ~/discourse フォルダにクローンします：

git clone https://github.com/discourse/discourse.git ~/discourse

~ はホームフォルダを意味するため、Discourse のソースコードはホームフォルダに格納されます。

Discourse のブートストラップ

Discourse フォルダに移動します：

cd ~/discourse

必要な gem をインストールします

bundle install

[JQ331]

@merefield

実は、数ドル以上かかっています（4GB の 8 コア VPS です。おそらく過剰ですが）、これによりあらゆるプラットフォームからどこでも開発できます。パフォーマンスは非常に良好ですが、Web サーバーを再起動すると数秒の遅延が生じることは避けられません。

@merefield さん、こんにちは。リモート環境についてもう少し詳しく説明していただけますか？

テーマの開発では、ライブサイトに変更を加えることができますが、プラグインの開発においては、Discourse のコードベース全体（その上にプラグインを配置した状態）をローカルマシンに用意して行う以外に方法がないように思われます。

その結果、プラグインをコーディングする際に CSS 以外の何らかの変更を加えると、リロードするたびに 1) コンピューターのファンが回り出し、2) リロードに確実な 30 秒を要します。さらにサーバーを再起動する必要がある場合は、数分かかってしまいます。

これらの遅延は積み重なります。通常のコーディングフロー（ホットリロードがあるか、変更ごとにせいぜい 2〜3 秒かかる環境）であれば 15 分で済むものが、実際には1 時間もかかってしまうこともあります。

そのため、処理を高速化するためのご提案をいただければ幸いです。

[merefield (Robert)]

これはおそらく Ubuntu のトピック の方が適切でしょう。私はクラウドサーバー上でそのインストールを実行しており、nginx と完全な DNS（Docker は使用せず）でフロントエンドを構築しているため、実際にドメインを指しています。すべてをターミナルから実行しています。その環境でも Ember CLI がうまく動作するようになりました。

それほど高速ではありませんが、十分な速度です。フル HTTPS コールバックサービスを実行してテストできるという利点があります。

私が知る限り、最も高速なプラグイン開発環境はローカルの WSL2 上の Docker Dev で、爆速です。また、メンテナンスも非常に簡単です。残念ながら、私の知る限り discourse_theme はその環境ではまだ動作しないため、その作業については再びクラウドサーバーに戻っています。

なぜ Apple がここで出遅れているのか、少し不思議に思います。Microsoft のエンジニアたちは非常に機転が利くことを証明しました。

[Nacho_Caballero]

Ruby 2.7.3 のインストールでエラーが発生した場合に備えて、Xcode 12 以降で何かが変更され、rbenv でのインストールプロセスが壊れるようです。

installing older Ruby versions on OSX after XCode 12

最新バージョンの psych と libyaml がインストールされているにもかかわらず、次のようなエラーが 계속 발생しました。

It seems your ruby installation is missing psych (for YAML output).
To eliminate this warning, please install libyaml and reinstall your ruby.

ガイドで提案されている回避策を試しましたが、同じエラーが 계속発生し、最終的には rvm を使用する必要がありました。

rvm install 2.7.3

[JQ331]

プラグイン開発をより速く行う方法について、最近アプローチを変更しました。そして、それは素晴らしい結果をもたらしています。基本的に、フロントエンドの作業はすべてテーマコンポーネントに移動し、プラグイン自体ではバックエンドの作業のみをコーディングします。他の人も以前にそれに気づいていたことは知っています。しかし、今私がそれをやっていると、プログラミングははるかに速く、より快適になりました。詳細はこちらをご覧ください。