macOS 開発用 Discourse インストール

[Discourse]

このガイドは 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
• MailHog**
• ImageMagick**

** オプション

ターミナルを再起動してください

これで Discourse の依存関係がインストールできましたので、次に Discourse 自体のインストールに進みましょう。

ターミナルの再起動

シェルを終了し、再起動することで、インストールされたパッケージへのパスがターミナルによって正しく認識されるようになります。

Discourse のクローン

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

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

~ はホームフォルダを示すため、Discourse のソースコードはホームフォルダに配置されます。

Discourse のブートストラップ

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

cd ~/discourse

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

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]

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