边缘开发者平台

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

当前为国际站中文文档，如需访问中国站文档，请点击这里

使用 Github Action

通过本章节的指南，您可以快速在 Github 仓库集成 Actions 工作流，实现自动构建并部署至 EdgeOne Pages。
﻿
设置 Github 仓库 Secret
要运行此 Action，您需要在 GitHub 中创建仓库的 Secret：
访问您的 GitHub 仓库页面
前往 "Settings" > "Secrets and variables" > "Actions"
点击 "New repository secret"
在“Name”输入 EDGEONE_API_TOKEN，在“Secret”输入 EdgeOne API token 的值
﻿
EDGEONE_API_TOKEN 的获取可参考文档 API Token。
﻿
完整的 .github/workflows/deploy.yml 配置如下：
name: Build and Deploy
﻿
on:
  push:
    branches:
      - main
﻿
jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22.11.0' # 选择适合的 Node.js 版本
      
      - name: Install dependencies
        run: npm install
      
      - name: Build project
        run: npm run build
      
      - name: Deploy to EdgeOne Pages
        run: npx edgeone pages deploy <outputDirectory> -n <projectName> -t ${{ secrets.EDGEONE_API_TOKEN }} [-e <env>]
        env:
          EDGEONE_API_TOKEN: ${{ secrets.EDGEONE_API_TOKEN }}
说明：
npx edgeone pages deploy 参数说明：
<outputDirectory>: 项目构建后产物所在的文件夹（必填）
-n, --name: 需要部署的项目名称，项目不存在则自动创建新项目（必填）
-e, --env: 部署目标环境，可选值: production 或 preview（默认 production）
﻿
示例：npx edgeone pages deploy ./dist -n project-name -t ${{ secrets.EDGEONE_API_TOKEN }}
﻿
GitHub Actions 构建
将上述的 deploy.yml 文件配置到您的项目根目录下。当代码推送到 main 分支时，会触发以下构建过程：
1. checkout 到目标仓库
2. 设置 Node.js 版本为 22.11.0
3. 安装项目依赖
4. 构建项目
﻿
EdgeOne Pages 部署
构建完成后，项目将通过以下过步骤自动部署到 EdgeOne Pages：
构建阶段生成 ./out 目录
使用 EdgeOne 命令行工具进行部署：npx edgeone pages deploy ./out -n my-edgeone-pages-project -t ${{ secrets.EDGEONE_API_TOKEN }}
﻿
Github Action 的相关文档：https://docs.github.com/zh/actions﻿
﻿

使用 Github Action

设置 Github 仓库 Secret

﻿

GitHub Actions 构建

EdgeOne Pages 部署