justin
821ff9b9ef
Adds a Kubernetes-ZVMA companion to the existing Windows-ZVM recipe:
- scripts/examples/zerto-zvma-send.ps1 - Zerto-side sender for both
pre and post phases, packages the Zerto* env vars into a structured
JSON body and POSTs to a {phase}-templated webhook URL.
- scripts/examples/zerto-receiver-notify.ps1 - server-side receiver
that posts a Slack/Teams notification, with phase-aware formatting
and ZertoForce highlighted on pre.
- scripts/examples/zerto-receiver-vm-healthcheck.ps1 - server-side
receiver that pings + port-probes each VM in VmDisplayNames after
failover and writes a per-run JSON report.
- scripts/examples/send-env-vars.ps1 + save-env-vars.ps1 - generic
env-dump client/receiver pair (the diagnostic that surfaced what
the ZVMA scripts-service container exposes).
- docs/recipes/zerto-zvma-pre-post.md - full walkthrough mirroring
the existing Windows-ZVM recipe's structure.
- README.md and docs/README.md - link the new recipe and examples.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
34 lines
2.1 KiB
Markdown
34 lines
2.1 KiB
Markdown
# Webhook Server documentation
|
|
|
|
Webhook Server is a Windows service that runs a script (PowerShell, cmd, or any executable) when an HTTP request hits a URL you choose. It's designed for sysadmins who want to wire a tool like **Zerto pre/post scripts**, GitHub Actions, a monitoring system, or a backup tool into a Windows-side automation step — without writing a custom listener every time.
|
|
|
|
## New here? Start with these
|
|
|
|
1. [Concepts](concepts.md) — five-minute read on what a webhook is and how this server uses one
|
|
2. [Installation](installation.md) — download, install, first endpoint
|
|
3. [Recipe: Zerto failover post-script → DNS + service checks](recipes/zerto-pre-post-scripts.md) — the canonical reason this exists
|
|
|
|
## Topical
|
|
|
|
- [Upgrading](upgrading.md)
|
|
- [Uninstalling](uninstalling.md)
|
|
- [Run As modes — when to use which](runas-modes.md)
|
|
- [Service account & Active Directory](service-account-and-ad.md)
|
|
- [Network & security](network-and-security.md)
|
|
- [Troubleshooting](troubleshooting.md)
|
|
|
|
## Recipes (cookbook style)
|
|
|
|
- [Zerto failover post-script → DNS + service checks](recipes/zerto-pre-post-scripts.md) ← canonical use case (Windows ZVM)
|
|
- [Zerto ZVMA (Kubernetes) pre/post → notify + VM health check](recipes/zerto-zvma-pre-post.md) — same pattern for the in-cluster scripts-service
|
|
- [GitHub-style HMAC-signed webhook](recipes/github-style-hmac.md)
|
|
- [Pop UI on the user's desktop](recipes/ui-on-desktop.md)
|
|
|
|
The flagship Zerto recipe ships with a ready-to-use Zerto-side post-script at [`scripts/examples/zerto-post-failover.ps1`](../scripts/examples/zerto-post-failover.ps1). The ZVMA recipe ships with [`zerto-zvma-send.ps1`](../scripts/examples/zerto-zvma-send.ps1) (sender) plus [`zerto-receiver-notify.ps1`](../scripts/examples/zerto-receiver-notify.ps1) and [`zerto-receiver-vm-healthcheck.ps1`](../scripts/examples/zerto-receiver-vm-healthcheck.ps1) (receivers).
|
|
|
|
## Reference
|
|
|
|
- [GitHub repo](https://github.com/recklessop/webhook-server)
|
|
- [Latest release](https://github.com/recklessop/webhook-server/releases/latest)
|
|
- [Issue tracker](https://github.com/recklessop/webhook-server/issues)
|