MoveStack Hilfe

Erst kostenlos testen, dann lizenzierten Restore freischalten, wenn er zaehlt

Mit MoveStack koennen Sie scan, doctor, Deploy-Snapshot-Vorschauen, Snapshot-Liste, monitor und watch kostenlos nutzen. Voll-Backup, deploy, clone und restore run gehoeren zum lizenzierten Wiederherstellungspfad.

Schneller Einstieg
movestack scan
movestack doctor . --to staging
movestack snapshot create .

Starten Sie mit dem kostenlosen Vorschaupfad. Aktivieren Sie erst dann, wenn Sie Voll-Backups, deploy, clone oder restore run brauchen.

Kurzfassung

Erst kostenlos testen, dann lizenzierten Restore nutzen

kostenlose Vorschau
movestack scan
movestack doctor . --to staging
movestack snapshot create .
lizenzierter Restore
movestack activate <token> --issuer https://movestack.dev
movestack snapshot create . --mode full-backup
movestack deploy local/full-backup/my-app@... --to ssh:[email protected]:/srv/apps --target-subdir my-app --watch

Kostenlos vs lizenziert

Die kostenlose Vorschau dient zum Verstehen, die Lizenz zum echten Restore-Wert

Core erzwingt diese Trennung jetzt. Kostenlose Befehle brauchen keine Aktivierung. Lizenzierte Befehle brauchen Entitlements, und Deploy, Clone sowie Restore Run brauchen zusaetzlich einen Signed Plan.

Kostenlose Vorschau

Verstehe das Produkt vor dem Kauf. Diese Befehle benoetigen keine Aktivierung, kein Entitlement und keinen Signed Plan.

movestack scan
movestack doctor . --to staging
movestack snapshot create .
movestack snapshot list
movestack monitor staging
movestack watch staging
ScanDoctorDeploy-Snapshot-VorschauSnapshot-ListeMonitorWatch

Lizenzierter Restore-Ablauf

Der Restore-Wert ist lizenziert. Voll-Backup braucht ein Entitlement; Deploy, Clone und Restore Run brauchen zusaetzlich einen Signed Plan.

movestack activate <token> --issuer https://movestack.dev
movestack snapshot create . --mode full-backup
movestack deploy local/full-backup/my-app@... --to ssh:[email protected]:/srv/apps --target-subdir my-app --watch
movestack clone prod --to staging --watch
movestack restore run ...
Voll-Backup-SnapshotsDeployCloneRestore Run

Erste Schritte

Kostenlos starten, fuer lizenzierten Restore aktivieren

Der kostenlose Vorschaupfad hilft Ihnen, App und Zielumgebung zu verstehen. Der lizenzierte Wiederherstellungspfad beginnt erst, wenn Sie Voll-Backups, deploy, clone oder restore run brauchen.

1

Kostenlose Vorschau starten

Scan ist kostenlos. Verwende ihn, um App, Runtime und Datenbankstruktur vor der Lizenzierung zu verstehen.

movestack scan
2

Doctor fuer ein Ziel ausfuehren

Doctor ist kostenlos. Er prueft Workload und Zielbereitschaft, ohne das Ziel zu veraendern.

movestack doctor . --to staging
3

Deploy-Snapshot-Vorschau erstellen

Die Deploy-Snapshot-Vorschau ist kostenlos. Sie ist nicht dasselbe wie ein Voll-Backup.

movestack snapshot create .
4

Einmal aktivieren

Die Aktivierung ist fuer Voll-Backup, Deploy, Clone und Restore Run erforderlich.

movestack activate <token> --issuer https://movestack.dev
5

Lizenziertes Voll-Backup erstellen

Voll-Backup benoetigt ein Lizenz-Entitlement mit snapshot_full_backup.

movestack snapshot create . --mode full-backup
6

Snapshots auflisten

Snapshot List ist kostenlos und zeigt verfuegbare Deploy-Snapshots und Backups.

movestack snapshot list
7

In ein Target-Subdir deployen

