以下指南将引导您完成在使用 Meilisearch 官方镜像时，在 DigitalOcean、AWS 或 GCP 上更新 Meilisearch 实例所需的步骤。

在开始之前，请注意以下事项

  • 此指南不适用于 v0.15 以下的版本。由于转储功能是在 v0.15 版本中引入的，如果您使用的是 v0.14 或更低版本，则需要手动重新索引所有文档和设置。
  • 如果您要更新到 v0.28 或更高版本，从旧版本导入的密钥将重新生成其 key 和 uid 字段。
  • 您需要通过 SSH 连接到您的云实例，并且根据您连接的用户（root、admin 等），您可能需要在某些命令前加上 sudo。

此外，如果您使用的是 v0.22 或更高版本，您可以使用我们的 迁移脚本 让它为您完成所有工作！

步骤 1：检查您的 Meilisearch 版本

您需要知道您的 Meilisearch 版本。如果您不知道或不确定，可以使用获取版本端点。

curl \
  -X GET 'http://<your-domain-name>/version' \
  -H 'Authorization: Bearer API_KEY'

如果您收到 missing_authorization_header 错误代码，您可能使用的是 v0.24 或更低版本。将授权标头更改为 X-MEILI-API-KEY，如下所示：

curl \
  -X GET 'http://<your-domain-name>/version' \
  -H 'X-Meili-API-Key: API_KEY'

检查您的 pkgVersion，如果它高于“0.21.0”，您可以直接转到 步骤 3。否则，请继续执行下一步。

步骤 2：将所有字段设置为显示属性

⚠️
此步骤仅在您使用 v0.20 或更低版本时是强制性的。

‌‌

在使用低于 v0.21 的 Meilisearch 版本创建转储时，所有字段必须 显示 才能保存在转储中。

首先，您需要验证显示的属性列表。

# whenever you see {index_uid}, replace it with your index's unique id
curl \
  -X GET 'http://<your-domain-name>/indexes/{index_uid}/settings/displayed-attributes' \
  -H 'X-Meili-API-Key: API_KEY'

如果响应包含 {'displayedAttributes': '["*"]'}，您可以继续执行 步骤 3。

‌‌如果它不是，请保存当前列表以便在迁移完成后恢复它，然后继续将显示属性列表重置为其默认值 ([“*”])

curl \
  -X DELETE 'http://<your-domain-name>/indexes/{index_uid}/settings/displayed-attributes' \
  -H 'X-Meili-API-Key: API_KEY'

此命令返回一个 updateId。您可以使用它跟踪操作的状态。

# replace {updateId} with the updateId returned by the previous request
curl \
  -X GET 'http://<your-domain-name>/indexes/{index_uid}/updates/{updateId}' \
  -H 'X-Meili-API-Key: API_KEY'

一旦状态变为 processed，您就可以继续了。

现在所有字段都已显示，继续执行下一步。

步骤 3：创建转储

在创建转储之前，请确保您的 转储目录 可访问。默认情况下，转储在配置文件目录中的名为 dumps 的文件夹中创建：/var/opt/meilisearch/dumps。

‌‌然后，您可以创建 Meilisearch 数据库的转储。

# replace the header with -H 'X-Meili-API-Key: API_KEY' if you are on v0.24 or below
curl \
  -X POST 'http://<your-domain-name>/dumps' \
  -H 'Authorization: Bearer API_KEY'

‌‌如果您使用的是 v0.27 或更低版本，转储使用与任务队列不同的队列。响应应该返回一个转储 uid。您可以使用它通过获取转储状态端点跟踪转储的状态。

# replace the header with -H 'X-Meili-API-Key: API_KEY' if you are on v0.24 or below
curl -X GET 'http://<your-domain-name>/dumps/{uid}/status' \
  -H 'Authorization: Bearer API_KEY'

一旦转储状态变为 done，您就可以继续执行下一步。

{
    "uid":"20221130-110940190",
    "status":"done",
    "startedAt":"2022-11-30T11:09:40.190772Z",
    "finishedAt":"2022-11-30T11:09:45.94484Z"
}

