跳转到内容

将你的 Astro 网站部署到 Azion

你可以将你的 Astro 项目部署在 Azion 上，这是一个供前端开发者协作和部署静态（JAMstack）和 SSR 网站的平台。

先决条件

名为“先决条件”的部分

在开始之前，你需要准备好：

  • 一个 Azion 账户。如果你还没有，可以注册一个免费账户。
  • 你的应用程序代码存储在 GitHub 仓库中。
  • 安装 Azion CLI 以便更快地设置和部署项目。

如何通过 Azion 控制台仪表板进行部署

名为“如何通过 Azion 控制台仪表板进行部署”的部分

要开始构建，请按照以下步骤操作：

  1. 访问 Azion 控制台。
  2. 在主页上，点击 + Create 按钮。
    • 这将打开一个模态框，其中包含创建新应用程序和资源的选项。
  3. 选择 Import from GitHub 选项并点击卡片。
    • 此操作将打开设置页面。
  4. 将你的 Azion 账户与 GitHub 连接。
    • 将出现一个请求授权的弹出窗口。
  5. 选择你想从 GitHub 导入的仓库。
  6. 配置构建设置：
    • 框架预设： 选择合适的框架（例如 Astro）。
    • 根目录： 指你的代码所在的目录。你的代码必须位于根目录，而不是子目录。此字段中出现一个 ./ 符号，表示它是根目录。
    • 安装命令： 编译你的设置以进行生产构建的命令。构建命令通过脚本执行。例如：对于 NPM 包，使用 npm run build 或 npm install。
  7. 点击 Save and Deploy。
  8. 使用 Azion Real-Time Metrics 监控部署，并验证你的网站是否已在边缘上线。

如何使用 Azion CLI 部署静态站点

名为“如何使用 Azion CLI 部署静态站点”的部分

  1. 安装 Azion CLI

    • 下载并安装 Azion CLI 以便更轻松地进行管理和部署。

  2. 验证 CLI

    • 运行以下命令以使用你的 Azion 账户验证 CLI。
    终端窗口
    azion login

  3. 设置你的应用程序

    • 使用以下命令来初始化和配置你的项目：
    终端窗口
    azion init

  4. 构建你的 Astro 项目

    • 在本地运行你的构建命令：
    终端窗口
    azion build

  5. 部署你的静态文件

    • 使用 Azion CLI 部署你的静态文件：
    终端窗口
    azion deploy

本指南概述了如何部署静态应用程序。

使用 Azion CLI 启用本地开发

名为“使用 Azion CLI 启用本地开发”的部分

为了使预览正常工作，你必须执行以下命令：

终端窗口
azion dev

一旦你初始化了本地开发服务器，应用程序就会进入 build 过程。

终端窗口
Building your Edge Application. This process may take a few minutes
Running build step command:
...

然后，当构建完成时，会提示访问应用程序：

终端窗口
[Azion Bundler] [Server] › ✔  success   Function running on port https://:3000

故障排除

名为“故障排除”的部分

Node.js 运行时 API

名为“Node.js 运行时 API”的部分

一个使用 NPM 包的项目构建失败，并出现类似 [Error] Could not resolve "XXXX. The package "XXXX" wasn't found on the file system but is built into node. 的错误消息。

这意味着你正在使用的包或导入与 Azion 的运行时 API 不兼容。

如果你正在直接导入 Node.js 运行时 API，请参考 Azion Node.js 兼容性 文档，了解如何解决此问题的更多步骤。

如果你正在导入一个会导入 Node.js 运行时 API 的包，请与该包的作者确认他们是否支持 node:* 导入语法。如果他们不支持，你可能需要寻找替代的包。

更多部署指南

贡献 社区 赞助