Comandi on-box

Due set di comandi separati raggiungono un Customer Edge, e nessuno dei due contiene l’altro.

• Sul dispositivo, la Site CLI dispone di 6 comandi di primo livello e 82 sottocomandi execcli.
• Tramite rete, la debug API ha un proprio catalogo di 34.

La maggior parte della superficie on-box non ha un equivalente API: l’intero piano di controllo Vega, i wrapper Envoy, la cattura dei pacchetti, il set di parametri kubelet, i file edit-* e la coppia ausiliaria di accesso root sono raggiungibili solo dal dispositivo.

Per accedervi è necessario SSH o la console seriale, e una cosa che non è documentata da nessuna parte:

execcli è un comando nascosto

execcli non appare nel menu interattivo della Site CLI. Accetta un nome di comando come argomento e digitando execcli seguito da Tab vengono elencati tutti gli 82 con la descrizione di una riga fornita dall’appliance stessa per ciascuno. Quel menu di completamento è il catalogo autorevole per una build ed è ciò che sitecli/exec-catalog.json registra.

Come è stato misurato e come si sovrappongono i set

Il set riportato di seguito non è trascritto da un documento del fornitore. È stato letto da nodi attivi con scripts/sitecli_ssh_harvest.py e salvato in sitecli/exec-catalog.json con la relativa provenienza. Tre esecuzioni, in tre stati di registrazione:

Misurato in	Primo livello	execcli
site_state: PROVISIONING	6	82
site_state: PROVISIONED	6	82
site_state: ONLINE	6	82

Tutte e tre hanno restituito set identici — gli stessi nomi, non semplicemente gli stessi totali, e l’ultima era un deployment diverso con nomi di sito e risorse differenti. Pertanto la superficie dei comandi non cambia con lo stato di registrazione, e un comando assente è genuinamente assente piuttosto che non ancora disponibile.

Rispetto ai 34 dell’API di debug, si ottengono due valori da tenere distinti:

• 51 sottocomandi execcli non hanno un equivalente API.
• 55 è lo stesso valore conteggiato sull’intera superficie on-box, perché include anche i quattro comandi configure*, che si trovano al primo livello anziché sotto execcli.

Entrambi sono corretti; un lettore che ricalcola uno e trova l’altro non ha commesso un errore. Ogni valore qui deriva da sitecli/catalog.json e sitecli/exec-catalog.json.

Cinque comandi che non esistono

factory-reset, upgrade, reboot, show e clear non sono presenti in questa build. Sono il tipo di comandi che una Site CLI potrebbe plausibilmente avere, sono stati inclusi nella classificazione di questo repository per un certo periodo in base a tale ipotesi, e nessuna enumerazione li ha trovati. Il primo livello ha esattamente sei voci: configure, configure-generic-hardware, configure-network, configure-http-proxy, diagnosis e health.

Tre comandi API non sono sottocomandi execcli

Cercare questi sotto execcli non restituisce nulla, il che si legge come “il comando è mancante”:

• health e diagnosis sono comandi Site CLI di primo livello. Digitarli direttamente al prompt >>> senza alcun prefisso execcli.
• dig è raggiungibile tramite la debug API e non appare in nessuno dei menu on-box, quindi è assente dall’elenco passthrough riportato di seguito. È solo API.

Cosa è documentato e cosa è solo elencato

Un Customer Edge esegue Linux e diversi demoni di terze parti. Documentare i loro comandi duplicherebbe i loro riferimenti e implicherebbe che F5 ne sia proprietaria, quindi la regola è: documentare il software F5, e per tutto il resto documentare solo ciò che è specifico di un CE.

Tre livelli, perché “nostro” e “altrui” non è una divisione netta. La divisione è registrata in sitecli/command-classification.json.

Livello	Trattamento
Software F5	Documentazione completa — scopo, sintassi, argomenti, output acquisito, cosa cercare. Argo, Vega, vpm, vifdump, configure*, il set edit-*, parametri kubelet, accesso root.
Interpretazione specifica per CE	Uno strumento di terze parti il cui output ha un significato particolare su un CE. Viene documentata la lettura specifica per CE e la semantica propria dello strumento viene lasciata a monte.
Passthrough	Linux puro o terze parti senza nulla di specifico per CE da segnalare. Elencato come disponibile, con un puntatore a monte. Nessun testo descrittivo.

Questa distinzione determina se una pagina esiste o meno, ed è ciò che impedisce a questa documentazione di degradarsi in una copia peggiore delle pagine man.

Software F5

Vega control planeSix vegactl commands: configuration objects, introspection tables, trace buffers, and which node holds the primary role.

EnvoyFour wrappers around Envoy's admin interface — listeners, clusters, and two config dumps.

Packet captureThe five vifdump commands. Documented, never run here: they write capture files onto the node.

Kubelet parametersRead, add and remove custom kubelet parameters. Support-directed.

vpm serviceThe agent that registers the node and runs the platform containers.

Configuration filesThe four edit-* commands that open F5-owned files on the node.

Auxiliary root accessCreating and removing the xuser root account. Support-directed, and it leaves the node modified.

Node configurationThe four configure* commands at the Site CLI top level.

Passthrough

Disponibili sul dispositivo e non documentati qui — si tratta del sistema operativo e dei demoni di terze parti, non del software F5, e i loro riferimenti propri sono migliori di qualsiasi cosa questa pagina potrebbe riformulare.

Comandi	A monte
ping, netstat, lsof, ip, ip-link-show, nmcli, tracepath	iproute2, NetworkManager
top, check-mem, sysctl, load-sysctl-conf, journalctl, files, rpm-ostree, chronyc-sources	coreutils, procps, systemd, rpm-ostree, chrony
edit-etc-hosts, edit-sysctl-conf	I file appartengono al sistema operativo
systemctl-status-crio, systemctl-status-docker, systemctl-status-kubelet, systemctl-status-iscsid, systemctl-status-multipathd	systemd
systemctl-restart-crio, systemctl-restart-docker, systemctl-restart-kubelet, systemctl-restart-iscsid, systemctl-restart-multipathd	systemd — ognuno di questi interrompe i workload sul nodo

Due di questi vale la pena conoscere anche se non hanno una pagina dedicata. files esegue operazioni sui file e scrive solo sotto /tmp. E ogni systemctl-restart-* è per definizione distruttivo — riavviare crio o kubelet interrompe i workload su quel nodo.

Sette comandi esistono su build più recenti e non su questa

collect-database-stats, iptables-lv, i tre comandi marker-exists-*, systemctl-restart-NetworkManager e systemctl-start-crio-prune sono assenti qui e presenti nella build 20260703-e2c462a, che quindi ha 89 comandi execcli rispetto agli 82 qui presenti. Comandi su build più recenti li documenta. Sono registrati sotto not_on_this_build.newer_build nella classificazione in modo che nulla qui venga scambiato per qualcosa che è possibile eseguire su crt-20250613-3382.

collect-debug-info è un caso a parte: non appare in nessun menu né in nessun catalogo. Il testo di benvenuto della Site CLI afferma che la CLI “consente di… raccogliere informazioni di debug per il supporto”, quindi il nome è stato molto probabilmente derivato da quella dicitura piuttosto che osservato. È contrassegnato come non verificato e deliberatamente non testato — eseguire speculativamente un comando sconosciuto su un nodo attivo è il modo in cui una cattura di pacchetti vifdump è stata avviata su un CE che stava ancora registrandosi.