CLI

Beheer je apps vanuit de terminal.

De nodion-CLI gebruikt dezelfde HTTP-API (v2) als het dashboard. Gebruik hem zelf, vanuit CI of vanuit een agent die shellcommando's kan uitvoeren.

Installeren

macOS en Linux:

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

Windows (PowerShell):

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

Het installatieprogramma zet nodion in ~/.local/bin op Unix of in %LocalAppData%\Programs\nodion op Windows, controleert een ondertekend releasemanifest en vervangt een Classic-versie van nodion die al op je PATH staat. Wijzig de map met NODION_INSTALL_DIR. Terug naar Classic: curl -fsSL https://cli.nodion.com/install.sh | bash.

Verificatie op Windows vereist Python 3 (python3, python of py -3).

Inloggen

nodion login start een device-code-flow in de browser. Heb je nog geen account, dan registreer je je op dezelfde pagina (GitHub, Google of e-mail). Bevestig de code. Is e-mailbevestiging vereist, open dan de mail, ga terug naar de pagina en keur opnieuw goed. De CLI slaat een persoonlijke API-sleutel op in ~/.config/nodion/config.yml (modus 0600). Agents moeten auth.md volgen en mogen het token niet tonen.

bashnodion login
nodion whoami

Sleutels moeten beginnen met nodion_ of nodion_proj_. Oudere nk_-sleutels worden geweigerd. Maak een persoonlijke sleutel aan onder Account → Security als je de browserflow wilt overslaan.

Sla in CI login over en geef een token mee. Dat wordt nooit naar schijf geschreven:

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

nodion logout trekt de persoonlijke sleutel van login in en verwijdert de lokale config. Projectsleutels en NODION_API_TOKEN worden niet ingetrokken.

Project en app

De meeste commando's hebben een project en een applicatie nodig. Volgorde waarin ze worden bepaald:

--project / --app
NODION_PROJECT / NODION_APP_ID
nodion.yml, gezocht vanaf de huidige map omhoog
Het standaardproject uit de projectkiezer in het dashboard (of nodion projects use)

bashnodion projects list
nodion projects use prj_…
nodion link

nodion link schrijft een nodion.yml in deze map. Je kunt het bestand veilig committen. Het bevat alleen ID's:

yamlproject: prj_…
app: app_…

Snel aan de slag

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

Aanmaken, verwijderen, deployen en schalen vragen om bevestiging. Geef in CI --yes mee.

Veelgebruikte commando's

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

De strategieën voor apps create zijn dockerfile, buildpacks en prebuilt_image. Git is een bron, geen strategie: geef --integration, --repo en --branch mee als de app vanuit een repository moet deployen. Zie Applicaties.

nodion logs heeft --container nodig (de procesnaam, zoals web).

Versie en updates

bashnodion version
nodion update

nodion update haalt het ondertekende manifest op bij cli.nodion.net, controleert de digest en vervangt de binary ter plekke. Installaties via een package manager of een symlink worden geweigerd (Homebrew, /usr/bin). Gebruik --force alleen om te downgraden. Er is geen stille automatische vervanging.

In een interactieve TTY kan de CLI één regel tonen die naar nodion update verwijst als er een nieuwere release is (hooguit één keer per dag; fouten blokkeren de CLI niet; er worden geen inloggegevens meegestuurd). Uitschakelen met NODION_NO_UPDATE_CHECK=1. In CI staat de check uit, en ook zodra NODION_API_TOKEN is gezet.

Andere commando's

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

Hiervoor gelden dezelfde flags als voor de app-commando's. Sandboxes zitten nog niet in de CLI.

JSON en flags

Elk list- en get-commando accepteert --output json:

bashnodion apps list --output json

Globale flags:

--api URL: API-origin (standaard https://app.nodion.com)
--token TOKEN: API-sleutel alleen voor deze aanroep
--project ID / --app ID
--output table|json
--yes: bevestiging overslaan

Omgevingsvariabelen:

NODION_API: hetzelfde als --api
NODION_API_TOKEN: heeft voorrang op het configuratiebestand en wordt nooit opgeslagen
NODION_PROJECT / NODION_APP_ID
NODION_NO_UPDATE_CHECK=1: slaat de versiehint in de TTY over

De CLI stuurt X-Nodion-Project mee, net als de HTTP API. Request-bodies kun je interactief uitproberen in de API-console.

CLI