如何将您的应用更新到最新的 Meilisearch 版本
更新部署在云平台上的 Meilisearch 实例可能令人望而生畏。让我们引导您完成整个过程。
以下指南将引导您完成在使用 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服务器上有一个专门的支持频道！
Meilisearch 使用二值量化将嵌入索引速度提高7倍
通过在向量存储 Arroy 中实现二值量化，显著减少了大型嵌入的磁盘空间使用和索引时间，同时保持了搜索相关性和效率。
