跳转到内容

将你的 Astro 网站部署到 Zerops

Zerops 是一个以开发优先的云平台，可用于部署静态和服务端渲染的 Astro 网站。

本指南将引导你在 Zerops 上设置和部署静态 和 SSR 服务端渲染的 Astro 站点。

在 Zerops 上运行应用程序需要两个步骤：

  1. 创建项目
  2. 触发构建和部署流水线

在 Zerops 上部署 Astro 静态站点

Section titled “在 Zerops 上部署 Astro 静态站点”

创建 Astro 静态站点的项目和服务

Section titled “创建 Astro 静态站点的项目和服务”

可以通过 Project add 向导或使用 yaml 结构导入项目和服务：

# 参考 https://docs.zerops.io/references/import 了解更多
project:
  name: recipe-astro
services:
  - hostname: app
    type: static

这将创建一个名为 recipe-astro 的项目，其中包含一个名为 app 的 Zerops 静态服务。

部署你的 Astro 静态站点

Section titled “部署你的 Astro 静态站点”

要告诉 Zerops 如何构建和运行你的站点，请在存储库中添加 zerops.yml 文件：

zerops.yml
# 参考 https://docs.zerops.io/zerops-yml/specification 了解更多
zerops:
  - setup: app
    build:
      base: nodejs@20
      buildCommands:
        - npm i
        - npm build
      deployFiles:
        - dist/~
    run:
      base: static

现在你可以 使用 Zerops CLI 触发构建和部署流水线，或者通过服务详情内部将 app 服务与你的 GitHub / GitLab 存储库连接。

在 Zerops 上部署 Astro SSR 站点

Section titled “在 Zerops 上部署 Astro SSR 站点”

更新脚本

Section titled “更新脚本”

更新你的 start 脚本以运行 Node 适配器的服务器输出。

package.json
"scripts": {
  "start": "node ./dist/server/entry.mjs",
}

创建 Astro SSR（Node.js）的项目和服务

Section titled “创建 Astro SSR（Node.js）的项目和服务”

可以通过 Project add 向导或使用 yaml 结构导入项目和服务：

# 参考 https://docs.zerops.io/references/import 了解更多
project:
  name: recipe-astro
services:
  - hostname: app
    type: nodejs@20

这将创建一个名为 recipe-astro 的项目，其中包含一个名为 app 的 Zerops Node.js 服务。

部署你的 Astro SSR 站点

Section titled “部署你的 Astro SSR 站点”

要告诉 Zerops 如何使用官方的 Astro Node.js 适配器 在 standalone 模式下构建和运行你的站点，请在存储库中添加 zerops.yml 文件：

zerops.yml
# 参考 https://docs.zerops.io/zerops-yml/specification 了解更多
zerops:
  - setup: app
    build:
      base: nodejs@20
      buildCommands:
        - npm i
        - npm run build
      deployFiles:
        - dist
        - package.json
        - node_modules
    run:
      base: nodejs@20
      ports:
        - port: 3000
          httpSupport: true
      envVariables:
        PORT: 3000
        HOST: 0.0.0.0
      start: npm start

现在你可以 使用 Zerops CLI 触发构建和部署流水线，或者通过服务详情内部将 app 服务与你的 GitHub / GitLab 存储库连接。

使用 Zerops CLI 触发流水线（zcli）

Section titled “使用 Zerops CLI 触发流水线（zcli）”

  1. 安装 Zerops CLI。

    终端窗口
    # 要直接下载 zcli 二进制文件，
    # 请使用 https://github.com/zeropsio/zcli/releases
    npm i -g @zerops/zcli

  2. 在 Zerops 中打开 Settings > Access Token Management 并生成一个新的访问令牌。

  3. 用以下命令使用访问令牌登录：

    终端窗口
    zcli login <token>

  4. 导航到应用的根目录（zerops.yml 所在的位置），并运行以下命令以触发部署：

    终端窗口
    zcli push

资源

Section titled “资源”

官方

Section titled “官方”

社区

Section titled “社区”

更多部署指南

贡献 社区 赞助