Deploy benoetigt Lizenz, Entitlement und Signed Plan. Verwende den gemeinsamen Parent-Pfad des Hosts und halte das app-spezifische Verzeichnis in --target-subdir.

movestack deploy local/full-backup/my-app@... --to ssh:[email protected]:/srv/apps --target-subdir my-app --watch
8

Ziel ueberwachen

Zeigt nach Deploy oder Clone den aktuellen Zustand von Service, Healthcheck, Proxy und oeffentlicher URL.

movestack monitor staging
kostenlose Vorschau
scan, doctor und Deploy-Snapshot
doctor
prueft Bereitschaft ohne Aenderungen
full-backup
lizenzierte echte Sicherung
snapshot list
findet wiederherstellbare Snapshots
monitor
zeigt den Zielzustand

Workflows

Die Befehle, die am haeufigsten genutzt werden

Verwenden Sie Umgebungsnamen wie prod und staging. Denken Sie zuerst in Umgebungen, dann an den Transport. Auf SSH-Hosts sollten Parent-Pfad und --target-subdir getrennt bleiben.

Diese App sichern

movestack snapshot create . --mode full-backup

Nutze Voll-Backup, wenn du ein echtes Backup brauchst, das spaeter wiederhergestellt werden kann.

In ein Target-Subdir deployen

movestack deploy <snapshot-or-archive> --to ssh:[email protected]:/srv/apps --target-subdir my-app --watch

Deploy stellt einen Snapshot oder ein exportiertes .tar.gz-Archiv in einer Zielumgebung wieder her. Verwende den Parent-Pfad des Hosts und halte den app-spezifischen Ort in --target-subdir.

Prod nach Staging klonen

movestack clone prod --to staging --watch

Clone kopiert eine benannte Umgebung in eine andere, inklusive App, Datenbank, Umgebung und Runtime-Zustand.

Deploy-Fortschritt verfolgen

movestack watch staging

Watch fragt denselben Live-Zustand wie Monitor ab, bis das Ziel ready ist. Transiente SSH-Polling-Probleme waehrend des Rollouts werden toleriert.

Ziel ueberwachen

movestack monitor staging

Monitor zeigt den aktuellen Zustand von Service, Healthcheck, Proxy und oeffentlicher URL.

Auth und Lizenzierung

Ein Aktivierungsbefehl reicht fuer den normalen Einsatz

Nach der Aktivierung holen geschuetzte Befehle das benoetigte Entitlement und den Signed Plan automatisch. Issuer-Auth kann Bearer-Token oder Basic Auth nutzen, das ist aber ein Operator-Detail.

movestack activate <token> --issuer https://movestack.dev
movestack auth status
movestack auth logout

Zielumgebungen

Verwenden Sie prod und staging als benannte Umgebungen

Ziele koennen lokal oder per SSH angebunden sein. Sie koennen Host, Parent-Pfad, Source- oder Target-Rolle, Domains, Datenbank-Overrides, Deploy-Overrides und beim Deploy ein app-spezifisches --target-subdir enthalten.

prod
meist die Quellumgebung
staging
meist die Zielumgebung
Parent-Pfad
gemeinsamer Host-Pfad des SSH-Ziels, zum Beispiel /srv/apps
--target-subdir
das app-spezifische Verzeichnis unter dem Parent-Pfad, zum Beispiel my-app
domain / domains[]
primaere Domain plus optionale Domain-Liste
auto www
www.<primaere-domain> wird automatisch ergaenzt

Target-Konfiguration

Beispiel fuer eine Zielkonfiguration

Remote ist nur der Transport. Das sichtbare Modell fuer den Nutzer ist das Environment Target.

movestack targets
{
  "targets": {
    "prod": {
      "type": "ssh",
      "host": "203.0.113.10",
      "path": "/srv/my-app",
      "role": "source",
      "domain": "example.com"
    },
    "staging": {
      "type": "ssh",
      "host": "108.181.66.218",
      "path": "/srv/my-app-staging",
      "role": "target",
      "domains": ["staging.example.com"],
      "database": {
        "name": "my_app_staging"
      }
    }
  }
}

