開発用 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 でお願いします。