콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

aggrega version

aggrega version은 aggrega CLI의 버전을 출력합니다.

출력

기본적으로 aggrega version은 사람이 읽을 수 있는 버전 한 줄을 출력합니다.

-o json을 지정하면 모든 aggrega 명령이 JSON 출력에 사용하는 것과 같은 형태로, 두 칸 들여쓰기된 기계 판독용 객체를 출력합니다. JSON 파서로 읽으십시오. 대신 텍스트를 대상으로 매칭하는 소비자는 매칭 전에 공백을 제거해야 합니다. 필드 이름은 계약이지만 주변 레이아웃은 계약이 아니기 때문입니다.

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

필드는 바이너리에 내장된 빌드 메타데이터에서 가져옵니다. committed는 커밋 타임스탬프이며, 빌드가 이를 기록한 경우에만 존재합니다. abiVersion은 바이너리가 사용하는 플러그인 ABI 버전으로, 파이프라인은 이를 읽어 플러그인을 로드하지 않고도 플러그인 호환성을 확인할 수 있습니다. 내장된 버전이 없는 개발 빌드는 실패하지 않고 센티널 값(예: (devel))을 보고합니다.

-o json을 사용하는 경우

  • 편집기 확장은 데몬이 보고한 버전을 자신이 빌드된 대상 버전과 비교하여, 호환되지 않는 aggrega serve 바이너리를 구동하기 전에 감지합니다.
  • CI 및 출처 추적 도구는 아티팩트를 생성한 정확한 컴파일러 빌드를 기록합니다.

참고 항목

  • ./aggrega-serve.md — 클라이언트가 호환성을 위해 버전을 확인하는 데몬입니다.

개요

aggrega version [flags]

설명

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.

플래그

플래그기본값설명
--output, -otext출력 형식: text|json.
--verbosefalse출력에 내장 플러그인 집합을 포함합니다