Lanzador Productos Bitnami Documentaciónimaxe CLI Blog Contacto
imaxe.cloud/ imaxe CLI/ Módulos/ info
imaxe info inventario v1.0.0

El inventario de tu servidor, de un vistazo

Sondea la máquina y escribe un inventario legible con el sistema operativo, el software instalado y sus versiones, la base de datos y el producto imaxe en /etc/imaxe/info.yaml. Sin secretos, sin sorpresas: un comando y sabes exactamente qué tienes.

$ imaxe info create
Versión
v1.0.0
Subcomandos
3
Inventario
/etc/imaxe/info.yaml
Requiere root
sí (create)
Secretos
nunca

Qué hace este módulo #

Cuando arrancas una AMI de imaxe, a menudo la primera pregunta es la más básica: ¿qué llevo dentro? Qué versión del sistema operativo, qué software está instalado y en qué versión, qué base de datos hay detrás y qué producto imaxe se ha desplegado.

El módulo info responde a eso de un tirón: sondea el sistema en vivo y escribe un inventario claro y legible en /etc/imaxe/info.yaml. Ese fichero reúne el sistema operativo, el software y sus versiones, la base de datos y el producto imaxe, listo para consultar por pantalla o en JSON para automatizar.

El inventario no contiene secretos

El fichero /etc/imaxe/info.yaml es puramente descriptivo: nombres y versiones. Nunca guarda contraseñas, claves ni tokens, así que puedes leerlo, copiarlo o adjuntarlo a una incidencia con tranquilidad.

Guía rápidatareas paso a paso

Tareas comunes #

Elige lo que quieres hacer. Cada receta trae el comando ya escrito — solo cópialo y pulsa Copiar.

Generar el inventario Ver qué llevo instalado Obtener el inventario en JSON Regenerar tras un cambio
1

Generar el inventario

Sondea la máquina y escribe /etc/imaxe/info.yaml por primera vez.

Conéctate por SSH a tu servidor con el usuario ubuntu.

Lanza create: recorre el sistema y escribe el inventario en disco.

terminal
$ sudo imaxe info create
El fichero /etc/imaxe/info.yaml queda escrito con el sistema operativo, el software y sus versiones, la base de datos y el producto imaxe.
2

Ver qué llevo instalado

Muestra el inventario ya generado por pantalla.

Consulta el inventario guardado en /etc/imaxe/info.yaml:

terminal
$ imaxe info show
Verás en pantalla el sistema operativo, el software con su versión, la base de datos y el producto imaxe. Si aún no existe el inventario, genéralo con la receta anterior.
3

Obtener el inventario en JSON

Salida estructurada para scripts, monitorización o inventario centralizado.

Añade --json a show para obtener el inventario en formato legible por máquina:

terminal
$ imaxe info show --json

¿Quieres extraer un solo dato? Combínalo con jq, por ejemplo la versión del sistema operativo:

terminal
$ imaxe info show --json | jq .os
El JSON sale por stdout, listo para canalizar hacia jq, un agente de inventario o tu CMDB.
4

Regenerar tras un cambio

Actualiza el inventario después de instalar o actualizar software.

El inventario es una foto del sistema en el momento de generarlo. Si has actualizado paquetes o cambiado la base de datos, vuelve a lanzar create para reescribirlo con los datos frescos:

terminal
$ sudo imaxe info create
$ imaxe info show
El fichero /etc/imaxe/info.yaml refleja de nuevo el estado real de la máquina.
El inventario es una foto, no un vigía

El fichero refleja el sistema tal como estaba al ejecutar create. No se actualiza solo: tras cualquier cambio importante en el software, vuelve a lanzar create para que show siga siendo fiel a la realidad.

Referencia CLIcomandos, flags y ficheros

Sinopsis #

uso
imaxe info <subcomando> [--json]

El subcomando create requiere privilegios de root (usa sudo) porque escribe en /etc/imaxe/. En cambio, show solo lee el inventario y puede ejecutarse sin sudo. Añade --json a show para obtener salida legible por máquina, apta para scripting.

Subcomandos #

SubcomandoQué haceFlags relevantes
createSondea el sistema en vivo y (re)escribe el inventario en /etc/imaxe/info.yaml.—
showMuestra el inventario guardado en /etc/imaxe/info.yaml.--json
helpMuestra la ayuda del módulo.—

Argumentos y flags #

FlagTipoPor defectoDescripción
--jsonboolfalseEn show, emite el inventario como JSON estructurado en stdout, apto para jq y automatización.

El módulo info no toma argumentos posicionales: cada subcomando opera sobre el inventario del propio sistema.

Ficheros y rutas #

RutaContenido
/etc/imaxe/info.yamlInventario de la AMI: sistema operativo, software y versiones, base de datos y producto imaxe. Puramente descriptivo, sin secretos.

Ejemplo de info.yaml:

/etc/imaxe/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.0

Códigos de salida y logs #

Cada ejecución devuelve un código que puedes comprobar con echo $? — útil para encadenar en scripts:

0OKInventario generado o mostrado correctamente.
1ERRError genérico no clasificado. Revisa el mensaje.
2USAGESubcomando o flag inválidos.
3NOFILEshow sin inventario: ejecuta antes create.
4PERMcreate sin privilegios para escribir en /etc/imaxe/.

Resolución de problemas #

SíntomaCausa probableSolución
show no muestra nada o fallaEl inventario aún no se ha generado.Ejecuta sudo imaxe info create y vuelve a probar show.
create da error de permisosSe lanzó sin root y no puede escribir en /etc/imaxe/.Relánzalo con sudo imaxe info create.
El inventario no cuadra con la realidadSe instaló o actualizó software después de generarlo.Regenéralo con sudo imaxe info create: es una foto del momento.
El --json no sale limpioSe aplicó --json a un subcomando que no lo soporta.--json solo aplica a show; úsalo como imaxe info show --json.

¿Te atascaste con el módulo Inventario?

Escríbenos con la salida de «imaxe <módulo> status --json» y te respondemos rápido.

Contactar con soporte