開発用 Windows に Discourse をインストール

[Discourse]

このチュートリアルは Windows 10 および 11 でテストされています。

Windows 上で Discourse の開発環境をセットアップするには、Windows Subsystem for Linux 機能を使用することができます。

このセットアップには WSL 2 のインストールが必要です。Windows 10 ビルド 18917 以降でのみ利用可能です。 ここでは、Windows 10 システムにすでに Windows Subsystem for Linux 2 (Ubuntu) がインストールされていることを前提とします。警告: 20.04 では一部のインストールが失敗するため、Ubuntu 18.04 をインストールし、20.04 はインストールしないでください。詳細については、この投稿の下部にある 2020 年 6 月 30 日のメモをご覧ください。

では、始めましょう！

Discourse のインストール

1. まず、トピック Beginners Guide to Install Discourse on Ubuntu for Development の手順に従い、Clone Discourse のステップまで進みます。

@techAPJ

Discourse の依存関係のインストール

システムに以下のパッケージが必要です：

• Git
• rbenv または asdf
• ruby-build
• Ruby (最新の安定版)
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

** オプション

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

2. データベースのセットアップの前に、以下のコマンドを使用して PostgreSQL サービスと Redis サーバーを手動で起動する必要があります。

   sudo service postgresql start
   redis-server --daemonize yes
   

3. 次に、Ubuntu ガイド の残りのすべての手順を実行します。

@techAPJ

Discourse のクローン

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

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

~ はホームフォルダを示すため、Discourse のソースコードはホームフォルダに利用可能になります。

データベースのセットアップ

Ubuntu システムのユーザー名と同じ名前のロールを作成します：

sudo -u postgres createuser -s "$USER"

Discourse のブートストラップ

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

cd ~/discourse

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

source ~/.bashrc
bundle install

これで gems のインストールが成功しましたので、以下のコマンドを実行します：

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

スペックを実行してみます：

bundle exec rake autospec

すべてのテストがパスするはずです。

Rails サーバーを起動します：

bundle exec rails server

これで http://localhost:3000 で Discourse アプリに接続できるはずです。試してみてください！

別のターミナルインスタンスで、Discourse フォルダ (cd ~/discourse) に移動し、以下を実行します：

bin/dev --only ember

これによりフロントエンドバンドラーが起動します。アプリは引き続き http://localhost:3000 から提供されます。

Discourse 起動コマンドの作成

これで開発環境はほぼ準備完了です。 唯一の問題は、Windows で Ubuntu を開くたびに PostgreSQL サービスと Redis サーバーを手動で起動する必要があることです。心配しないでください、カスタムコマンドを作成することでこれを回避できます

cd ~
```\n
コマンド `nano start-discourse` を使用して新しいファイルを作成し、以下の内容を貼り付けて保存し、終了します。

```sh
#!/bin/bash

# PostgreSQL を起動
sudo service postgresql start

# Redis サーバーを起動
redis-server --daemonize yes

次に、以下のコマンドを使用して CHMOD を変更します。

chmod +x start-discourse

そして、ファイルを bin フォルダにコピーします。

sudo cp start-discourse /usr/bin/

これで完了です。 今後、Ubuntu bash を開くたびに、以下のコマンドを実行して開発を開始できます

start-discourse

---

あるいは、Windows 10 Enterprise、Pro、または Education Edition を使用している場合は、hyper-v で Linux 仮想マシンを作成して Discourse 開発環境をセットアップすることもできます。

Windows 環境に関する注意

2020 年 6 月 30 日現在:

@AndreaHabib

Windows 10 ビルド 2004 と WSL 2 の導入により、Discourse が実際に動作するには WSL 2 が必要になったため、多くの人がいくつかの問題に直面する可能性があります。
まず第一に： まだの場合は、システムを Windows 2004 (19041) に更新する必要があります。
注意：システム設定の Windows Update を使用してインストールしないでください。インストール中にエラーが発生する可能性があります。また、Windows 1903 (18362) または 1909 (18363) を使用していることを確認してください。winver を検索して確認できます。

• Windows 10 をダウンロード にアクセスします。
• Windows 10 2020 年 5 月更新の下にある「今すぐ更新」ボタンをクリックして、更新アシスタントをダウンロードし、インストールと完了を待ちます。
• エラーが発生した場合は、メディア作成ツールをダウンロードして実行し、起動可能なフラッシュドライブ（8GB 以上のフラッシュ）を作成し、それを使用して Windows をインストールします。

Windows のインストールが完了したら、WSL 2 を手動でインストールする必要があります。
まず、以下の 2 つの機能が有効になっていることを確認する必要があります：

