进阶 docs.nodebb.org 2026-10-13 15:07:09 · 32 阅读

第15章 在 OpenShift PaaS 上部署 NodeBB

第15章:OpenShift PaaS

注意 已经制作了一个快速入门指南,通过利用 OpenShift 的环境变量简化了以下大部分操作流程。如果你是初学者,建议参考 ahwayakchih 的 OpenShift 仓库。

以下是 OpenShift PaaS 的安装说明。在开始之前,你需要按照 [https://developers.openshift.com/en/managing-client-tools.html](https://developers.openshift.com/en/managing-client-tools.html) 安装 Red Hat 的 rhc 命令行工具。

第 1 步:创建应用程序 你可以通过 Web 控制台或使用 rhc 命令完成此操作: `rhc app create nodebb nodejs-0.10`

如果你使用 Web 控制台: 向下滚动,在“其他类型”中选择 Node.js 0.10,然后点击“下一步”。 在应用程序名称中输入 nodebb,或者替换 [name] 为你喜欢的名称。 你可能会看到一条提示,要求指定命名空间(Namespace)。只要不更改应用程序名称,命名空间可以是任意值。如果添加了命名空间,请确保在 RHC 命令中使用 -n 参数,并使用 -a 参数通过名称指定目标应用程序。 `rhc app create -a nodebb -n mynamespace nodejs-0.10`

一直滚动到底部,点击“创建应用程序”。然后等待第一个 NodeBB 应用创建完成。 系统会询问是否要编写代码。简单点击“暂不,继续”。之后你会被重定向到应用程序页面。 它会显示应用已无错误地创建并启动。

第 2 步:添加数据库 NodeBB 支持 Redis 或 MongoDB,这里我们将使用 MongoDB。 `rhc cartridge add mongodb-2.4 -a nodebb`

在 Web 控制台中: 点击“查看你可以添加的购物车列表”。选择 MongoDB 购物车。然后点击“下一步”。此时应会显示确认提示。 点击“添加购物车”。

第 3 步:记录数据库凭证 安装购物车后,你会收到用户名和密码的通知。请将其记录在安全的地方,稍后会用到。

打开终端(或 Git Bash),粘贴以下命令以通过 SSH 访问。 `rhc app ssh -a nodebb`

注意:如果遇到“不存在”或类似的错误,你需要运行以下命令,然后重试。 `rhc setup`

获取数据库的主机、IP 和端口 这些也需要稍后保存…… `echo $OPENSHIFT_NODEJS_IP && echo $OPENSHIFT_MONGODB_DB_HOST && echo $OPENSHIFT_MONGODB_DB_PORT`

顺序如下:第一行:NodeJS IP 地址 - 应保存。第二行:Mongodb IP 地址 - 记录它。第三行:Mongodb 端口 - 记录它。 现在粘贴以下命令退出 SSH。 `exit`

注意:可能需要输入一次 'exit',然后再输入一次才能完全退出 SSH。

第 4 步:在 OpenShift 上添加 NodeBB 源代码 返回 Web 控制台,点击 NodeBB 应用程序。复制“源代码”部分的 URL 地址。 类似的源代码 URL 地址应如下所示: `ssh://%5Bcode%5D@nodebb-%5Bnamespace%5D.rhcloud.com/~/git/nodebb.git/`

返回终端。粘贴以下命令,然后粘贴该 URL 地址。 `git clone ssh://[code]@nodebb-[namespace].rhcloud.com/~/git/nodebb.git/`

注意:如果目录已存在,请确保其中没有超过四个文件。如果有,请删除它并重新运行命令。否则请继续。 注意:这将在你的计算机上创建一个 NodeBB 文件夹,通常位于 \~/users/[name]/NodeBB

然后进入计算机上的 NodeBB 文件夹。你需要使用以下命令从 Github 克隆 NodeBB 到你的应用程序中。默认的 git clone 命令在 OpenShift 上无法正常工作,除非你处于 SSH 环境中。如果需要将仓库克隆到计算机的其他位置,可以将此命令分为两部分,并从那里启动 git bash。 `cd nodebb && git remote add upstream -m master https://github.com/NodeBB/NodeBB.git`

或者 `cd nodebb` `git remote add upstream -m master https://github.com/NodeBB/NodeBB.git`

然后从 NodeBB 的仓库拉取文件。 `git pull -s recursive -X theirs upstream v0.9.x`

OpenShift 尚不支持 1.0.0 或更高版本,请参阅 github 上的此问题。

第 5 步:将源代码上传到 OpenShift 现在你需要提交并推送文件到应用程序仓库。将 message 替换为你的消息。这需要一些时间才能完成。 `git commit -a -m 'message' && git push`

第 6 步:配置并安装 NodeBB 重新通过 SSH 进入你的应用程序: `rhc app ssh -a nodebb`

使用交互式安装程序启动 NodeBB 的安装。你需要填写应用程序的详细信息。 `cd ~/app-root/repo && ./nodebb setup`

注意:Web 安装程序 (npm start) 无法工作,因为应用程序尚未配置为绑定到 OpenShift 允许的端口。我们现在就要做这个。 *用于访问此 NodeBB 的 URL (http://localhost:4567)) - 复制并粘贴你的应用程序 URL 地址,然后像这样添加端口 8080: `http://nodebb-%5Bnamespace%5D.rhcloud.com:8080` 请输入 NodeBB 密钥 (code) - 直接按回车。 使用哪个数据库 (redis) - 输入 mongo。 你的 Mongo 实例的主机 IP 或地址 (127.0.0.1) - 复制并粘贴 Mongo 的 IP 地址。 你的 Mongo 实例的主机端口 (6379) - 复制并粘贴 Mongo 的端口。 你的 Mongo 数据库的密码 - 输入你的 Mongo 密码。 使用哪个数据库 (0) - 输入数据库名称。

第 7 步:现在你需要编辑 NodeBB 创建的 config.json 粘贴以下命令。 `nano config.json`

在 "url" 下方添加一行,然后添加以下内容。将 NodeJS IP 地址替换为你应用程序的 IP 地址。然后使用 CTRL+X 退出编辑器。 `"bind_address": "NodeJS IP Address",`

第 8 步:现在在 OpenShift 上启动你的 NodeBB! 完成了!然后访问你的网站: `http://nodebb-%5Bnamespace%5D.rhcloud.com/` `cd ~/app-root/repo && ./nodebb start`

注意 在 OpenShift 上,启动、停止、重载或重启 NodeBB 现在均可正常工作。请确保在此之前始终执行此操作。(将 [string] 替换为你选择的 nodeBB 命令)。例如,你可以通过运行 `./nodebb stop` 然后 `./nodebb reset -p nodebb-plugin-name` 来从严重插件故障中恢复你的应用程序。

`rhc app ssh -a nodebb` `cd ~/app-root/repo` `./nodebb [string]`

如果 `git push` 后应用程序因类似 EADDRINUSE 的错误而启动失败,说明 OpenShift 上的应用程序已严重故障,你可能需要考虑将 NodeBB 安装迁移到新的实例。查阅数据库备份和导出方法。你仍然可以通过在推送之前先强制停止应用程序来解决错误,但从现在起每次 git push 都必须这样做。 `rhc app-force-stop -a nodebb` `git push origin master`

评论 (0)