cf-pages-cli

用于管理Cloudflare Pages项目的命令行工具

什么是cf-pages-cli

cf-pages-cli是一个用于管理Cloudflare Pages项目的行工具。目前，它唯一的特性是管理环境变量，这在CI/CD工作流中将项目与存储在Git中的变量同步时非常有用。

安装

安装了cargo之后，从crates.io进行安装

cargo install --locked --version 0.2.1 cf-pages-cli

使用方法

同步变量

首先，确保您有您的Cloudflare账户ID以及一个有效的Cloudflare API令牌（具有Cloudflare Pages:Edit权限）。将它们作为环境变量导出

$ export CLOUDFLARE_ACCOUNT="YOUR_ACCOUNT_ID"
$ export CLOUDFLARE_TOKEN="YOUR_API_TOKEN"

（也可以通过--account和--token分别作为命令行选项使用，但直接导出它们更简单，因为它们在许多命令中使用。）

默认情况下，该命令导出生产环境和预览环境的最新的设置。您还可以通过添加--deployment DEPLOYMENT_ID选项来从特定的部署中导出变量。请注意，由于每个部署只针对一个环境，其他环境将在生成的JSON文件中留为null。

然后，导出您项目的环境变量

$ cf-pages get-env-vars --project YOUR_PROJECT_NAME --output ./vars.json
Environment variables written to: ./vars.json

（也可以通过设置CF_PAGES_PROJECT和CF_PAGES_OUTPUT环境变量分别设置项目名称和文件路径。）

您还可以通过省略--output选项将生成的文件内容打印到标准输出。

现在，修改vars.json文件，并将其上传到Cloudflare

$ cf-pages set-env-vars --project YOUR_PROJECT_NAME --file ./vars.json
Environment variables successfully updated

生成.env文件

使用get-env-vars导出的vars.json文件也可以用于生成.env文件，这对于前端开发非常有用

$ cf-pages to-env-file --output ./.env ./vars.json
Environment variables written to: ./.env

您还可以通过省略--output选项将生成的文件内容打印到标准输出。

默认情况下，生产环境的环境变量会被导出。要导出预览环境，请添加--environment preview选项。

许可证

许可协议为以下之一：

• Apache License 2.0 (LICENSE-APACHE或http://www.apache.org/licenses/LICENSE-2.0)
• MIT许可证 (LICENSE-MIT或http://opensource.org/licenses/MIT)

任选其一。