← Cloudflare Workers / workers / ci-cd / builds / git-integration

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

Cloudflare поддерживает подключение вашего репозитория GitHub к вашему Cloudflare Worker и автоматически развёртывает код при каждом push с изменениями.

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

Если коммит относится к pull request, Cloudflare автоматически публикует комментарий к этому pull request со статусом сборки.

A URL предпросмотра будет предоставлен для любых сборок, которые выполняют wrangler versions upload. Это особенно удобно при просмотре pull request, поскольку позволяет сравнить изменения кода с обновлённой версией Worker.

История комментариев показывает все сборки, выполненные, пока PR оставался открытым.

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

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

Проверки будут отображаться в вашем репозитории следующим образом. Вы можете выбрать Подробности чтобы посмотреть сборку (Build ID) и проект (Script), связанные с каждой проверкой.

Обратите внимание, что при использовании пути отслеживания сборки, check run создаётся только для проектов, которые запускают сборку.

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

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

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

Доступ Cloudflare Workers к вашему репозиторию или аккаунту 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.

При возникновении проблем с интеграцией Git одним из возможных шагов устранения неполадок является удаление и повторная установка приложения GitHub или GitLab, связанного с установкой Cloudflare Pages. Процесс для каждого Git-провайдера описан ниже.

1. Перейдите на страницу настроек установки на GitHub:
   • Перейдите в Settings > Builds для проекта Workers или 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. Попробуйте выполнить новый деплой проекта, который до этого был неработоспособен.