← Cloudflare Pages / pages / configuration

Превью-деплои

Превью-деплои позволяют просматривать новые версии проекта без развёртывания в продакшен. Чтобы просмотреть превью-деплои:

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

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

2. Выберите проект и найдите деплой, который нужно просмотреть.

Каждый раз, когда вы открываете новый pull request в своём репозитории GitHub, Cloudflare Pages создаёт уникальный предварительный URL-адрес, который обновляется по мере того, как вы отправляете новые коммиты в ветку. Это верно только для pull request, созданных из самого репозитория.

Например, если у вас есть репозиторий с именем user-example подключен к Pages, это предоставит вам user-example.pages.dev поддомен. Если main является вашей веткой по умолчанию, то любые коммиты в main ветка будет обновлять ваш user-example.pages.dev содержимое, а также любые пользовательские домены прикреплённый к проекту.

В процессе разработки user-example, вы можете отправить новые изменения в development ветку, например.

В этом примере после создания нового development ветку, Pages автоматически создаст preview-деплой для этих изменений, доступный по адресу 373f31e2.user-example.pages.dev - где 373f31e2 это случайно сгенерированный хеш.

Каждая новая созданная вами ветка получит новый, случайно сгенерированный хеш перед вашим pages.dev поддомен.

Любые дополнительные изменения в development ветка будет продолжать обновлять этот 373f31e2.user-example.pages.dev предварительный адрес, пока development ветка объединяется с main production branch.

Любые пользовательские домены, а также ваш user-example.pages.dev сайт, не будет затронут предварительными развёртываниями.

Вы можете использовать Cloudflare Access чтобы управлять доступом к превью развертываний. По умолчанию такие URL-адреса развертываний общедоступны. Включение политики доступа ограничит просмотр развертываний проекта только вашей учетной записью Cloudflare.

После включения вы можете настройте аккаунт с несколькими пользователями чтобы разрешить остальным участникам вашей команды просматривать превью-развертывания.

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

Чтобы защитить preview-развёртывания с помощью Cloudflare Access:

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

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

2. Выберите свой проект Pages.

3. Перейдите в Настройки > Общее > и выберите Включить политику доступа.

Учтите, что это защитит только предварительные развёртывания (например, 373f31e2.user-example.pages.dev и всех остальных случайно сгенерированных превью-ссылок, а не для *.pages.dev домен или собственный домен.

При публикации предварительного развёртывания ему присваивается уникальный адрес на основе хеша, например <hash>.<project>.pages.dev. Они атомарны, и к ним всегда можно будет обратиться в дальнейшем. Однако Pages также создает алиас для git ветки и обновляет его так, чтобы алиас всегда указывал на последний коммит этой ветки.

Например, если вы отправляете изменения в development ветка (не связанная с вашим окружением Production), то Pages развернёт проект на abc123.<project>.pages.dev и алиас development.<project>.pages.dev к нему. Позже вы сможете отправлять новые изменения в development ветку, которая создаёт xyz456.<project>.pages.dev развертывание. На этом этапе development.<project>.pages.dev алиас указывает на xyz456 развертывание, но abc123.<project>.pages.dev остается доступным напрямую.

Псевдонимы имён веток приводятся к нижнему регистру, а все не буквенно-цифровые символы заменяются дефисом, например, fix/api ветка создаёт fix-api.<project>.pages.dev алиас.

Чтобы просмотреть псевдонимы веток в своём проекте Pages, выберите Просмотр сборки для любого preview-деплоя. Сведения о развертывании отобразит все алиасы, связанные с этим развёртыванием.

Псевдоним Preview можно привязать к пользовательскому домену, добавление пользовательского домена к ветке ↗.

Чтобы удалить старые preview-развёртывания, используйте Wrangler:

npx wrangler pages deployment delete <DEPLOYMENT_ID> --project-name <PROJECT_NAME>

Используйте --force (или -f) чтобы пропустить запрос подтверждения и принудительно удалить алиасные развертывания. Идентификаторы развертываний можно найти, выполнив wrangler pages deployment list.

Для поддержания хорошего SEO-профиля важно не допускать появления дублирующегося контента в поисковых системах. Поскольку preview-развёртывания представляют собой точную копию продакшен-окружения, они неизбежно создают такую ситуацию. По умолчанию Cloudflare Pages гарантирует, что эти временные предпросмотры не повлияют на позиции сайта в поиске.

По умолчанию каждое предпросмотровое развертывание, созданное Cloudflare Pages, включает HTTP-заголовок ответа X-Robots-Tag: noindex. Этот заголовок служит чётким указанием для поисковых роботов игнорировать страницу и не включать её в результаты поиска.

Легко убедиться, что предварительные развертывания правильно настроены на блокировку индексирования. Выполните в терминале следующую команду curl, заменив placeholder на уникальный preview URL:

curl -I https://<your-preview-url>.pages.dev

Проверьте вывод на наличие строки x-robots-tag: noindex, чтобы убедиться, что ваш превью-сайт не индексируется.