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 Appbuild. Sonst tragen Sie ihn selbst ein. - Python:
requirements.txt,pyproject.tomloderPipfilemitPipfile.lock. Der Startbefehl kommt aus einerProcfile-Zeileweb:oder aus der Erkennung von FastAPI, Flask und Django. - Dockerfile:
Dockerfileim Stammverzeichnis. Liegt es woanders, setzen Sie den Pfad über die API (Felddockerfile). - Statische Seite:
index.htmlim 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.0und auf dem Port aus der UmgebungsvariablePORThören. Nach dem Build startet Agile Deploy die App einmal zur Probe. - Aus dem Quelltext gebaute Apps laufen mit schreibgeschütztem Dateisystem. Nur
/tmpist beschreibbar. Bei eigenem Dockerfile entscheidet Ihr Image. - Bei Flask und Django nehmen Sie
gunicornin 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.