← Cloudflare Pages / pages / configuration
Deploy Hooks
Pomocí Deploy Hooks můžete spouštět nasazení na základě jiných zdrojů událostí než commitů ve vašem zdrojovém repozitáři. Každý zdroj události může získat vlastní jedinečnou URL adresu, na kterou budou přicházet požadavky HTTP POST pro zahájení nových nasazení. Tato funkce umožňuje propojit Pages s novými i stávajícími pracovními postupy. Můžete například:
- Automaticky nasazuje nová sestavení při každé změně obsahu v Headless CMS
- Implementujte plně přizpůsobený pipeline CI/CD, který nasazuje pouze za požadovaných podmínek
- Naplánujte si CRON trigger, který bude aktualizovat váš web v pravidelných intervalech.
Chcete-li vytvořit Deploy Hook:
-
V dashboardu Cloudflare přejděte na Workers & Pages stránce.
Přejděte na Workers & Pages ↗ -
Vyberte svůj projekt Pages.
-
Přejděte na Nastavení > Builds a vyberte Přidejte deploy hook a zahajte konfiguraci.
Potřebné parametry
Chcete-li nakonfigurovat Deploy Hook, musíte zadat dva klíčové parametry:
- Název deploy hooku: jedinečný identifikátor pro váš Deploy Hook (například
contentful-site) - Větev k sestavení: větev repozitáře, kterou by měl váš Deploy Hook sestavit
Používání vašeho Deploy Hook
Jakmile je vaše konfigurace dokončená, je jedinečná URL adresa Deploy Hooku připravená k použití. Uvidíte jak URL adresu, tak úryvek kódu s POST požadavkem, který můžete zkopírovat.
Pokaždé, když je na váš Deploy Hook odeslán požadavek, spustí se nové sestavení. Přečtěte si Zdroj sloupec ve svém logu nasazení, kde zjistíte, které nasazení bylo spuštěno pomocí Deploy Hook.
Bezpečnostní aspekty
Deploy Hooks jsou jedinečně propojené s vaším projektem a k jejich použití není potřeba žádné další ověření. Ačkoli to poskytuje naprostou flexibilitu, je důležité tyto URL adresy chránit stejně jako jakékoli důvěrné informace nebo tajný klíč aplikace.
Pokud máte podezření na neoprávněné použití Deploy Hook, měli byste Deploy Hook smazat a vygenerovat na jeho místo nový.
Integrace Deploy Hooks s běžnými CMS platformami
Každý poskytovatel CMS je jiný a nabízí odlišné způsoby integrace s Deploy Hooks služby Pages. Následující část obsahuje podrobný návod pro několik oblíbených platforem CMS.
Contentful
Contentful podporuje integraci s Cloudflare Pages prostřednictvím svého Webhooks funkci. V nastavení projektu Contentful přejděte do Webhooks, vytvořte nový Webhook a vložte svou jedinečnou adresu URL Deploy Hook do pole URL pole. Volitelně můžete určit události, které má Contentful Webhook předávat. Ve výchozím nastavení Contentful spouští nasazení Pages při jakékoli aktivitě v projektu, což může být až příliš časté. Můžete filtrovat konkrétní události, například Create, Publish a mnoho dalších.
Ghost
Svůj web Ghost můžete nakonfigurovat tak, aby spouštěl nasazení Pages, vytvořením nového Custom Integration. V nastavení svého webu Ghost vytvořte novou vlastní integraci (Custom Integration) v Integrace stránce.
Každá vytvořená vlastní integrace může mít více webhooky k němu připojený. Nový webhook vytvoříte výběrem Přidat webhook a Web byl změněn (přestavění) jako Událost. Poté vložte svou jedinečnou adresu URL Deploy Hooku jako Cílová URL hodnotu. Jakmile tento webhook vytvoříte, vaše aplikace Cloudflare Pages se znovu nasadí pokaždé, když dojde ke změně na vašem webu Ghost.
Sanity
Na stránce Settings vašeho projektu Sanity vyhledejte Webhooks sekci a přidejte URL adresu Deploy Hook, jak je znázorněno níže. Webhook ve výchozím nastavení spustí váš Pages Deploy Hook pro všechny datové sady ve vašem projektu Sanity. Oznámení můžete filtrovat podle jednotlivých datových sad, například produkční (production), pomocí Dataset pole:
WordPress
WordPress můžete nakonfigurovat tak, aby spouštěl Pages Deploy Hook, instalací bezplatného WP Webhooks plugin. Ten obsahuje řadu triggerů, například Send Data on New Post, Send Data on Post Update a Send Data on Post Deletion, které vám všechny umožňují spouštět nová nasazení Pages při změně dat WordPress. V postranním panelu nastavení pluginu vyberte spouštěč a poté Add Webhook URL ↗, a vložte svou jedinečnou adresu URL Deploy Hook.
Strapi
V Strapi Admin Panelu můžete nastavit a nakonfigurovat webhooky, které vylepší práci s Cloudflare Pages. V Strapi Admin Panelu:
- Přejděte na Nastavení.
- Vyberte Webhooks.
- Vyberte Add New Webhook.
- V Název pole formuláře zadejte pro nový webhook jedinečný název.
- V URL pole formuláře vložte jedinečnou URL adresu Cloudflare Deploy Hook.
V administračním panelu Strapi můžete nastavit, aby se webhook spouštěl na základě událostí. Toto nastavení můžete upravit tak, aby se automaticky vytvořilo nové nasazení vašeho webu na Cloudflare Pages při vytvoření, aktualizaci nebo odstranění položky nebo mediálního souboru ve Strapi.
Nezapomeňte přidat konfiguraci webhooku do produkce ↗ aplikace Strapi, která pohání váš web na Cloudflare.
Storyblok
V nástroji Storyblok můžete nastavit a nakonfigurovat deploy hooks pro spouštění událostí. Ve svém prostoru Storyblok přejděte do Nastavení a přejděte dolů na Webhooks. Vložte svůj deploy hook do Publikace a zrušení publikace story pole a vyberte Save.