CLI

Gestisci le app dal terminale.

La CLI nodion usa la stessa API HTTP v2 della dashboard. Puoi usarla direttamente, in CI o tramite un agente in grado di eseguire comandi shell.

Installazione

macOS e Linux:

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

Windows (PowerShell):

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

L'installer copia nodion in ~/.local/bin su Unix o in %LocalAppData%\Programs\nodion su Windows, verifica un manifest di release firmato e sostituisce un nodion Classic già presente nel tuo PATH. Per cambiare directory usa NODION_INSTALL_DIR. Per tornare a Classic: curl -fsSL https://cli.nodion.com/install.sh | bash.

La verifica su Windows richiede Python 3 (python3, python o py -3).

Accesso

nodion login avvia un flusso device code nel browser. Se non hai ancora un account, puoi registrarti dalla stessa pagina (con GitHub, Google o email). Conferma il codice. Se è richiesta la conferma dell'email, apri l'email, torna alla pagina e approva di nuovo. La CLI salva una chiave API personale in ~/.config/nodion/config.yml (permessi 0600). Gli agenti devono seguire auth.md e non devono stampare il token.

bashnodion login
nodion whoami

Le chiavi devono iniziare con nodion_ o nodion_proj_. Le vecchie chiavi nk_ vengono rifiutate. Se vuoi saltare il flusso nel browser, crea una chiave personale in Account → Security.

Per la CI salta login e passa un token. Non viene mai scritto su disco:

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

nodion logout revoca la chiave personale creata da login e cancella la configurazione locale. Non revoca le chiavi di progetto né NODION_API_TOKEN.

Progetto e app

La maggior parte dei comandi richiede un progetto e un'applicazione. Ordine di risoluzione:

--project / --app
NODION_PROJECT / NODION_APP_ID
nodion.yml, cercato dalla directory corrente verso l'alto
Impostazione predefinita dell'account dal selettore della dashboard (o nodion projects use)

bashnodion projects list
nodion projects use prj_…
nodion link

nodion link scrive un nodion.yml in questa directory. Puoi fare il commit del file senza rischi. Contiene solo ID:

yamlproject: prj_…
app: app_…

Avvio rapido

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

Creazione, eliminazione, deploy e scaling chiedono una conferma. In CI passa --yes.

Comandi più usati

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

Le strategie di apps create sono dockerfile, buildpacks e prebuilt_image. Git è una sorgente, non una strategia: passa --integration, --repo e --branch quando l'app deve fare il deploy da un repository. Vedi Applicazioni.

nodion logs richiede --container (il nome del processo, ad esempio web).

Versione e aggiornamenti

bashnodion version
nodion update

nodion update scarica il manifest firmato da cli.nodion.net, verifica il digest e sostituisce questo binario sul posto. Rifiuta le installazioni gestite da un package manager o tramite symlink (Homebrew, /usr/bin). Usa --force solo per fare il downgrade. Non c'è nessuna sostituzione automatica silenziosa.

Su un TTY interattivo la CLI può mostrare una riga che rimanda a nodion update quando esiste una release più recente (al massimo una volta al giorno, senza credenziali e senza bloccare i comandi in caso di errore). Disattiva il controllo con NODION_NO_UPDATE_CHECK=1. Il controllo è spento in CI e ogni volta che NODION_API_TOKEN è impostato.

Altri comandi

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

Stessi flag dei comandi per le app. Le sandbox non sono ancora nella CLI.

JSON e flag

I comandi list e get accettano --output json:

bashnodion apps list --output json

Flag globali:

--api URL: URL di origine dell'API (predefinito https://app.nodion.com)
--token TOKEN: chiave API solo per questa invocazione
--project ID / --app ID
--output table|json
--yes: salta la conferma

Variabili d'ambiente:

NODION_API: come --api
NODION_API_TOKEN: ha la precedenza sul file di configurazione, non viene mai salvato
NODION_PROJECT / NODION_APP_ID
NODION_NO_UPDATE_CHECK=1: salta l'avviso di versione sul TTY

La CLI invia X-Nodion-Project come l'API HTTP. I body delle richieste, da provare in modo interattivo, sono nella console API.

CLI