gooddeploy
Doku

Handbuch

Alles, was du für die Arbeit mit gooddeploy brauchst: installieren, deployen, live schalten, schützen und aufräumen. Kurz erklärt, mit den Befehlen zum Kopieren. Den Zugang richten wir dir in der Pilotphase ein: Pilot anfragen, danach geht es mit dem Testzugang los.

  1. 1Testzugang: deine erste App in 10 MinutenDu hast einen Testzugang für gooddeploy bekommen. Diese Seite bringt dich vom Installieren bis zur ersten App online: anmelden, deployen, live schalten, zurückrollen. Dazu, was in der Testphase schon geht und was noch nicht.
  2. 2Erste SchritteIn wenigen Minuten startklar: gooddeploy installieren, per E-Mail anmelden und dein Repo mit einem Projekt verknüpfen (gooddeploy link).
  3. 3Deploy, Preview, Promote, RollbackDer Kern von gooddeploy in vier Befehlen: Stand hochladen und als Vorschau (Preview) bauen, prüfen, live schalten und bei Bedarf in Sekunden zurück.
  4. 4Status und ListeWas ist gerade live, wohin führt ein Rollback, was läuft noch? gooddeploy status gibt dir den Überblick, gooddeploy ls die ganze Liste der Deployments und gooddeploy inspect ein einzelnes Deployment im Detail. gooddeploy projects zeigt alle Projekte, die du sehen darfst.
  5. 5PasswortschutzSchütze die Live-Seite oder alle Previews eines Projekts mit Benutzer und Passwort, etwa für eine Kundenabnahme oder eine Seite vor dem Start. Der Schutz wirkt sofort, ohne neuen Deploy.
  6. 6AufräumenNimm einzelne Previews oder frühere Live-Versionen offline, oder entferne ein ganzes Projekt. Die aktuelle Live-Version ist dabei immer geschützt.
  7. 7RechteJeder Zugangscode hat Rechte je Projekt. So kann eine Kollegin bei einem Kunden alles dürfen und bei einem anderen nur lesen, und dein Kunde kann seine Previews ansehen, ohne live schalten zu können.
  8. 8Aktualisierengooddeploy hält sich mit einem Befehl aktuell und sagt dir Bescheid, wenn es eine neue Version gibt.
  9. 9Für Skripte und CIAlle Befehle lassen sich ohne Rückfragen und mit maschinenlesbarer Ausgabe nutzen, etwa in einer GitLab- oder GitHub-Pipeline. Feste Exit-Codes sagen deinem Skript, was schiefging.
  10. 10Häufige FehlerJede Fehlermeldung von gooddeploy hat einen festen Code und einen Hinweis, was du tun kannst. Hier stehen die häufigsten, sortiert nach dem, was du gerade tust.
  11. 11UmgebungsvariablenZugangsdaten, API-Schlüssel und Einstellungen gibst du deiner Anwendung als Umgebungsvariablen mit, getrennt für Previews und Live. gooddeploy speichert die Werte verschlüsselt und zeigt sie nie an.
  12. 12Logs, Checks und DatenbankWas deine Anwendung gerade schreibt, wie du eigene Prüfungen aus der CI meldest und wie du an deine Postgres-Datenbank kommst.
  13. 13Freigabelink für PreviewsPreviews sind geschützt: Wer die Adresse einer Preview ohne Freigabe aufruft, sieht nur eine Hinweisseite. Mit gooddeploy share erzeugst du einen Link, mit dem dein Kunde oder dein Team die Preview ohne Konto und ohne Passwort ansieht, so lange du willst, höchstens 30 Tage.
  14. 14Datenbank in deiner App nutzenPostgres für deine Next.js-App: anlegen, mit Prisma, Drizzle oder pg verbinden, lokal entwickeln, Migrationen ausrollen und Daten holen. Dazu, was über den Verbindungs-Pool nicht geht und welche Fehler du am häufigsten siehst.
  15. 15Umzug von VercelSchritt für Schritt von Vercel zu gooddeploy: Next.js-App mit Postgres und eigener Domain, ohne dass die Seite ausfällt. Vercel läuft weiter, bis bei gooddeploy alles geprüft ist; am Ende steht eine Checkliste zum Abhaken.
  16. 16WeiterleitungenAlte Adressen auf neue umleiten, etwa nach einem Relaunch oder beim Umzug von Vercel: Für statische Seiten (reines HTML, Vite, Astro und andere Builds mit fester Ausgabe) trägst du Weiterleitungen in die gooddeploy.json ein, im selben Format wie redirects in der vercel.json.