Cloudflare Workers KV

创建 Dapr 组件

要设置 Cloudflare Workers KV 状态存储，请创建一个类型为 state.cloudflare.workerskv 的组件。请参阅此指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: <NAME>
spec:
  type: state.cloudflare.workerskv
  version: v1
  # 如果 Dapr 为您管理 Worker，请增加 initTimeout
  initTimeout: "120s"
  metadata:
    # Workers KV 命名空间的 ID（必需）
    - name: kvNamespaceID
      value: ""
    # Worker 的名称（必需）
    - name: workerName
      value: ""
    # PEM 编码的 Ed25519 私钥（必需）
    - name: key
      value: |
        -----BEGIN PRIVATE KEY-----
        MC4CAQ...
        -----END PRIVATE KEY-----
    # Cloudflare 账户 ID（让 Dapr 管理 Worker 时必需）
    - name: cfAccountID
      value: ""
    # Cloudflare 的 API 令牌（让 Dapr 管理 Worker 时必需）
    - name: cfAPIToken
      value: ""
    # Worker 的 URL（如果在 Dapr 外部预先创建了 Worker 则必需）
    - name: workerUrl
      value: ""

规范元数据字段

当您配置 Dapr 为您创建 Worker 时，可能需要为组件的 initTimeout 属性设置更长的值，以留出足够的时间来部署 Worker 脚本。例如：initTimeout: "120s"

创建 Workers KV 命名空间

要使用此组件，您必须在您的 Cloudflare 账户中创建一个 Workers KV 命名空间。

您可以通过以下两种方式之一创建新的 Workers KV 命名空间：

• 使用 Cloudflare 控制面板
  记下您在控制面板中可以看到的 Workers KV 命名空间的 “ID”。这是一个十六进制字符串（例如 123456789abcdef8b5588f3d134f74ac）——不是您创建时使用的名称！

• 使用 Wrangler CLI：

  # 如需身份验证，首先运行 `npx wrangler login`
  wrangler kv:namespace create <NAME>
  

  输出包含命名空间的 ID，例如：

  { binding = "<NAME>", id = "123456789abcdef8b5588f3d134f74ac" }
  

配置 Worker

由于 Cloudflare Workers KV 命名空间只能由在 Workers 上运行的脚本访问，Dapr 需要维护一个 Worker 来与 Workers KV 存储进行通信。

Dapr 可以自动为您管理 Worker，或者您可以自己预先预配一个 Worker。在 workerd 上运行时，预先预配 Worker 是唯一支持的选项。

• 让 Dapr 管理 Worker
• 手动预配 Worker 脚本

# 您的 Worker 的名称，例如 "mydaprkv"
name = ""

# 不要更改这些选项
main = "worker.js"
compatibility_date = "2022-12-09"
usage_model = "bundled"

[vars]
# 将此设置为 Ed25519 密钥的**公钥**部分，PEM 编码（换行符替换为 `\n`）。
# 示例：
# PUBLIC_KEY = "-----BEGIN PUBLIC KEY-----\nMCowB...=\n-----END PUBLIC KEY-----
PUBLIC_KEY = ""
# 将此设置为您的 Worker 的名称（与上方的 "name" 属性值相同），例如 "mydaprkv"。
TOKEN_AUDIENCE = ""

[[kv_namespaces]]
# 将以下两个值设置为您的 KV 命名空间的 ID（而不是名称），例如 "123456789abcdef8b5588f3d134f74ac"。
# 请注意，它们将被设置为相同的值。
binding = ""
id = ""

# 将此设置为您正在使用的 Dapr 版本
DAPR_VERSION="release-1.17"
curl -LfO "https://raw.githubusercontent.com/dapr/components-contrib/${DAPR_VERSION}/internal/component/cloudflare/workers/code/worker.js"

npx wrangler publish

生成 Ed25519 密钥对

所有 Cloudflare Workers 都监听公共 Internet，因此 Dapr 需要使用额外的身份验证和数据保护措施来确保没有其他人员或应用程序可以与您的 Worker 通信（进而与您的 Worker KV 命名空间通信）。这些措施包括行业标准措施，例如：

• Dapr 向 Worker 发出的所有请求都通过不记名令牌（技术上是 JWT）进行身份验证，该令牌使用 Ed25519 密钥签名。
• Dapr 与您的 Worker 之间的所有通信都通过加密连接进行，使用 TLS (HTTPS)。
• 不记名令牌在每个请求上生成，仅在很短的时间内有效（目前为一分钟）。

要让 Dapr 颁发不记名令牌并让您的 Worker 验证它们，您需要生成一个新的 Ed25519 密钥对。以下是使用 OpenSSL 或 step CLI 生成密钥对的示例。

• 使用 OpenSSL 生成
• 使用 step CLI 生成

openssl genpkey -algorithm ed25519 -out private.pem
openssl pkey -in private.pem -pubout -out public.pem

step crypto keypair \
  public.pem private.pem \
  --kty OKP --curve Ed25519 \
  --insecure --no-password

无论您如何生成密钥对，按照上述说明，您将拥有两个文件：

• private.pem 包含密钥的私钥部分；使用此文件的内容作为组件元数据的 key 属性。
• public.pem 包含密钥的公钥部分，仅当您手动部署 Worker 时才需要（按照上一节的说明）。

其他注意事项

• 请注意，Cloudflare Workers KV 不保证强数据一致性。虽然对同一 Cloudflare 数据中心发出的请求的更改通常是立即可见的，但更改复制到所有 Cloudflare 区域可能需要一定的时间（通常长达一分钟）。
• 此状态存储支持 Dapr 的 TTL，但 TTL 的最小值为 1 分钟。

相关链接

• Dapr 组件的基本架构
• 阅读此指南，了解配置状态存储组件的说明
• 状态管理构建块
• Cloudflare Workers KV 的文档