이 페이지는 현재 영어로만 제공되며 한국어 버전은 곧 제공될 예정입니다. 기다려 주셔서 감사드립니다.

Edgeone CLI

概述

快速结合项目和 Pages 函数的能力,可以通过 Edgeone CLI 来实现。
EdgeOne CLI 提供了管理 Pages 函数的方法,借助 CLI,可以在项目中生成、配置和调试函数。


一、准备工作

使用 Gmail 邮箱快速注册登录 腾讯云控制台
在控制台开通 Pages 服务,创建新的 Pages 项目,并将其克隆到本地。


二、快速开始

1. 安装

在准备工作阶段克隆下来的项目中,可以通过 npm 来安装 CLI:
npm install -g edgeone
通过 edgeone -v命令,可以查看是否安装成功。通过edgeone -h命令,可以查看相关的所有命令。


2. 登录

执行登录命令,按照提示选择 Global (国际站)或 Chinese (中国站),建议选择 Global 以确保获取准确的数据和信息,然后在弹出的浏览器窗口完成登录。
edgeone login
完成登录后可以执行 edgeone whoami 查看当前登录账号的信息。


3. 初始化

成功登录后,执行初始化命令,在项目中初始化 Edgeone Pages 需要的基础环境:
edgeone pages init
完成初始化后,项目根目录下会生成functions文件夹和示例的函数,后续可以在该文件夹下不断新增和开发函数,函数的详细用法参考文档


4. 本地开发

完成初始化后,进入本地开发阶段:
edgeone pages dev
执行命令默认会在本地 8088 端口起一个服务,可以通过 http://localhost:8088/helloworld 访问示例函数,这里的访问路径,就是functions文件夹下函数文件的地址路径。

在本地开发时,Pages 函数的服务和 Pages 项目的服务可能运行在不同的端口上。为了让 Pages 项目能够调用函数,可以使用代理服务器或反向代理来将请求转发到正确的端口。以下是一个 webpack-dev-server 的配置示例:
module.exports = {
devServer: {
proxy: {
'/api': {
target: 'http://localhost:8088', // Pages 函数的本地开发服务地址
chagneOrigin: true,
pathRewrite: {
'^/api': '',
}
}
}
}
}
这样,在 Pages 项目中使用 Fetch API:
fetch('/api/my-functions', {
method: 'POST',
body: JSON.stringify({ data: 'example' }),
})


5. 关联项目

如果需要使用 KV 存储 能力或将控制台已设置的环境变量同步到本地调试,可以执行关联项目命令,按要求输入项目名称,这里的项目名为准备工作中已创建的 Pages 项目名。
edgeone pages link


6. 提交部署

本地开发调试完成后,将项目代码推送到 Git 远端,即可触发 Pages 后台的 CI 构建部署,完成整个开发流程。


7. 切换账号

如果需要切换到其他腾讯云账号,可以执行以下命令然后重新登录:
edgeone switch