← Artifacts / artifacts / concepts

Пространства имён

Artifacts использует пространства имён как контейнеры верхнего уровня для репозиториев. Используйте их, чтобы разделять репозитории по окружениям, например prod, staging, а также dev, по тенанту или шарду.

Вы можете создать пространство имён явно или позволить Artifacts создать его автоматически. Если вы создаёте репозиторий в пространстве имён, которого ещё не существует, Artifacts создаёт это пространство имён автоматически.

Используйте одно пространство имён на каждое окружение или границу арендатора.

• Используйте пространства имен окружений, такие как prod, staging, или dev.
• Используйте пространства имен тенантов или шардов, если одно общее пространство имен становится слишком нагруженным или слишком большим.
• Следите за уникальностью имён репозиториев в пределах каждого пространства имён.

Используйте стабильное имя, например default, staging, или agents-realtime.

Имена пространств имён подчиняются тем же публичным правилам именования, что и имена репозиториев:

• начинаться с буквы или цифры
• используйте буквы, цифры, ., _, или - после первого символа
• сохраняйте имя неизменным в Workers, API-клиентах и рабочих процессах Git

Если вы ещё не выбрали стратегию для пространств имён, используйте default в примерах на протяжении всей этой документации.

При создании пространства имён выберите юрисдикцию, чтобы ограничить, где Artifacts хранит и обрабатывает данные репозитория. Каждый репозиторий в этом пространстве имён использует выбранную юрисдикцию.

Вы не можете изменить юрисдикцию пространства имён после его создания. Список поддерживаемых юрисдикций и инструкции по созданию приведены в Локализация данных.

Используйте то же имя пространства имен в своем Wrangler binding:

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

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

Используйте то же самое пространство имен в базовом URL REST API:

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.