← Cloudflare Pages / pages / configuration

Náhledová nasazení

Náhledová nasazení vám umožňují prohlédnout si nové verze projektu, aniž byste je nasazovali do produkce. Náhledová nasazení zobrazíte takto:

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

   Přejděte na Workers & Pages ↗

2. Vyberte projekt a najděte nasazení, které chcete zobrazit.

Pokaždé, když ve svém repozitáři na GitHubu otevřete nový pull request, Cloudflare Pages vytvoří jedinečnou náhledovou adresu URL, která se bude aktualizovat s každým dalším commitem do dané větve. Platí to však pouze v případě, že pull request vznikl přímo v daném repozitáři.

Pokud máte například repozitář s názvem user-example připojeno k Pages, získáte tak user-example.pages.dev subdoménu. Pokud main je vaše výchozí větev, pak se všechny commity do main větev aktualizuje vaši user-example.pages.dev obsah, stejně jako jakékoli vlastní domény připojený k projektu.

Během vývoje user-example, můžete odeslat nové změny do development větev, například.

V tomto příkladu po vytvoření nového development větev Pages automaticky vygeneruje pro tyto změny preview nasazení, dostupné na 373f31e2.user-example.pages.dev - kde 373f31e2 je náhodně vygenerovaný hash.

Každá nová vytvořená větev získá nový, náhodně vygenerovaný hash před vaším pages.dev subdoména.

Jakékoli další změny v development větev bude nadále aktualizovat tuto 373f31e2.user-example.pages.dev náhledovou adresu, dokud development větev je sloučena s main produkční větev.

Jakékoli vlastní domény a rovněž váš user-example.pages.dev web nebude náhledovými nasazeními ovlivněn.

Můžete použít Cloudflare Access a spravujte přístup k náhledovým nasazením. Tyto URL adresy nasazení jsou ve výchozím nastavení veřejné. Zapnutím zásady Access omezíte zobrazení nasazení projektu pouze na váš účet Cloudflare.

Jakmile je tato funkce zapnutá, můžete nastavení účtu pro více uživatelů a umožněte ostatním členům týmu prohlížet preview nasazení.

Preview nasazení jsou ve výchozím nastavení povolena a veřejně dostupná. V nastavení projektu můžete vyžadovat, aby se návštěvníci před zobrazením preview nasazení ověřili. Díky tomu můžete přístup k těmto preview nasazením omezit pouze na členy týmu, organizaci nebo kohokoli dalšího, koho určíte pomocí Zásady Access.

Chcete-li chránit svá náhledová nasazení pomocí Cloudflare Access:

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 Nastavení > Obecné > a vyberte Povolit zásadu přístupu.

Mějte na paměti, že tímto ochráníte pouze svá náhledová nasazení (například 373f31e2.user-example.pages.dev a všechny ostatní náhodně generované náhledové odkazy) a nikoli vaši *.pages.dev doména nebo vlastní doména.

Po publikování náhledového nasazení mu je přiřazena jedinečná adresa založená na hashi, například <hash>.<project>.pages.dev. Ty jsou atomické a lze je kdykoli v budoucnu navštívit. Pages však také vytváří alias pro git název větve a aktualizuje ho tak, aby alias vždy odkazoval na nejnovější commit dané větve.

Pokud například odešlete změny do development větev (která není přidružena k vašemu prostředí Production), Pages nasadí do abc123.<project>.pages.dev a alias development.<project>.pages.dev k němu. Novou práci pak můžete kdykoli odeslat do development větev, což vytvoří xyz456.<project>.pages.dev nasazení. V tomto okamžiku development.<project>.pages.dev alias odkazuje na xyz456 nasazení, ale abc123.<project>.pages.dev zůstává přístupný přímo.

Aliasy názvů větví se převádějí na malá písmena a nealfanumerické znaky se nahrazují spojovníkem, například fix/api větev vytvoří fix-api.<project>.pages.dev alias.

Chcete-li zobrazit aliasy větví v rámci projektu Pages, vyberte Zobrazit sestavení pro jakékoli náhledové nasazení. Podrobnosti o nasazení zobrazí všechny aliasy přiřazené k danému nasazení.

Alias náhledu můžete k vlastní doméně připojit tak, že přidání vlastní domény k větvi ↗.

Chcete-li vyčistit stará náhledová nasazení, můžete je odstranit pomocí Wrangleru:

npx wrangler pages deployment delete <DEPLOYMENT_ID> --project-name <PROJECT_NAME>

Použijte --force (nebo -f) pro přeskočení potvrzovací výzvy a vynucené odstranění aliasovaných nasazení. ID nasazení zjistíte spuštěním wrangler pages deployment list.

Pro zdravý profil SEO je zásadní zabránit tomu, aby vyhledávače na webu nacházely duplicitní obsah. Náhledová nasazení jsou navržena jako přesná replika produkčního prostředí, a proto tuto situaci ze své podstaty vytvářejí. Cloudflare Pages proto ve výchozím nastavení zajišťuje, že tyto dočasné náhledy neohrozí vaše umístění ve vyhledávání.

Každé preview nasazení vygenerované Cloudflare Pages ve výchozím nastavení obsahuje HTTP hlavičku odpovědi X-Robots-Tag: noindex. Tato hlavička dává vyhledávacím robotům jasný pokyn, aby stránku ignorovali a nezahrnovali ji do výsledků vyhledávání.

Snadno můžete ověřit, že vaše náhledová nasazení jsou správně nakonfigurována tak, aby blokovala indexování. Spusťte v terminálu následující příkaz curl a nahraďte zástupný text svou jedinečnou náhledovou URL adresou:

curl -I https://<your-preview-url>.pages.dev

Zkontrolujte výstup a ověřte, zda obsahuje řádek x-robots-tag: noindex, což potvrdí, že váš preview web není indexován.