INTEGRITY Dokumentace

Řešení problémů s buildy

Tento průvodce vysvětluje, jak identifikovat a řešit chyby sestavení a jak odstraňovat běžné problémy v procesu nasazení Workers Builds.

Chcete-li zobrazit historii sestavení, přejděte v Cloudflare dashboardu do projektu Worker a vyberte Nasazení, vyberte Zobrazit historii sestavení v dolní části stránky a vyberte build, který chcete zobrazit. Pokud chcete build spustit znovu, klikněte na ikonu tří teček vedle něj a vyberte Opakovat sestavení. Případně můžete vybrat Opakovat sestavení na stránce Build Details.

Známé problémy nebo omezení

Zde najdete časté chyby sestavení, které se mohou objevit v protokolech sestavení, i obecné problémy a jejich řešení.

Požadavek na název Workeru

✘ [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.

Při propojování repozitáře Git s vaším projektem Workers musí zadaný název Workeru v Cloudflare dashboardu odpovídat name argument v konfiguračním souboru Wrangleru umístěném ve zadaném kořenovém adresáři. Pokud se neshoduje, upravte pole name v konfiguračním souboru Wrangleru tak, aby odpovídalo názvu Workeru na dashboardu.

Systém sestavení používá name argument v konfiguračním souboru Wrangleru, aby se určilo, který Worker se má nasadit do globální sítě Cloudflare. Tento požadavek zajišťuje shodu mezi názvem Workeru na dashboardu a nasazeným Workerem.

Chybí konfigurační soubor Wrangleru

✘ [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.

Pokud se tato chyba zobrazí, v kořenovém adresáři pravděpodobně chybí konfigurační soubor Wrangler. Přejděte do Nastavení > Sestavit > Konfigurace buildu pro aktualizaci kořenového adresáře, nebo přidejte Konfigurační soubor Wrangler do zadaného adresáře.

Nesprávné account_id

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

Pokud se tato chyba zobrazí, konfigurační soubor Wrangler pravděpodobně obsahuje account_id pro jiný účet. Odeberte account_id argument nebo jej aktualizujte hodnotou z vašeho účtu account_id, dostupné v Přehled Workers & Pages v části Podrobnosti o účtu.

Neaktuální API token

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.

Rozevírací nabídka API Token v nastavení Build Configuration může zobrazovat neplatné tokeny, které byly upraveny, smazány nebo rotovány. Pokud kvůli neplatnému tokenu narazíte na chybu, vytvořte nový API Token a vyberte ho pro sestavení.

Vypršel časový limit sestavení

Build was timed out

Maximální doba trvání sestavení je 20 minut. Pokud sestavení tento čas překročí, bude ukončeno a zobrazí se výše uvedený chybový protokol. Další podrobnosti najdete v Limity Workers Builds.

Problémy s integrací Git

Pokud narážíte na chyby související s integrací Git, zkuste odebrat přístup k GitHub nebo GitLab integraci z Cloudflare a poté znovu nainstalujte GitHub nebo GitLab integrace.

Pro další podporu

Pokud objevíte další problémy nebo chcete poskytnout zpětnou vazbu, ozvěte se nám v Cloudflare Developers Discord.