← Cloudflare Version Management / version-management

Устранение неполадок

Используйте эту страницу для устранения распространенных проблем с Version Management. Если приведенные ниже шаги не решают вашу проблему, обратитесь в службу поддержки Cloudflare и укажите сведения, перечисленные в Информация для службы поддержки.

Version Management неактивен (затемнен) или недоступен

Если параметр Version Management отображается серым цветом или не отображается в панели управления Cloudflare, убедитесь, что выполнены все требования выполнены.

Частые причины:

Ваша зона не использует план Enterprise. Version Management доступен только для зон уровня Enterprise.
Ваша зона не находится в активном состоянии. Убедитесь, что для вашей зоны статус домена это Активно.
Миграция WAF не завершена. Ваша зона должна использовать WAF managed rules и пользовательские правила вместо устаревшего Firewall Rules. Если ваша зона всё ещё использует устаревший WAF, обратитесь к своей команде по работе с аккаунтом, чтобы завершить миграцию.
У вашей учетной записи пользователя нет необходимой роли. Вам нужен Роль Super Administrator или Administrator чтобы включить Version Management. Роли Zone Versioning не могут создавать новые версии.
У вашей учетной записи пользователя нет ключа API. У вас должен быть выпущен API-ключ. См. посмотреть свой Global API Key, где это описано подробнее.
Доступ к API отключен для вашей учетной записи. См. управлять API Access, где это описано подробнее.

Если все требования выполнены, а Version Management по-прежнему недоступен, обратитесь в свою команду по работе с аккаунтом.

Не удалось создать или клонировать версию

Создание версии (клонирование) может завершиться сбоем по нескольким причинам. При клонировании версии Cloudflare копирует конфигурацию зоны из исходной версии в новую. Если на любом этапе этого процесса возникает ошибка, клонирование не выполняется.

Распространённые причины

Неподдерживаемые или частично поддерживаемые конфигурации продуктов

Некоторые продукты и функции не полностью совместимы с Version Management. Если исходная версия содержит конфигурации для неподдерживаемых продуктов, клонирование может завершиться ошибкой или дать неполный результат. См. Ограничения с полным списком.

Типичные примеры:

API Shield Некоторые конфигурации API Shield не клонируются. После создания новой версии вам может понадобиться вручную настроить параметры API Shield заново.
Преобразования изображений Изменения в Image Transformations не переносятся в новые версии.
WAF Attack Score Конфигурации WAF Attack Score не клонируются.
Network Error Logging Конфигурации NEL не копируются в новые версии.

Недопустимая или конфликтующая конфигурация в исходной версии

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

Создание версии зависло

Если создание версии как будто зависло (статус долго не меняется), подождите несколько минут и обновите панель управления. Если проблема не устранена, обратитесь в Cloudflare Support и укажите сведения, перечисленные в Информация для службы поддержки.

Что делать

Проверьте Ограничения чтобы убедиться, что исходная версия не использует неподдерживаемые конфигурации.
Проверьте конфигурацию исходной версии на наличие недопустимых или конфликтующих правил.
Повторите операцию клонирования.
Если проблема не устранена, обратитесь в Cloudflare Support.

У некоторых пользователей отсутствуют правила или настройки

Когда Version Management включен, у каждой версии есть собственный независимый набор правил и конфигураций. Если правило или настройка кажутся отсутствующими, возможно, вы или другой пользователь просматриваете не ту версию, в которой было создано это правило.

Например, правило кэширования, созданное в одной версии, не отображается при просмотре другой версии. Оно может оставаться активным и влиять на трафик, если его версия продвинута в активное окружение, но в панели управления оно не отображается, если выбрана другая версия.

Чтобы решить эту проблему:

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

Маршруты Worker исчезают или ведут себя непредсказуемо

Если у версии есть маршрут Worker, этот маршрут может исчезнуть при развертывании Worker с помощью Wrangler. Кроме того, если у двух версий совпадают пользовательские домены, Worker может случайным образом выбирать между ними.

Чтобы избежать этого:

Разверните Workers с помощью Wrangler, прежде чем создавать новые версии, которые ссылаются на те же маршруты.
Не настраивайте одинаковые пользовательские домены в нескольких версиях.

Terraform не поддерживается

Terraform не поддерживается в Version Management. Если вы используете Terraform для управления конфигурацией зоны, выберите либо Terraform, либо Version Management: одновременное использование обоих инструментов не поддерживается.

Расхождения в аналитике

Когда Version Management включен, данные аналитики в панели управления Cloudflare могут не отражать распределение трафика между средами так, как ожидается. Аналитика формируется на уровне зоны и может не детализироваться по отдельным версиям или средам.

Если после включения Version Management вы замечаете расхождения данных в панели аналитики, убедитесь, что просматриваете аналитику на уровне зоны, а не ожидаете разбивку по отдельным версиям.

Разрешения и версии только для чтения

Domain-scoped roles не копируются в новые версии

Роли на уровне домена применяются только к вашей корневой зоне. При создании новой версии эти роли не копируются, и пользователи с ролями на уровне домена теряют доступ к новой версии.

Чтобы устранить эту проблему, назначьте необходимые роли заново после создания новой версии или используйте роли уровня аккаунта.

Версия отображается как доступная только для чтения

Версия может отображаться как доступная только для чтения в следующих случаях:

В настоящее время она продвинута в окружение только для чтения.
У вашей учетной записи пользователя нет прав, необходимых для редактирования версий.

Проверьте свою роль пользователя и убедитесь, что версия не развернута в среде, доступной только для чтения.

Информация для службы поддержки

При обращении в Cloudflare Support по вопросу, связанному с Version Management, укажите следующие данные:

Account ID и Zone ID (находится в панели управления Cloudflare в разделе Обзор).
Имя зоны (ваш домен).
номер версии с которой вы работали, когда возникла проблема.
действие, которое вы пытались выполнить (например, создание версии, клонирование, продвижение или сравнение).
точное сообщение об ошибке отображаемые, если они есть.
примерная временная метка (включая часовой пояс), когда возникла проблема.
Скриншоты ошибки, если она доступна.