命名空间 · Cloudflare Artifacts docs

Artifacts 使用命名空间作为存储库的顶级容器。使用它们按环境（例如 prod、staging 和 dev）、租户或分片（shard）来隔离存储库。

命名空间是隐式创建的 —— 没有单独的创建步骤。您选择一个命名空间名称，然后在您的 Wrangler 配置或 REST API 路径中引用它。当您首次在该名称下创建存储库时，Artifacts 会自动为您创建该命名空间。

使用命名空间作为容器

首先为每个环境或租户边界设置一个命名空间。

使用环境命名空间，例如 prod、staging 或 dev。
当单个共享命名空间变得过于繁忙或过大时，请使用租户或分片命名空间。
保持每个命名空间内的存储库名称唯一。

选择命名空间名称

首先使用一个稳定的名称，例如 default、staging 或 agents-realtime。

命名空间名称遵循与存储库名称相同的公开命名规则：

以字母或数字开头
第一个字符后使用字母、数字、.、_ 或 -
保持该名称在您的 Workers、API 客户端和 Git 工作流中稳定一致

如果您尚未选择命名空间策略，请在此文档集的示例中使用 default。

在所有地方使用相同的命名空间

在您的 Wrangler 绑定（binding）中使用相同的命名空间名称：

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "artifacts": [
    {
      "binding": "ARTIFACTS",
      "namespace": "default"
    }
  ]
}

[[artifacts]]
binding = "ARTIFACTS"
namespace = "default"

在您的 REST 根 URL 中使用相同的命名空间：

export ACCOUNT_ID="<YOUR_ACCOUNT_ID>"
export ARTIFACTS_NAMESPACE="default"
export ARTIFACTS_BASE_URL="https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/artifacts/namespaces/$ARTIFACTS_NAMESPACE"

在需要时拆分命名空间

在学习该产品时，先从一个命名空间开始。当您在环境、团队或高速率工作负载之间需要更清晰的边界时，请添加更多命名空间。

有关更多信息，请参阅 Artifacts 最佳实践。