Lançador Produtos Bitnami Documentaçãoimaxe CLI Blog Contacto
imaxe.cloud/ imaxe CLI/ Módulos/ info
imaxe info inventário v1.0.0

O inventário do teu servidor, num relance

Sonda a máquina e escreve um inventário legível com o sistema operativo, o software instalado e as suas versões, a base de dados e o produto imaxe em /etc/imaxe/info.yaml. Sem segredos, sem surpresas: um comando e sabes exatamente o que tens.

$ imaxe info create
Versão
v1.0.0
Subcomandos
3
Inventário
/etc/imaxe/info.yaml
Requer root
sim (create)
Segredos
nunca

O que faz este módulo #

Quando lanças uma AMI imaxe, a primeira pergunta costuma ser a mais básica: o que tem lá dentro? Que versão do sistema operativo, que software está instalado e em que versão, que base de dados está por trás e que produto imaxe foi implementado.

O módulo info responde a tudo isso de uma vez: sonda o sistema ao vivo e escreve um inventário claro e legível em /etc/imaxe/info.yaml. Esse ficheiro reúne o sistema operativo, o software e as suas versões, a base de dados e o produto imaxe, pronto para ver no ecrã ou em JSON para automação.

O inventário não contém segredos

O ficheiro /etc/imaxe/info.yaml é puramente descritivo: nomes e versões. Nunca guarda palavras-passe, chaves ou tokens, por isso podes lê-lo, copiá-lo ou anexá-lo a um ticket com tranquilidade.

Guia rápidotarefas passo a passo

Tarefas comuns #

Escolhe o que queres fazer. Cada receita traz o comando já escrito — basta copiá-lo e clicar em Copiar.

Gerar o inventário Ver o que tenho instalado Obter o inventário em JSON Regenerar após uma alteração
1

Gerar o inventário

Sonda a máquina e escreve /etc/imaxe/info.yaml pela primeira vez.

Liga-te por SSH ao teu servidor com o utilizador ubuntu.

Executa create: percorre o sistema e escreve o inventário no disco.

terminal
$ sudo imaxe info create
O ficheiro /etc/imaxe/info.yaml é escrito com o sistema operativo, o software e as suas versões, a base de dados e o produto imaxe.
2

Ver o que tenho instalado

Mostra no ecrã o inventário já gerado.

Lê o inventário guardado em /etc/imaxe/info.yaml:

terminal
$ imaxe info show
Verás no ecrã o sistema operativo, o software com a sua versão, a base de dados e o produto imaxe. Se o inventário ainda não existir, gera-o com a receita anterior.
3

Obter o inventário em JSON

Saída estruturada para scripts, monitorização ou um inventário centralizado.

Adiciona --json a show para obter o inventário num formato legível por máquina:

terminal
$ imaxe info show --json

Queres extrair um único valor? Combina-o com jq, por exemplo a versão do sistema operativo:

terminal
$ imaxe info show --json | jq .os
O JSON sai em stdout, pronto para encaminhar para o jq, um agente de inventário ou o teu CMDB.
4

Regenerar após uma alteração

Atualiza o inventário após instalar ou atualizar software.

O inventário é uma foto do sistema no momento em que foi gerado. Se atualizaste pacotes ou mudaste a base de dados, executa create de novo para o reescrever com dados frescos:

terminal
$ sudo imaxe info create
$ imaxe info show
O ficheiro /etc/imaxe/info.yaml volta a refletir o estado real da máquina.
O inventário é uma foto, não um vigia

O ficheiro reflete o sistema tal como estava quando o create foi executado. Não se atualiza sozinho: após qualquer alteração significativa ao software, executa create de novo para que show se mantenha fiel à realidade.

Referência CLIcomandos, flags e ficheiros

Sinopse #

uso
imaxe info <subcomando> [--json]

O subcomando create requer privilégios de root (usa sudo) porque escreve em /etc/imaxe/. Em contraste, show apenas lê o inventário e pode correr sem sudo. Adiciona --json a show para obter saída legível por máquina, apta para scripting.

Subcomandos #

SubcomandoO que fazFlags relevantes
createSonda o sistema ao vivo e (re)escreve o inventário em /etc/imaxe/info.yaml.—
showMostra o inventário guardado em /etc/imaxe/info.yaml.--json
helpMostra a ajuda do módulo.—

Argumentos e flags #

FlagTipoPor omissãoDescrição
--jsonboolfalseEm show, emite o inventário como JSON estruturado em stdout, apto para jq e automação.

O módulo info não recebe argumentos posicionais: cada subcomando opera sobre o próprio inventário do sistema.

Ficheiros e caminhos #

CaminhoConteúdo
/etc/imaxe/info.yamlInventário da AMI: sistema operativo, software e versões, base de dados e produto imaxe. Puramente descritivo, sem segredos.

Exemplo 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 saída e logs #

Cada execução devolve um código que podes verificar com echo $? — útil para encadear em scripts:

0OKInventário gerado ou mostrado com sucesso.
1ERRErro genérico não classificado. Revê a mensagem.
2USAGESubcomando ou flag inválido.
3NOFILEshow sem inventário: executa create primeiro.
4PERMcreate sem privilégios para escrever em /etc/imaxe/.

Resolução de problemas #

SintomaCausa provávelSolução
show não mostra nada ou falhaO inventário ainda não foi gerado.Executa sudo imaxe info create e tenta show de novo.
create dá um erro de permissõesFoi executado sem root e não consegue escrever em /etc/imaxe/.Volta a executá-lo com sudo imaxe info create.
O inventário não coincide com a realidadeFoi instalado ou atualizado software depois de ter sido gerado.Regenera-o com sudo imaxe info create: é uma foto de um instante concreto.
A saída --json não está limpa--json foi aplicado a um subcomando que não o suporta.--json só se aplica a show; usa-o como imaxe info show --json.

Ficou bloqueado com o módulo Inventário?

Escreva-nos com a saída de «imaxe <module> status --json» e respondemos rapidamente.

Contactar o suporte