New — Iris AI drafts your firewall, routing & rate-limit rules. Explore AI features →
Changelog
Apps

Git deploys: deploy hooks, cancel a build, skip rules, GitHub statuses

Rebuild from your CMS with a deploy hook, cancel a build you don't want, skip pushes by commit message or changed files, and see every build on its commit.

Git deploys: deploy hooks, cancel a build, skip rules, GitHub statuses

Every push to the production branch built, even a README fix, and a queued build couldn't be stopped. A CMS had no way to ask for a rebuild, and GitHub didn't show what became of a commit.

Apps that deploy from Git now have deploy hooks, Cancel build, skip rules and path filters, and they show their builds on GitHub. In the Deploys list above, Tomás canceled the build of a half-finished pricing page, and his next push went live.

The Push to deploy card: Build only when these change lists the src and public folders and astro.config.mjs, Ignore changes to lists README files and the .github folder, and Show builds on GitHub is on
Acme Labs' docs site builds from acme-labs/docs. Priya limits builds to the site's sources, which is why the README fix in the list above didn't build. The typo fix said [skip ci] in its commit message.
The Deploy hooks card: Headless CMS publish and Nightly rebuild (changelog feed) on main, each with the start of its URL and its last call
Their headless CMS calls a deploy hook whenever an editor publishes a guide, and a scheduler calls another one each night. A hook's URL is shown once, when you add it; the list keeps its first characters, its branch and its last call.

What changed

  • Deploy hooks. A secret URL that deploys the app when a CMS, a scheduler or a CI job sends it a POST. It builds the latest commit of its branch: the production branch deploys to production, another branch builds a preview.
  • Cancel build. In a queued or building deploy's menu. The live version doesn't change, and a newer push also replaces the queued builds of its branch.
  • Skip rules. [skip ci], [ci skip], [no ci], [skip ngris] or [ngris skip] in a push's last commit message, in any case, and the push builds nothing.
  • Path filters. Build only when certain files change, or ignore others. When ngris can't tell which files a push changed, it builds. Redeploy and deploy hooks always build.
  • Builds on GitHub. For apps imported through the ngris GitHub App, each commit shows its build as ngris/<app name>, from queued to deployed, failed or canceled, with a link to the deploy. An owner approves the permission once in GitHub, and you can turn it off per app.

Get started

  1. In the dashboard, go to Gateway → Applications, open a Git app and its Settings tab.
  2. In Push to deploy, fill in Build only when these change or Ignore changes to, keep Show builds on GitHub on, and click Save Git settings.
  3. In Deploy hooks, name the hook, click Add deploy hook and copy its URL into the service that will call it.
  4. To stop a build, open its menu on the Deploys tab and choose Cancel build.
  5. Read the docs: Deploy hooks, Cancel a deploy, Skip rules, Path filters and Builds on GitHub.

Read the docs

Ask an AI to summarise this page
Deploy
App hosting Edge functions Domains & certificates
Connect
Secure tunnels API gateway Multi-region edge
Protect
Bot protection & challenge WAF & firewall Edge login
Observe & AI
Monitoring Inspector & replay Iris AI MCP server AI Gateway
Developers
Developer tools Docs ngrok policy converter Blog Changelog
Compare
Ngris vs ngrok Ngris vs Cloudflare Tunnel Ngris vs Vercel Ngris vs Netlify Expose localhost guide
More
Solutions Pricing Enterprise Sign in Get Started Free