MoveStack-ohjeet

Free preview ensin, lisensoitu restore kun sillä on merkitystä

MoveStack antaa ajaa scanin, doctorin, deploy snapshot previewn, snapshot listin, monitorin ja watchin ilmaiseksi. Full backup, deploy, clone ja restore run ovat lisensoituja restore-komentoja.

Nopea polku
movestack scan
movestack doctor . --to staging
movestack snapshot create .

Aloita ilmaisella preview-polulla. Aktivoi vasta kun tarvitset lisensoitua restore-polkuasi: full backupit, deploy, clone tai restore run.

Lyhyt versio

Free preview ensin, lisensoitu restore kun tarvitset oikeaa palautusta

free preview
movestack scan
movestack doctor . --to staging
movestack snapshot create .
lisensoitu 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

Free vs lisensoitu

Free preview on ymmärtämiseen; lisensoitu puoli on restore-arvoa varten

Core enforceaa nyt tämän jaon. Free-komennot eivät vaadi aktivointia. Lisensoidut komennot vaativat entitlementin, ja deploy, clone sekä restore run vaativat lisäksi signed planin.

Free preview

Ymmärrä tuotteen malli ennen ostoa. Nämä komennot eivät vaadi aktivointia, entitlementia tai signed plania.

movestack scan
movestack doctor . --to staging
movestack snapshot create .
movestack snapshot list
movestack monitor staging
movestack watch staging
ScanDoctorDeploy snapshot previewSnapshot listMonitorWatch

Lisensoitu restore-flow

Restore-arvo on lisensoitu. Full backup tarvitsee entitlementin; deploy, clone ja restore run tarvitsevat lisäksi signed planin.

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 ...
Full backup snapshotsDeployCloneRestore run

Aloitus

Aloita ilmaiseksi, aktivoi lisensoitua restorea varten

Free preview auttaa ymmärtämään appin ja targetin. Lisensoitu restore-flow alkaa kun tarvitset full backupin, deployn, clonen tai restore runin.

1

Aloita free preview

Scan on ilmainen. Käytä sitä appin, runtimen ja tietokannan rakenteen ymmärtämiseen ennen lisensointia.

movestack scan
2

Aja doctor targetille

Doctor on ilmainen. Se tarkistaa workloadin ja targetin valmiuden muuttamatta targetia.

movestack doctor . --to staging
3

Luo deploy snapshot preview

Deploy snapshot preview on ilmainen. Se ei ole sama asia kuin full backup.

movestack snapshot create .
4

Aktivoi kerran

Aktivointi vaaditaan full-backupille, deploylle, clonelle ja restore runille.

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

Luo lisensoitu full backup

Full-backup vaatii lisenssi-entitlementin snapshot_full_backupilla.

movestack snapshot create . --mode full-backup
6

Listaa snapshotit

Snapshot list on ilmainen ja näyttää saatavilla olevat deploy-snapshotit ja backupit.

movestack snapshot list
7

Deploy target-subdiriin

Deploy vaatii lisenssin, entitlementin ja signed planin. Käytä hostin yhteistä parent pathia ja pidä appikohtainen hakemisto --target-subdirissa.

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

Monitoroi targetia

Näyttää nykytilan deployn tai clonen jälkeen: service, healthcheck, proxy ja public URL.

movestack monitor staging
free preview
scan, doctor and deploy snapshot
doctor
checks readiness without changes
full-backup
licensed real backup
snapshot list
finds restorable snapshots
monitor
shows target state

Yleisimmät workflowt

Komennot joita operaattorit käyttävät eniten

Käytä ympäristönimiä kuten prod ja staging. Ajattele ensin ympäristöä, sitten transporttia. SSH-hostilla parent path ja --target-subdir kannattaa erottaa toisistaan.

Varmuuskopioi tämä appi

movestack snapshot create . --mode full-backup

Käytä full-backupia kun tarvitset oikean varmuuskopion, jonka voi palauttaa myöhemmin.

Deploy target-subdiriin

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

Deploy palauttaa snapshotin tai viedyn .tar.gz-arkiston target-ympäristöön. Käytä hostin parent pathia ja pidä appikohtainen sijainti --target-subdirissa.

Kloonaa prod stagingiin

movestack clone prod --to staging --watch

