Salta ai contenuti

CoreCLI — Riga di comando

CoreCLI è l’interfaccia amministrativa ufficiale dell’appliance. Il suo scopo dichiarato è sostituire la shell Linux nelle operazioni ordinarie.

L’accesso diretto al sistema operativo va considerato un’operazione eccezionale, consentita solo attraverso la procedura di break-glass — che è disponibile, ed è tracciata.

Perché la shell non ha confini. Chi ha una shell può fare qualsiasi cosa, compresa quella che romperà il cluster in un modo che nessuno saprà ricostruire tre mesi dopo.

CoreCLI fa passare ogni operazione dalle API di piattaforma. Da questo discendono quattro proprietà che una shell non può dare:

  • Auditabilità. Ogni comando è un’operazione tracciata con autore, momento ed esito.
  • RBAC. Chi può fare che cosa è deciso centralmente, non dai permessi del filesystem.
  • Astrazione. Il comando esprime l’intento, non l’implementazione. Se domani cambia il modo in cui un servizio viene riavviato, il comando resta lo stesso.
  • Automazione. Ogni comando può produrre JSON o YAML, adatti a essere consumati da uno script.

CoreCLI non esegue systemctl, kubectl, helm, crictl, ip o nmcli. Chiede alle API di farlo.

Dalla console del nodo — quella dell’hypervisor o la console fisica — oppure via SSH dove la policy lo consente. All’accesso l’ambiente presenta direttamente CoreCLI: non c’è un prompt di shell da cui passare.

I comandi descrivono che cosa volete ottenere:

Terminal window
core cluster expand
core service restart nucleus
core lcm upgrade
core network set --interface eth0 --address 10.0.10.21/24

e non come si fa:

Terminal window
# non è così che si lavora su un'appliance Corellix
systemctl restart corellix-nucleus
kubectl -n corellix-services rollout restart deployment/nucleus
Terminal window
core cluster status # tabella leggibile
core cluster status --output json # per uno script
core cluster status --output yaml # per una pipeline

L’elenco completo è in Comandi CoreCLI. I gruppi:

GruppoAmbito
core clusterNodi, join, espansione, stato
core serviceServizi della piattaforma
core lcmVersioni, piani, aggiornamenti, rollback
core networkIndirizzi, gateway, DNS, VIP
core certCertificati, scadenze, sostituzione
core licenseLicenza e componenti attivati
core connectivityModalità connected / proxy-only / air-gapped
core backupBackup e ripristino della piattaforma
core diagDiagnostica e bundle di supporto

Ogni comando ha --help.

Quando serve davvero la shell — un guasto che le API non coprono, una richiesta esplicita del supporto — la procedura di break-glass la concede. L’accesso è registrato, delimitato nel tempo e riportato negli audit.

Non è una scorciatoia da usare perché è più veloce. Ogni intervento manuale sul sistema è una divergenza dallo stato che la piattaforma crede di avere, e la riconciliazione la annullerà o entrerà in conflitto con essa.