← Cloudflare Pages / pages / configuration / git-integration

Интеграция с GitHub

Каждый проект Cloudflare Pages можно подключить к репозиторию GitHub, и Cloudflare будет автоматически развертывать код при каждом push изменений в ветку.

Помимо автоматических развёртываний, интеграция Cloudflare с GitHub позволяет отслеживать, управлять и просматривать развёртывания прямо в GitHub, не отвлекаясь от рабочего процесса.

По умолчанию Pages задаёт ваш продакшен-окружение к ветке, которую вы отправили первой. Если используется ветка, отличная от ветки по умолчанию (например, main) представляет продакшен-ветку вашего проекта, перейдите в Настройки > Builds > Управление ветками, измените продакшен-ветку, нажав на Продакшен-ветка выпадающем меню и выберите любую другую ветку.

Также можно использовать развёртывания предпросмотра чтобы просматривать версии проекта до слияния рабочей ветки и развертывания в продакшен. В Pages можно настроить, какие из ваших превью-веток будут развертываться автоматически, с помощью элементы управления сборкой веток. Чтобы настроить это, перейдите в Настройки > Builds > Управление ветками и выберите нужный параметр в Превью-ветка. Используйте Пользовательские ветки чтобы указать ветки, которые нужно включить в автоматические превью-развертывания или исключить из них.

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

Без какой-либо настройки можно пропускать отдельные развертывания по мере необходимости. Для этого добавьте [CI Skip], [CI-Skip], [Skip CI], [Skip-CI], или [CF-Pages-Skip] флаг в качестве префикса в сообщении коммита, Pages пропустит этот деплой. Регистр префиксов не имеет значения.

Если у вас один или несколько проектов подключены к репозиторию (например, монорепозиторий), можно проверить статус каждой сборки в GitHub через Запуски проверок GitHub ↗.

Проверки можно посмотреть, выбрав значок статуса рядом с коммитом в репозитории GitHub. В примере ниже можно нажать на зелёную галочку, чтобы увидеть результаты выполнения проверки.

Check runs будут отображаться в вашем репозитории следующим образом.

Если сборка пропускается по любой причине (например, из-за CI Skip, путей отслеживания сборки или элементов управления развертыванием по веткам), статус проверки или коммита не появится.

Проекты можно развёртывать в Cloudflare Workers из вашего корпоративного или личного проекта на GitHub с помощью Cloudflare Workers & Pages GitHub App ↗.

Проекты для компании или личные проекты можно развертывать в Cloudflare Pages как из GitHub, так и из GitLab.

При авторизации доступа Cloudflare Pages к аккаунту GitHub вы можете указать доступ к своему личному аккаунту или к организации, в которой состоите на GitHub. Чтобы добавить установку Cloudflare Pages в такую организацию, ваш аккаунт должен иметь права владельца или соответствующую роль в организации (а именно роль GitHub Apps Manager). Подробнее об этих ролях можно узнать на Документация GitHub ↗.

Доступ Cloudflare Pages к репозиторию или аккаунту GitHub можно отозвать, перейдя в Страница приложений ↗ на GitHub (если вы состоите в организации, выберите Switch settings context, чтобы перейти к настройкам организации GitHub). Приложение GitHub называется Cloudflare Workers and Pages и используется совместно проектами Workers и Pages.

Чтобы убрать доступ к отдельному репозиторию GitHub, перейдите в Доступ к репозиторию. Выберите Только выбранные репозитории параметр и настройте, к каким репозиториям Cloudflare должен иметь доступ.

Чтобы полностью убрать доступ Cloudflare Workers и Pages к своей учётной записи Git, перейдите в Удалите «Cloudflare Workers and Pages», затем выберите Удалить. Отзыв доступа приложения Cloudflare Workers and Pages лишит Cloudflare доступа к все репозитории из этого аккаунта GitHub. Если вы хотите только отключить автоматические сборки и развёртывания, следуйте Отключить сборку инструкции.

Учтите, что отзыв доступа к GitHub отключит новые сборки для проектов Workers и Pages, подключённых к этим репозиториям, однако предыдущие развёртывания по-прежнему будут размещены в Cloudflare Workers.

Если появляются ошибки о том, что Cloudflare Pages не может получить доступ к вашему репозиторию git, попробуйте удалить и заново установить приложение GitHub, связанное с установкой Cloudflare Pages.

1. Перейдите на страницу настроек установки на GitHub:
   • Перейдите в Settings > Builds для проекта Pages и выберите Управление в разделе Git Repository.
   • Либо перейдите по этим ссылкам, чтобы найти установленное приложение Cloudflare Workers and Pages, и выберите Настройте:

2. На странице настроек Cloudflare Workers and Pages GitHub App перейдите в Удалите «Cloudflare Workers and Pages» и выберите Удалить.
3. Вернуться к Workers & Pages обзор ↗ странице. Выберите Создать приложение > Pages > Подключение к Git.
4. Выберите + Add account кнопку, выберите учетную запись GitHub, которую хотите добавить, а затем выберите Установка и авторизация.
5. Вас должно перенаправить на страницу создания проекта, где в списке аккаунтов будет ваш аккаунт или организация GitHub.
6. Попробуйте выполнить новый деплой проекта, который до этого был неработоспособен.