Agile Developer Hilfe-Center › Agile Deploy

Projekteinstellungen: Framework, Befehle und Crons

Wie Agile Deploy Ihr Projekt erkennt, wann Sie Befehle selbst setzen sollten und wie geplante Aufrufe funktionieren.

Wo finde ich die Einstellungen?

Beim Anlegen im Schritt Konfigurieren, danach im Projekt unter dem Tab Einstellungen. Änderungen gelten ab dem nächsten Deployment.

  • Projektname: Beim Anlegen entsteht daraus Ihre Adresse unter agiledeploy.app.
  • Produktionsbranch: Pushes auf diesen Branch gehen live, alle anderen werden Vorschauen.
  • Framework: Automatisch erkennen, Next.js, Node.js, Vite, Statische Seite, Python oder Dockerfile.
  • Stammverzeichnis: nur bei Monorepos nötig, zum Beispiel apps/web. Leer bedeutet Wurzel des Repositorys.

Befehle

Unter Befehle tragen Sie Installieren, Bauen, Starten und Ausgabeordner (statisch) ein. Lassen Sie die Felder leer, erkennt Agile Deploy die Befehle automatisch. Eigene Angaben haben Vorrang.

So erkennt Agile Deploy Ihr Projekt

  • Node.js: Abhängigkeiten installiert Agile Deploy mit npm, pnpm oder yarn, je nach Lockfile bzw. Feld packageManager. bun wird nicht unterstützt.
  • Next.js: Build-Skript aus der package.json, Start mit dem Start-Skript bzw. next start.
  • Vite und andere statische Builds: Ausgabeordner ist dist, bei SvelteKit und Create React App build. Sonst tragen Sie ihn selbst ein.
  • Python: requirements.txt, pyproject.toml oder Pipfile mit Pipfile.lock. Der Startbefehl kommt aus einer Procfile-Zeile web: oder aus der Erkennung von FastAPI, Flask und Django.
  • Dockerfile: Dockerfile im Stammverzeichnis. Liegt es woanders, setzen Sie den Pfad über die API (Feld dockerfile).
  • Statische Seite: index.html im Stammverzeichnis.

Liegt neben dem Dockerfile eine nutzbare package.json, baut die automatische Erkennung das Projekt als Node.js. Wählen Sie dann Dockerfile als Framework.

Worauf Ihre App achten muss

  • Server-Apps müssen auf 0.0.0.0 und auf dem Port aus der Umgebungsvariable PORT hören. Nach dem Build startet Agile Deploy die App einmal zur Probe.
  • Aus dem Quelltext gebaute Apps laufen mit schreibgeschütztem Dateisystem. Nur /tmp ist beschreibbar. Bei eigenem Dockerfile entscheidet Ihr Image.
  • Bei Flask und Django nehmen Sie gunicorn in die Abhängigkeiten auf. Sonst startet der Entwicklungsserver, und das Build-Log warnt davor.

Crons

Geplante Aufrufe tragen Sie in der Datei vercel.json Ihres Repositorys ein, Zeiten in UTC:

"crons": [{ "path": "/api/cron/aufraeumen", "schedule": "0 4 * * *" }]

Das gilt ab dem nächsten Deployment. Agile Deploy ruft den Pfad auf der aktuellen Produktion auf. Ist die Umgebungsvariable CRON_SECRET gesetzt, kommt sie als Authorization: Bearer mit.

Im Tab Crons sehen Sie Pfad, Zeitplan und letzten Lauf. Mit Jetzt ausführen starten Sie einen Aufruf von Hand.

Projekt löschen

Unter dem Tab Einstellungen im Bereich Projekt löschen. Zur Bestätigung geben Sie den Projektnamen ein. Das lässt sich nicht rückgängig machen.

  • Wird gelöscht: Deployments, Apps und Domains des Projekts, der Webhook beim Git-Anbieter und alle Datenbanken samt Sicherungen, die nur dieses Projekt nutzt.
  • Bleibt erhalten: Datenbanken, die weitere Projekte nutzen, S3-Buckets und Ihr Repository. Buckets löschen Sie bei Bedarf unter Datenbanken & S3.

Löschen dürfen Team-Admins und die Person, die das Projekt angelegt hat. Hat das Projekt eigene Datenbanken, dürfen es nur Team-Admins löschen.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 1. November 2026

Weitere Artikel zu Agile Deploy

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.