d4rkbot/docs/auto-deploy.md

Auto-Deploy statt „Pull and redeploy"

Bisher: pushen, in Portainer einloggen, Stack suchen, Pull and redeploy klicken. Das geht automatisch — zwei Wege, je nachdem wie viel du willst.

Weg 1: Portainer-Webhook (2 Minuten, kein Runner nötig) ← empfohlen

Portainer kann einen Stack per HTTP-Aufruf neu ausrollen. Gitea ruft diese Adresse nach jedem Push auf, fertig.

In Portainer:

1. Stack ecobot öffnen → Reiter Editor
2. Automatic updates einschalten, Methode Webhook
3. Die erzeugte Webhook-URL kopieren (Form: https://portainer.../api/stacks/webhooks/<uuid>)

In Gitea:

1. Repo d4rkbot → Einstellungen → Webhooks → Webhook hinzufügen → Gitea
2. Ziel-URL: die kopierte Portainer-Adresse
3. HTTP-Methode POST, Inhaltstyp application/json
4. Trigger: Push-Ereignisse, Branch-Filter main
5. Speichern, dann Zustellung testen — Portainer sollte den Stack neu bauen

Der Stack muss aus dem Git-Repository deployed sein (nicht aus einem hochgeladenen Compose-Text), damit Portainer den neuen Stand ziehen kann. „Re-pull image" bleibt aus — das Image wird ja lokal gebaut.

Weg 2: Gitea Actions (prüft den Code vor dem Deploy)

Der Workflow in .gitea/workflows/deploy.yml installiert die Abhängigkeiten, prüft alle Server-Dateien auf Syntaxfehler, baut das Frontend — und stößt erst dann das Redeploy an. Kaputter Code geht damit gar nicht erst live.

Voraussetzung: ein Act-Runner. In deiner Instanz sind Actions aktiviert, aber ohne Runner passiert nichts. Einrichten als zusätzlicher Container:

# docker-compose.yml für den Runner
services:
  runner:
    image: gitea/act_runner:latest
    restart: always
    environment:
      GITEA_INSTANCE_URL: https://git.d4rkst3r.de
      GITEA_RUNNER_REGISTRATION_TOKEN: <Token aus Gitea>
      GITEA_RUNNER_NAME: d4rk-runner
      GITEA_RUNNER_LABELS: ubuntu-latest:docker://node:22-bookworm
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./runner-data:/data

Den Registrierungs-Token findest du unter Site-Administration → Actions → Runner → Runner erstellen (oder pro Repo unter Einstellungen → Actions).

Secret hinterlegen: Repo → Einstellungen → Actions → Secrets → PORTAINER_WEBHOOK mit der Portainer-Adresse. Fehlt das Secret, läuft nur die Prüfung und der Deploy-Schritt wird übersprungen.

Welchen nehmen?

	Weg 1 (Webhook)	Weg 2 (Actions)
Aufwand	2 Minuten	Runner-Container aufsetzen
Prüft den Code	nein	ja (Syntax + Frontend-Build)
Läuft ohne Zusatzdienst	ja	nein

Fang mit Weg 1 an. Weg 2 lohnt sich, sobald du Tests hast oder mehrere Leute pushen — dann verhindert er, dass ein kaputter Stand live geht.