• 仮想マシンプラットフォーム：Windows の「プログラムと機能」から「オプション機能の有効化または無効化」で直接有効にできます。
• もう一つは仮想化です。これは BIOS からのみ有効にできます。ただし、このオプションはマザーボードによって異なります。例えば、AMD では SVM と呼ばれます。したがって、特定のマザーボードについて調べてください。

これで両方の機能が有効になりました：

• 20.04 では一部のインストールが失敗するため、Ubuntu 18.04 をインストールし、20.04 はインストールしないでください。
• ここにアクセスして Linux カーネルを更新します：返信内のリンク
• このリンクにアクセスして手順に従います：Install Windows Subsystem for Linux (WSL) on Windows 10 | Microsoft Docs
• PowerShell（管理者として実行）に移動し、wsl --set-version Ubuntu-18.04 2 または wsl --set-version Ubuntu 2 を実行します（wsl -l -v で表示されるディストリビューションに応じて）。
• 変換には数分かかることがあります。
• wsl -l -v を実行して、Ubuntu が WSL 2 で実行されていることを確認します。

これで Ubuntu-18.04 または Windows Terminal with Ubuntu を実行し、依存関係とツールのインストールを開始できます。

注意：bundle install 中に gems のインストールでエラーが発生した場合は、Ubuntu-18.04 を使用しており、20.04 を使用していないことを確認してください。

ただし、すでに postgreSQL 12 がポート 5432 で実行されている場合、依存関係が postgreSQL 10 をインストールし、ポートが 5433 にインクリメントされる可能性があるため、いくつかの問題が発生する可能性があります。
これを修正するには：

• テキストエディタ（例えば VS Code）でフォルダを開きます。
• config/database.yml に移動します。
• development と adapter の下に新しい行を追加し、port: 5433 を追加します。
• test と profile についても同様に設定してください。

上記が機能しない場合は、pg_isready を介して PostgreSQL が実行されているかどうか、およびどのポートで実行されているかを確認し、上記と同じ手順に従って、データベースが実行されているポートにポートを設定してください。

LINUX カーネルについて：Updating the WSL 2 Linux kernel | Microsoft Docs

@RickyC0626

database.yml で明示的なポート設定を必要としないソリューション

データベースの作成とマイグレーション中に発生するいくつかのエラー：

特定のポートへの無効な Redis 接続 / 接続拒否

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

このエラーから、Redis が使用するポートが 6379 であることがわかります。このポート経由で Redis サーバーを起動することでこれを修正できます。

デフォルトでは、redis-server --daemonize yes で動作するはずですが、動作しない場合は以下を使用します：

redis-server --daemonize yes --port 6379

Redis インスタンスのステータスを確認します：

redis-cli

127.0.0.1:6379> ping
PONG

psql ポートへの無効な接続

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

このエラーから、PostgreSQL がポート 5432 に接続することに問題があることがわかります。通常、サービスを開始すれば動作するはずです。

sudo service postgresql start

それでも動作せずエラーが継続する場合は、サービスがリッスンしているポートを確認し、必要に応じて postgresql.conf でポートを変更してみてください：

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

結果

n
上記を実行したか、start-discourse コマンドを実行した後、2 つのインスタンスはデフォルト/指定されたポートで実行されるはずです。デフォルトの Windows cmd ターミナルでステータスを確認するには、以下を実行できます：

netstat -anop tcp

これにより、以下のような内容が表示されます：

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

これで、postgresql と redis-server の両方のインスタンスが実行されていることを確認しました。

また、以下のコマンドを使用して、Ubuntu または WSL 上のインスタンスのステータスを確認できます：

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

ここから、これらのコマンドは database.yml ファイルを修正する必要なく、大きな問題なく動作するはずです：

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

今後発生する可能性のあるその他の問題は、将来的に解決できます。

2020 年 7 月 1 日現在

@RickyC0626

database.yml で明示的なポート設定を必要としないソリューション

データベースの作成とマイグレーション中に発生するいくつかのエラー：

特定のポートへの無効な Redis 接続 / 接続拒否

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

このエラーから、Redis が使用するポートが 6379 であることがわかります。このポート経由で Redis サーバーを起動することでこれを修正できます。

デフォルトでは、redis-server --daemonize yes で動作するはずですが、動作しない場合は以下を使用します：

redis-server --daemonize yes --port 6379

Redis インスタンスのステータスを確認します：

redis-cli

127.0.0.1:6379> ping
PONG

psql ポートへの無効な接続

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

このエラーから、PostgreSQL がポート 5432 に接続することに問題があることがわかります。通常、サービスを開始すれば動作するはずです。

