← Cloudflare Workers / workers / versions-and-deployments

Preview URLs

Preview URLs vám umožňují zobrazit náhled nových verzí Workeru bez nasazení do produkčního prostředí.

Existují dva typy náhledových URL:

• Verzované URL adresy náhledu: Jedinečná adresa URL automaticky vygenerovaná pro každou novou verzi vašeho Workeru.
• Aliased Preview URLs: Statický, člověku srozumitelný alias, který můžete ručně přiřadit verzi Workeru.

Oba typy preview URL mají následující formát: <VERSION_PREFIX OR ALIAS>-<WORKER_NAME>.<SUBDOMAIN>.workers.dev.

Preview URLs mohou být:

• Začleněno do pipeline CI/CD, což umožňuje automatické vytváření náhledových prostředí pro každý pull request.
• Slouží ke spolupráci mezi týmy při testování změn kódu v ostrém prostředí a ověřování aktualizací.
• Slouží k testování nových API endpointů, ověřování formátů dat a zajištění zpětné kompatibility se stávajícími službami.

Při testování funkcí výkonu nebo zabezpečení na úrovni zóny pro danou verzi doporučujeme použít přepisy verzí aby se uplatnila nastavení výkonu a zabezpečení vaší zóny.

Pokaždé, když vytvoříte nový verze vašeho Workeru se automaticky vygeneruje jedinečná statická náhledová URL verze. Tyto URL adresy používají prefix verze a mají formát <VERSION_PREFIX>-<WORKER_NAME>.<SUBDOMAIN>.workers.dev.

Nové verze Workeru se vytvářejí spuštěním:

• wrangler deploy
• wrangler versions upload
• Nebo když provedete úpravy přes Cloudflare dashboard

Pokud jsou povoleny Preview URLs, jsou veřejné a dostupné ihned po vytvoření verze.

wrangler versions upload příkaz nahraje nový verze vašeho Workeru a vrátí náhledovou URL pro každou nahranou verzi.

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

   Přejděte na Workers & Pages ↗

2. Vyberte svůj Worker.

3. Přejděte na Deployments kartě a najděte verzi, kterou chcete zobrazit.

Aliased Preview URLs vám umožňují přiřadit konkrétní verzi Workeru trvalý a čitelný alias. Hodí se k odkazování na stabilní náhledy napříč mnoha verzemi (například pro sdílení připravované, ale stále aktivně vyvíjené nové funkce). Běžným postupem je přiřadit alias větvi, na které právě pracujete. Tyto typy preview URLs se řídí stejným vzorem jako ostatní preview URLs: <ALIAS>-<WORKER_NAME>.<SUBDOMAIN>.workers.dev

Aliasy lze vytvořit během versions upload, poskytnutím --preview-alias příznak s platným názvem aliasu:

wrangler versions upload --preview-alias staging

Výsledný alias by byl přiřazen k této verzi a okamžitě dostupný na adrese: staging-<WORKER_NAME>.<SUBDOMAIN>.workers.dev

• Aliasy lze vytvořit pouze při nahrávání verze.
• Aliasy smí obsahovat pouze malá písmena, číslice a pomlčky.
• Aliasy musí začínat malým písmenem.
• Alias a název Workeru dohromady (spojené pomlčkou) nesmí kvůli limitům DNS štítků přesáhnout 63 znaků.
• Uchovává se pouze 1000 naposledy nasazených aliasů. Když je nad tento limit vytvořen nový alias, nejstarší nasazený alias se smaže.

Je-li povoleno, Preview URLs jsou veřejně dostupné. Chcete-li po návštěvnících vyžadovat přihlášení před přístupem k Preview URLs, použijte Cloudflare Access.

Access dokáže chránit náhledy jednoho Workeru nebo všech Workerů v účtu. Chránit můžete jak produkční, tak náhledová nasazení.

Chcete-li ve svém Workeru použít údaje o přihlášeném uživateli, přečtěte si identita uživatele z ověřeného JWT nebo z /cdn-cgi/access/get-identity koncový bod.

Poznámka:

• Preview URLs jsou ve výchozím nastavení zapnuté, pokud workers_dev je zapnuté.
• Preview URLs jsou ve výchozím nastavení vypnuté, pokud workers_dev je zakázána.
• Zakázání Preview URLs zakáže směrování na verzované i aliasované Preview URL adresy.

Chcete-li přepínat Preview URLs pro Worker:

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

   Přejděte na Workers & Pages ↗

2. V Přehled, vyberte svého Workera.

3. Přejděte na Nastavení > Domains & Routes.

4. U Preview URLs klikněte na Povolit nebo Zakázat.

5. Potvrďte svou akci.

Chcete-li přepínat Preview URLs pro Worker, zahrňte do souboru Wrangler daného Worker jedno z následujícího:

{
	"preview_urls": true
}

preview_urls = true

{
	"preview_urls": false
}

preview_urls = false

Pokud není zadáno, preview_urls = workers_dev je výchozí hodnota.

• Preview URLs se negenerují pro Workery, které implementují Durable Object, včetně Containers a Sandbox Workers. Možnosti testování Containers najdete v Nasaďte Containers.
• Preview URLs se v současnosti negenerují pro Workers for Platforms uživatelské Workers. Jde o dočasné omezení, na jehož odstranění pracujeme.
• Preview URLs aktuálně nelze nakonfigurovat tak, aby fungovaly na jiné subdoméně než workers.dev.
• Protokoly pro Preview URLs aktuálně zobrazit nelze, a to včetně Workers Logs, Wrangler tail a Logpush.