Konzepte

Die Kernbegriffe

Diese Unterschiede entsprechen dem Verhalten von CLI und Core heute.

Snapshot vs Backup

Snapshot ist die allgemeine Restore-Einheit. --mode full-backup ist der echte Backup-Modus. --mode deploy erzeugt einen erneut deploybaren Snapshot.

Deploy vs Restore

Deploy ist der nutzerseitige Restore-Befehl. restore dry-run und restore run sind erweiterte Debug-Befehle.

Monitor vs Watch

Monitor zeigt den aktuellen Live-Zustand. Watch fragt denselben Zustand ab, bis das Ziel ready ist, und toleriert transiente SSH-Polling-Probleme waehrend des Rollouts.

Parent-Pfad vs Target-Subdir

Verwende den gemeinsamen Parent-Pfad des Hosts und halte das app-spezifische Verzeichnis in --target-subdir. So bleibt ein Host fuer mehrere Apps und Staging-Ziele nutzbar.

Doctor

Doctor prueft Workload und Zielbereitschaft vor Deploy oder Clone. Er meldet fehlende Pakete, Provisioning-Optionen und Worker- oder Cron-Signalzustand.

React/Vite Preview-Runtime

React- oder Vite-artige Apps koennen jetzt in der Preview-Runtime hochkommen, indem bei passender App-Struktur vite preview verwendet wird.

Worker- und Cron-Signale

Worker- und Cron-Workloads koennen Heartbeat- und Last-Success-Dateien schreiben, damit Doctor not_configured, missing, stale oder ok melden kann.

Status

Worauf Sie bei Deploy oder Clone achten sollten

Doctor, Monitor und Watch nutzen direkte Statussprache, damit Fehler auf die richtige Schicht zeigen.

Runtime-Status

StatusZielVerifikationFortschrittProxyUpstreamOeffentliche URLServiceHealthcheck

Doctor-Pruefungen

StatusWorkloadSnapshot-BereitschaftTarget-PreflightTarget-BereitschaftFehlende FaehigkeitenProvisioningCron-Signalstatus
Proxy, Domains und Verifikation
domain / domains[]
Ziele koennen eine primaere Domain oder eine Domain-Liste definieren
www primary
www.<primaere-domain> wird automatisch ergaenzt
fallback host
SSH-Ziele ohne Domain koennen auf Host/IP zurueckfallen
collision guard
bestehende Site-Konfigurationen werden nicht ueberschrieben
fingerprint verify
Datenbank-Fingerprint prueft wiederhergestellte Daten
Debian / AlmaLinux
aktuelle Host-Validierung deckt Debian 12 und AlmaLinux ab
React / Vite preview
Die Preview-Runtime kann React- und Vite-artige Apps jetzt ueber vite preview hochbringen.
Worker- und Cron-Bereitschaft

Doctor kann den Zustand von Cron-Signalen melden

Cron-Komponenten koennen Heartbeat- und Last-Success-Dateien schreiben. Doctor nutzt diese Dateien, um zu melden, ob ein geplanter Workload konfiguriert, fehlend, veraltet oder gesund ist.

not_configuredmissingstaleok
Standard-Heartbeat
.movestack/cron/<component>/heartbeat
Standard Last Success
.movestack/cron/<component>/last-success
Optionale Altersgrenzen
heartbeat_max_age_seconds und last_success_max_age_seconds
Go-Helper-API
pkg/signals.DefaultCronPaths, WriteHeartbeat und WriteLastSuccess

Fehlerbehebung

Hauefige Auth-, SSH- und Readiness-Fehler

Beginnen Sie mit der Aktivierung, dann mit dem Signed Plan, dann mit dem Live-Zustand aus Monitor und erst danach mit SSH-Vertrauen und Zielvoraussetzungen.

Aktivierung erforderlich

  • Fuehre vor geschuetzten Befehlen movestack activate <token> --issuer https://movestack.dev aus.

Lizenz widerrufen

  • Die aktuelle Lizenz ist widerrufen. Hole eine gueltige Aktivierung oder kontaktiere den Issuer.

