← Cloudflare Workers / workers / versions-and-deployments

Preview URLs

Preview URLs позволяют вам просматривать новые версии Worker без развертывания в продакшен-среде.

Есть два типа URL-адресов предварительного просмотра:

• URL предпросмотра с указанием версии: Уникальный URL-адрес, автоматически создаваемый для каждой новой версии вашего Worker.
• Aliased Preview URLs: Статический понятный человеку псевдоним, который можно вручную присвоить версии Worker.

Оба типа preview URL имеют следующий формат: <VERSION_PREFIX OR ALIAS>-<WORKER_NAME>.<SUBDOMAIN>.workers.dev.

Preview URLs могут быть:

• Интегрируется в конвейеры CI/CD, что позволяет автоматически создавать среды предварительного просмотра для каждого pull request.
• Используется для совместной работы команд при тестировании изменений кода в рабочей среде и проверке обновлений.
• Используется для тестирования новых конечных точек API, проверки форматов данных и обеспечения обратной совместимости с существующими сервисами.

Для тестирования функций производительности или безопасности на уровне зоны для версии рекомендуем использовать переопределения версии чтобы применялись настройки производительности и безопасности вашей зоны.

Каждый раз, когда вы создаёте новый версия вашего Worker автоматически создаётся уникальный статический preview URL версии. Такие URL используют префикс версии и имеют формат <VERSION_PREFIX>-<WORKER_NAME>.<SUBDOMAIN>.workers.dev.

Новые версии Worker создаются при выполнении команды:

• wrangler deploy
• wrangler versions upload
• Или когда вы вносите изменения через Cloudflare dashboard

Если Preview URL включены, они становятся общедоступными сразу после создания версии.

wrangler versions upload команда загружает новый версия вашего Worker и возвращает предварительный URL (preview URL) для каждой загруженной версии.

1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

   Перейдите в Workers & Pages ↗

2. Выберите свой Worker.

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

Aliased preview URLs позволяют назначить постоянный, удобочитаемый алиас конкретной версии Worker. Это полезно для ссылок на стабильные превью разных версий (например, чтобы поделиться новой функцией, которая ещё активно разрабатывается). Обычный сценарий: назначить алиас для ветки, над которой вы сейчас работаете. Такие URL превью следуют тому же шаблону, что и другие URL превью: <ALIAS>-<WORKER_NAME>.<SUBDOMAIN>.workers.dev

Алиасы можно создавать во время versions upload, указав --preview-alias флаг с допустимым именем псевдонима:

wrangler versions upload --preview-alias staging

Полученный алиас будет связан с этой версией и сразу станет доступен по адресу: staging-<WORKER_NAME>.<SUBDOMAIN>.workers.dev

• Алиасы можно создавать только при загрузке версии.
• Алиасы могут содержать только строчные буквы, цифры и дефисы.
• Алиасы должны начинаться со строчной буквы.
• Псевдоним и имя Worker вместе (через дефис) не должны превышать 63 символов из-за ограничений на длину DNS-метки.
• Сохраняются только 1000 последних развернутых алиасов. Когда создается новый алиас сверх этого лимита, самый старый по времени развертывания алиас удаляется.

Если этот параметр включен, Preview URL становятся общедоступными. Чтобы требовать от посетителей вход перед доступом к Preview URL, используйте Cloudflare Access.

Access может защищать preview-версии одного Worker или всех Worker в аккаунте. Также можно защитить и продакшен-, и preview-развёртывания.

Чтобы использовать данные о вошедшем пользователе в своём Worker, прочитайте личность пользователя из проверенного JWT или /cdn-cgi/access/get-identity конечная точка.

Примечание:

• Preview URLs по умолчанию включены, если workers_dev включён.
• Preview URLs по умолчанию отключены, если workers_dev отключён.
• Отключение Preview URLs отключит маршрутизацию к preview URL с версиями и с псевдонимами.

Чтобы включить или отключить Preview URLs для Worker:

1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

   Перейдите в Workers & Pages ↗

2. В Обзор, выберите ваш Worker.

3. Перейдите в Настройки > Domains & Routes.

4. Для Preview URLs нажмите Включить или Отключить.

5. Подтвердите своё действие.

Чтобы включить или отключить Preview URLs для Worker, добавьте в файл Wrangler одно из следующего:

{
	"preview_urls": true
}

preview_urls = true

{
	"preview_urls": false
}

preview_urls = false

Если не указано, preview_urls = workers_dev используется по умолчанию.

• Preview URLs не создаются для Workers, которые реализуют Durable Object, включая Containers и Sandbox Workers. Информацию о вариантах тестирования Containers см. Развертывание Containers.
• Preview URLs в настоящее время не создаются для Workers for Platforms пользовательские Workers. Это временное ограничение, мы работаем над его устранением.
• Сейчас нельзя настроить Preview URLs для работы на поддомене, отличном от workers.dev.
• На сегодняшний день просмотр логов для Preview URLs недоступен, это касается Workers Logs, Wrangler tail и Logpush.