Guida alla riga di comando
La CLI di Cloud Noce è lo strumento da riga di comando per le attività normalmente svolte nel pannello: accesso all’account, consultazione di progetti e servizi, deploy di una cartella locale, gestione delle variabili di ambiente, collegamento dei domini, consultazione di build e release, rollback, lettura dei log e controllo dei servizi PaaS. È utile per progetti non ancora collegati a GitHub o GitLab e per eseguire il deploy da CI/CD, script interni o terminale locale. La CLI usa esclusivamente l’API pubblica di Cloud Noce e salva il token di accesso nella configurazione utente.
Punti importanti
Installazione consigliata con un solo comando
Il metodo consigliato è curl -fsSL https://get.gerdoo.cloud/install.sh | sh. Lo script rileva sistema operativo e architettura, scarica il binario corretto e lo colloca in /usr/local/bin. Se non sono disponibili permessi di scrittura diretta, usa sudo soltanto per spostare il file.
Token e posizione della configurazione
Dopo gerdoo login, il token CLI viene salvato in ~/.config/gerdoo/config.json con permessi 0600. In CI puoi usare GERDOO_TOKEN al posto del login per evitare di scrivere il token su disco.
Deploy da una cartella locale
Durante deploy, la cartella del progetto viene impacchettata in un archivio tar.gz e caricata. Le cartelle .git, node_modules, .gerdoo e il file .DS_Store vengono sempre esclusi. Per escludere altri percorsi, crea un file .gerdooignore.
Procedura consigliata per iniziare con la CLI
Installa la CLI
Esegui curl -fsSL https://get.gerdoo.cloud/install.sh | sh oppure scarica manualmente il binario adatto al tuo sistema e inseriscilo nel PATH.
Accedi all’account
Esegui gerdoo login e accedi all’account Cloud Noce con email o numero di cellulare e password. Poi esegui gerdoo whoami per verificare l’account.
Esegui il primo deploy
Nella radice del progetto esegui semplicemente gerdoo deploy: la CLI crea automaticamente il servizio e chiede una conferma, che puoi saltare con --yes. Al termine, .gerdoo/service.json collega il progetto al servizio creato.
Configura le variabili ed esegui un nuovo deploy
Se il progetto richiede variabili come DATABASE_URL o SECRET_KEY, impostale con gerdoo service env <slug> set KEY=VALUE e poi esegui nuovamente gerdoo deploy.
Monitora e risolvi i problemi
Usa gerdoo logs <slug> --tail 200 o gerdoo service logs <slug> per leggere i log e gerdoo service status <slug> per controllare lo stato.
Collegare un assistente AI (MCP e agenti)
La CLI di Cloud Noce include un server MCP con cui collegare assistenti come Claude Code, Cursor, Codex o Gemini Antigravity ai tuoi progetti con un solo comando: gerdoo setup agent. Consulta Configurare MCP e gli agenti per tutti i dettagli.