前往首頁v1.12文件

    將 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

    選取您的專案，然後按一下 Deploy。部署完成後，返回您專案的儀表板。

    新增 Meilisearch 整合

    前往專案設定標籤，然後按一下畫面左側邊欄選單中的 Integrations。

    Selecting the integration tab in the project settings

    在搜尋列中搜尋 Meilisearch 整合。按一下 Add integration 按鈕。

    Meilisearch integration page in Vercel's marketplace

    選取您要新增整合的 Vercel 帳戶或團隊和專案。您可以在此選單中將 Meilisearch 整合新增至一個或多個專案。

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

    按一下 Continue。Vercel 將顯示一個清單，其中包含整合正常運作所需的權限。檢閱它，然後按一下 Add Integration。

    設定 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

    按一下 Create project 後，您應該會看到以下訊息：「您的 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。

    您現在已準備好開始搜尋！