Hono

Hono (在日文中意為火焰🔥)是一個針對邊緣裝置設計的小型、簡單且超快的 Web 框架。

本文件將指導你如何在 Zeabur 上部署 Hono 專案。

判斷條件

如果你的服務符合以下所有條件,Zeabur 會識別為 Hono 專案並自動完成構建和部署:

  1. 專案根目錄下有 bun.lockb 檔案。
  2. 專案目錄下有 package.json 檔案。
  3. package.json 檔案的 dependencies 欄位中有 hono 套件。

如果你有興趣參與開源貢獻,可以在 zbpack 的開源程式碼 中找到相關的部分。

步驟一:初始化專案

你可以按照 Hono 官方文件 的步驟來使用 Bun 初始化一個 Hono 專案。

安裝 Bun

curl https://bun.sh/install | bash

初始化 Hono 專案

bun create hono my-app

建立後,你可以進入 my-app 目錄,然後安裝依賴。

cd my-app
bun install

本地測試

bun run dev

現在,你可以造訪 http://localhost:3000 頁面,應該會看到 Hello, Bun!

步驟二:部署

你可以選擇兩種方式部署你的 Hono 專案:使用 GitHub 或 使用 Zeabur CLI。

使用 Zeabur CLI 部署

使用 Zeabur CLI 是部署 Hono 專案的最簡單方式,你只需要先登入 Zeabur CLI:

npx zeabur auth login

這個指令會開啟瀏覽器並引導你完成登入。

接著,你可以使用 deploy 指令部署你的 Hono 專案:

npx zeabur deploy

這個指令會用互動式的方式詢問你要部署到哪個專案,你也可以選擇建立一個新的專案。

關於更多使用 Zeabur CLI 部署的說明,請查看 使用 CLI 部署服務

使用 GitHub 部署

使用 GitHub 部署可以讓你的專案享有開箱即用的 CI/CD 服務,未來只要推送代碼到 GitHub,Zeabur 將自動幫你部署。

請在 GitHub 上建立一個新的儲存庫,然後將程式碼推送到儲存庫中即可,更詳細的說明請參考 GitHub 文件

推送完畢後,點選 Deploy service,然後選擇 Deploy your source code

deploy

搜尋你的儲存庫,點選匯入,你的 Hono 服務將自動開始部署。

步驟三:設定網域

當部署完成後,你可能需要為你的 Hono 網站設定一個網域。

打開服務頁面的 “Domain” 分頁,然後點選 “Generate Domain” 或 “Custom Domain”。

關於如何為你的服務綁定網域的更多資訊,請參考 綁定網域

Domain Binding