전역 플래그
모든 aggrega 하위 명령에서 사용할 수 있는 플래그입니다.
--workspace-root <path>
탐색을 완전히 건너뛰고 <path>를 워크스페이스 루트로 사용합니다. 이 플래그를 생략하면 aggrega는 현재 디렉터리에서 위쪽으로 올라가며 루트를 찾습니다. 이 탐색에서 아무것도 찾지 못하고 명령이 자신의 Release나 문서를 절대 경로로 지정하는 경우에는, 대신 그 파일의 폴더에서 위쪽으로 올라가며 찾습니다. 무엇이 루트의 기준이 되는지, 어떤 순서로 적용되는지, 어떤 명령이 그러한 파일을 지정하는지는 구성을 참고하십시오.
AGGREGA_WORKSPACE_ROOT는 이에 대응하는 환경 변수입니다. --workspace-root가 주어지지 않으면 이 변수가 루트를 제공합니다. 플래그가 설정되면 플래그가 우선합니다.
루트는 어디에서 주어지든, 서버를 포함하여 그대로 루트입니다. 자체 워크스페이스를 지정하지 않은 aggrega mcp 요청은 이 루트에서 응답되며, 그 위쪽은 전혀 탐색하지 않습니다. 존재하는 폴더가 아닌 루트, 즉 아무것도 가리키지 않거나 파일을 가리키는 경로는 워크스페이스를 읽는 모든 명령이 다른 작업을 하기 전에 거부합니다. aggrega serve와 aggrega mcp 리스너는 그러한 루트로는 시작하지 않으며, 표준 입력과 출력을 사용하는 aggrega mcp는 그대로 시작하되 해당 워크스페이스에서 동작하는 모든 호출에 거부로 응답합니다. 거부 메시지는 루트를 제공한 쪽인 --workspace-root 또는 AGGREGA_WORKSPACE_ROOT를 주어진 값 그대로 함께 표시합니다. aggrega version처럼 워크스페이스를 읽지 않는 명령은 루트도 읽지 않으므로 이 때문에 거부되지 않습니다.
둘 다 주어지지 않고 탐색으로도 기준을 찾지 못하면 명령이 실행되는 폴더가 루트가 되며, 워크스페이스를 읽는 명령은 표준 오류에 한 줄로 그 폴더와 이 플래그를 표시하여 이를 알립니다. 구성을 참고하십시오. 그러한 폴더에서 아티팩트 캐시에 아무것도 기록하지 않는 이유도 그곳에서 설명합니다.
전역 구성 파일
--config <path>는 한 번의 호출에 대해 전역 구성 파일을 명시적으로 지정합니다. 이 플래그는 AGGREGA_CONFIG 환경 변수보다 우선하며, 이 환경 변수는 다시 기본 위치보다 우선합니다. 그리고 둘 다 의도적으로 파일을 지정하는 것이므로, 존재하지 않는 경로는 조용한 대체가 아니라 명확한 오류가 됩니다. AGGREGA_* 설정 변수와 달리 둘 중 어느 것도 개별 설정을 재정의하지 않으며, 어떤 파일을 적용할지를 선택합니다. 어떤 파일로 결정되든 프로젝트 자체의 구성 파일은 여전히 그 위에 겹쳐 적용됩니다. 결정 순서와 그 파일에 들어갈 내용은 구성에서 설명합니다.
--config와 AGGREGA_CONFIG 환경 변수는 읽기 원본뿐 아니라 쓰기 대상도 선택합니다. --config <path>로 실행한 명령은 그 파일에서 구성을 읽고 변경 사항도 같은 파일에 적용하므로, 한 명령이 쓴 내용은 같은 호출 형태로 실행한 다음 명령이 다시 읽는 내용과 같습니다.
구성을 변경하는 명령은 설정의 성격에 따라 어느 파일에 쓸지 선택합니다. 머신 전체에 적용되는 도구 구성(레지스트리)은 기본적으로 전역 파일에 쓰고, 빌드에 관여하는 구성(provider 바인딩 또는 거버넌스/린터/임포터 소켓 연결)은 기본적으로 커밋된 프로젝트 파일에 씁니다. 이를 재정의하려면 --global 또는 --workspace를 전달하며, 명령은 어디에 썼는지 출력합니다.
새 머신에 전역 구성을 초기 설정하려면, 즉 레지스트리와 그 서명 신뢰 정책을 등록하여 YAML을 직접 편집하지 않고도 서명된 아티팩트를 풀하고 검증할 수 있게 하려면 aggrega config init을 실행합니다. 현재 적용되는 내용과, --origin을 사용하여 각 설정을 어느 계층이 결정했는지 확인하려면 aggrega config show를 실행합니다.
--offline
이번 한 번의 실행에서 모든 네트워크 접근을 거부합니다.
오프라인은 한 명령의 모드가 아니라 워크스페이스의 상태이며, 세 곳에서 지정할 수 있습니다. 이 플래그, AGGREGA_OFFLINE, 그리고 구성 파일의 최상위 offline 키입니다. 셋은 같은 의미이며 통상적인 우선순위를 따릅니다. 플래그가 변수보다 우선하고, 변수가 파일보다 우선합니다.
끄는 방향도 켜는 방향만큼 이 플래그의 역할입니다. --offline=false는 커밋된 구성 파일이나 내보낸 변수가 이 상태를 켜 둔 경우에도 한 명령에 대해 네트워크를 허용합니다. 이는 파일을 직접 수정할 수 없을 때 중요합니다. .aggrega-config.yaml에 offline: true가 있는 프로젝트는 이를 클론하는 모든 사람의 게시를 거부하며, --offline=false를 전달하는 것이 커밋도 내보낸 변수도 필요 없는 유일한 방법입니다.
거부되는 것과 거부되지 않는 것
경계는 어떤 명령을 입력했는지가 아니라 작업에 무엇이 필요한지로 정해집니다.
레지스트리에 접근하지 않고는 성립할 수 없으므로 거부되는 것:
- 어디에 나타나든
--upgrade. 이 플래그는 모든 의존성을 다시 해석하여 각각을 레지스트리가 현재 제공하는 가장 높은 버전으로 올리며, “사용 가능한 최신 버전”은 레지스트리가 지금 제공하는 것에 대한 주장입니다. 이를 웜 캐시에 대해 실행하면 우연히 캐시되어 있던 것을 고정하면서 최신 버전으로 올렸다고 보고하게 되며, 이는 중단보다 나쁩니다. - 작업 자체가 네트워크 왕복인 명령:
aggrega push,aggrega push-artifact,aggrega registry update. 이 명령들은 엔티티를 읽거나 저장소를 순회하기 전에 거부를 알리며, 거부 메시지는 세 곳 중 어디에서 상태가 설정되었는지 알려 주므로 플래그를 입력하지 않은 사람도 어디를 확인해야 할지 알 수 있습니다.
머신이 이미 충족할 수 있을지도 모르므로 거부되지 않는 것:
- 일반적인
aggrega pull과aggrega build --auto-pull. 둘 다 이미 기록된 고정을 따르고 고정이 없는 것만 해석하므로, 모든 참조가 캐시되어 있거나catalog_dirs카탈로그에 있는 워크스페이스는 외부에 전혀 접근하지 않고 완료됩니다. 이러한 실행이 실제로 무언가를 가져와야 하는 경우에는 그 시점에 거부되며, 어떤 참조를 충족할 수 없었는지 알려 줍니다. - 채워진 잠금 파일에 대한
aggrega build. 이 명령은 전체 클로저를 캐시에서 읽습니다. 유일한 네트워크 접근은 복구입니다. 고정된 외부 입력의 저장소 사본이 없어진 경우, 그 입력을 잠금 파일에 이미 기록된 다이제스트로 다시 가져옵니다. 이 상태에서는 그것을 위한 전송 수단조차 없으므로, 사본이 없으면 대신 상태를 명시하며 빌드가 중단됩니다. --dry-run게시. 이 게시는 무엇을 게시할지 보고할 뿐 아무것도 호출하지 않으므로, 상태에 모순되는 것이 아니라 오프라인에서 안전한 게시 형태입니다.
카탈로그와 아티팩트의 로컬 사본을 가진 에어갭 머신이 바로 이 구분이 계속 동작하도록 지키려는 경우입니다. 그러한 워크스페이스는 오프라인이지만, 하는 일의 거의 전부를 여전히 충족할 수 있습니다.
구성 우선순위
플래그는 모든 것보다 우선합니다. 환경 변수, 구성 파일, 내장 기본값보다 우선합니다. 전체 우선순위 단계는 구성에 있으며, AGGREGA_ 접두사가 붙은 변수 목록은 environment-variables.md에 있습니다.
aggrega config show --origin은 각 설정을 이 계층 중 어느 것이 결정했는지 보고하며, 입력한 플래그는 플래그로 보고됩니다. 따라서 거부 메시지가 예상하지 못한 계층을 지목한다면, 이 명령으로 이를 확인할 수 있습니다.
참고 항목
- configuration.md — 설정이 어느 파일에 속하는지, 그리고 전체 우선순위 모델.
- environment-variables.md —
AGGREGA_*변수 전체 레퍼런스. - aggrega-serve.md — 데몬은 동일한 루트 탐색 경로를 통해 워크스페이스를 결정합니다.
| 플래그 | 기본값 | 설명 |
|---|---|---|
--config | — | 전역 설정 파일의 경로로, AGGREGA_CONFIG 환경 변수와 기본 위치보다 우선합니다. 워크스페이스 트리의 설정 파일은 여전히 그 위에 겹쳐 적용됩니다 |
--no-color | false | 모든 출력에서 ANSI 색상을 비활성화합니다. NO_COLOR 환경 변수로도 적용됩니다 |
--offline | false | 이번 한 번의 실행에 대해 모든 네트워크 접근을 거부합니다. 설정을 편집하지 않고 오프라인 모드를 켜는 방법입니다. 설정 파일이나 AGGREGA_OFFLINE이 이미 오프라인 모드를 켜고 있는 경우, 한 번의 실행에서 이를 끄려면 —offline=false를 전달합니다. 거부되는 것은 레지스트리 없이는 성립할 수 없는 작업입니다. 즉, 각 의존성을 레지스트리가 현재 제공하는 가장 높은 버전으로 올리는 것이 유일한 역할인 —upgrade, 그리고 작업 자체가 네트워크 왕복인 명령인 push, push-artifact, registry update입니다. 계속 실행되는 것은 머신이 이미 충족할 수 있는 작업입니다. 채워진 lockfile을 기준으로 한 빌드, 이미 캐시되었거나 로컬 카탈로그에 있는 참조에 대한 —auto-pull, 그리고 무엇을 게시할지 보고만 하고 아무것도 호출하지 않는 dry run이 이에 해당합니다 |
--plain | false | 접근성 모드: 터미널에서도 색상을 비활성화하고, 스피너 애니메이션이나 커서 다시 그리기 없이 단순하고 정적인 진행 줄을 출력합니다. 화면 낭독기용입니다 |
--workspace-root | — | 워크스페이스 루트로 사용할 절대 경로 (탐색을 건너뜀) |