CLI

Gérez vos apps depuis le terminal.

La CLI nodion utilise la même API HTTP v2 que le dashboard. Utilisez-la dans votre terminal, depuis la CI ou avec un agent capable d'exécuter des commandes shell.

Installation

macOS et Linux :

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

Windows (PowerShell) :

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

L'installateur place nodion dans ~/.local/bin sous Unix ou dans %LocalAppData%\Programs\nodion sous Windows, vérifie un manifeste de release signé et remplace un nodion Classic déjà présent dans votre PATH. Changez le répertoire avec NODION_INSTALL_DIR. Pour revenir à Classic : curl -fsSL https://cli.nodion.com/install.sh | bash.

La vérification sous Windows nécessite Python 3 (python3, python ou py -3).

Connexion

nodion login lance une authentification par code d'appareil dans le navigateur. Si vous n'avez pas encore de compte, cette page vous permet aussi de vous inscrire (GitHub, Google ou e-mail). Confirmez le code. Si une confirmation par e-mail est requise, ouvrez l'e-mail, revenez sur la page et validez à nouveau. La CLI enregistre une clé d'API personnelle dans ~/.config/nodion/config.yml (mode 0600). Les agents doivent suivre auth.md et ne doivent pas afficher le token.

bashnodion login
nodion whoami

Les clés doivent commencer par nodion_ ou nodion_proj_. Les anciennes clés nk_ sont refusées. Créez une clé personnelle sous Account → Security si vous voulez éviter le flux dans le navigateur.

En CI, passez-vous de login et fournissez un token. Il n'est jamais écrit sur le disque :

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

nodion logout révoque la clé personnelle créée par login et supprime la configuration locale. Il ne révoque ni les clés de projet ni NODION_API_TOKEN.

Projet et app

La plupart des commandes ont besoin d'un projet et d'une application. Ordre de résolution :

--project / --app
NODION_PROJECT / NODION_APP_ID
nodion.yml, recherché à partir du répertoire courant en remontant
Valeur par défaut du compte, choisie dans le sélecteur du dashboard (ou avec nodion projects use)

bashnodion projects list
nodion projects use prj_…
nodion link

nodion link écrit un nodion.yml dans ce répertoire. Vous pouvez le committer sans risque. Il ne contient que des identifiants :

yamlproject: prj_…
app: app_…

Démarrage rapide

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

Les commandes create, delete, deploy et scale demandent une confirmation. En CI, utilisez --yes.

Commandes courantes

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

Les stratégies de apps create sont dockerfile, buildpacks et prebuilt_image. Git est une source, pas une stratégie : passez --integration, --repo et --branch quand l'app doit être déployée depuis un dépôt. Voir Applications.

nodion logs nécessite --container (le nom du processus, par exemple web).

Version et mises à jour

bashnodion version
nodion update

nodion update récupère le manifeste signé depuis cli.nodion.net, vérifie le digest et remplace ce binaire sur place. Il refuse les installations gérées par un gestionnaire de paquets ou via un lien symbolique (Homebrew, /usr/bin). N'utilisez --force que pour revenir à une version antérieure. Le binaire n'est jamais remplacé automatiquement sans avertissement.

Dans un TTY interactif, la CLI peut afficher un message qui renvoie vers nodion update quand une release plus récente existe (au plus une fois par jour, sans bloquer en cas d'échec, sans identifiants). Désactivez cette vérification avec NODION_NO_UPDATE_CHECK=1. La vérification est désactivée en CI et dès que NODION_API_TOKEN est défini.

Autres commandes

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

Mêmes options que les commandes d'app. Les sandboxes ne sont pas encore disponibles dans la CLI.

JSON et options

Toutes les commandes list et get acceptent --output json :

bashnodion apps list --output json

Options globales :

--api URL : origine de l'API (par défaut https://app.nodion.com)
--token TOKEN : clé d'API pour cet appel uniquement
--project ID / --app ID
--output table|json
--yes : ignore la confirmation

Environnement :

NODION_API : identique à --api
NODION_API_TOKEN : prioritaire sur le fichier de configuration, jamais enregistré
NODION_PROJECT / NODION_APP_ID
NODION_NO_UPDATE_CHECK=1 : désactive l'indication de version dans le TTY

La CLI envoie X-Nodion-Project, comme l'API HTTP. Vous pouvez tester les corps de requête dans la console de l'API.

CLI