Kom i gang med Suble CLI'en

suble-CLI'en lægger hele platformen i din terminal — ingen omveje via dashboardet, scriptbar til CI, og med et guidet deploy-flow til når du bare vil have noget op at køre. Den er en binær uden afhængigheder, så den hurtigste måde at prøve den på er med npx.

Installation

Kør den efter behov med npx (intet installeres), eller installer globalt:

# engangsbrug
npx @suble/cli --help

# eller installer globalt
npm i -g @suble/cli
suble --help

Log ind

Login bruger samme OAuth som alt andet — ingen tokens at kopiere. suble login åbner din browser, du godkender, og CLI'en cacher legitimationen lokalt:

suble login
# → åbner browseren, godkend, færdig

suble logout   # rydder den cachede legitimation

Daglige kommandoer

instance er nu det kanoniske navn (vm virker stadig som alias), og hver <ref> tager et instans-navn eller uid — navne er unikke i et projekt. Tilføj --project <uid> (eller sæt SUBLE_PROJECT) for at springe vælgeren over.

• suble projects · suble plans · suble apps — list projekter, planer og 1-klik-kataloget
• suble instance list — dine instanser (vm er stadig et alias)
• suble instance create — opret en instans
• suble instance power <ref> start|stop|reboot — strømhandlinger
• suble instance ssh <ref> — tilføj din SSH-nøgle (spørger først) og åbn en session
• suble instance delete <ref> — riv en ned
• suble status <ref> — tilstand, jobfremdrift, IP'er, firewall, netværk, app-helbred
• suble logs <ref> [container] — container-logs (--tail N, --follow)
• suble app info <ref> — app-/database-forbindelsesdetaljer (--show-credentials)
• suble resize <ref> <plan> — skift plan (genstarter; --yes springer bekræftelse over)
• suble backup ls|create|restore <ref> — snapshots
• suble db create|user-add <ref> … — managed-database-operationer
• suble network ls|create|connect|disconnect|rm — private netværk

suble instance list
suble instance create --app docker --plan BXS.s1 --project prj_xxx --name web-01
suble instance ssh web-01   # → autoriserer ~/.ssh/id_ed25519.pub, derefter ssh root@<ip>
suble status web-01
suble logs web-01 --follow

Hovedattraktionen: suble deploy

suble deploy er et interaktivt, guidet flow. Peg det mod et Docker-image, og det klarer de kedelige dele: vælger (eller opretter) en VPS, kører din container på den, og kan sætte ingress op med automatisk HTTPS — alt sammen ud fra nogle få spørgsmål.

suble deploy

1. Vælg et projekt og en plan (eller accepter den foreslåede)
2. Angiv Docker-imaget og evt. porte/env
3. CLI'en opretter en Docker-VPS, venter på den og starter containeren
4. Eksponer den eventuelt på et hostname — Caddy henter et Let's Encrypt-certifikat automatisk
5. Skriver en suble.yml, der beskriver det du startede — så næste deploy, eller CI, er en kommando

Du får instansen, containeren og den offentlige URL tilbage — plus en suble.yml i mappen. Derefter reconciler suble deploy den fil, og suble update gør det samme i CI uden prompts (kør suble plan for at forhåndsvise diffen først).

Uanset om du lever i terminalen eller bare vil have en one-liner til at sende en container afsted, får CLI'en dig fra image til kørende service uden at forlade din shell.