Cosa fa questo modulo #
Quando avvii un'AMI imaxe, la prima domanda è spesso la più elementare: cosa c'è dentro? Quale versione del sistema operativo, quale software è installato e in quale versione, quale database c'è dietro e quale prodotto imaxe è stato distribuito.
Il modulo info risponde a tutto questo in un colpo solo: sonda il sistema dal vivo e scrive un inventario chiaro e leggibile in /etc/imaxe/info.yaml. Quel file raccoglie il sistema operativo, il software e le sue versioni, il database e il prodotto imaxe, pronto da consultare a schermo o in JSON per l'automazione.
Il file /etc/imaxe/info.yaml è puramente descrittivo: nomi e versioni. Non memorizza mai password, chiavi o token, così puoi leggerlo, copiarlo o allegarlo a un ticket con tranquillità.
Attività comuni #
Scegli cosa vuoi fare. Ogni ricetta porta il comando già scritto — basta copiarlo e premere Copia.
1
Generare l'inventario
Sonda la macchina e scrivi /etc/imaxe/info.yaml per la prima volta.
/etc/imaxe/info.yaml per la prima volta.Connettiti via SSH al tuo server con l'utente ubuntu.
Avvia create: percorre il sistema e scrive l'inventario su disco.
$ sudo imaxe info create/etc/imaxe/info.yaml viene scritto con il sistema operativo, il software e le sue versioni, il database e il prodotto imaxe.2
Vedere cosa ho installato
Mostra a schermo l'inventario già generato.
Leggi l'inventario memorizzato in /etc/imaxe/info.yaml:
$ imaxe info show3
Ottenere l'inventario in JSON
Output strutturato per script, monitoraggio o un inventario centralizzato.
Aggiungi --json a show per ottenere l'inventario in un formato leggibile dalla macchina:
$ imaxe info show --jsonVuoi estrarre un singolo valore? Combinalo con jq, per esempio la versione del sistema operativo:
$ imaxe info show --json | jq .osstdout, pronto per essere convogliato in jq, un agente di inventario o il tuo CMDB.4
Rigenerare dopo una modifica
Aggiorna l'inventario dopo aver installato o aggiornato software.
L'inventario è un'istantanea del sistema nel momento in cui è stato generato. Se hai aggiornato pacchetti o cambiato il database, esegui di nuovo create per riscriverlo con dati aggiornati:
$ sudo imaxe info create
$ imaxe info show/etc/imaxe/info.yaml riflette di nuovo lo stato reale della macchina.Il file riflette il sistema com'era quando è stato eseguito create. Non si aggiorna da solo: dopo qualsiasi modifica significativa al software, esegui di nuovo create affinché show resti fedele alla realtà.
Sinossi #
imaxe info <subcomando> [--json]Il sottocomando create richiede privilegi di root (usa sudo) perché scrive in /etc/imaxe/. Al contrario, show si limita a leggere l'inventario e può essere eseguito senza sudo. Aggiungi --json a show per ottenere un output leggibile dalla macchina adatto allo scripting.
Sottocomandi #
| Sottocomando | Cosa fa | Flag rilevanti |
|---|---|---|
| create | Sonda il sistema dal vivo e (ri)scrive l'inventario in /etc/imaxe/info.yaml. | — |
| show | Mostra l'inventario memorizzato in /etc/imaxe/info.yaml. | --json |
| help | Mostra l'aiuto del modulo. | — |
Argomenti e flag #
| Flag | Tipo | Predefinito | Descrizione |
|---|---|---|---|
| --json | bool | false | In show, emette l'inventario come JSON strutturato su stdout, adatto a jq e all'automazione. |
Il modulo info non accetta argomenti posizionali: ogni sottocomando opera sull'inventario del sistema stesso.
File e percorsi #
| Percorso | Contenuto |
|---|---|
| /etc/imaxe/info.yaml | Inventario dell'AMI: sistema operativo, software e versioni, database e prodotto imaxe. Puramente descrittivo, senza segreti. |
Esempio di info.yaml:
os:
name: Ubuntu
version: 22.04
software:
nginx: 1.18.0
php: 8.1
database:
engine: mysql
version: 8.0.36
product:
name: imaxe
version: 1.0.0Codici di uscita e log #
Ogni esecuzione restituisce un codice che puoi verificare con echo $? — utile per concatenare negli script:
show senza inventario: esegui prima create.create senza privilegi per scrivere in /etc/imaxe/.Risoluzione dei problemi #
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| show non mostra nulla o fallisce | L'inventario non è ancora stato generato. | Esegui sudo imaxe info create e riprova con show. |
| create dà un errore di permessi | È stato eseguito senza root e non può scrivere in /etc/imaxe/. | Rieseguilo con sudo imaxe info create. |
| L'inventario non corrisponde alla realtà | Del software è stato installato o aggiornato dopo la sua generazione. | Rigeneralo con sudo imaxe info create: è un'istantanea puntuale. |
L'output di --json non è pulito | --json è stato applicato a un sottocomando che non lo supporta. | --json vale solo per show; usalo come imaxe info show --json. |
Bloccato con il modulo Inventario?
Scrivici allegando l'output di «imaxe <module> status --json» e ti rispondiamo in fretta.