Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

aggrega version

aggrega version imprime la versión de la CLI aggrega.

Salida

De forma predeterminada, aggrega version imprime una línea de versión legible por personas.

Con -o json emite un objeto legible por máquinas, con una sangría de dos espacios, con la misma forma que usa cada comando aggrega para su salida JSON. Léelo con un analizador JSON; un consumidor que en cambio busque coincidencias en el texto debería eliminar los espacios en blanco antes de comparar, porque los nombres de los campos son el contrato y la disposición que los rodea no lo es.

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

Los campos proceden de los metadatos de compilación incrustados en el binario. committed es la marca de tiempo del commit, y solo está presente cuando la compilación registró una. abiVersion es la versión de la ABI de plugins que habla el binario, que una canalización puede leer para comprobar la compatibilidad de plugins sin cargar ningún plugin. Una compilación de desarrollo que no lleva ninguna versión incrustada informa de un valor centinela (como (devel)) en lugar de fallar.

Cuándo usar -o json

  • Una extensión de editor compara la versión que informa el daemon con la versión para la que se compiló, para detectar un binario aggrega serve incompatible antes de manejarlo.
  • Las herramientas de CI y de procedencia registran la compilación exacta del compilador que produjo un artefacto.

Véase también

  • ./aggrega-serve.md: el daemon cuya versión comprueba un cliente para verificar la compatibilidad.

Sinopsis

aggrega version [flags]

Descripción

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

FlagPredeterminadoDescripción
--output, -otextFormato de salida: text|json.
--verbosefalseincluir en la salida el conjunto de plugins incrustados