Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

aggrega version

aggrega version stampa la versione della CLI aggrega.

Output

Per impostazione predefinita aggrega version stampa una riga di versione leggibile.

Con -o json emette un oggetto leggibile dalle macchine, indentato di due spazi, nella stessa forma che ogni comando aggrega usa per il proprio output JSON. Leggilo con un parser JSON; un consumer che invece fa corrispondenze sul testo dovrebbe rimuovere gli spazi bianchi prima del confronto, perché i nomi dei campi sono il contratto e la disposizione circostante no.

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

I campi provengono dai metadati di build incorporati nel binario. committed è il timestamp del commit, ed è presente solo quando la build ne ha registrato uno. abiVersion è la versione dell’ABI dei plugin parlata dal binario, che una pipeline può leggere per verificare la compatibilità dei plugin senza caricare alcun plugin. Una build di sviluppo che non contiene alcuna versione incorporata riporta un valore sentinella (come (devel)) anziché fallire.

Quando usare -o json

  • Un’estensione dell’editor confronta la versione riportata dal daemon con quella per cui è stata compilata, per rilevare un binario aggrega serve incompatibile prima di pilotarlo.
  • Gli strumenti di CI e di provenienza registrano l’esatta build del compilatore che ha prodotto un artefatto.

Vedi anche

  • ./aggrega-serve.md — il daemon di cui un client verifica la versione per la compatibilità.

Sinossi

aggrega version [flags]

Descrizione

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.

Flag

FlagPredefinitoDescrizione
--output, -otextFormato di output: text|json.
--verbosefalseinclude nell’output l’insieme dei plugin incorporati