sudo service postgresql start

それでも動作せずエラーが継続する場合は、サービスがリッスンしているポートを確認し、必要に応じて postgresql.conf でポートを変更してみてください：

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

結果

上記を実行したか、start-discourse コマンドを実行した後、2 つのインスタンスはデフォルト/指定されたポートで実行されるはずです。デフォルトの Windows cmd ターミナルでステータスを確認するには、以下を実行できます：

netstat -anop tcp

これにより、以下のような内容が表示されます：

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

これで、postgresql と redis-server の両方のインスタンスが実行されていることを確認しました。

また、以下のコマンドを使用して、Ubuntu または WSL 上のインスタンスのステータスを確認できます：

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

ここから、これらのコマンドは database.yml ファイルを修正する必要なく、大きな問題なく動作するはずです：

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

今後発生する可能性のあるその他の問題は、将来的に解決できます。

---

Last Reviewed by @SaraDev on 2022-06-16T02:00:00Z

---

このドキュメントはバージョン管理されています - 変更提案は on github でお願いします。

[Arkshine]

@Arkshine

FreshなUbuntu 22（Windows 10、WSL2）と正常にインストールされたDiscourseで、すべての画像がデフォルトポート4200で提供されない。

解決策が見つかりました。

127.0.0.1 を localhost に置き換えると、画像の問題が解決することに気づきました。

少し調べたところ、Discourseを起動するには次のコマンドを使用できます。

DISCOURSE_HOSTNAME=localhost UNICORN_LISTENER=localhost:3000 bin/ember-cli -u

---

後でガイドを更新します。

[Arkshine]

このPRを確認していただけますか？

FIX: The PostgreSQL service not starting after installation (WSL2 context)

これにより、このガイドがもう少し使いやすくなります。

[Will_S1 (Will S)]

「残念ながら、予期せぬエラーが発生し、Bundler を続行できません。」というエラーが発生する原因について、何かご存知ですか？ bundle install の後です。

[D111 (D)]

同じ問題

[sam (Sam Saffron)]

エラーのスクリーンショットを提供していただけますか？お使いのRubyのバージョンは何ですか？

[frocm]

依存関係で問題が発生しています。

ux430uq@Asus-UX430UQ:~/discourse$ bundle install
You must use Bundler 2 or greater with this lockfile.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Bundler version 1.16.1

ux430uq@Asus-UX430UQ:~/discourse$ gem install bundler

Fetching: bundler-2.4.20.gem (100%)
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /var/lib/gems/2.5.0 directory.
ux430uq@Asus-UX430UQ:~/discourse$
ux430uq@Asus-UX430UQ:~/discourse$ sudo gem install bundler
[sudo] password for ux430uq:
Fetching: bundler-2.4.20.gem (100%)
ERROR:  Error installing bundler:
        The last version of bundler (>= 0) to support your Ruby & RubyGems was 2.3.26. Try installing it with `gem install bundler -v 2.3.26`
        bundler requires Ruby version >= 2.6.0. The current ruby version is 2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Bundler version 1.16.1
ux430uq@Asus-UX430UQ:~/discourse$

簡単に修正するにはどうすればよいですか？ 2.6.0、次に2.7.0をインストールしようとしましたが、常に他の問題が発生していました。

[AliBenBongo]

以前のコメントにもありましたが、私もこのガイドに従おうとした際にいくつかの困難やエラーに遭遇しました。Windows 10とWindows 11の両方のデスクトップで試しました。

試行錯誤の結果、Windows 11で完全に動作する開発環境を構築するための手順がわかりました。これは最新の22H2ビルドと、今後の23H2リリースプレビューでテスト済みです（Windows 10の最新ビルドでも機能するはずです）。

もしどなたかの役に立つようでしたら、ガイドをここに投稿しました:-

Guide to Setting Up Discourse Development Environment - Windows 11

Hi Everyone, After spending some time attempting to get a working development environment up and running under Windows 11 / WSL2 I thought I would share the steps that I have followed. This is my first post here so I hope that this is of use to somebody I am a Systems Administrator used to working with Windows so this has been an interesting journey learning Linux / Ruby / Discourse etc. A few things seem to have changed since the guide for Windows 10 was written and I ran into…

WindowsでDiscourseを実行しようとしている私のような人々を助けることができれば幸いです

[Canapin (Coin-coin le Canapin)]

再度、公式ガイド全体を確認し、前回試行したときから何も問題が発生していないことを確認しました。
Windows 11 の WSL で Ubuntu (バージョン指定なし) をインストールしました。この場合、最新の LTS バージョンである 22.04 がインストールされました。

