在 macOS 上安装 Discourse 用于开发

[Discourse]

本指南介绍了 macOS 开发环境的安装步骤。有关生产环境安装指南，请参阅：Install Discourse in production with the official supported instructions

你想在 macOS 上搭建 Discourse 进行开发和调试吗？

我们假设你的 Mac 上尚未安装 Ruby/Rails/Postgres/Redis。让我们开始吧 ！

安装 Discourse 依赖项

你的系统中需要安装以下软件包：

• Git
• rbenv 或 asdf
• ruby-build
• Ruby（最新稳定版）
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• libvips
• MailHog**
• ImageMagick**

** 可选

重启你的终端

现在我们已经安装了 Discourse 的依赖项，接下来让我们安装 Discourse 本身。

重启终端

退出你的 shell 并重新启动它，可以确保终端正确获取已安装软件包的路径。

克隆 Discourse

将 Discourse 仓库克隆到 ~/discourse 文件夹中：

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

~ 表示主目录，因此 Discourse 源代码将位于你的主目录中。

初始化 Discourse

切换到你的 Discourse 文件夹：

cd ~/discourse

安装所需的 gems

bundle install

安装 JS 依赖项

pnpm install

接下来，运行以下命令来设置你的本地 Discourse 实例：

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

启动 rails 和 Ember 服务器，你有两个选择。

选项 1：使用两个单独的终端标签页/窗口，分别通过以下命令运行 Rails 和前端打包器：

bundle exec rails server

以及

bin/dev --only ember

选项 2：仅使用一个终端标签页/窗口：

bin/dev # 同时运行 Pitchfork 和前端打包器

现在你应该可以访问 http://localhost:3000 来查看你的本地 Discourse 安装。（注意：由于服务器需要预热，首次加载可能需要长达一分钟的时间。）

你也可以尝试运行测试规范：

bundle exec rake autospec

所有（或几乎全部）测试应该都会通过。

创建新管理员

要创建新的管理员，请运行以下命令：

RAILS_ENV=development bundle exec rake admin:create

按照提示创建管理员账户。

配置邮件

运行 MailHog：

mailhog

---

恭喜！你现在是自己 Discourse 安装的管理员了！

祝开发愉快！如果你想开始动手，请参阅 Discourse 插件创建入门指南。

---

本文档受版本控制 - 建议更改请 在 github 上提交。

[jamesmarkcook (James Cook)]

If anyone is getting failing specs with most of them being .count errors, then try the following:

RAILS_ENV=test bundle exec rake db:reset

I had a problem where development data somehow got into my test database and was causing lots of failures.

[henrikbg (Henrik Berg)]

Is it possible to reset a discourse completely?

[techAPJ (Arpit Jalan)]

@Henrik_B

Is it possible to reset a discourse completely?

Yes, do:

rake db:drop db:create db:migrate

Note that this will wipe everything and you will have to create your Admin user account again.

[Chaboi_3000]

Can someone assist me in how I can update my discourse?

/launcher rebuild app

returns an error.

[techAPJ (Arpit Jalan)]

./launcher rebuild app is for discourse_docker based production setup. To update local/development Discourse instance you need:

cd ~/discourse
git pull origin master

[Chaboi_3000]

@techAPJ

git pull origin master

I get this error @techAPJ,

error: Your local changes to the following files would be overwritten by merge:
	.gitignore
Please commit your changes or stash them before you merge.
Aborting

[techAPJ (Arpit Jalan)]

The error message is pretty clear:

Please commit your changes or stash them before you merge.

If you want to ignore your local changes, do:

git fetch origin
git reset --hard origin/master

[Decorbuz]

根据 Ruby on Rails 论坛的指南，我目前卡在步骤 7。

这可能是一个非常“新手”的问题，但我该如何“指向”该主题中链接的实验性分支呢？我尝试了几种方法，但每次都会收到 Unknown command mini_racer 的错误提示。

[blake (Blake Erickson)]

他们在这里提问没问题。

我们在本指南中引用了 我们撰写的特定 M1 说明，并在 Rails 论坛上进行了讨论。

@Decorbuz

这可能是一个非常“新手”的问题，但我该如何“指向”该主题中链接的实验性分支呢？

我稍后需要在我的 M1 Air 上查看，也许最近刚设置新 Mac 的同事会更清楚这是否仍有必要。不过，在第 7 步中有一个如何指向分支的示例：

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

因此，您需要编辑本地版本 discourse/Gemfile 中的这一行：

Gemfile

然后运行 bundle install。

[Decorbuz]

@pfaffman

如果您没有遵循这些说明（我没看到第 7 步），那么这里并不是提问的好地方。

它就在原始帖子的顶部链接着。

