← Cloudflare Workers / workers / ci-cd / builds

Автоматическое создание pull request

Workers Builds может автоматически создавать pull request в вашем репозитории для настройки проекта или устранения проблем с развёртыванием.

Когда вы подключаете репозиторий, в котором нет файла конфигурации Wrangler, Workers Builds запускает wrangler deploy который запускает автоматическая настройка проекта. Вместо того чтобы завершиться ошибкой, он создаёт pull request с необходимой конфигурацией для обнаруженного фреймворка.

Без конфигурации в репозитории каждая сборка вынуждена сначала запускать autoconfig, поэтому проект собирается дважды: один раз во время autoconfig для генерации конфигурации и второй раз для самого развертывания. При мерже PR конфигурация фиксируется в репозитории, поэтому последующие сборки пропускают autoconfig и сразу переходят к сборке и развертыванию. Это ускоряет развертывания и переводит настройки под контроль версий.

PR с конфигурацией может содержать изменения в следующих файлах, в зависимости от вашего фреймворка:

• wrangler.jsonc - Файл конфигурации Wrangler с настройками вашего Worker
• Адаптер фреймворка - любой необходимый адаптер Cloudflare для вашего фреймворка (например, @astrojs/cloudflare для Astro)
• Конфигурация фреймворка - Обновления конфигурационных файлов фреймворка (например, astro.config.mjs для Astro или svelte.config.js для SvelteKit)
• package.json - Новые скрипты, такие как deploy, preview, а также cf-typegen, плюс необходимые зависимости
• package-lock.json / yarn.lock / pnpm-lock.yaml - Обновлённый lock-файл с новыми зависимостями
• .gitignore - Записи для .wrangler и .dev.vars* файлы
• .assetsignore - Для фреймворков, которые создают файлы worker в выходном каталоге

Описание PR включает:

• Обнаруженные настройки - Фреймворк, команда сборки, команда деплоя и команда версии
• Ссылка предпросмотра - рабочий предпросмотр, созданный на основе определённых настроек
• Следующие шаги - Ссылки на документацию по добавлению биндингов, пользовательских доменов и другого

Если Workers Builds обнаруживает несоответствие между именем Worker в панели управления Cloudflare и name поле в файле конфигурации Wrangler, будет создан pull request для устранения конфликта.

Это может происходить в следующих случаях:

• Вы переименовали Worker в панели управления, но не в файле конфигурации
• Вы подключаете репозиторий, который ранее уже использовался с другим Worker
• name поле в вашей конфигурации не соответствует подключённому Worker

PR обновит name поле в конфигурации Wrangler, чтобы оно соответствовало имени Worker в dashboard.

Подробнее см. в журнал изменений при конфликтах имён.

Когда вы получаете PR от Workers Builds:

1. Просмотрите изменения - проверьте, что конфигурация соответствует требованиям вашего проекта
2. Тестирование предпросмотра - Используйте ссылку предпросмотра в описании PR, чтобы проверить, что всё работает
3. Merge when ready - Когда всё устроит, слейте PR, чтобы включить более быстрые деплои