CLI

Zarządzaj aplikacjami z terminala.

CLI nodion korzysta z tego samego API HTTP v2 co dashboard. Używaj go samodzielnie, w CI albo przez agenta, który potrafi uruchamiać polecenia w powłoce.

Instalacja

macOS i Linux:

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

Windows (PowerShell):

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

Instalator umieszcza nodion w ~/.local/bin na systemach Unix lub w %LocalAppData%\Programs\nodion na Windows, weryfikuje podpisany manifest release'u i zastępuje nodion w wersji Classic, jeśli jest już w Twoim PATH. Katalog możesz zmienić przez NODION_INSTALL_DIR. Powrót do wersji Classic: curl -fsSL https://cli.nodion.com/install.sh | bash.

Weryfikacja na Windows wymaga Pythona 3 (python3, python lub py -3).

Logowanie

nodion login uruchamia w przeglądarce logowanie kodem urządzenia (device code). Jeśli nie masz jeszcze konta, zarejestrujesz się na tej samej stronie (GitHub, Google lub e-mail). Potwierdź kod. Jeśli wymagane jest potwierdzenie adresu e-mail, otwórz wiadomość, wróć na stronę i zatwierdź ponownie. CLI zapisuje osobisty klucz API w ~/.config/nodion/config.yml (tryb 0600). Agenci powinni postępować według auth.md i nie mogą wyświetlać tokena.

bashnodion login
nodion whoami

Klucze muszą zaczynać się od nodion_ lub nodion_proj_. Starsze klucze nk_ są odrzucane. Utwórz osobisty klucz w Account → Security, jeśli chcesz pominąć logowanie w przeglądarce.

W CI pomiń login i przekaż token. Token nigdy nie jest zapisywany na dysku:

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

nodion logout unieważnia osobisty klucz utworzony przez login i usuwa lokalną konfigurację. Nie unieważnia kluczy projektu ani NODION_API_TOKEN.

Projekt i aplikacja

Większość poleceń potrzebuje projektu i aplikacji. Kolejność ustalania:

--project / --app
NODION_PROJECT / NODION_APP_ID
nodion.yml, szukany od bieżącego katalogu w górę
Ustawienie domyślne konta z selektora w dashboardzie (lub nodion projects use)

bashnodion projects list
nodion projects use prj_…
nodion link

nodion link zapisuje plik nodion.yml w tym katalogu. Plik możesz bezpiecznie dodać do repozytorium. Zawiera tylko identyfikatory:

yamlproject: prj_…
app: app_…

Szybki start

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

Polecenia create, delete, deploy i scale proszą o potwierdzenie. W CI przekaż --yes.

Najczęstsze polecenia

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

Strategie dla apps create to dockerfile, buildpacks i prebuilt_image. Git to źródło, a nie strategia: przekaż --integration, --repo i --branch, gdy aplikacja ma być wdrażana z repozytorium. Zobacz Aplikacje.

nodion logs wymaga --container (nazwy procesu, np. web).

Wersja i aktualizacje

bashnodion version
nodion update

nodion update pobiera podpisany manifest z cli.nodion.net, sprawdza digest i podmienia ten plik binarny w miejscu. Odmawia aktualizacji instalacji zarządzanych przez menedżer pakietów lub opartych na dowiązaniach symbolicznych (Homebrew, /usr/bin). --force używaj tylko do obniżenia wersji. Nie ma cichej, automatycznej podmiany.

W interaktywnym TTY CLI może wyświetlić jedną linię z odesłaniem do nodion update, gdy dostępny jest nowszy release (najwyżej raz dziennie, bez przerywania pracy w razie błędu i bez przesyłania danych logowania). Wyłączysz to przez NODION_NO_UPDATE_CHECK=1. Sprawdzanie jest wyłączone w CI oraz zawsze, gdy ustawiono NODION_API_TOKEN.

Inne polecenia

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

Te same flagi co w poleceniach aplikacji. Sandboxy nie są jeszcze dostępne w CLI.

JSON i flagi

Każde polecenie typu list lub get przyjmuje --output json:

bashnodion apps list --output json

Flagi globalne:

--api URL: adres bazowy API (domyślnie https://app.nodion.com)
--token TOKEN: klucz API tylko dla tego wywołania
--project ID / --app ID
--output table|json
--yes: pomija potwierdzenie

Zmienne środowiskowe:

NODION_API: to samo co --api
NODION_API_TOKEN: ma pierwszeństwo przed plikiem konfiguracyjnym, nigdy nie jest zapisywany
NODION_PROJECT / NODION_APP_ID
NODION_NO_UPDATE_CHECK=1: wyłącza podpowiedź o wersji w TTY

CLI wysyła X-Nodion-Project, tak jak HTTP API. Treści żądań możesz interaktywnie przetestować w konsoli API.

CLI