Skip to content

Latest commit

 

History

History
120 lines (94 loc) · 5.2 KB

更新NodeBB.md

File metadata and controls

120 lines (94 loc) · 5.2 KB

更新 NodeBB

[TOC]

NodeBB 定期在 发布版本页面 中发布新版。 这些发布版包含高质量的代码，可用于生产环境部署。 你可以使用 git 安装指定版本的 NodeBB，以及周期性升级到新发布版。

如需获得最新的修订和特性，你也可以使用 git clone 直接从代码库(master 分支) 克隆代码，不过这样不能保证程序的稳定性。核心开发者会在工作环境上，验证每次代码提交，虽然个别特性还没 100% 完成。

一如既往， NodeBB 团队不会为，可能由于升级引起的，任何意外、数据丢失、数据损坏、或者任何坏的情况负责。所以在升级之前，请不要忘记备份！

[warning] 补充: 使用 zip 包安装的 NodeBB 的更新方法（更新路径依旧参考 Git 方法安装的NodeBB）。 虽然 Github 确实链接缓慢，但我们依旧不建议使用 ZIP 包安装NodebB

  1. 备份 数据库 ，config.json 和 public 目录
  2. 下载新版本的 zip 包，解压缩
  3. 将 Public 目录替换到新的目录中 ， 把第一步备份的文件一次替换进去( 除了 config.json 选择替换，其他都 否)
  4. 执行 ./nodebb upgrade 享受新版本吧！

升级路径

NodeBB 的升级路径设计为，在不同版本之间升级是直接的。NodeBB 会提供高版本分支和低版本分支直接的升级兼容 (通过 --upgrade 标记)。例如， 如果 v0.2.2 是 v0.2.x 分支的最新版本，你可以无痛切换到 v.0.3.x 分支。而从 v0.2.0 升级到 v0.3.x 是不支持的，同时 NodeBB 会在你尝试升级时，警告升级不正确。

在补丁版本间升级

例如：从 v0.1.0 升级到 v0.1.1

补丁版本包含错误修正和其他小的改动。需要升级到你所在小版本序列中的最新补丁版本。

执行“升级步骤”一节的第1步到第3步。

在小版本之间升级

例如：从 v0.1.3 升级到 v0.2.0

小版本包含一些新的特性和重要的改动，但会保持向后兼容。 其中可能涉及到依赖软件包的升级，而且其他特性有可能废弃（但是还是支持的，只会通过日志中提醒）

执行“升级步骤”一节的第1步到第4步。

升级步骤

[info] 在小版本中升级后 (例如 v0.0.4 到 v0.0.5), 也有可能需要执行下面的升级步骤，以确保数据结构能正确的升级:

1. 关闭论坛

虽然可以在 NodeBB 运行时进行升级，但是很明显不推荐这种做法，尤其是对活跃的论坛而言。

$ cd /path/to/nodebb
$ ./nodebb stop

2. 备份数据

[warning]注意: 此节并不完整，请小心并正确地备份你的文件！

备份 Redis

与所有的升级一样，第一步是 备份你的数据。没人喜欢数据库损坏/错误。 Redis 中，所有的数据库数据都在.rdb文件中。在通常安装的 Redis 上，主数据库在 /var/lib/redis/dump.rdb。

把文件保存到安全的地方。

备份 MongoDB

执行备份 MongoDB，只需要运行

$ mongodump

此命令会创建一个目录结构的备份，而且可以通过 mongorestore 命令恢复备份。

推荐备份前，先关闭数据库。在 Debian / Ubuntu, 执行命令: sudo service mongod stop

备份 LevelDB

因为 LevelDB 是一些数据文件的简单集合，只需要把数据库复制到安全的位置，例如：

cp -r /path/to/db /path/to/backups

把文件存储到安全的地方。

[danger] 目前 NodeBB 已不再支持 LevelDB ，故删除以上内容

头像

已上传的图片 (头像) 保存在 ./public/uploads。请备份目录：

cd /path/to/nodebb/public
tar -czf ~/nodebb_assets.tar.gz ./uploads

3. 获取最新代码

进入 NodeBB 目录：

$ cd /path/to/nodebb。

如果你从低版本分支升级到高版本分支，必须要切换分支。确认你当前的分支已经更新到最新！

例如，如果从 v0.3.2 升级到 v0.4.3:

$ git fetch    # 从 NodeBB 代码库获取最新的代码
$ git checkout v0.4.x    # 根据需要的版本输入 v0.4.2 或者 v0.4.3 等，而不是 "v0.4.x"！
$ git merge origin/v0.4.x

如果不是在分支之间升级（如 v1.5.0到v1.5.1），只需要执行下面的命令：

$ git fetch
$ git reset --hard origin/v1.5.x    # 修改 v1.5.x 为您当前所在的分支名!

从代码库获取最新(最高)版本的 NodeBB。

或者，从 发布页面 下载 NodeBB 的最新版本，解压并覆盖原有文件。不推荐此方法。

4. 运行 NodeBB 升级脚本

脚本会安装缺失的依赖软件包，升级任何插件或主题 (如果存在新版)，视情况迁移数据库。

$ ./nodebb upgrade

注意：./nodebb upgrade 只在 v0.3.0 后可用。如果你运行的是更早的版本，可运行下面的命令：

npm install
ls -d node_modules/nodebb* | xargs -n1 basename | xargs npm update
node app --upgrade

5. 启动 NodeBB、测试！

你现在可以运行最新版本的 NodeBB 了。

[info] 编写: NodeBB Development Team 维护: a632079 审核: PA Team 最后更新: 2017.08.17