在 Windows 上安装 Discourse 用于开发

[Discourse]

本教程已在 Windows 10 和 11 上测试。

要在 Windows 上设置 Discourse 的开发环境，你可以使用 Windows 子系统 for Linux 功能。

此设置需要安装 WSL 2。它仅适用于 Windows 10 版本 18917 或更高版本。 我们假设你已经在 Windows 10 系统上安装了 Windows 子系统 for Linux 2 (Ubuntu)。警告： 请安装 Ubuntu 18.04，而不是 20.04，因为某些安装在 20.04 上会失败。更多信息请参阅本文底部的 2020 年 6 月 30 日说明。

让我们开始吧！

安装 Discourse

1. 首先按照 Ubuntu 开发环境 Discourse 安装新手指南 中的步骤操作，直到 克隆 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"
```\n
## 引导 Discourse

切换到你的 Discourse 文件夹：

```sh
cd ~/discourse
```\n
安装所需的 gems

```sh
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

尝试运行 specs：

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 来查看。

• 前往：下载 Windows 10
• 点击 Windows 10 2020 年 5 月更新下的立即更新按钮，以下载更新助手并让其安装完成
• 如果出现任何错误，请下载媒体创建工具，运行它并创建一个可启动的闪存驱动器（至少 8GB 闪存），并使用它来安装 Windows。

完成 Windows 安装后，你需要手动安装 WSL 2
但首先，我们需要确保启用了 2 个功能：

• 虚拟机平台，可以通过前往“程序和功能”然后在“打开或关闭 Windows 功能”中启用可选功能，直接从 Windows 中启用
• 另一个是虚拟化，只能从 BIOS 中启用。然而，此选项因主板而异。例如：在 AMD 上称为 SVM。所以请查找你的特定主板。

现在你已经启用了这两个功能：

• 安装 Ubuntu 18.04，而不是 20.04，因为某些安装在 20.04 上会失败。
• 前往此处并更新 Linux 内核：回复中的链接
• 前往此链接并按照步骤操作：在 Windows 10 上安装 Windows 子系统 for Linux (WSL) | 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 终端，并开始安装依赖项和工具

注意：如果在 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 内核：更新 WSL 2 Linux 内核 | 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 命令后，这两个实例应该在其默认/指定端口上运行。要通过默认的 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 命令后，这两个实例应该在其默认/指定端口上运行。要通过默认的 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 上建议更改。