ThunderHosting

Mit Webhook bei Push deployen

GitHub, GitLab, Gitea oder Forgejo verbinden, damit jeder Push auf Ihren Branch die App deployt.

Mit einem Webhook deployt jeder Push auf Ihren Branch die App von selbst: Dash holt den Code und startet die App neu.

1. URL und Secret kopieren

Öffnen Sie den Tab Deploy der App. Speichern Sie zuerst das Repository; danach zeigt die Karte Webhook die Payload-URL und das Secret. Lassen Sie «Bei Push deployen» eingeschaltet.

GitHub

  1. Im Repository: Settings → Webhooks → Add webhook.
  2. Payload URL: die URL aus Dash. Content type: application/json.
  3. Secret: das Secret aus Dash.
  4. Wählen Sie «Just the push event» und klicken Sie auf Add webhook. GitHub sendet einen Test-Ping; er wird als zugestellt angezeigt.

GitLab

  1. Im Projekt: Settings → Webhooks → Add new webhook.
  2. URL: die URL aus Dash. Secret token: das Secret aus Dash.
  3. Trigger: Push events, dann auf Add webhook klicken.

Gitea und Forgejo

  1. Im Repository: Settings → Webhooks → Add webhook → Gitea (oder Forgejo).
  2. Target URL: die URL aus Dash, Content type application/json, Secret: das Secret aus Dash.
  3. Bei Push-Events auslösen und speichern.

Andere Dienste

Jeder Dienst und jedes Skript kann deployen, indem es eine POST-Anfrage mit dem Secret im Header X-Deploy-Token sendet:

bash
curl -X POST "WEBHOOK_URL" \
  -H "X-Deploy-Token: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"ref":"refs/heads/main"}'

Behandeln Sie das Secret wie ein Passwort. Gelangt es nach aussen, klicken Sie im Tab Deploy auf Neues Webhook-Secret und passen Sie den Webhook im Repository an.

Was bei einem Push passiert

  • Nur Pushes auf den eingestellten Branch deployen; andere Branches und Ereignisse werden ignoriert.
  • Kurz aufeinanderfolgende Pushes werden zu einem Deploy zusammengefasst.
  • Ein pausiertes Gratis-Paket deployt erst, wenn Sie es bestätigt haben.
  • Der Verlauf im Tab Deploy zeigt jeden Deploy mit Commit, Nachricht und Log.