macOSにDiscourseをインストールして開発環境を構築する

Discourse · 2014 年 5 月 19 日午後 4:59

このガイドは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 で行ってください。

jamesmarkcook · 2014 年 7 月 27 日午後 9:00

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 · 2016 年 7 月 21 日午後 8:18

Is it possible to reset a discourse completely?

techAPJ · 2016 年 7 月 22 日午前 1:55

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 · 2019 年 4 月 30 日午前 6:33

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

/launcher rebuild app

returns an error.

techAPJ · 2019 年 4 月 30 日午前 7:04

./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 · 2019 年 4 月 30 日午前 7:09

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 · 2019 年 4 月 30 日午前 7:11

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 · 2021 年 11 月 5 日午後 10:35

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

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

blake · 2021 年 11 月 5 日午後 11:28

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

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

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

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

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

github.com/discourse/discourse

Gemfile

main


      
          
          gem "net-smtp", require: false
          gem "net-pop", require: false
          gem "digest", require: false
          
          gem "goldiloader"
          
          group :test do
            gem "capybara", require: false
            gem "webmock", require: false
            gem "simplecov", require: false
            gem "test-prof"
            gem "rails-dom-testing", require: false
            gem "minio_runner", require: false
            gem "capybara-playwright-driver"
            gem "puma", require: false
          end
          
          group :test, :development do
            gem "rspec"
            gem "listen", require: false

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

Decorbuz · 2021 年 11 月 5 日午後 11:49

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

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

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

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

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

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

blake · 2021 年 11 月 5 日午後 11:50

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

Decorbuz · 2021 年 11 月 5 日午後 11:54

ああ！

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

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

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

blake · 2021 年 11 月 6 日午前 12:01

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

Decorbuz · 2021 年 11 月 6 日午前 12:04

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

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

blake · 2021 年 11 月 6 日午後 1:10

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 · 2021 年 11 月 6 日午後 1:45

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

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

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

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

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

merefield · 2021 年 11 月 6 日午後 3:09

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

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

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

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

Nacho_Caballero · 2021 年 11 月 26 日午後 2:31

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

github.com/rbenv/ruby-build

installing older Ruby versions on OSX after XCode 12

opened 03:28AM - 11 Nov 20 UTC

closed 04:10AM - 15 Apr 21 UTC

eddroid

_tldr_: This is an installation problem and solution. Maybe ya'll can do somethi…ng about this in `ruby-build` itself? Maybe not. In any case, it's here for the search bots. ### Problem ```sh $ rbenv install 2.1.7 ``` output ``` BUILD FAILED (Mac OS X 10.15.7 using ruby-build 20200926) Inspect or clean up the working tree at /var/folders/hk/6ghd603s4gggg2kpspf5jjth0000gn/T/ruby-build.20201110215242.31778.FSCdTL Results logged to /var/folders/hk/6ghd603s4gggg2kpspf5jjth0000gn/T/ruby-build.20201110215242.31778.log ``` end of logfile output ``` # ruby-build.20201110215242.31778.log 3 warnings and 4 errors generated. make[2]: *** [ossl_pkcs7.o] Error 1 make[1]: *** [ext/openssl/all] Error 2 make[1]: *** Waiting for unfinished jobs.... compiling objspace_dump.c installing default objspace libraries linking shared-object objspace.bundle linking shared-object nkf.bundle 13 warnings generated. linking shared-object date_core.bundle make: *** [build-ext] Error 2 ``` sample line from openssl extension [MakeMakefile](https://ruby-doc.org/stdlib-2.1.7/libdoc/mkmf/rdoc/MakeMakefile.html) log: ``` # <BUILD_DIR>/ruby-2.1.7/ext/openssl/mkmf.log conftest.c:13:15: error: implicit declaration of function 'OPENSSL_cleanse' is invalid in C99 [-Werror,-Wimplicit-function-declaration] ``` ### Solution ```sh $ CFLAGS="-Wno-error=implicit-function-declaration" rbenv install 2.1.7 ``` output: ``` Downloading openssl-1.0.2u.tar.gz... -> https://dqw8nmjcqpjn7.cloudfront.net/ecd0c6ffb493dd06707d38b14bb4d8c2288bb7033735606569d8f90f89669d16 Installing openssl-1.0.2u... Installed openssl-1.0.2u to /Users/***/.rbenv/versions/2.1.7 Downloading ruby-2.1.7.tar.bz2... -> https://cache.ruby-lang.org/pub/ruby/2.1/ruby-2.1.7.tar.bz2 Installing ruby-2.1.7... WARNING: ruby-2.1.7 is past its end of life and is now unsupported. It no longer receives bug fixes or critical security updates. ruby-build: using readline from homebrew Installed ruby-2.1.7 to /Users/***/.rbenv/versions/2.1.7 ``` ### Explanation [XCode 12 was released September 16, 2020.](https://en.wikipedia.org/wiki/Xcode#12.x_series) [Apple changed the default `CFLAGS` for `clang`.](https://developer.apple.com/documentation/xcode-release-notes/xcode-12-release-notes) > Clang now reports an error when you use a function without an explicit declaration when building C or Objective-C code for macOS (-Werror=implicit-function-declaration flag is on). This change prevents this version of Ruby (and possibly others) from compiling native extensions like `openssl` and `zlib`. Unfortunately, those errors only appear in the corresponding `mkmf.log` for the extensions. [This could also affect building some gems that use C code](https://github.com/macournoyer/thin/pull/364). ```sh gem install <GEMNAME> -- --with-cflags="-Wno-error=implicit-function-declaration" ```

最新バージョンの 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 · 2021 年 12 月 9 日午後 5:50

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

トピック		返信	表示
Install Discourse on Ubuntu or Debian for Development Developer Guides dev-install , how-to	83	201840	2025 年 6 月 22 日
Install Discourse for development using Docker Developer Guides docker , dev-install , how-to	226	92282	2026 年 5 月 22 日
Unable to setup discourse in my windows 10 Self-hosting	22	2507	2022 年 8 月 23 日
Error after installation - Discourse-doctor - antibiotics not working Self-hosting	17	948	2024 年 2 月 7 日
When trying to upgrade: Error running ember build Self-hosting	19	2857	2022 年 3 月 10 日