Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

aggrega version

aggrega version imprime a versão da CLI aggrega.

Saída

Por predefinição, aggrega version imprime uma linha de versão legível por humanos.

Com -o json emite um objeto legível por máquina, indentado com dois espaços, na mesma forma que todos os comandos aggrega usam para a sua saída JSON. Leia-o com um analisador JSON; um consumidor que faça correspondência com o texto deve, em vez disso, remover os espaços em branco antes de fazer a correspondência, porque os nomes dos campos são o contrato e a disposição envolvente não é.

{
"version": "1.2.3",
"committed": "2026-07-09T18:07:57Z",
"commit": "a1b2c3d",
"abiVersion": "v1beta1",
"goVersion": "go1.23.0",
"platform": "linux/amd64"
}

Os campos provêm dos metadados de compilação incorporados no binário. committed é o carimbo temporal do commit, e só está presente quando a compilação registou um. abiVersion é a versão da ABI de plugins que o binário fala, que um pipeline pode ler para verificar a compatibilidade de plugins sem carregar nenhum plugin. Uma compilação de desenvolvimento que não tem versão incorporada reporta um valor sentinela (como (devel)) em vez de falhar.

Quando usar -o json

  • Uma extensão de editor compara a versão reportada pelo daemon com a versão para a qual foi construída, para detetar um binário aggrega serve incompatível antes de o conduzir.
  • As ferramentas de CI e de proveniência registam a compilação exata do compilador que produziu um artefacto.

Ver também

  • ./aggrega-serve.md — o daemon cuja versão um cliente verifica quanto à compatibilidade.

Sinopse

aggrega version [flags]

Descrição

Print the aggrega CLI's build identity.
By default the output is a single human-readable line followed by a
one-line pointer to the plugins compiled into the binary. With
-o json, the output is a structured JSON object suitable for
programmatic consumption (the VS Code extension uses this form to
read the binary's version at activation time), in the same indented
shape every aggrega command's JSON output uses.
With --verbose, the output replaces the pointer line with a table of
the embedded plugins — type, name, served capabilities, and commit —
under a header naming the count and their shared version. With
--verbose -o json, the JSON object gains an embeddedPlugins array
carrying the same detail.
Version strings are v-less (1.0.0, not v1.0.0), homogeneous with the
version form catalog entities use. Tagged release builds report the
release version, a build stamped with a version reports that version,
and a build carrying no version stamp reports the literal "(devel)",
which marks an unreleased build.

Flags

FlagPredefiniçãoDescrição
--output, -otextFormato de saída: text|json.
--verbosefalseincluir o conjunto de plugins incorporados na saída