Cloudflare Workers 部署指南

有关将 Eyeofcloud Edge Agent 部署到 Cloudflare Workers 的说明。

👍

试用版

---

Eyeofcloud Edge Agent 目前处于测试阶段。在 Eyeofcloud 测试版注册页面上申请，或联系您的客户成功经理。

先决条件

---

您必须安装 Wrangler CLI 来管理 Cloudflare Workers。

开始使用

---

生成项目

使用 GitHub 上托管的模板生成项目：

Shell

wrangler generate {projectname} REPOSITORY PLACEHOLDER

配置文件wrangler.toml

1. 将wrangler.toml.template项目根目录中的文件重命名为wrangler.toml。
2. 通过添加你的account_id和kv_namespace(s)， 如果您打算使用 KV Store 进行数据文件和标志键管理来更新其中的变量。

wrangler.toml.template 文件示例：

#:schema node_modules/wrangler/config-schema.json
name = "optly-hybrid-agent"
main = "src/index.js"
compatibility_date = "2024-05-02"
compatibility_flags = ["nodejs_compat"]
account_id = "YOUR ACCOUNT ID HERE"
workers_dev = true
route = "YOUR ROUTE GOES HERE"
kv_namespaces = [
  {
    binding = "OPTLY_HYBRID_AGENT_KV", 
    id = "KV NAMESPACE ID GOES HERE", 
    preview_id = "KV PREVIEW NAMESPACE ID GOES HERE"
  },
  {
    binding = "OPTLY_HYBRID_AGENT_UPS_KV", 
    id = "KV USER PROFILE NAMESPACE ID GOES HERE", 
    preview_id = "KV USER PROFILE PREVIEW NAMESPACE ID GOES HERE"
  }
]

[vars]
# Supported: "debug, debugExt, info, error"
LOG_LEVEL = "debug"
# TESTING_FLAG_DEBUG = "INDIVIDUAL FX FLAG KEY FOR TESTING GOES HERE"

更新项目配置

---

在 config 目录中的文件中更新项目配置设置。有关信息，请参阅 requestConfig.js 文档。requestConfig.js

安装节点模块

---

使用以下命令安装必要的 Node.js 模块：

Shell

npm install

在本地测试和调试

---

使用 Wrangler CLI，您可以在本地测试和调试 worker。这支持本地调试，并允许您设置断点。

Shell

wrangler dev

Visual Studio （VS） Code 启动配置

---

以下是将 VS Code 调试器附加到本地开发 Cloudflare Edge Worker 以进行调试的示例 VS Code 启动配置。

JSON

{  
  "version": "0.2.0",  
  "configurations": \[  
    {  
      "type": "pwa-node",  
      "request": "attach",  
      "name": "Attach to Cloudflare Worker",  
      "skipFiles": ["<node_internals>/**"],  
      "port": 9229,  
      "localRoot": "${workspaceFolder}",  
      "remoteRoot": "/src"  
    }  
  ] 
}

部署 Cloudflare Worker

---

要将 Worker 部署到 Cloudflare，请运行以下命令：

Shell

wrangler publish

用于调试的尾部日志（可选）

要在访问部署在 Cloudflare 上的 Workers 时调试和跟踪日志，请运行以下命令：

Shell

wrangler tail -f pretty