在 Windows 上安装 Discourse 进行开发

[Discourse]

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

要在 Windows 上为 Discourse 搭建开发环境，您可以使用 适用于 Linux 的 Windows 子系统 功能。

此设置需要安装 WSL 2。它仅在 Windows 10 版本 18917 或更高版本中可用。 我们假设您已经在 Windows 10 系统上安装了 适用于 Linux 的 Windows 子系统 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"

引导 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 更新进行安装，因为这可能会导致安装中途出错。另外，请确保您处于 Windows 1903 (18362) 或 1909 (18363) 版本，您可以搜索 winver 来确认。

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

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

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

既然您已经启用了这两个功能：

• 安装 Ubuntu 18.04，而不是 20.04，因为在 20.04 上某些安装会失败。
• 前往此处更新 Linux 内核：链接在回复中
• 前往此链接并按照步骤操作：在 Windows 10 上安装适用于 Linux 的 Windows 子系统 (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 也执行相同的操作。

如果上述方法不起作用，请确保检查 PostgreSQL 是否正在运行以及运行在哪个端口，通过 pg_isready。然后按照上述相同的说明，将端口设置为数据库运行的端口。

关于 LINUX KERNEL：更新 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 上提出更改建议。