← Cloudflare Workers / workers / ci-cd
Builds
Cloudflare Интеграция с Git позволяет подключить новый или уже существующий Worker к репозиторию GitHub или GitLab, что обеспечивает автоматическую сборку и развёртывание вашего Worker при каждом push.
Начало работы
Подключение нового Worker
Чтобы создать новый Worker и подключить его к репозиторию GitHub или GitLab:
-
На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.
Перейдите в Workers & Pages ↗ -
Выберите Создать приложение.
-
Выберите Начало работы рядом с Импорт репозитория.
-
В разделе Импорт репозитория, выберите Учётная запись Git.
-
Выберите репозиторий для импорта из списка. Также можно воспользоваться строкой поиска, чтобы сузить результаты.
-
Настройте проект и выберите Save and Deploy.
-
Откройте предпросмотр Worker по предоставленному
workers.devподдомен.
Подключение существующего Worker
Чтобы подключить существующий Worker к репозиторию GitHub или GitLab:
-
На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.
Перейдите в Workers & Pages ↗ -
Выберите Worker, который нужно подключить к репозиторию.
-
Выберите Настройки и затем Builds.
-
Выберите Подключить и следуйте подсказкам, чтобы подключить репозиторий к своему Worker и настроить настройки сборки.
-
Отправьте коммит в ваш Git-репозиторий, чтобы запустить сборку и развёртывание вашего Worker.
Автоматическая настройка проекта
Когда вы подключаете репозиторий, в котором нет файла конфигурации Wrangler, autoconfig запускается, чтобы определить ваш фреймворк и создать pull request чтобы настроить ваш проект для Cloudflare Workers.
- Autoconfig определяет ваш фреймворк и создаёт необходимую конфигурацию
- В вашем репозитории создаётся pull request с необходимыми изменениями конфигурации
- Создаётся preview-развёртывание, на котором можно протестировать изменения перед merge
- После слияния PR проект готов к развертыванию
Подробнее о поддерживаемых фреймворках и создаваемых файлах см. в Развертывание существующего проекта. Подробнее о созданных PR см. в Автоматическое создание pull request.
Просмотр сборки и URL предпросмотра
Статус сборки и её логи можно отслеживать, перейдя в Просмотр истории сборок внизу Развёртывания вкладку вашего Worker.
Если сборка выполнена успешно, вы можете просмотреть её детали, выбрав Просмотр сборки в связанном новом версия создаётся в разделе Version History. Там же вы найдёте URL предпросмотра сгенерированный версией, указанной в Version ID.
Workers с Containers
Для Workers, использующих Containers, используйте wrangler deploy в ветке production, чтобы образы и экземпляры контейнеров могли обновляться. Preview сборки по умолчанию по-прежнему используют wrangler versions upload, который не обновляет образы контейнеров. Для таких Workers URL предпросмотра не создаются, поскольку каждый контейнер управляется из Durable Object. См. Развертывание Containers.
Отключение сборок
Чтобы отключить Worker от репозитория GitHub или GitLab:
-
На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.
Перейдите в Workers & Pages ↗ -
Выберите Worker, который нужно отключить от репозитория.
-
Выберите Настройки и затем Builds.
-
Выберите Отключить.
Если вы хотите переключить Worker на другой репозиторий, сначала отключите сборки, а затем переподключитесь, чтобы выбрать новый репозиторий.
Чтобы отключить автоматические развертывания, но при этом по-прежнему разрешить автоматический запуск сборок и сохранение как версии (не переводя их в активное развёртывание), обновите команду развёртывания на: npx wrangler versions upload.