Ruby on Rails 论坛的那个话题已经沉寂好几个月了。原帖作者（OP）自二月以来就不活跃了，也没有回复那里任何寻求帮助评论。

这里有更多能帮我的人。我只是说说。

@blake

第 7 步中有一个如何指向分支的示例：

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

我尝试将其复制到终端，但收到了和之前一样的 Unknown command mini_racer 错误。

诚实地说，Ruby on Rails 论坛的指南在这方面确实不如我希望的清晰。

提前致歉……

[blake (Blake Erickson)]

@Decorbuz

我尝试将其复制到终端，但收到了与之前相同的“未知命令 mini_racer”错误。

这不是一个要运行的命令。您需要编辑位于 discourse 目录内的实际文本文件 “Gemfile”。

[Decorbuz]

@blake

您需要编辑位于 Discourse 目录内的实际文本文件“Gemfile”。

哎呀！

谢谢！我现在就试试。

在我看来，有人应该编辑 Ruby on Rails 论坛中的指南，并对第 7 步提供更进一步的说明。这只是我的一点个人意见。

我马上回来。请稍等……

[blake (Blake Erickson)]

抱歉我得先走了，但我认为针对 M1 Mac 的 mini_racer 修复已经合并了。我刚刚检查了 M1 Mac 上的 Gemfile，我的并没有被修改。所以我认为你可以跳过第 7 步。

[Decorbuz]

我执行了步骤 8，但收到了“无法找到 Gemfile”的错误。

我（认为）已经解决了步骤 7，但步骤 8 仍然给我带来麻烦，并输出了上述错误。

[blake (Blake Erickson)]

@Decorbuz

我运行了第8步，收到了 Could not locate Gemfile 错误。

运行 bundle install 时，您需要位于 discourse 目录下。

@techAPJ

克隆 Discourse

在 ~/discourse 文件夹中克隆 Discourse 仓库：

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

~ 表示主文件夹，因此 Discourse 源代码将在您的主文件夹中可用。

引导 Discourse

切换到您的 Discourse 文件夹：

cd ~/discourse

安装所需的 gem
bundle install

[JQ331]

@merefield

实际上，这比几美元要多一些（这是一个 4GB 8 核 VPS - 可能有点过头了），但它允许我在任何地方、任何平台上进行开发。性能相当不错，但重启 Web 服务器总会有几秒钟的延迟。

嗨 @merefield：您能多描述一下您的远程设置吗？

虽然开发主题允许我在实时网站上添加更改，但对于开发插件，我似乎别无选择，只能在我本地机器上进行，将整个 discourse 代码库放在那里（并在其之上放置我的插件）。

结果是，对于编码插件时的任何（非 CSS）更改，当我重新加载它时，1) 会启动我电脑的风扇，2) 需要整整 30 秒才能重新加载。如果我需要重启服务器，则需要几分钟。

这些延迟确实会累加——结果是我可能需要一个小时才能编写完一些东西，而按照我正常的编码流程（有热重载或每次更改最多 2-3 秒）只需要15 分钟。

所以，我很想听听任何加快速度的建议。

[merefield (Robert)]

这或许更适合放在 Ubuntu 主题 上，因为我只是在云服务器上运行该安装，前面有 nginx 和完整的 DNS（无 docker），所以我实际上是在处理域名。一切都从终端运行。我甚至已经让 Ember CLI 在该设置中运行良好。

它也不是很快，但足够快。它的好处是可以运行和测试完整的 https 回调服务。

据我所知，目前最快的插件开发环境是本地的 Docker Dev on WSL2，它运行速度极快。它也非常容易维护。不幸的是，据我所知 discourse_theme 在该环境中还不能正常工作，所以我又回到了我的云服务器上进行这项工作。

苹果在这方面落后真是有点奇怪？微软的工程师们已经证明了他们非常精明。

[Nacho_Caballero]

如果有人在安装 ruby 2.7.3 时遇到错误，显然 Xcode 12 之后的一些更改破坏了 rbenv 的安装过程：

installing older Ruby versions on OSX after XCode 12

尽管我已安装最新版本的 psych 和 libyaml，但仍收到此错误：

似乎您的 ruby 安装缺少 psych（用于 YAML 输出）。
要消除此警告，请安装 libyaml 并重新安装您的 ruby。

我尝试了指南中建议的解决方法，但仍然收到相同的错误，最后不得不使用 rvm：

rvm install 2.7.3

[JQ331]

关于如何更快地进行插件编程，我最近改变了我的方法。而且效果很好。基本上，将任何前端的东西移到一个主题组件中，只在插件本身中编写后端的东西。我知道其他人以前也发现了这一点。但现在我这样做了，编程速度更快，体验也更好。详情请参见此处。