Nasazení webu na Cloudflare Pages

Účel

Návod popisuje, jak nasadit statický web na Cloudflare Pages pomocí nativní integrace s GitHubem — bez GitHub Actions, bez API tokenů a bez extra konfigurace. Cloudflare Pages si sám hlídá větev main a po každém commitu nebo merge automaticky nasadí aktuální obsah.

Kdy tento postup použít

Vhodné pro menší a středně velké projekty se statickým webem, kde není potřeba oddělená preview a production větev ani vlastní build pipeline. Nasazuje se vždy z main.

Předpoklady

Přístup do Cloudflare účtu NITTIN (sekce Workers & Pages)
Přístup do GitHub repozitáře projektu (stačí read přístup pro Cloudflare, admin pro nastavení)
Znalost cesty ke statickým souborům v repozitáři (např. src/web)

Postup

Vytvoř novou Pages aplikaci v Cloudflare

V Cloudflare dashboardu přejdi na Workers & Pages → Create application → Pages. Zvol možnost Connect to Git a autorizuj přístup ke GitHubu. Vyber repozitář projektu a klikni na Begin setup.

🔧 Cloudflare Dashboard
Nastav zdrojovou větev a kořenový adresář

V sekci Build settings proveď tato nastavení:
- Production branch: main
- Root directory: src/web (nebo cesta ke složce se statickými soubory)
- Build command: ponech prázdné — web je čisté HTML, žádný build není potřeba
- Build output directory: ponech prázdné
🔧 Cloudflare Dashboard
Potvrď a spusť první deployment

Klikni na Save and Deploy. Cloudflare okamžitě nasadí aktuální stav větve main. Průběh deploymentu vidíš přímo v dashboardu pod záložkou Deployments.

🔧 Cloudflare Dashboard

Hotovo

Od teď se každý commit nebo merge do větve main automaticky nasadí na Cloudflare Pages — bez dalšího zásahu. Stav deploymentu vidíš v Cloudflare dashboardu pod záložkou Deployments.

Potřebuješ oddělenou preview a production větev?

Pokud projekt vyžaduje více prostředí (staging + produkce) nebo vlastní build pipeline, použij místo tohoto postupu GitHub Actions s Wrangler CLI. Tento přístup vyžaduje nastavení API tokenu a GitHub secrets, ale dává plnou kontrolu nad tím, co a kdy se nasadí.

Časté problémy

Deployment proběhl, ale web zobrazuje chybnou stránku nebo 404 — ověř, že Root directory v nastavení projektu odpovídá skutečné cestě ke statickým souborům (src/web, nikoli ./src/web ani kořen repozitáře).
Cloudflare nasadí prázdnou stránku — složka nastavená jako Root directory musí obsahovat index.html přímo v kořeni, ne ve vnořené podsložce.
Push do main deployment nespustil — zkontroluj v Cloudflare Pages → Settings → Builds & deployments, že je Production branch skutečně nastavena na main.

Související

Changelog

Verze	Datum	Autor	Změny
v1.1	2026-06-25	Pavel Hess	Přepsáno na nativní Cloudflare Pages integraci — bez GitHub Actions, API tokenu a separátní větve
v1.0	2026-06-25	Pavel Hess	Prvotní verze (GitHub Actions + Wrangler)