INTEGRITY Dokumentace

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:

Chcete-li vytvořit Deploy Hook:

  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í > Builds a vyberte Přidejte deploy hook a zahajte konfiguraci.

Přidejte deploy hook na dashboardu Cloudflare

Potřebné parametry

Chcete-li nakonfigurovat Deploy Hook, musíte zadat dva klíčové parametry:

  1. Název deploy hooku: jedinečný identifikátor pro váš Deploy Hook (například contentful-site)
  2. Větev k sestavení: větev repozitáře, kterou by měl váš Deploy Hook sestavit
Výběr názvu Deploy Hook a větve pro sestavení v Cloudflare dashboardu

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.

Kontrola nově vygenerované jedinečné URL adresy Deploy Hook

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.

Zjištění, 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.

Konfigurace Deploy Hooks se službou Contentful

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.

Konfigurace Deploy Hooks se službou 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:

Konfigurace Deploy Hooks se službou Sanity

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.

Konfigurace Deploy Hooks se službou WordPress

Strapi

V Strapi Admin Panelu můžete nastavit a nakonfigurovat webhooky, které vylepší práci s Cloudflare Pages. V Strapi Admin Panelu:

  1. Přejděte na Nastavení.
  2. Vyberte Webhooks.
  3. Vyberte Add New Webhook.
  4. V Název pole formuláře zadejte pro nový webhook jedinečný název.
  5. 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.

Konfigurace Deploy Hooks se službou Strapi

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.

Konfigurace Deploy Hooks se službou Storyblok