边缘开发者平台
  • Pages
    • 产品简介
    • 快速开始
      • 导入 Git 仓库
      • 从模板开始
      • 直接上传
    • 框架指南
    • 项目指南
      • 项目管理
      • edgeone.json
      • 缓存配置
      • 错误码
    • 构建指南
    • 部署指南
      • 概览
      • 触发部署
      • 管理部署
      • 部署按钮
      • 使用 Github Action
      • 使用 CNB 插件
      • 使用 IDE 插件
      • 使用 CodeBuddy IDE
    • 域名管理
      • 概览
      • 自定义域名
      • 配置 HTTPS 证书
      • 如何配置 DNS 的 CNAME 记录
    • Pages Functions
    • KV 存储
    • 边缘 AI
    • API Token
    • EdgeOne CLI
    • Pages MCP
    • 集成指南
      • AI
        • 对话型大模型集成
        • 图片大模型集成
      • 数据库
        • Supabase 集成
        • Pages KV 集成
      • 电商
        • Shopify 集成
        • WooCommerce 集成
      • 支付
        • Stripe 集成
        • Paddle 集成
      • CMS
        • WordPress 集成
        • Contentful 集成
        • Sanity 集成
      • 身份验证
        • Supabase 集成
        • Clerk 集成
    • 最佳实践
      • 使用通用大模型快速搭建AI应用
      • 使用 Deepseek-R1 模型快速搭建对话型AI站点
      • 使用 WordPress + WooCommerce 和 GatsbyJS 搭建电商平台
      • 使用 Supabase 和 Stripe 搭建 SaaS 站点
      • 如何快速搭建公司品牌站点
      • 如何快速搭建博客站点
    • 迁移指南
      • 从 Vercel 迁移至 EdgeOne Pages
      • 从 Cloudflare Pages 迁移至 EdgeOne Pages
      • 从 Netlify 迁移至 EdgeOne Pages
    • 排障指南
    • 常见问题
    • 联系我们
    • 产品动态
当前为国际站中文文档,如需访问中国站文档,请点击这里

使用 CNB 插件

通过本章节的指南,您可以快速在 CNB 集成云原生构建流程,实现自动构建并部署至 EdgeOne Pages。


配置密钥

从 Pages 获取 EDGEONE_API_TOKEN,获取方式可参考文档 API Token
使用 CNB 的密钥仓库来存储,然后在流水线中来引用。envs.yml 内容如下:
EDGEONE_API_TOKEN: oJTlMUq9**********NYzKFIw=

完整的 .cnb.yml 配置如下:
# 触发器:推送到主分支
main:
push:
# 从私有仓库导入环境变量:
# 参考:https://docs.cnb.cool/en/build/env.html#importing-environment-variables
- imports: https://cnb.cool/***/-/blob/main/envs.yml
stages:
# 构建当前项目
- name: Build Current Project
image: node:20
script: node -v && npm install && npm run build
# 将构建输出部署到 EdgeOne Pages
# ./dist 目录由前一步构建步骤生成
# 参考:https://www.npmjs.com/package/edgeone
- name: Deploy to EdgeOne Pages
image: node:20
script: npx edgeone pages deploy <outputDirectory> -n <projectName> -t $EDGEONE_API_TOKEN
说明:
npx edgeone pages deploy 参数说明:
<outputDirectory>: 项目构建后产物所在的文件夹(必填)
-n, --name: 需要部署的项目名称,项目不存在则自动创建新项目(必填)
-e, --env: 部署目标环境,可选值: production 或 preview(默认 production)

示例:npx edgeone pages deploy ./dist -n project-name -t $EDGEONE_API_TOKEN


CNB 云原生构建

当代码推送到 main 分支时,会触发以下构建过程:
1. 导入必要的环境变量
2. 使用 Node.js 20 环境构建项目
3. 将构建输出部署到 Pages


EdgeOne Pages 部署

构建完成后,项目会通过以下过程自动部署到 Pages:
1. 构建阶段生成 ./dist 目录
2. 使用 EdgeOne 命令行工具 edgeone pages deploy 进行部署