匯入 Emergent

如何從 Emergent 遷移到 Zeabur

本指南是獲取你在 Emergent 等雲 IDE 中構建的程式碼並將其轉換為 24/7 在線生產就緒應用的最簡單方法。

Emergent 非常適合原型製作和在瀏覽器中快速執行程式碼。但是，當你準備好在沒有”睡眠”實例或帶寬限制的情況下與世界分享你的應用時，你需要專業託管。

我們強烈推薦 Zeabur，因為它簡化了從原型到生產的轉變。使用本機編輯器的 Zeabur 擴充功能，你可以在不需要複雜設定檔案的情況下部署應用。

工作流程：

📝 重要說明：本指南涵蓋完整堆棧。我們首先部署應用程式碼，在第 6 步，我們將特別介紹如何為需要保存使用者資料的應用配置和連接 MongoDB 資料庫。

本計劃將你從基於瀏覽器的沙盒遷移到託管在可擴展雲上的專業本機開發環境。

喚醒你的代理： 如果你的專案一直處於非活躍狀態，你可能會看到”代理已進入睡眠狀態”的訊息。點擊你的專案將其喚醒。
存取程式碼檢視器： 查找 “Code” 按鈕（通常在專案介面的右上方附近）。
取得認證： 當你點擊”Code”時，會出現一個彈出視窗，其中有兩項內容：
- 一個指向 VS Code 環境的連結。
- 一個密碼。 先複製密碼，然後點擊連結在新索引標籤中打開。
解鎖編輯器： 將你複製的密碼貼到提示中並按 Enter。你現在將看到瀏覽器中的完整 VS Code 介面。
下載資料夾：
- 在左側邊欄（檔案瀏覽器）中，你將看到你的專案資料夾（通常是 frontend、backend 或只是專案根目錄）。
- 右鍵點擊 你想保留的資料夾。
- 選擇下載。
- 這會將資料夾以 .zip 檔案形式保存到你的電腦。

如果你計劃遷移到 Zeabur 或其他主機，直接推送到 GitHub 通常比下載 zip 檔案更簡潔。

連接 GitHub： 在 Emergent 的主聊天/儀表板介面中，查找你的個人資料設定中的 GitHub 圖示 或”連接 GitHub”按鈕。
授權： 按照提示授權 Emergent 存取你的 GitHub 帳戶。
推送程式碼： 在聊天介面中，輸入如下命令：

“將此程式碼推送到名為 my-app-export 的新 GitHub 儲存庫”
驗證： 轉到你的 GitHub 帳戶以確認儲存庫已建立。然後你可以使用 git clone 在本機複製此儲存庫。

現在程式碼已在 GitHub 上，你將在本機設定它以驗證依賴項並進行生產調整。

複製儲存庫： 打開 Cursor，打開命令調板（Cmd+Shift+P 或 Ctrl+Shift+P），然後輸入 > Git: Clone。貼上你的新儲存庫 URL。

或者，通過終端：
```
git clone <https://github.com/your-username/your-repo-name.git>
cd your-repo-name
```
安裝依賴項： Emergent 專案通常會自動偵測套件管理器。檢查鎖定檔案（pnpm-lock.yaml、package-lock.json 或 yarn.lock）。
```
# 如果使用 npm
npm install
# 如果使用 pnpm（在 Emergent 中常見）
pnpm install
```
環境設定：
- 找到 .env.example 檔案（如果存在），並複製它以建立 .env 檔案。
- 重要： 如果你的 Emergent 應用使用了 API 金鑰（OpenAI、Supabase 等），你必須手動將這些金鑰新增到本機的 .env 檔案中。Emergent 出於安全考慮，不會將你的金鑰匯出到 GitHub。
本機測試： 執行開發伺服器以確保應用在 Emergent 沙盒外運作。
```
npm run dev
```

解壓縮檔案並在本機程式碼編輯器（如 VS Code 或 Cursor）中打開專案資料夾。為了使部署非常簡單，你將使用 Zeabur 擴充功能。

現在是魔法時刻。安裝擴充功能後，部署你的專案只需點擊幾次。

你的編輯器將要求權限在瀏覽器中打開連結。點擊 “打開”。

點擊部署和打開.png

重定向到 Zeabur 後，平台的 AI 代理接管。它分析你的程式碼以理解專案的結構、依賴項和構建要求。

Zeabur 代理將：

你將被提示選擇一個專案和一個部署區域。之後，Zeabur 處理其餘的一切。

Zeabur 代理處理其餘的.png

你可以即時觀看你的服務構建並變得完全可運作。Zeabur 甚至在部署成功後立即為你提供一個即時網域。

如果你的 Emergent 應用允許使用者登入、建立帳戶或保存資料，它需要一個資料庫（通常是 Supabase）。

目前，你已成功部署了前端（可視化介面）。要使資料和身份驗證功能運作，你需要通過將 API 金鑰新增到 Zeabur 的 Variable 設定來連接後端。

我們有一份專門的指南來幫助你取得 Supabase 金鑰並將其新增到 Zeabur：

👉 按照即將發布的指南在 Zeabur 上建立和連線 supabase(即將推出)。

就是這樣！你已成功將專案從 Emergent 上的原型遷移到 Zeabur 上的即時、生產就緒應用，無需編寫任何一行設定程式碼。這種無縫工作流讓你可以專注於最重要的事情：構建優秀的軟體。