問題は発生しませんでした。すべて順調で、エラーもなく、開発環境のインストールも完了しました。

将来、公式ガイドを使用して何かをインストールする際に問題が発生した場合は、エラーを書き留めて私たちに報告してください。常に役立ちます

---

ただし、2 つの警告があります。

Node.js をインストールするとき:

================================================================================
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
================================================================================

                           SCRIPT DEPRECATION WARNING


  Node.js をインストールするために使用されていた https://deb.nodesource.com/setup_X に
  あるこのスクリプトは現在非推奨であり、最終的には無効になります。

  NodeSource distributions Github にアクセスし、
  移行手順に従ってください。
  https://github.com/nodesource/distributions

  NodeSource Node.js Linux distributions GitHub リポジトリには、
  どのバージョンの Node.js とどの Linux ディストリビューションが
  サポートされているか、およびインストール方法に関する情報が含まれています。
  https://github.com/nodesource/distributions


                          SCRIPT DEPRECATION WARNING

================================================================================
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
================================================================================

この待機を避けるにはスクリプトを移行してください
60 秒後に続行します (中止するには Ctrl-C を押してください)...

redis-server --daemonize yes を実行するとき:

# WARNING メモリのオーバーコミットを有効にする必要があります！無効にすると、メモリ不足の状態でバックグラウンド保存またはレプリケーションが失敗する可能性があります。無効にすると、メモリ不足の状態でも失敗する可能性があります。詳細については https://github.com/jemalloc/jemalloc/issues/1328 を参照してください。この問題を解決するには、/etc/sysctl.conf に 'vm.overcommit_memory = 1' を追加してから再起動するか、コマンド 'sysctl vm.overcommit_memory=1' を実行して有効にしてください。

[AliBenBongo]

なぜそんなに多くの問題があったのか分かりません！トラブルシューティング中に気づかずに修正したWindowsのインストールに何か奇妙なものがあったのかもしれません！

それでも、これまでに学んだことに満足しており、フォーラムをDiscourseに移行する作業を続けることを楽しみにしています。

[Arkshine]

@Canapin

もう一度、この公式ガイドを最初から最後まで確認しました。前回試した時から何も壊れていないことを確認するためです。

Windowsを再インストールする必要があったので、クリーンなWindows 11をインストールしました。
ガイドに従って、後で報告します！@AliBenBongoさんのガイドも念頭に置きます。

[Arkshine]

フォローアップです。

ガイドは確かに更新が必要ですが、Windows 11 22H2 のクリーンインストールでも問題なく動作します。

唯一の問題は、ターミナルで wsl コマンドは動作していましたが、WSL 機能がデフォルトで有効になっていなかったことです。

[NateDhaliwal]

このガイドは古いと思います。Ubuntu/Debianガイドで言及されている手順は、もはや存在しません。

[NateDhaliwal]

これらの手順をすべて元に戻す方法はありますか。たとえば、パッケージ、gem、およびクローンをアンインストールするスクリプトを実行することはできますか。

[TempAccount]

@Discourse

警告: Ubuntu 18.04 をインストールしてください。20.04 は一部のインストールが失敗するため、インストールしないでください。

18.04 を 20.04 の上にインストールすることは、まだ必要ですか？

nodejs をインストールする際にエラーが発生しています。

# apt install nodejs

パッケージリストを読み込んでいます... 完了
依存関係ツリーを作成しています
状態情報を読み取っています... 完了
いくつかのパッケージはインストールできませんでした。これは、不可能な状況を要求したか、不安定版ディストリビューションを使用している場合に、必要なパッケージがまだ作成されていないか、Incoming から移動されていないことを意味する可能性があります。
以下の情報が状況の解決に役立つかもしれません。

以下のパッケージにはアンメットな依存関係があります:
  nodejs : 依存: libc6 (>= 2.28) ですが、2.27-3ubuntu1.6 がインストールされようとしています
E: 問題を修正できません。保留中の壊れたパッケージがあります。```

[saros]

@Arkshine

解決策を見つけました。

127.0.0.1 を localhost に置き換えると、画像の問題が解決することがわかりました。

検索したところ、以下のコマンドで Diwsl を起動できます。

24.04 のインストールに失敗し、ホストマシンから 3000 ポートに接続できません

[merefield (Robert)]

24.04 で動作しています。サーバー起動時の状態について、より詳細な情報を共有することをお勧めします。

FORCE_HOSTNAME=localhost bin/ember-cli -u を試してみてください。これにより、バックエンドとフロントエンドの両方のサーバーを同時に実行できます。

（移動中：記憶から）