CLI

Gira as aplicações a partir do terminal.

A CLI nodion comunica com a mesma API HTTP v2 que o dashboard. Use-a diretamente, a partir da CI ou através de um agente capaz de executar comandos de shell.

Instalação

macOS e Linux:

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

Windows (PowerShell):

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

O instalador coloca o nodion em ~/.local/bin no Unix ou em %LocalAppData%\Programs\nodion no Windows, verifica um manifesto de release assinado e substitui um nodion Classic que já esteja no seu PATH. Altere o diretório com NODION_INSTALL_DIR. Para voltar ao Classic: curl -fsSL https://cli.nodion.com/install.sh | bash.

A verificação no Windows requer Python 3 (python3, python ou py -3).

Iniciar sessão

nodion login inicia um fluxo de código de dispositivo no browser. Se ainda não tiver conta, pode registar-se na mesma página (GitHub, Google ou e-mail). Confirme o código. Se for necessária uma confirmação por e-mail, abra a mensagem, volte à página e aprove novamente. A CLI guarda uma chave de API pessoal em ~/.config/nodion/config.yml (modo 0600). Os agentes devem seguir auth.md e não podem mostrar o token.

bashnodion login
nodion whoami

As chaves têm de começar por nodion_ ou nodion_proj_. As chaves nk_ antigas são rejeitadas. Crie uma chave pessoal em Account → Security se quiser evitar o fluxo no browser.

Na CI, dispense o login e passe um token. O token nunca é gravado em disco:

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

nodion logout revoga a chave pessoal criada pelo login e apaga a configuração local. Não revoga chaves de projeto nem NODION_API_TOKEN.

Projeto e aplicação

A maioria dos comandos precisa de um projeto e de uma aplicação. Ordem de resolução:

--project / --app
NODION_PROJECT / NODION_APP_ID
nodion.yml, procurado a partir do diretório atual, subindo na hierarquia
Seleção por omissão da conta no dashboard (ou com nodion projects use)

bashnodion projects list
nodion projects use prj_…
nodion link

nodion link escreve um nodion.yml neste diretório. Pode fazer commit do ficheiro sem risco. Guarda apenas IDs:

yamlproject: prj_…
app: app_…

Início rápido

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

Os comandos create, delete, deploy e scale pedem confirmação. Na CI, passe --yes.

Comandos comuns

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

As estratégias de apps create são dockerfile, buildpacks e prebuilt_image. O Git é uma origem, não uma estratégia: passe --integration, --repo e --branch quando o deploy da aplicação deve ser feito a partir de um repositório. Consulte Aplicações.

nodion logs requer --container (o nome do processo, como web).

Versão e atualizações

bashnodion version
nodion update

nodion update obtém o manifesto assinado de cli.nodion.net, verifica o digest e substitui este binário no próprio local. Recusa instalações geridas por um gestor de pacotes ou feitas através de symlinks (Homebrew, /usr/bin). Use --force apenas para fazer downgrade. Não há substituição automática silenciosa.

Num TTY interativo, a CLI pode mostrar uma linha a remeter para nodion update quando existe uma release mais recente (no máximo uma vez por dia, sem bloquear em caso de falha, sem credenciais). Desative com NODION_NO_UPDATE_CHECK=1. A verificação está desativada na CI e sempre que NODION_API_TOKEN estiver definido.

Outros 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

Use as mesmas flags dos comandos de aplicações. As sandboxes ainda não estão disponíveis na CLI.

JSON e flags

Todos os comandos list e get aceitam --output json:

bashnodion apps list --output json

Flags globais:

--api URL: origem da API (por omissão https://app.nodion.com)
--token TOKEN: chave de API apenas para esta invocação
--project ID / --app ID
--output table|json
--yes: ignora a confirmação

Variáveis de ambiente:

NODION_API: o mesmo que --api
NODION_API_TOKEN: tem prioridade sobre o ficheiro de configuração, nunca é guardado
NODION_PROJECT / NODION_APP_ID
NODION_NO_UPDATE_CHECK=1: desativa o aviso de versão no TTY

A CLI envia X-Nodion-Project, tal como a API HTTP. Pode testar os corpos dos pedidos na consola da API.

CLI