View as Markdown

升级Nakama

将Nakama升级至新版本时，在运行新版本前，您需要完成三个操作：

  • 检查发行说明 ，查看该版本是否有具体的升级要求。
  • 将您的数据迁移到Nakama新版本支持的格式。
  • 确保您运行的客户端版本与部署的服务器兼容。
如果您的服务器使用自定义 Go 运行时模块，升级 Nakama 时还需要将 Go 依赖项与新版本重新对齐。与 Nakama 二进制文件共享的任何直接或传递（transitive）依赖项都必须完全匹配，否则插件将无法加载。有关如何解决版本不匹配问题，请参阅 Go 模块依赖项固定 。

Docker #

出现可用的新版本Nakama或CockroachDB时可能需要升级。Docker允许您轻松升级，因为仅需要下载容器映像的新版本。升级至Nakama新版本时，docker-compose.yml中的流程会自动将您的数据迁移至新的数据库架构。

您可以提取最新的Nakama映像，并允许Docker Compose执行数据迁移。

1
2
3

docker-compose down # top and remove both the Nakama and CockroachDB containers
docker pull heroiclabs/nakama # download the latest Nakama image
docker-compose up # start the containers (both Nakama and CockroachDB) as fresh installs

CockroachDB容器的更新与之类似，具体方法如下：

1

docker pull cockroachdb/cockroach # download the latest CockroachDB image

如果需要显式运行数据库架构迁移，应发出以下命令：

1

docker run heroiclabs/nakama migrate up

手动升级 #

可以按照以下说明将一个节点或整个集群升级到最新的Nakama版本。

对于集群中的每个节点：

停止Nakama。如果在Linux安装程序上使用systemd，命令为：

1

sudo systemctl stop nakama

备份CockroachDB：

1

cockroach dump nakama > mydatabackup.sql --insecure

下载最新版本 并将nakama二进制文件替换为最新下载的版本。

使用以下命令升级数据库架构：

1

nakama migrate up

您可以遵循相同的过程降级Nakama，但需要将迁移命令替换为以下内容：

1

nakama migrate down --limit 1

启动Nakama并验证升级版本是否正在运行。

1

sudo systemctl start nakama