Clone kopioi yhden nimetyn ympäristön toiseen, mukaan lukien appi, tietokanta, ympäristö ja runtime-tila.

Seuraa deployn etenemistä

movestack watch staging

Watch pollaa samaa live-tilaa kuin monitor, kunnes target on ready. Se sietää myös ohimeneviä SSH-pollausongelmia rolloutin aikana.

Monitoroi targetia

movestack monitor staging

Monitor näyttää nykytilan service-, healthcheck-, proxy- ja public URL -kerroksissa.

Auth ja lisensointi

Yksi aktivointikomento riittää normaaliin käyttöön

Aktivoinnin jälkeen suojatut komennot hakevat automaattisesti tarvitsemansa entitlementin ja signed planin. Issuer-auth voi käyttää bearer-tokenia tai Basic Authia, mutta se on operaattoritason yksityiskohta.

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

Target-ympäristöt

Käytä prodia ja stagingia nimettyinä ympäristöinä

Targetit voivat olla local-backed tai SSH-backed. Niissä voi olla host, parent path, source/target-rooli, domainit, database-overridet, deploy-overridet ja appikohtainen --target-subdir deploy-komennossa.

prod
usually the source environment
staging
usually the target environment
parent path
SSH-targetin yhteinen host-polku, esimerkiksi /srv/apps
--target-subdir
appikohtainen hakemisto parent pathin alla, esimerkiksi my-app
domain / domains[]
primary domain plus optional domain list
auto www
www.<primary-domain> is added for the primary domain

Target-config

Esimerkkikonfiguraatio target-ympäristöille

Remote on transport. Käyttäjälle näkyvä malli on 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"
      }
    }
  }
}

Käsitteet

Coren ydintermit

Nämä erot vastaavat sitä miten CLI ja core käyttäytyvät tänään.

Snapshot vs backup

Snapshot on yleinen restore-yksikkö. --mode full-backup on oikea backup-tila. --mode deploy luo uudelleen deployattavan snapshotin.

Deploy vs restore

Deploy on käyttäjälle näkyvä restore-komento. restore dry-run ja restore run ovat edistyneitä/debug-komentoja.

Monitor vs watch

Monitor näyttää nykyisen live-tilan. Watch pollaa samaa tilaa kunnes target on ready, ja se sietää ohimeneviä SSH-pollausongelmia rolloutin aikana.

Parent path vs target subdir

Käytä hostin yhteistä parent pathia ja pidä appikohtainen hakemisto --target-subdirissa. Näin sama hosti voi palvella useita appeja ja staging-targeteja.

Doctor

Doctor tarkistaa workloadin ja targetin valmiuden ennen deployta tai clonea. Se raportoi puuttuvat paketit, provisioning-vaihtoehdot ja worker/cron-signaalit.

React/Vite preview runtime

React- tai Vite-tyyliset appit voivat nousta preview-runtimeen käyttämällä vite preview -käynnistystä, kun appin rakenne vastaa tätä runtimea.

Worker- ja cron-signaalit

Worker- ja cron-workloadit voivat julkaista heartbeat- ja last-success-tiedostoja, jotta doctor voi raportoida not_configured, missing, stale tai ok.

Tilat

Mitä seurata deployn tai clonen aikana

Doctor, monitor ja watch käyttävät suoraa status-kieltä, jotta virheet osoittavat oikeaan kerrokseen.

Runtime-status

StatusTargetVerifyProgressProxyUpstreamPublic URLServiceHealthcheck

Doctor-tarkistukset

StatusWorkloadSnapshot readinessTarget preflightTarget readinessMissing capabilitiesProvisioningCron signal status
Proxy, domainit ja verifiointi
domain / domains[]
targets can define a primary domain or a domain list
www primary
www.<primary-domain> is added automatically
fallback host
SSH targets without a domain can fall back to host/IP
collision guard
existing site configs are not overwritten
fingerprint verify
database fingerprint verify checks restored data
Debian / AlmaLinux
current host validation covers Debian 12 and AlmaLinux
React / Vite preview
Preview-runtime voi tuoda React- ja Vite-tyylisiä appeja ylös vite preview -käynnistyksellä.
Worker ja cron valmius

Doctor voi raportoida cron-signaalien tilan

