部署你的 Astro 站点至 Vercel
你可以使用 Vercel 零配置的将 Astro 站点部署到其全球边缘网络中。
本指南包括通过 Vercel 网站 UI 或 Vercel 的 CLI 将 Astro 站点部署到 Vercel 的相关说明。
项目配置
段落标题 项目配置你的 Astro 项目可以作为静态站点或服务端渲染站点(SSR)部署到 Vercel。
静态站点
段落标题 静态站点默认情况下,你的 Astro 项目是一个静态站点。你无需任何额外配置即可将静态 Astro 站点部署到 Vercel。
SSR 适配器
段落标题 SSR 适配器要在 Astro 项目中启用 SSR 并在 Vercel 上部署:
使用以下 astro add
命令为你的 Astro 项目中添加 Vercel 适配器 以开启 SSR。此命令将安装适配器并同时自动对你的 astro.config.mjs
文件进行适当的配置。
如果你更喜欢手动安装适配器,你需要完成以下两个步骤:
-
使用你喜欢的包管理器将
@astrojs/vercel
适配器 安装到项目的依赖项中。如果你正在使用 npm 或不确定想要使用什么包管理器,请在终端中运行: -
在你的
astro.config.mjs
配置文件中添加以下配置。
如何部署
段落标题 如何部署你可以通过 Vercel 的网站 UI 或使用 Vercel 提供的官方 CLI(命令行界面)部署 Astro 站点到 Vercel。部署静态站点和 SSR 站点的过程相同。
通过网站 UI 部署
段落标题 通过网站 UI 部署-
将你的代码推送到你的在线 Git 存储库(GitHub、GitLab、BitBucket 等)。
-
导入你的项目 至 Vercel。
-
Vercel 将自动检测 Astro 项目并自动为其配置正确的设置。
-
你的应用程序已部署完成了!(例如:astro.vercel.app)
在你的项目完成导入和部署后,所有后续内容推送到(生产分支外的)分支都将自动生成 预览部署(Preview Deployments),以及对生产分支(通常是名为“main”的分支)所做的任何更改都将自动被部署为 生产部署(Production Deployment)。
通过 CLI 部署
段落标题 通过 CLI 部署-
安装 Vercel CLI 并运行
vercel
以进行部署。 -
Vercel 将自动检测 Astro 项目并自动为其配置正确的设置。
-
当被问及
Want to override the settings? [y/N]
(想要覆盖配置吗?),选择N
(No)。 -
你的应用程序已部署完成了!(例如:astro.vercel.app)
使用 vercel.json
的项目配置
段落标题 使用 vercel.json 的项目配置你可以使用 vercel.json
来覆盖 Vercel 的默认行为并配置其他设置。例如,你可以在部署时为 HTTP 响应附加标头。
升级到 Astro 2.0
段落标题 升级到 Astro 2.0Astro v2.0 不再支持 Node 14,因此请确保你的项目使用 Node 18.14.1
或更高版本。你可以在项目设置的 “通用” 页面中的 “构建步骤和无服务器函数” 下 自定义所使用的 Node.js 版本。