Signed Plan stimmt nicht

  • Das angeforderte Deploy, Clone oder Restore Run wurde fuer dieses Ziel oder diesen Snapshot nicht freigegeben.

Deploy sah fehlgeschlagen aus, aber die App laeuft schon

  • Fuehre movestack monitor <target> aus, bevor du annimmst, dass der Rollout wirklich fehlgeschlagen ist.
  • Wenn Monitor Status: ready, Services: ok und Healthcheck: ok zeigt, ist das Ziel benutzbar, auch wenn ein frueherer Deploy-Bericht fehlgeschlagen aussah.
  • Die fruehere Ausgabe kann nur einen veralteten Zwischenzustand gezeigt haben. Monitor ist die finale Quelle fuer den aktuellen Zielzustand.

SSH Host Key stimmt nicht

  • Der VPS wurde moeglicherweise neu aufgebaut.
  • Nutze die vom CLI vorgeschlagenen known_hosts-Cleanup- und Key-Scan-Befehle.

SSH funktioniert von einem Runner, aber nicht von einem anderen

  • Pruefe Source-IP-Allowlisten, Firewalls, NAT-Policy und VM-Egress-Regeln, bevor du das Ziel selbst fuer defekt haeltst.
  • Der aktuelle Core unterscheidet echte SSH-Timeouts vom alten generischen Killed-Process-Symptom, deshalb sollte der Timeout-Hinweis woertlich genommen werden.

Doctor Readiness fehlgeschlagen

  • Dem Ziel fehlen benoetigte Pakete.
  • Fuehre den Befehl erneut mit Provisioning aus oder installiere die gemeldeten Pakete zuerst.

Erweiterte Befehle

Low-level Restore- und License-Befehle getrennt halten

Diese Befehle sind real, aber eher Operator- und Debug-Pfade als der Hauptfluss der Hilfe.

Restore Dry-Run

movestack restore dry-run ...

Vorschau des Low-Level-Restore-Plans fuer Debugging.

Restore Run

movestack restore run ...

Fuehrt den Low-Level-Restore-Pfad direkt aus, wenn Operator-Debugging es erfordert.

Lizenz-Interna

movestack license entitlement fetch ...

Low-Level-Issuer-Befehle sind fuers Debugging nuetzlich, aber normale geschuetzte Befehle holen Entitlement und Signed Plans automatisch.

Lizenz abrufen

movestack license fetch ...

Liefert rohe Lizenzdaten fuer die Fehlersuche bei der Issuer-Verbindung.

Signed Plan ausstellen

movestack license plan issue ...

Stellt einen Signed Plan manuell aus, um Issuer- und Entitlement-Verhalten zu pruefen.

Funktionsumfang

Aktueller Core-Umfang auf dieser Seite

Das ist der aktuelle Funktionsstand, den das Core-Handoff fuer diese Hilfeseite vorgibt.

Backup und Archive

  • lokaler Snapshot / Voll-Backup
  • lokales Restore / Verifikation
  • Archiv-Export / -Import
  • Deploy aus Snapshot oder .tar.gz-Archiv

Ziele und Hosts

  • Remote-Deploy auf SSH-Ziele
  • Host-Validierung fuer Debian 12 und AlmaLinux
  • Multi-Site nginx auf demselben Host
  • domain + domains[] mit auto-www als Primaerdomain

Verifikation und Konfiguration

  • Datenbank-Fingerprint-Verifikation
  • mehrzeilige PEM- / env-Datei-Referenzen
  • Doctor-Bereitschaftspruefungen
  • Remote monitor / watch

Lizenzdurchsetzung

  • activate / auth status / auth logout
  • Issuer-Profile
  • Entitlement-Aktualisierung
  • Signed-Plan-Autofetch
  • harte Durchsetzung fuer geschuetzte Befehle
Brauchen Sie Hilfe oder haben Sie Feedback?

Fehler melden, Funktionen anfragen oder Ihr Setup teilen

Feedback senden
MoveStack Hilfe und CLI-Dokumentation | MoveStack