将 Meilisearch Cloud 与 Vercel 集成

    在本指南中,你将学习如何将Meilisearch Cloud实例链接到你的 Vercel 项目。

    介绍我们的工具

    什么是 Vercel?

    Vercel是一个用于构建和部署 Web 应用程序的云平台。它可以开箱即用地与大多数流行的 Web 开发工具配合使用。

    什么是 Meilisearch Cloud?

    Meilisearch Cloud提供可扩展、可靠且旨在满足所有公司需求的托管搜索服务。

    将 Meilisearch 集成到你的 Vercel 项目中

    创建和部署 Vercel 项目

    从你的 Vercel 仪表板中,创建一个新项目。你可以从模板创建一个项目,或者导入一个 Git 存储库。

    Create a new project on Vercel dashboard

    选择你的项目,然后单击“部署”。部署完成后,返回你项目的仪表板。

    添加 Meilisearch 集成

    转到项目设置选项卡,然后单击屏幕左侧边栏菜单中的“集成”。

    Selecting the integration tab in the project settings

    在搜索栏中搜索Meilisearch 集成。单击“添加集成”按钮。

    Meilisearch integration page in Vercel's marketplace

    选择你要向其中添加集成的 Vercel 账户或团队以及项目。你可以在此菜单中将 Meilisearch 集成添加到一个或多个项目。

    Form to add Meilisearch integration, the "Specific projects" option is selected

    单击“继续”。Vercel 将显示一个列表,其中包含集成正常工作所需的权限。查看后,单击“添加集成”。

    设置 Meilisearch Cloud

    Vercel 会将你重定向到 Meilisearch Cloud 页面。登录或创建一个账户。新账户可享受 14 天的免费试用期。

    你可以选择一个现有项目或创建一个新项目。要创建一个新项目,请填写项目名称和区域的表单。

    Meilisearch Cloud form to create a project complete, with "search-app" as the project's name and "Frankfurt" as the region

    单击“创建项目”后,你应该会看到以下消息:“你的 Meilisearch + Vercel 集成只需单击一下即可完成。” 单击“完成 Vercel 集成设置”。然后,Meilisearch 会将你重定向回 Vercel 集成页面。

    Meilisearch integration page in Vercel's dashboard

    了解和使用 Meilisearch API 密钥

    Meilisearch 创建两个默认 API 密钥:默认搜索 API 密钥默认管理 API 密钥

    管理 API 密钥

    使用 默认管理 API 密钥来控制谁可以访问或创建新文档、索引和更改索引设置。小心使用管理密钥,避免在公共环境中暴露它。

    搜索 API 密钥

    使用 默认搜索 API 密钥来访问搜索路由。这是你想要在前端使用的密钥。

    这两个密钥以及 Meilisearch URL 都会自动添加到 Vercel 中。

    提示

    主密钥(尚未添加到 Vercel)授予用户对实例的完全控制权。您可以在您的Meilisearch Cloud 仪表板的项目概览中找到它。阅读更多关于Meilisearch 安全性的信息。

    检查您的项目设置

    返回您的项目设置并检查新的 Meilisearch 环境变量

    Display the environment variables in the project settings

    提示

    当使用Next.js时,请确保您的面向浏览器的环境变量以 NEXT_PUBLIC_ 为前缀。这使它们在您应用程序的浏览器端可用。

    利用 Meilisearch Cloud 仪表板

    Meilisearch Cloud dashboard: overview of the "search-app" project

    使用Meilisearch Cloud 仪表板来索引文档并管理您的项目设置。

    资源和下一步

    查看快速入门指南,了解如何使用 Meilisearch 的简短介绍。我们还提供了许多SDK 和工具,以便您可以使用您喜欢的语言或框架中的 Meilisearch。

    您现在可以开始搜索了!