← Cloudflare Pages / pages / configuration

Ladění Pages

Při nastavování projektu Pages se můžete setkat s různými chybami, které vám brání web úspěšně nasadit. Tato příručka nabízí přehled některých běžných chyb a jejich řešení.

Chyby sestavení si můžete zkontrolovat v protokolu sestavení Pages. Přístup k protokolu sestavení:

1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

   Přejděte na Workers & Pages ↗

2. Vyberte svůj projekt Pages.

3. Přejděte na Deployments > Zobrazit podrobnosti > Protokol sestavení.

Případné chyby ve svém protokolu sestavení najdete v následujících částech.

Případné chyby v tomto kroku mohou být způsobené nesprávnou instalací během Git integrace.

Chcete-li to opravit v GitHubu:

1. Přihlaste se ke svému účtu GitHub.
2. Přejděte na Nastavení z ikony uživatele > najděte Aplikace v části Integrations.
3. Najděte Cloudflare Pages > Konfigurovat > přejděte dolů a vyberte Odinstalovat.
4. Znovu autorizujte svého uživatele nebo organizaci GitHub v Cloudflare dashboardu.

Chcete-li to opravit v GitLabu:

1. Přihlaste se ke svému účtu GitLab.
2. Přejděte na Předvolby z ikony uživatele > Aplikace.
3. Najděte Cloudflare Pages > přejděte dolů a vyberte Odvolat.

Mějte na paměti, že potřebujete roli Správce nebo vyšší, aby se repozitář úspěšně propojil, jinak sestavení selže.

Případné chyby v tomto kroku mohou být způsobené chybějícím Git Large File Storage (LFS). Své využití LFS zkontrolujte v GitHub ↗ a GitLab ↗ dokumentace.

Nezapomeňte také zkontrolovat konfiguraci submodulů v .gitmodules soubor v kořenovém adresáři. Tento soubor musí obsahovat jak path a url vlastnost.

Příklad platné konfigurace:

[submodule "example"]
	path = example/path
	url = git://github.com/example/repo.git

Příklad neplatné konfigurace:

[submodule "example"]
	path = example/path

nebo

[submodule "example"]
        url = git://github.com/example/repo.git

Případné chyby v tomto kroku mohou být způsobené chybným nastavením projektu Pages. Zkontrolujte svůj Build command, výstupní složku a proměnné prostředí, zda v nich není nesprávná konfigurace.

Případné chyby v tomto kroku mohou být způsobené nesprávnou konfigurací Pages Functions. Podívejte se na Funkce dokumentaci, kde najdete více informací o nastavení Functions.

Pokud Functions nepoužíváte, nebo jste ověřili, že konfigurace vašich Functions neobsahuje žádné chyby, projděte si Stránka stavu Cloudflare ↗ zda za selháním sestavení nestojí problém v síti Cloudflare.

Pokud je vaše vlastní doména proxována (s oranžovým mrakem) přes Cloudflare, budou platit nastavení vaší zóny, například ukládání do mezipaměti.

Pokud se potýkáte s tím, že se nový obsah nezobrazuje, přejděte do Pravidla > Page Rules v Cloudflare dashboardu a zkontrolujte, zda tam existuje Page Rule s Cache Everything povoleno. Pokud toto pravidlo existuje, odstraňte ho, protože Pages si správu cache zajišťuje sama.

Pokud se chyby objevují na vaší vlastní doméně, ale ne na pages.dev doména, přejděte na DNS > Záznamy v Cloudflare dashboardu a nastavte DNS záznam svého projektu na DNS Only (šedý mrak). Pokud chyba přetrvává, zkontrolujte konfiguraci své zóny.

Pokud váš vlastní doména se nepřesunul z Ověřování fázi v Cloudflare dashboardu, projděte si následující kroky pro ladění.

