← Cloudflare Pages / pages / configuration

Deploy Hooks

С Deploy Hooks можно запускать развертывания с помощью источников событий, отличных от коммитов в исходном репозитории. Каждый источник события может получить собственный уникальный URL-адрес, на который будут поступать HTTP POST запросы для инициации новых развертываний. Эта функция позволяет интегрировать Pages с новыми или уже существующими рабочими процессами. Например, вы можете:

• Автоматическое развёртывание новых сборок при каждом изменении содержимого в Headless CMS
• Реализация полностью настраиваемого CI/CD пайплайна с развертыванием только при заданных условиях
• Настройте CRON trigger для обновления сайта по расписанию

Чтобы создать Deploy Hook:

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

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

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

3. Перейдите в Настройки > Builds и выберите Добавьте deploy hook чтобы начать настройку.

Чтобы настроить Deploy Hook, укажите два ключевых параметра:

1. Имя Deploy Hook: уникальный идентификатор для Deploy Hook (например, contentful-site)
2. Ветка для сборки: ветку репозитория, которую должен собирать Deploy Hook

После завершения настройки уникальный URL-адрес Deploy Hook готов к использованию. Вы увидите как сам URL-адрес, так и фрагмент кода с POST-запросом, доступный для копирования.

Каждый раз, когда запрос отправляется на ваш Deploy Hook, запускается новая сборка. См. Источник столбец журнала деплоев, чтобы увидеть, какие деплои были запущены через Deploy Hook.

Deploy Hooks однозначно привязаны к вашему проекту и не требуют дополнительной аутентификации для использования. Это обеспечивает полную гибкость, но важно защищать эти URL так же, как вы защищаете любую конфиденциальную информацию или секреты приложения.

Если вы подозреваете несанкционированное использование Deploy Hook, удалите его и создайте новый взамен.

Каждая CMS устроена по-своему, поэтому способы интеграции с Deploy Hooks в Pages будут отличаться. В следующем разделе приведены пошаговые инструкции для ряда популярных платформ CMS.

Contentful поддерживает интеграцию с Cloudflare Pages через свой Webhooks функцию. В настройках проекта Contentful перейдите в Webhooks, создайте новый Webhook и вставьте свой уникальный URL-адрес Deploy Hook в URL поле. При желании можно указать события, которые должен пересылать Contentful Webhook. По умолчанию Contentful запускает развёртывание Pages при любой активности в проекте, а это может быть слишком часто. Вы можете отфильтровать нужные события, например Create, Publish и другие.

Сайт на Ghost можно настроить на запуск развертываний Pages, создав новый Custom Integration. В настройках сайта Ghost создайте новую Custom Integration в разделе Интеграции страницу.

Каждая созданная пользовательская интеграция может иметь несколько вебхуки прикреплён к нему. Создайте новый webhook, выбрав Добавить webhook и Сайт изменён (пересборка) в качестве Событие. Затем вставьте уникальный URL-адрес Deploy Hook в качестве Целевой URL значение. После создания этого вебхука приложение Cloudflare Pages будет повторно развертываться при каждом изменении сайта Ghost.

На странице Settings проекта Sanity найдите Webhooks раздел и добавьте URL-адрес Deploy Hook, как показано ниже. По умолчанию Webhook будет запускать ваш Pages Deploy Hook для всех наборов данных внутри вашего проекта Sanity. Вы можете фильтровать уведомления для отдельных наборов данных, например production, с помощью Набор данных поле:

WordPress можно настроить на запуск Pages Deploy Hook, установив бесплатный WP Webhooks плагин. Плагин включает несколько триггеров, например Send Data on New Post, Send Data on Post Update и Send Data on Post Deletion, каждый из которых позволяет запускать новые развертывания Pages при изменении данных WordPress. Выберите триггер на боковой панели настроек плагина, а затем Add Webhook URL ↗, вставив свой уникальный URL-адрес Deploy Hook.

В Strapi Admin Panel можно настроить и сконфигурировать вебхуки для более удобной работы с Cloudflare Pages. В Strapi Admin Panel:

1. Перейдите в Настройки.
2. Выберите Webhooks.
3. Выберите Add New Webhook.
4. В Название поле формы, присвойте новому вебхуку уникальное имя.
5. В URL поле формы, вставьте уникальный URL-адрес Cloudflare Deploy Hook.

В Strapi Admin Panel можно настроить срабатывание webhook по событиям. С помощью этих настроек можно автоматически создавать новое развертывание сайта Cloudflare Pages при создании, обновлении или удалении записи или медиафайла в Strapi.

Обязательно добавьте настройки вебхука в продакшен ↗ приложение Strapi, которое обеспечивает работу вашего сайта на Cloudflare.

Хуки развёртывания в Storyblok можно настроить для запуска событий. В пространстве Storyblok перейдите в Настройки и прокрутите вниз до Webhooks. Вставьте свой deploy hook в Публикация и отмена публикации Story поле и выберите Save.