← Cloudflare Pages / pages / migrations

Перенос с Workers Sites на Pages

В этом руководстве вы узнаете, как перенести существующий Cloudflare Workers Sites приложение в Cloudflare Pages.

Прежде всего вам понадобится проект Cloudflare Workers Sites, созданный с помощью Wrangler ↗.

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

У вас уже может быть достаточно сложный Worker, и разбивать его на файловую систему маршрутизации Pages было бы утомительно. Для таких случаев Pages предоставляет разработчикам возможность определить _worker.js файл в выходном каталоге вашего проекта Pages.

Перейдя на Cloudflare Pages, вы получите доступ к таким функциям, как развёртывания предпросмотра и автоматические деплои веток без дополнительной настройки.

Проекты Workers Sites состоят из следующих компонентов:

1. Приложение, созданное с помощью инструмент для статических сайтов или статический набор файлов HTML, CSS и JavaScript.
2. При использовании инструмента для статических сайтов создается каталог сборки (называемый bucket в конфигурационный файл Wrangler) где статический проект собирает файлы HTML, CSS и JavaScript.
3. Worker-приложение для обслуживания этого каталога сборки. Для большинства проектов это, скорее всего, workers-site каталог.

При переходе на Cloudflare Pages удалите приложение Workers и все связанные с ним файлы конфигурации Wrangler или результаты сборки. Вместо этого запишите и сохраните свой build команду (если она у вас есть), и bucket поле, то есть каталог сборки, из файла Wrangler в каталоге проекта.

Перенести редиректы в Pages можно, создав _redirects файл в выходном каталоге. Pages пока поддерживает расширенные перенаправления лишь частично, поддержка будет расширяться. Список поддерживаемых типов см. в документация по Redirects.

Помимо _redirects файл, Cloudflare также предлагает Bulk Redirects, который обрабатывает редиректы сверх лимита в 2,100 правил, установленного Pages.

Пользовательские заголовки также можно перенести в _headers файл в выходном каталоге. Обратите внимание: пользовательские заголовки, заданные в _headers файла пока не применяются к ответам от Functions, даже если маршрут Function совпадает с шаблоном URL. Подробнее об обработке заголовков см. Headers.

После того как вы запишете команда сборки и каталог сборки в отдельном месте, удалите всё остальное из вашего приложения и отправьте новую версию вашего проекта своему git-провайдеру. Следуйте Руководство по началу работы чтобы добавить ваш проект в Cloudflare Pages, используя команда сборки и каталог сборки который вы сохранили ранее.

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

Если у вашего сайта на Workers есть собственные настройки сборки, вы можете перенести уже собранные ресурсы в Pages с помощью Direct Upload. Кроме того, вы можете передавать ресурсы своего сайта прямо в глобальную сеть Cloudflare, используя либо Wrangler CLI или вариант с перетаскиванием файлов.

Эти параметры позволяют создать и назвать новый проект из CLI или дашборда. После завершения развёртывания проекта настроить пользовательский домен можно, следуя добавление пользовательского домена шагов к вашему проекту Pages.

После того как вы развернёте приложение Pages, чтобы удалить Worker:

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

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

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

3. Перейдите в Управление > Удалить Worker.

После удаления приложения Workers запросы будут направляться в приложение Pages. Выполнив это руководство, вы успешно перенесли проект Workers Sites на Cloudflare Pages.