← Cloudflare Pages / pages / configuration

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

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

При подключении git-репозитория к проекту Cloudflare Pages Cloudflare также:

Превью-деплои для пользовательских веток, создавая предварительные URL-адреса для коммитов в любой ветке репозитория без влияния на продакшен-развёртывание.
Превью-URL в pull requests (PRs) в репозиторий.
Проверки статуса сборки и развертывания внутри репозитория Git.
Пропуск сборок с помощью сообщения коммита.

Эти функции позволяют управлять развёртываниями прямо в GitHub или GitLab, не выходя за рамки привычного рабочего процесса команды.

Позже переключиться на Direct Upload будет невозможно

Если вы выполняете развертывание через интеграцию с Git, вы не можете переключиться на Direct Upload позже. Однако если вы уже используете проект с интеграцией Git и не хотите запускать развёртывание при каждом отправленном коммите, вы можете отключить автоматические развёртывания для всех веток. После этого вы можете использовать Wrangler, чтобы разворачивать проекты Pages напрямую и вносить изменения в Git-репозиторий, не запуская сборку автоматически.

Поддерживаемые провайдеры Git

Cloudflare поддерживает подключение Cloudflare Pages к репозиториям GitHub и GitLab. На данный момент Pages не поддерживает подключение self-hosted инстансов GitHub или GitLab.

Если вы используете другого провайдера Git (например, Bitbucket) или self-hosted инстанс, вы можете начать с проекта Direct Upload и выполнять развертывание через CI/CD-провайдера (например, GitHub Actions) с помощью Wrangler CLI.

Добавьте интеграцию с Git

Если к вашему аккаунту Cloudflare не привязан аккаунт Git, вам будет предложено настроить установку в GitHub или GitLab, когда подключение к Git в первый раз или при добавлении нового аккаунта Git. Следуйте инструкциям и авторизуйте интеграцию Cloudflare с Git.

Проверить, установлена ли интеграция с Git, можно на следующих страницах:

Страница приложений GitHub ↗ (если вы состоите в организации, выберите Переключение контекста настроек для доступа к настройкам вашей организации GitHub)
Страница авторизованных приложений GitLab ↗

Подробнее о предоставлении доступа к аккаунтам организации см. в GitHub и GitLab руководства.

Управление интеграцией с Git

Управлять установкой Git, связанной с подключением репозитория, можно, перейдя в проект Pages, а затем в Настройки > Builds и выбрав Управление в разделе Репозиторий Git.

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

Отключить автоматические развертывания

Если вы используете проект с интеграцией Git и не хотите запускать развертывание при каждом push коммита, вы можете использовать управление ветками чтобы отключить или приостановить сборки:

Перейдите в Workers & Pages в Cloudflare dashboard.
Перейдите в Workers & Pages ↗
Выберите свой проект Pages.
Перейдите в Build > измените Управление ветками > отключите Включите автоматические деплои продакшен-ветки.
Также можно изменить ветку Preview на None (отключить автоматические развёртывания веток) чтобы приостановить автоматические превью-развертывания.

После этого вы можете использовать Wrangler, чтобы развёртывать изменения напрямую в проект Pages и вносить изменения в репозиторий Git без автоматического запуска сборки.