CLI

Gestiona tus apps desde la terminal.

La CLI nodion usa la misma API HTTP v2 que el dashboard. Úsala tú mismo, desde CI o desde un agente que pueda ejecutar comandos de shell.

Instalación

macOS y Linux:

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

Windows (PowerShell):

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

El instalador coloca nodion en ~/.local/bin en Unix o en %LocalAppData%\Programs\nodion en Windows, verifica un manifiesto de release firmado y sustituye un nodion Classic que ya esté en tu PATH. Para cambiar el directorio, usa NODION_INSTALL_DIR. Para volver a Classic: curl -fsSL https://cli.nodion.com/install.sh | bash.

La verificación en Windows necesita Python 3 (python3, python o py -3).

Iniciar sesión

nodion login inicia un flujo de código de dispositivo en el navegador. Si aún no tienes cuenta, la misma página te registra (con GitHub, Google o email). Confirma el código. Si hace falta confirmar el email, abre el correo, vuelve a la página y aprueba de nuevo. La CLI guarda una clave de API personal en ~/.config/nodion/config.yml (modo 0600). Los agentes deben seguir auth.md y no deben mostrar el token.

bashnodion login
nodion whoami

Las claves deben empezar por nodion_ o nodion_proj_. Las claves antiguas nk_ se rechazan. Si quieres saltarte el flujo del navegador, crea una clave personal en Account → Security.

En CI, sáltate login y pasa un token. Nunca se escribe en 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 clave personal creada con login y borra la configuración local. No revoca las claves de proyecto ni NODION_API_TOKEN.

Proyecto y app

La mayoría de los comandos necesitan un proyecto y una aplicación. Orden de resolución:

--project / --app
NODION_PROJECT / NODION_APP_ID
nodion.yml, buscado desde el directorio actual hacia arriba
Valor predeterminado de la cuenta, elegido en el selector del dashboard (o con nodion projects use)

bashnodion projects list
nodion projects use prj_…
nodion link

nodion link escribe un nodion.yml en este directorio. Puedes hacer commit del archivo sin problema. Solo guarda IDs:

yamlproject: prj_…
app: app_…

Inicio rápido

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

Crear, borrar, desplegar y escalar piden confirmación. En CI, pasa --yes.

Comandos habituales

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

Las estrategias de apps create son dockerfile, buildpacks y prebuilt_image. Git es un origen, no una estrategia: pasa --integration, --repo y --branch cuando la app deba desplegarse desde un repositorio. Consulta Aplicaciones.

nodion logs necesita --container (el nombre del proceso, por ejemplo web).

Versión y actualizaciones

bashnodion version
nodion update

nodion update descarga el manifiesto firmado de cli.nodion.net, comprueba el digest y sustituye este binario in situ. Rechaza las instalaciones gestionadas por un gestor de paquetes o hechas con symlinks (Homebrew, /usr/bin). Usa --force solo para hacer downgrade. No hay ninguna sustitución automática silenciosa.

En un TTY interactivo, la CLI puede mostrar una línea que remite a nodion update cuando hay una release más reciente (como mucho una vez al día, sin credenciales y sin bloquear nada si la comprobación falla). Desactívalo con NODION_NO_UPDATE_CHECK=1. La comprobación está desactivada en CI y siempre que NODION_API_TOKEN esté definido.

Otros comandos

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

Los demás comandos aceptan los mismos flags que los de apps. Los sandboxes aún no están en la CLI.

JSON y flags

Todos los comandos de listado y consulta aceptan --output json:

bashnodion apps list --output json

Flags globales:

--api URL: origen de la API (por defecto https://app.nodion.com)
--token TOKEN: clave de API solo para esta invocación
--project ID / --app ID
--output table|json
--yes: omite la confirmación

Variables de entorno:

NODION_API: igual que --api
NODION_API_TOKEN: tiene prioridad sobre el archivo de configuración y nunca se guarda
NODION_PROJECT / NODION_APP_ID
NODION_NO_UPDATE_CHECK=1: omite el aviso de versión en el TTY

La CLI envía X-Nodion-Project igual que la API HTTP. Puedes probar los cuerpos de las peticiones de forma interactiva en la consola de la API.

CLI