Pages používá HTTP ověření a při něm potřebuje zasáhnout HTTP endpoint. Pokud tomu stojí v cestě jiný produkt Cloudflare (například Access, přesměrování, Worker, atd.), nelze dokončit ověření.

Chcete-li si to ověřit, spusťte curl příkaz proti vaší doméně, který zasáhne /.well-known/acme-challenge/randomstring. Například:

curl -s -o /dev/null -D - https://example.com/.well-known/acme-challenge/randomstring

HTTP/2 302
date: Mon, 03 Apr 2023 08:37:39 GMT
location: https://example.cloudflareaccess.com/cdn-cgi/access/login/example.com?kid=...&redirect_url=%2F.well-known%2Facme-challenge%2F...
access-control-allow-credentials: true
cache-control: private, max-age=0, no-store, no-cache, must-revalidate, post-check=0, pre-check=0
server: cloudflare
cf-ray: 7b1ffdaa8ad60693-MAN

V příkladu výše přesměrováváte na Cloudflare Access (jak ukazuje Location hlavičky). V takovém případě musíte pro danou doménu vypnout Access, dokud nebude doména ověřena. Po ověření domény lze Access znovu zapnout.

Stejný postup budete muset provést i u pravidel přesměrování (Redirect Rules) nebo příkladu s Workerem.

Viz Řešení potíží s ověřením vlastnictví domény (DCV) článek, kde najdete další podrobnosti.

Pokud HTTP validaci nic neblokuje, pravděpodobně vám chybí záznamy CAA (Certification Authority Authorization). K tomu obvykle dochází, pokud jste vypnuli Universal SSL nebo použijte externího poskytovatele.

Chcete-li si to ověřit, spusťte dig na apexu vlastní domény (nebo zóny, pokud jde o zóna subdomény). Například:

dig CAA example.com

; <<>> DiG 9.10.6 <<>> CAA example.com
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 59018
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
;; QUESTION SECTION:
;example.com.		IN	CAA

;; ANSWER SECTION:
example.com.	300	IN	CAA	0 issue "amazon.com"

;; Query time: 92 msec
;; SERVER: 127.0.2.2#53(127.0.2.2)
;; WHEN: Mon Apr 03 10:15:51 BST 2023
;; MSG SIZE  rcvd: 76

Ve výše uvedeném příkladu je pouze jediný záznam CAA, který umožňuje společnosti Amazon vydávat certifikáty.

Chcete-li to vyřešit, musíte přidat následující záznamy CAA, které povolují všem certifikačním autoritám (CA), jež Cloudflare používá k vydávání certifikátů:

example.com.            300     IN      CAA     0 issue "letsencrypt.org"
example.com.            300     IN      CAA     0 issue "pki.goog; cansignhttpexchanges=yes"
example.com.            300     IN      CAA     0 issue "ssl.com"
example.com.            300     IN      CAA     0 issuewild "letsencrypt.org"
example.com.            300     IN      CAA     0 issuewild "pki.goog; cansignhttpexchanges=yes"
example.com.            300     IN      CAA     0 issuewild "ssl.com"

A pozastavení zóny zabrání tomu, aby Pages přidaly vlastní doménu pro hostname v zóně s aktivním zone holdem.

Chcete-li přidat vlastní doménu pro hostname se zone hold, dočasně uvolnění podržení zóny během procesu nastavení vlastní domény.

Jakmile je nastavení vlastní domény úspěšně dokončeno, můžete obnovit pozastavení zóny.

Pokud se zobrazí 404 chybu na kořenové pages.dev URL (example.pages.dev), pravděpodobně vám chybí index.html soubor ve vašem projektu.

Nahrajte index.html soubor, čímž tento problém vyřešíte.

Pokud potřebujete další pomoc s chybami při sestavení, obraťte se na svůj account team Cloudflare (Enterprise) nebo si přečtěte Support Center s pokyny, jak kontaktovat podporu Cloudflare.

Dotazy můžete pokládat také v sekci Pages na Cloudflare Developers Discord ↗.