在 Zeabur 上部署 Astro

Astro 是一個現代網站建置工具，擁有強大的開發者體驗與輕量級輸出。

本文將幫助你在 Zeabur 上部署 Astro 網站。

步驟一：建立一個 Astro 專案

你可以使用下面的指令建立一個 Astro 專案並跟隨提示進行配置。

npm create astro@latest

Zeabur 已經為 Astro 提供了一個適配器套件，你可以使用下面的指令安裝。

pnpm i @zeabur/astro-adapter

安裝好了以後，你需要在你的 astro.config.mjs 中配置適配器。

import zeabur from '@zeabur/astro-adapter/serverless';
 
export default {
  // ...
  adapter: zeabur(),
  output: 'server'
  // ...
};

就這樣，你的 Astro 專案已經準備好部署到 Zeabur 了。

有時候，你的 Astro 專案可能一些特殊的需求而不適合使用 Serverless 的方式部署，例如他可能依賴於某個需要執行很久的 API 請求來進行伺服器端渲染（Server Side Rendering）。

在這個情況下，你可以用 Astro 官方的 @astrojs/node 來改用容器化的方式部署在 Zeabur 上：

import node from '@astrojs/node';
 
export default {
  // ...
  adapter: node({ mode: 'standalone' }),
  output: 'server'
  // ...
};

首先，確保你已經按照 Zeabur CLI 的指南安裝好了 Zeabur CLI。

然後，在你剛初始化好的 Astro 專案中，將尚未提交到版本控制的檔案加入到 Git 中。

git add -A
git commit -m "Initial commit"

接著，使用下面的指令部署你的服務。

zeabur

前往 Zeabur 控制台並建立一個新專案。

然後，點選 Deploy New Service 按鈕，選擇從 GitHub 部署。

💡

如果你是第一次在 Zeabur 上從 GitHub 部署專案，你需要先配置並安裝 GitHub App。你可以在這裡查看更詳細的指南。

當你選擇好儲存庫和分支後，Zeabur 將會自動開始建置你的服務。

Zeabur 會自動檢測到你的服務是由 Astro 建置的，所以你不需要做任何額外的配置。你的部署將會在幾分鐘內完成。

部署完成後，你可能需要為你的 Astro 網站配置網域。

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

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