Cron-komponentit voivat kirjoittaa heartbeat- ja last-success -signaalitiedostoja. Doctor käyttää niitä kertoakseen onko ajastus konfiguroitu, puuttuva, vanhentunut vai kunnossa.

not_configuredmissingstaleok
Default heartbeat
.movestack/cron/<component>/heartbeat
Default last success
.movestack/cron/<component>/last-success
Optional age limits
heartbeat_max_age_seconds and last_success_max_age_seconds
Go helper API
pkg/signals.DefaultCronPaths, WriteHeartbeat and WriteLastSuccess

Vianhaku

Yleisimmät auth-, SSH- ja readiness-virheet

Aloita aktivoinnista, sitten signed planista, sitten monitorin live-tilasta ja vasta sen jälkeen SSH-trustista sekä targetin esitiedoista.

Aktivointi vaaditaan

  • Aja movestack activate <token> --issuer https://movestack.dev ennen suojattuja komentoja.

Lisenssi on peruttu

  • Nykyinen lisenssi on revoked. Hae uusi aktivointi tai ota yhteys issueriin.

Signed plan ei täsmää

  • Pyydetty deploy, clone tai restore run ei ollut sallittu tälle targetille tai snapshotille.

Deploy näytti epäonnistuneelta mutta appi on jo ylhäällä

  • Aja movestack monitor <target> ennen kuin päätät, että rollout oikeasti epäonnistui.
  • Jos monitor näyttää Status: ready, Services: ok ja Healthcheck: ok, target on käytettävissä vaikka aiempi deploy-raportti näyttäisi virhettä.
  • Aiempi tuloste voi olla vanhentunut välitila. Monitor on lopullinen lähde targetin nykytilalle.

SSH host key ei täsmää

  • VPS on voitu rakentaa uudelleen.
  • Käytä CLI:n tarjoamia known_hosts-cleanup- ja key scan -komentoja.

SSH toimii yhdestä runnerista mutta ei toisesta

  • Tarkista source-IP allowlistit, firewallit, NAT-policyt ja VM:n egress-säännöt ennen kuin oletat targetin olevan rikki.
  • Nykyinen core erottaa oikean SSH-timeoutin vanhasta geneerisestä killed-process-oireesta, joten timeout-viestiä kannattaa lukea kirjaimellisesti.

Doctor readiness epäonnistui

  • Targetilta puuttuu vaadittuja paketteja.
  • Aja komento uudelleen provisioning päällä tai asenna raportoidut paketit ensin.

Edistyneet komennot

Pidä low-level restore- ja license-komennot erillään

Nämä komennot ovat oikeita, mutta ne ovat operaattori/debug-polkuja eivätkä pääasiallista help-flow’ta.

Restore dry-run

movestack restore dry-run ...

Preview the lower-level restore plan for debugging.

Restore run

movestack restore run ...

Run the lower-level restore path directly when operator debugging requires it.

License internals

movestack license entitlement fetch ...

Low-level issuer commands are useful for debugging, but normal protected commands fetch entitlement and signed plans automatically.

License fetch

movestack license fetch ...

Fetch raw license data when debugging issuer connectivity.

Signed plan issue

movestack license plan issue ...

Issue a signed plan manually when validating issuer and entitlement behavior.

Feature coverage

Tällä sivulla kuvattu nykyinen core-coverage

Nämä ovat tämän hetken help-sivun taustakyvykkyydet core-handoffista.

Backup and archive

  • local snapshot / full-backup
  • local restore / verify
  • archive export / import
  • deploy from snapshot or .tar.gz archive

Targets and hosts

  • remote deploy to SSH targets
  • Debian 12 and AlmaLinux host validation
  • multi-site nginx on the same host
  • domain + domains[] with auto www primary domain

Verification and config

  • database fingerprint verify
  • multiline PEM / env file-ref support
  • doctor readiness checks
  • remote monitor / watch

License enforcement

  • activate / auth status / auth logout
  • issuer profiles
  • entitlement refresh
  • signed plan auto-fetch
  • hard enforcement for protected commands
Tarvitsetko apua tai haluatko antaa palautetta?

Raportoi bugeja, pyydä featureita tai kerro ympäristöstäsi

Lähetä palautetta
MoveStack ohjeet ja CLI-dokumentaatio | MoveStack