← Cloudflare Pages / pages / configuration / git-integration

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

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

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

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

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

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

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

Статусы можно посмотреть, нажав на значок статуса рядом с коммитом, либо перейдя в Build > Pipelines внутри вашего репозитория GitLab. В примере ниже вы можете нажать на зеленую галочку, чтобы увидеть результаты проверки.

Check runs будут отображаться в вашем репозитории следующим образом. Вы можете выбрать один из статусов, чтобы посмотреть URL предпросмотра для этого развертывания.

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

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

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

Авторизуя доступ Cloudflare Pages к своему аккаунту GitLab, вы автоматически предоставляете Cloudflare Pages доступ к организациям, группам и пространствам имён, доступным вашему аккаунту GitLab. Управление доступом к этим организациям и группам выполняется в GitLab.

Доступ Cloudflare Workers к вашему аккаунту GitLab можно отозвать, перейдя в страница Authorized Applications ↗ в GitLab. Найдите приложения с названием Cloudflare Workers и выберите Отозвать кнопку, чтобы отозвать доступ.

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

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

1. Перейдите на страницу настроек приложения в GitLab, она находится здесь: https://gitlab.com/-/profile/applications ↗
2. Выберите Отозвать кнопку в вашей установке Cloudflare Pages, если она есть.
3. Вернуться к Workers & Pages обзорную страницу на https://dash.cloudflare.com/[YOUR_ACCOUNT_ID]/workers-and-pages. Выберите Создать приложение > Pages > Подключение к Git.
4. Выберите GitLab вкладку в верхней части страницы, затем выберите + Add account кнопку, выберите учетную запись GitLab, которую хотите добавить, а затем выберите Авторизовать в модальном окне «Authorize Cloudflare Pages to use your account?».
5. Вы будете перенаправлены на страницу создания проекта, где в списке аккаунтов будет ваш аккаунт или организация GitLab.
6. Попробуйте выполнить новый деплой проекта, который до этого был неработоспособен.