• 产品简介
  • 快速开始
    • 导入 Git 仓库
    • 从模板开始
    • 直接上传
    • 从 AI 开始
  • 框架指南
    • 前端
    • 后端
    • 全栈
      • Next.js
    • 自定义 404 页面
  • 项目指南
    • 项目管理
    • edgeone.json
    • 缓存配置
    • 错误码
  • 构建指南
  • 部署指南
    • 概览
    • 触发部署
    • 管理部署
    • 部署按钮
    • 使用 Github Action
    • 使用 CNB 插件
    • 使用 IDE 插件
    • 使用 CodeBuddy IDE
  • 域名管理
    • 概览
    • 自定义域名
    • 配置 HTTPS 证书
    • 如何配置 DNS 的 CNAME 记录
  • Pages Functions
    • 概览
    • Edge Functions
    • Node Functions
  • 日志分析
  • KV 存储
  • 边缘 AI
  • API Token
  • EdgeOne CLI
  • Pages MCP
  • 集成指南
    • AI
      • 对话型大模型集成
      • 图片大模型集成
    • 数据库
      • Supabase 集成
      • Pages KV 集成
    • 电商
      • Shopify 集成
      • WooCommerce 集成
    • 支付
      • Stripe 集成
      • Paddle 集成
    • CMS
      • WordPress 集成
      • Contentful 集成
      • Sanity 集成
    • 身份验证
      • Supabase 集成
      • Clerk 集成
  • 最佳实践
    • 使用通用大模型快速搭建 AI 应用
    • 使用边缘 AI 模型快速搭建对话型 AI 站点
    • 使用 Shopify 搭建电商平台
    • 使用 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 进行部署