← Cloudflare Workers / workers / ci-cd / builds

Устранение неполадок со сборками

В этом руководстве объясняется, как выявлять и устранять ошибки сборки, а также решать распространённые проблемы в процессе развёртывания Workers Builds.

Чтобы просмотреть историю сборок, откройте проект Worker в дашборде Cloudflare и выберите Развёртывание, выберите Просмотр истории сборок внизу страницы и выберите сборку, которую хотите просмотреть. Чтобы повторить сборку, нажмите на многоточие рядом с ней и выберите Повторить сборку. Как вариант, можно выбрать Повторить сборку на странице Build Details.

Ниже перечислены типичные ошибки сборки, которые могут появляться в логах сборки, а также общие проблемы и способы их устранения.

✘ [ERROR] The name in your Wrangler configuration file (<Worker name>) must match the name of your Worker. Please update the name field in your Wrangler configuration file.

При подключении Git-репозитория к проекту Workers имя Worker, указанное в Cloudflare dashboard, должно совпадать с name аргумент в конфигурационном файле Wrangler, расположенном в указанном корневом каталоге. Если оно не совпадает, обновите поле name в конфигурационном файле Wrangler так, чтобы оно соответствовало имени Worker в дашборде.

Система сборки использует name аргумент в конфигурационном файле Wrangler, чтобы определить, какой Worker развернуть в глобальной сети Cloudflare. Это требование обеспечивает соответствие между именем Worker в дашборде и развёрнутым Worker.

✘ [ERROR] Missing entry-point: The entry-point should be specified via the command line (e.g. wrangler deploy path/to/script) or the main config field.

Если вы видите эту ошибку, вероятно, в корневом каталоге отсутствует файл конфигурации Wrangler. Перейдите в Настройки > Build > Конфигурация сборки чтобы обновить корневой каталог, или добавьте конфигурационный файл Wrangler в указанный каталог.

Could not route to /client/v4/accounts/<Account ID>/workers/services/<Worker name>, perhaps your object identifier is invalid? [code: 7003]

Если вы видите эту ошибку, вероятно, в файле конфигурации Wrangler есть account_id для другой учётной записи. Удалите account_id аргумент или обновите его значением своего account_id, доступно в Обзор Workers & Pages в разделе Сведения об аккаунте.

Failed: The build token selected for this build has been deleted or rolled and cannot be used for this build. Please update your build token in the Worker Builds settings and retry the build.

Раскрывающийся список API Token в настройках Build Configuration может показывать устаревшие токены, которые были изменены, удалены или обновлены. Если вы столкнулись с ошибкой из-за устаревшего токена, создайте новый API Token и выберите его для сборки.

Build was timed out

Максимальная продолжительность сборки составляет 20 минут. Если сборка превышает это время, она прерывается, и отображается указанный выше журнал ошибок. Подробнее см. в Ограничения Workers Builds.

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

Если вы обнаружили дополнительные проблемы или хотите оставить отзыв, свяжитесь с нами в Cloudflare Developers Discord ↗.