CLI

Apps vom Terminal verwalten.

Die nodion-CLI spricht dieselbe v2-HTTP-API wie das Dashboard. Nutz sie selbst, aus CI oder von einem Agenten, der Shell-Commands ausführen kann.

Installieren

macOS und Linux:

bashcurl -fsSL https://cli.nodion.net/install.sh | bash

Windows (PowerShell):

powershellirm https://cli.nodion.net/install.ps1 | iex

Der Installer legt nodion unter ~/.local/bin auf Unix oder %LocalAppData%\Programs\nodion auf Windows ab, prüft ein signiertes Release-Manifest und ersetzt ein Classic- nodion, das schon auf deinem PATH liegt. Das Verzeichnis überschreiben mit NODION_INSTALL_DIR. Rollback auf Classic: curl -fsSL https://cli.nodion.com/install.sh | bash.

Die Windows-Prüfung braucht Python 3 (python3, python oder py -3).

Anmelden

nodion login startet einen Browser-Device-Code-Flow. Hast du noch keinen Account, registriert dieselbe Seite dich (GitHub, Google oder E-Mail). Den Code bestätigen. Wenn E-Mail-Bestätigung nötig ist, die Mail öffnen, zur Seite zurück und nochmal freigeben. Die CLI speichert einen persönlichen API-Key in ~/.config/nodion/config.yml (Mode 0600). Agenten sollen auth.md folgen und den Token nicht ausgeben.

bashnodion login
nodion whoami

Keys müssen mit nodion_ oder nodion_proj_ beginnen. Ältere nk_-Keys werden abgelehnt. Einen persönlichen Key unter Account → Security anlegen, wenn du den Browser-Flow überspringen willst.

Für CI login überspringen und ein Token übergeben. Es wird nie auf Disk geschrieben:

bashexport NODION_API_TOKEN=nodion_…
# or a project key that survives when someone leaves
export NODION_API_TOKEN=nodion_proj_…

nodion logout widerruft den persönlichen Key von login und löscht die lokale Config. Es widerruft keine Projekt-Keys und kein NODION_API_TOKEN.

Projekt und App

Die meisten Commands brauchen ein Projekt und eine Application. Auflösungsreihenfolge:

--project / --app
NODION_PROJECT / NODION_APP_ID
nodion.yml, gesucht vom aktuellen Verzeichnis nach oben
Account-Default aus dem Dashboard-Picker (oder nodion projects use)

bashnodion projects list
nodion projects use prj_…
nodion link

nodion link schreibt eine nodion.yml in dieses Verzeichnis. Die Datei darfst du committen. Sie speichert nur IDs:

yamlproject: prj_…
app: app_…

Quickstart

bashnodion login
nodion projects use prj_…
nodion apps list
nodion link
nodion deploy --wait

Create, Delete, Deploy und Scale fragen nach Bestätigung. In CI --yes übergeben.

Häufige Commands

bash# Applications
nodion apps list
nodion apps get
nodion apps create --name my-api --region REGION --strategy dockerfile
nodion apps delete APP

# Deployments
nodion deploy --wait
nodion deployments list
nodion deployments get DEPLOYMENT

# Environment
nodion env list
nodion env set FOO=bar
nodion env set SECRET=value --secret
nodion env unset FOO

# Runtime
nodion logs --container web --tail 200
nodion processes list
nodion processes scale PROCESS --replicas 2

# Domains
nodion domains list
nodion domains add www.example.com
nodion domains verify DOMAIN

Strategien für apps create sind dockerfile, buildpacks und prebuilt_image. Git ist eine Source, keine Strategie: --integration, --repo und --branch übergeben, wenn die App aus einem Repository deployen soll. Siehe Applications.

nodion logs braucht --container (der Prozess- Name, zum Beispiel web).

Version und Updates

bashnodion version
nodion update

nodion update holt das signierte Manifest von cli.nodion.net, prüft den Digest und ersetzt dieses Binary an Ort und Stelle. Es lehnt package-managed oder Symlink-Installs ab (Homebrew, /usr/bin). --force nur zum Downgraden. Es gibt kein stilles Auto-Replace.

Auf einem interaktiven TTY kann die CLI eine Zeile auf nodion update zeigen, wenn ein neueres Release existiert (höchstens einmal am Tag, fail-open, ohne Credentials). Abschalten mit NODION_NO_UPDATE_CHECK=1. Der Check ist in CI aus und immer, wenn NODION_API_TOKEN gesetzt ist.

Weitere Commands

bashnodion databases list
nodion volumes list
nodion buckets list
nodion dns list
nodion cdn list
nodion email-domains list
nodion observers list
nodion regions

Dieselben Flags wie die App-Commands. Sandboxes sind noch nicht in der CLI.

JSON und Flags

Jeder List- und Get-Command akzeptiert --output json:

bashnodion apps list --output json

Globale Flags:

--api URL: API-Origin (Default https://app.nodion.com)
--token TOKEN: API-Key nur für diesen Aufruf
--project ID / --app ID
--output table|json
--yes: Bestätigung überspringen

Environment:

NODION_API: wie --api
NODION_API_TOKEN: überschreibt die Config-Datei, wird nie persistiert
NODION_PROJECT / NODION_APP_ID
NODION_NO_UPDATE_CHECK=1: den TTY-Versionshinweis überspringen

Die CLI schickt X-Nodion-Project wie die HTTP-API. Interaktive Request-Bodies stehen in der API-Console.

CLI