‌‌‌‌如果您使用的是 v0.28 或更高版本，转储被视为任务，并共享任务队列。然后，响应应该返回一个 taskUid，您可以使用它通过获取任务端点跟踪其状态。

curl \
  -X GET 'http://<your-domain-name>/tasks/{taskUid}' \
  -H 'Authorization: Bearer API_KEY’

‌‌一旦 dumpCreation 任务显示 "status": "succeeded"，您就可以继续执行下一步。

{
  "uid": 1,
  "indexUid": null,
  "status": "succeeded",
  "type": "dumpCreation",
  "canceledBy": null,
  "details": {
	"dumpUid": "20220621-161029217"
  },
  "error": null,
  "duration": "PT0.025872S",
  "enqueuedAt": "2022-06-21T16:10:29.217688Z",
  "startedAt": "2022-06-21T16:10:29.218297Z",
  "finishedAt": "2022-06-21T16:10:29.244169Z"
}

‌步骤 4：停止 Meilisearch 实例

如果您尚未这样做，请通过 SSH 连接到您的云实例，并执行以下命令停止 Meilisearch。请记住，如果您不是以 root 身份连接，则可能需要在命令前加上 sudo。

systemctl stop meilisearch

‌‌步骤 5：保存当前二进制文件和数据库以进行备份

将当前 Meilisearch 版本的二进制文件和数据库移动到 tmp/ 文件夹。

mv /usr/bin/meilisearch /tmp
mv /var/lib/meilisearch/data.ms /tmp/

‌步骤 6：安装所需的 Meilisearch 版本

‌‌‌‌您可以使用此命令下载 Meilisearch 二进制文件。将 {meilisearch_version} 替换为您选择版本的格式，例如：vX.X.X。

curl "https://github.com/meilisearch/meilisearch/releases/download/{meilisearch_version}/meilisearch-linux-amd64" --output meilisearch --location --show-error

使 meilisearch 二进制文件可执行

chmod +x meilisearch

将新的 Meilisearch 二进制文件移动到包含可执行文件的目录。

mv meilisearch /usr/bin/meilisearch

步骤 7：启动 Meilisearch 并导入转储

‌现在您已经拥有所需的 Meilisearch 版本，请执行以下命令在启动时导入转储。

不要忘记将 dump_uid.dump 替换为实际的转储文件名。

meilisearch --db-path /var/lib/meilisearch/data.ms --import-dump "/var/opt/meilisearch/dumps/dump_uid.dump"

导入转储需要索引它包含的所有文档。根据数据集的大小，此过程可能需要很长时间，并可能导致内存使用量激增。

步骤 8：重新启动 Meilisearch 作为服务

转储正确导入后，按 Ctrl+C  停止 Meilisearch。接下来，执行以下命令运行脚本配置 Meilisearch 并将其重新启动为服务

meilisearch-setup

不要忘记在必要时将 displayedAttributes 设置回其先前值。您可以使用 更新显示的属性端点 来完成此操作。

🎉 恭喜！您已成功将 Meilisearch 数据库迁移到最新版本！

步骤 9：清理文件或回滚

清理文件

如果您已完成所有先前的步骤，并且 Meilisearch 已启动并运行，则该进行一些清理工作了。还记得我们保存的备份文件吗？您可以使用以下命令将其删除。

rm /tmp/meilisearch
rm -r /tmp/data.ms

‌由于您不再需要它，因此您也可以删除转储文件。

rm /var/opt/meilisearch/dumps/{dump_uid.dump}

回滚

如果由于某种原因，某些操作出错，您始终可以回滚到以前的版本。使用以下方法将文件移回其以前的位置


mv /tmp/meilisearch /usr/bin/meilisearch
mv /tmp/data.ms /var/lib/meilisearch/data.ms

‌并运行配置脚本

meilisearch-setup

‌‌一切应该都和以前一样。呼！

我希望本指南能帮助您享受 Meilisearch 最新版本的所有优势。不要忘记，我们的支持团队随时准备提供帮助！我们在全新的 Discord 服务器上拥有专门的支持频道！

‌‌‌‌‌‌‌‌‌‌