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

[Discourse]

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

Windows 上で Discourse の開発環境を構築するには、Windows Subsystem for Linux 機能を使用できます。

このセットアップには WSL 2 のインストールが必要です。Windows 10 ビルド 18917 以降でのみ利用可能です。 ここでは、すでに Windows 10 システムに Windows Subsystem for Linux 2 (Ubuntu) がインストールされていると仮定します。警告: 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 ~

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

#!/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 のエンタープライズ、プロ、または教育エディションを使用している場合は、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 で検索できます。

• 以下に移動してください: Download Windows 10
• 「Windows 10 May 2020 Update」の下の「Update Now」ボタンをクリックして、更新アシスタントをダウンロードし、インストールが完了するまで待ちます。
• エラーが発生した場合は、メディア作成ツールをダウンロードして実行し、起動可能なフラッシュドライブ（少なくとも 8GB）を作成して Windows をインストールします。

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

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

両方の機能が有効になったら：

• Ubuntu 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 または Ubuntu を使用した Windows Terminal を実行し、依存関係とツールのインストールを開始できます。

注意: bundle install の中に gem のインストールでエラーが発生した場合: 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 KERNEL の場合: 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

---

結果

上記を実行するか 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

今後発生する可能性のある問題については、将来対応できます。

---

最終更新: @SaraDev による 2022-06-16T02:00:00Z

---

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