경고 및 린터 출력
컴파일러가 컴파일 중에 내보내는 치명적이지 않은 경고입니다. 경고는 빌드를 중단하지 않습니다. 경고는 작성상의 문제 징후, 컴파일러가 선택한 결정적 동점 처리, 그리고 개발자의 템플릿이 한 번도 사용하지 않은 리소스를 드러냅니다. 각 발견 사항은 그 종류를 나타내는 접두사 뒤에 붙어 stderr로 전달되며, 접두사는 어느 패스가 발생시켰는지에 따라 warning:, lint:, notice: 중 하나입니다. 따라서 CI 파이프라인이 이를 수집하여 다시 드러낼 수 있습니다. 렌더링된 아티팩트는 이와 관계없이 생성됩니다.
치명적인 컴파일 중단(빌드를 멈추는 진단)에 대해서는 fatal-halts.md를 참조하십시오.
모든 권고 항목(단축 코드순)
컴파일러가 빌드를 중단하지 않고 보고하는 항목 중 일부는 그 자체로 하나의 조건입니다. 이러한 항목은 단축 코드, 즉 중단 진단이 출력하는 것과 같은 네 자리 식별자를 가지며, 메시지는 고정된 문장으로 시작합니다. 아래 표는 하나에서 다른 하나로 찾아가는 조회를 제공하므로, 읽고 있는 줄이 중단이 아니라 경고인 경우에도 가지고 있는 코드로 해당 발견 항목이 무엇에 관한 것인지 확인할 수 있습니다.
여기에 실리는 기준은 설명이 아니라 선언입니다. 컴파일러가 평가하는 모든 규칙은 위반 시 어떻게 되는지, 즉 빌드를 중단하는지 아니면 발견 항목을 보고하고 빌드를 끝까지 진행하는지를 명시하며, 아래 행은 후자에 해당합니다. 따라서 컴파일러에 권고 항목이 추가되면 행을 직접 작성하지 않아도 여기에 나타나고, 중단 조건으로 바뀐 항목은 여기에서 빠집니다.
표가 다루는 범위에는 두 가지 한계가 있으며, 코드가 누락되었다고 결론 내리기 전에 둘 다 알아 두는 것이 좋습니다.
- 이 페이지의 모든 항목이 여기에 해당하는 것은 아닙니다. 아래에서 설명하는 발견 항목 중 일부는 선언된 규칙이 아니라 별도의 패스에서 발생하며, 일부는 조건을 전혀 가지지 않습니다. 이러한 항목이 출력하는 줄은 여전히 각 섹션에서 설명한 그대로이지만, 조회할 코드가 없으므로 행도 없습니다.
unsupported-field클래스 코드가 그 경우의 전형적인 형태로, 이 코드는 조건이 아니라 발견 항목의 클래스를 나타냅니다. - 여기에 행이 있다고 해서 아래에 섹션이 있는 것은 아닙니다. 렌더링 후반에 발생하는 권고 항목은 설명되지 않고 목록으로만 정리되므로, 어떤 코드는 여기에서 한 문장으로 조회되고 더 자세한 설명은 fatal-halts.md의 “Conditions that do not halt a build(빌드를 중단하지 않는 조건)”에 있을 수 있습니다. 이 섹션은 빌드를 중단하지 않으면서 코드를 가지는 모든 조건을 정리합니다.
sentinels.md는 빌드가 출력하는 모든 단축 코드를 권고든 중단이든 조회할 수 있으며, 가지고 있는 코드가 어느 종류인지 아직 모를 때 시작하기 좋은 곳입니다.
| 짧은 코드 | 시작 문장 |
|---|---|
E0004 | annotation contribution overridden by an explicit value |
E0037 | cross-boundary link between endpoints rendered by different providers is not supported |
E0149 | attachment name is a near miss for a declared slot |
E0167 | Recipe publishes a provides key its Component does not declare |
E0173 | declared parameter is read by no reference in the Aggregate |
E0174 | uses socket name is a near miss for a declared socket |
E0256 | annotation binding declares one path in both pillar lists |
E0297 | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
Schema-pillar-overlap 린트
발생 조건: Component 또는 Feature가 spec.schema: 블록의 values: 필러와 infra: 필러 양쪽에 같은 중첩 깊이로 같은 속성 이름을 선언한 경우입니다. 두 필러에 같은 필드 이름을 둔 스키마 작성자는 대개 둘 중 한쪽에만 두려던 것이므로, 이 린트는 중복을 표시하여 작성자가 어느 필러가 그 필드를 소유할지 정할 수 있게 합니다.
파이프라인 내 위치. 이 린트는 스키마 통합 이후, 토폴로지 구성 이전의 검증 단계에서 실행됩니다. 축약형 확장 이후의 스키마를 $ref:를 따라가지 않고 순회하며(아래의 소프트 스킵 원칙 참조), 겹치는 각 속성을 별도의 경고로 보고합니다.
출력 형태:
notice: LINT: Component "core/compute/web-server:1.0.0" at ./catalog/component/core/compute/web-server/1.0.0/component.yaml declares property "storage_size" in both values: and infra: pillars (path: storage_size)중첩된 속성의 경우 경로는 필러 루트에서 해당 속성까지의 점 표기 경로입니다:
notice: LINT: Feature "core/db-pool:1.0.0" at ./catalog/feature/core/db-pool/1.0.0/feature.yaml declares property "timeout" in both values: and infra: pillars (path: connection.timeout)카탈로그 전체를 로드할 때(인수 없는 aggrega validate)는 위와 같이 각 엔터티를 이름과 버전, 그리고 읽어 들인 파일로 지칭합니다. 빌드나 하나의 Release에 대한 검증은 그 Release가 도달하는 엔터티만 읽으며, 각 엔터티를 이름과 버전으로 지칭합니다 — at core/db-pool:1.0.0. Release 안의 몇 개의 참조가 도달하든 엔터티당 한 번만 보고합니다. Feature를 이름만으로 지칭하는 Aggregate와 이름과 버전으로 매핑하는 Manifest는 하나의 Feature에 도달하며, 이는 한 번만 보고됩니다.
편집기 표시. 이 결과는 언어 서버를 통해 경고 심각도로 편집기 진단에 전달되며, 키가 아니라 파일의 맨 앞에 표시됩니다. 편집 중인 문서 내부의 위치가 아니라 카탈로그 엔터티를 지칭하므로 마커를 둘 작성 키가 없기 때문입니다. 아티팩트 렌더링 단계 이전에 발생하므로 별도의 설정이 필요 없습니다. 편집기 세션은 serve.build_on_inspect가 켜져 있는지와 관계없이 이를 표시합니다.
소프트 스킵 원칙. 스키마 분기가 정적으로 도출 가능한 속성 집합을 막는 JSON Schema 2020-12 탈출구 중 하나를 포함하면 순회기는 경고 없이 종료합니다. 해당 탈출구는 $ref(문서 간 또는 문서 내 참조), patternProperties(키 형태 기반 속성 선언), true 또는 스키마로 설정된 additionalProperties(분기가 이름을 지정하지 않고 허용하는 속성), 그리고 합성 연산자 oneOf / anyOf / allOf(분기마다 서로 다른 속성 집합을 선언할 수 있는 논리합과 논리곱)입니다. 이러한 분기를 순회하려면 린트 시점에 참조되거나 합성된 스키마를 평가해야 하거나(린트가 수행하지 않는 종류의 작업), 한 분기의 values: 속성 이름이 다른 분기의 infra: 속성 이름과 우연히 겹칠 때 오탐이 발생합니다. 린트는 영향을 받는 중첩 깊이에 대해 경고를 내지 않으며, 같은 스키마의 더 깊은 수준은 여전히 순회되고 린트 대상이 됩니다.
작성 참고. 컴파일러는 필러 이름 중복을 거부하지 않습니다. 이 린트는 권고 사항입니다. 두 필러 모두에 storage_size가 있는 Component도 컴파일됩니다. 개발자 측 values.storage_size와 운영자 측 infra.storage_size는 각 필러 스키마에 의해 독립적으로 검증되며, 어느 필러의 값이 렌더링 출력으로 흘러갈지는 Recipe의 valuesMapping: 템플릿이 선택합니다. 이 린트가 존재하는 이유는 이러한 작성 패턴이 거의 항상 실수이기 때문입니다. 의도적인 필러 간 중복은 충분히 드물어서, 정말로 이를 원하는 작성자는 경고를 무시하면 됩니다. 의도적인 필러 간 전달이 정당한 드문 경우를 포함한 더 넓은 필러 간 동작 방식은 vocabulary/data-pillars.md의 “Cross-pillar mechanics(필러 간 동작 방식)”를 참조하십시오.
바인딩 맵 중복 린트
발생 조건: Manifest 어노테이션 바인딩이 maps.infra 목록과 maps.values 목록 양쪽에 동일한 점 표기 경로를 선언한 경우입니다. 이 경로는 두 필러를 모두 거쳐 라우팅되며, 컴파일러의 결정적 타이브레이크는 이를 infra:로 보내므로 Aggregate에서 values: 쪽에 도달할 수 없게 됩니다. 린트는 이를 드러내어 작성자가 바인딩을 단일 필러로 좁히거나 infra 쪽 전용 라우팅을 의식적으로 수용할 수 있게 합니다.
파이프라인 내 위치. 이 린트는 Manifest가 해석된 후, 어노테이션 확장이 실행되기 전에 실행되므로, 빌드는 Aggregate 어노테이션이 해당 바인딩에 실제로 도달하는지와 관계없이 중복된 바인딩을 보고합니다. 린트는 mappings.features.annotations 아래의 바인딩을 작성된 순서대로 순회하며, 각 바인딩의 maps.infra 목록과 maps.values 목록의 교집합을 구하고, 중복된 경로마다 하나의 결과를 보고합니다. 하나의 바인딩 안에서 중복된 경로는 해당 바인딩의 maps.values 목록이 선언한 순서, 즉 작성한 순서대로 보고되므로, 동일한 입력에 대해 반복 실행하면 동일한 순서가 보고됩니다.
출력 형태:
lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations, "compliance.aggrega.ai/data-class", on Feature "core/pii-redaction", at path "classifier_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values") lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations.audit-scope, "audit-scope", on Feature "core/pii-redaction", at path "retention_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values")위의 두 줄은 하나의 Manifest에 대한 하나의 빌드에서 나온 것이며, 두 로케이터의 차이는 어노테이션 키의 형태에 있습니다. 로케이터는 점 표기 경로로 문서를 가리키므로, 자체적으로 마침표를 포함하는 첫 번째 세그먼트에서 멈춥니다. audit-scope에는 마침표가 없어 로케이터가 바인딩까지 도달하지만, compliance.aggrega.ai/data-class에는 마침표가 있어 로케이터는 대신 이를 담고 있는 annotations 블록을 가리킵니다. 문제가 된 키가 모든 결과의 첫 번째 인용 값이기도 한 것은 이 때문입니다. 로케이터가 항상 담을 수 있는 것은 아닌 유일한 부분이기 때문입니다.
에디터 표시. 이 결과는 언어 서버를 통해 에디터 진단에도 경고 심각도로 전달되며, 로케이터가 도달하는 위치에 표시됩니다. 일반 키라면 바인딩 자체에, 마침표를 포함한 키라면 이를 둘러싼 annotations 블록에 표시됩니다. 터미널 출력을 읽지 않는 작성자도 이를 볼 수 있습니다. 이 결과는 아티팩트 렌더링 단계 이전에 발생하므로 별도의 설정이 필요하지 않습니다. 에디터 세션은 serve.build_on_inspect가 켜져 있는지와 관계없이 이를 표시합니다.
프로그램에서 일치시키기. 이 결과는 pkg/resolver의 ErrAnnotationBindingPillarOverlap를 담고 있으므로, 소비자는 메시지 텍스트를 일치시키는 대신 errors.Is로 이 유형을 인식할 수 있습니다. 모든 권고 센티널과 마찬가지로 이 결과는 빌드의 판정에 영향을 주지 않습니다. 접근자와 해당 조건의 코드는 sentinels.md를 참조하십시오.
결정적 타이브레이크. 런타임은 경로를 infra: 필러로만 라우팅하여 충돌을 해결합니다. 이 선택은 빌드 간에 일관되므로 작성자가 이에 의존할 수 있습니다. values: 쪽은 바인딩의 실질적인 라우팅에서 제외됩니다. 해당 경로에 도달하려는 Aggregate 쪽 어노테이션은 라우팅 대상을 받지 못하며, 빌드는 확장 시점에 Aggregate 쪽에서 중단됩니다. 이 중단은 fatal-halts.md의 “An annotation routes through a pillar its authoring side may not use (어노테이션이 작성 측에서 사용할 수 없는 필러를 통해 라우팅됨)”에 설명되어 있습니다. 린트는 조기 경고 수단이고, 해당 중단은 강제 수단입니다.
작성 참고. 스키마 필러 중복 린트와 마찬가지로 이 린트는 권고 사항입니다. 바인딩은 컴파일되며 런타임 타이브레이크는 결정적인 출력을 생성합니다. 이 린트가 발생하는 이유는 이러한 작성 패턴이 거의 항상 의도하지 않은 것이기 때문입니다. 두 필러가 동일한 경로를 라우팅하기를 실제로 원하는 바인딩 작성자라면 서로 다른 어노테이션 키를 가진 두 개의 별도 바인딩을 작성할 것입니다.
Attachment-slot near-miss 린트
발생 조건: 컴포넌트 인스턴스가 Feature를 해당 Component 타입이 선언한 featuresSchema 슬롯이 아닌 이름으로 연결했지만, 그 이름이 어떤 슬롯과 한 번의 편집 거리 — 문자 하나의 삽입, 삭제 또는 치환, 혹은 인접한 두 문자의 자리바꿈 — 안에 있고, 연결된 Feature가 그 슬롯의 selector를 충족하지 않는 경우입니다. 이는 슬롯 이름 오타가 나타나는 형태이며, 린트는 작성자가 그 쌍을 볼 수 있도록 두 철자를 모두 표시합니다.
존재 이유. 슬롯을 선언해도 연결 표면이 닫히지는 않습니다. 어떤 슬롯도 선언하지 않은 이름으로 연결하는 것은 적법한데, 이러한 개방성 덕분에 하나의 카탈로그 엔티티가 슬롯을 채우는 연결과 더 넓은 범위에서 공유되는 자격 증명 양쪽에 모두 쓰일 수 있기 때문입니다. 그 대가로, 슬롯 이름을 잘못 쓰면 작성자가 의도한 슬롯을 채우는 대신 아무 표시 없이 자유 연결이 됩니다. 빌드는 성공하고 슬롯은 그냥 빈 채로 남습니다. 린트는 바로 그 경우에 대해 공개된 완화책입니다.
파이프라인 위치. 린트는 해석 단계에서, 카탈로그를 인식하는 의미 검사와 같은 패스 안에서, 해석된 Aggregate를 대상으로 실행됩니다. 모든 컴포넌트 인스턴스의 연결 이름을 해당 인스턴스의 Component 타입이 선언한 슬롯 이름과 대조하며, near-miss 쌍마다 경고를 하나씩 내보냅니다.
출력 형태:
lint: attachment name is a near miss for a declared slot (Aggregate nearmiss, at .spec.components.db.features.app_user_passwrod, "app_user_passwrod", on component type "core/datastore/postgres", near the declared slot "app_user_password")첫 번째로 인용된 값은 연결이 작성된 이름이며, 경고의 첫 문장이 다루는 대상입니다. 뒤따르는 두 값은 각각 무엇인지 말해 주는 단어로 시작합니다. 연결이 놓인 Component 타입, 그리고 그 연결과 한 번의 편집 거리 안에 있는 선언된 슬롯입니다.
편집기 표시. 이 경고는 언어 서버를 통해 편집기 진단에도 경고 심각도로 전달되며, 문제가 되는 연결 키 위에 표시됩니다. 터미널 출력을 읽지 않는 작성자도 그 쌍을 볼 수 있습니다. 아티팩트 렌더링 단계 이전에 발생하므로 별도의 설정이 필요 없습니다. 편집기 세션은 serve.build_on_inspect가 켜져 있는지와 관계없이 이 경고를 표시합니다.
임계값과 그 절충. 린트는 한 번의 편집 거리에 있는 이름만, 그리고 두 이름이 모두 네 글자 이상일 때만 쌍으로 묶습니다. 그보다 짧으면 거의 모든 짧은 이름이 서로 한 번의 편집 거리 안에 있으므로 쌍으로 묶으면 신호가 아니라 잡음이 됩니다. 편집이 두 번 이상이면 그 쌍은 더 이상 오타처럼 보이지 않습니다. 자리바꿈은 두 번이 아니라 한 번의 편집으로 계산하는데, 두 문자가 뒤바뀌는 것이 가장 흔한 실수이고 더 엄격하게 세면 이를 놓치기 때문입니다.
작성 참고. 이 린트는 권고 사항이며 빌드 판정을 바꾸지 않습니다. 컴파일러는 작성자가 연결에 어떤 이름을 붙이는지 단속하지 않습니다. 슬롯과 비슷한 이름으로 의도적으로 Feature를 연결하는 작성자는 경고를 무시해도 되며, 연결은 작성된 그대로 동작합니다.
Feature가 슬롯에 맞는 경우는 제외. 연결된 Feature가 selector를 충족하는 슬롯과 한 번의 편집 거리에 있는 이름에는 경고가 나오지 않습니다. 그런 쌍은 오타로 생긴 자유 연결이 아니라 다른 이름으로 작성된 채움이며, 그것이 문제가 되는지는 슬롯이 결국 비게 되는지에 달려 있고, 이는 모든 범위가 접힌 뒤에야 알 수 있습니다. 슬롯이 빈 채로 남으면 빌드가 중단되고 그 연결과 슬롯을 지목합니다. fatal-halts.md의 “An attachment written under another name fits a slot its component leaves empty (다른 이름으로 작성된 연결이 컴포넌트가 비워 둔 슬롯에 맞음)”를 참조하십시오. 따라서 보고되는 결과는 중단 하나뿐이며, 그 옆에 경고가 함께 나오지 않습니다. 다른 무언가가 슬롯을 바인딩하면 그 연결은 평범한 추가 연결이며 아무것도 보고되지 않습니다. selector를 선언하지 않은 슬롯에는 어떤 Feature도 맞지 않으므로, 그런 슬롯과 가까운 이름에는 항상 경고가 나옵니다.
연결(connection)에는 적용되지 않음. 이 린트는 컴포넌트 자체의 features: 블록을 읽으며, 이 블록은 열려 있습니다. connection이 지니는 연결은 해당 소켓이 선언한 슬롯으로만 키가 지정되므로, 그 슬롯 중 하나와 한 번의 편집 거리에 있는 이름은 그곳에서 적법하지 않습니다. 대신 빌드가 중단되며, 중단 메시지는 같은 문장 안에서 그 이름과 가까운 슬롯을 지목합니다. 그 옆에 경고는 발생하지 않습니다. fatal-halts.md의 “A connection carries an attachment under a name its socket declares no slot for (connection이 소켓에 선언된 슬롯이 없는 이름으로 연결을 지님)”를 참조하십시오.
Uses-socket 근접 오타 린트
발생 조건: 컴포넌트 자체의 uses: 블록이 해당 Component 타입에 선언된 usesSchema 소켓에 속하지 않지만 그중 하나와 편집 한 번 차이인 소켓을 지정할 때 발생합니다. 편집 한 번이란 문자 하나의 삽입, 삭제, 치환 또는 인접한 두 문자의 교환을 말합니다. 이것이 소켓 이름 오타가 나타나는 형태이며, 린트는 작성자가 두 철자를 비교할 수 있도록 둘 다 표시합니다.
존재 이유. 소켓을 선언해도 개발자 자신의 컴포넌트에서 uses: 표면이 닫히지는 않습니다. 어떤 usesSchema 항목도 선언하지 않은 소켓 이름도 유효합니다. 카탈로그가 어떤 소켓에 대해 언급하지 않는다는 것은 해당 연결이 금지되었다는 뜻이 아니라 예상되지 않았다는 뜻이며, Aggregate의 토폴로지는 개발자가 소유하기 때문입니다. 그 대가로, 철자가 틀린 소켓 이름은 작성자가 의도한 소켓을 연결하는 대신 그 자체로 하나의 애드혹 연결이 됩니다. 빌드는 성공하고, 의도한 소켓은 그대로 연결되지 않은 채 남으며, 애드혹 엣지에는 셀렉터도 엣지별 계약도 없습니다. 이 린트는 바로 그 경우를 위해 공개된 완화책입니다. 애드혹 소켓이 무엇을 포기하고 무엇을 유지하는지는 entities/component.md의 “Topology Sockets: usesSchema”를 참조하십시오.
적용 범위. 컴포넌트 자체의 uses: 블록만 해당합니다. 이것이 선언되지 않은 소켓 이름이 허용되는 유일한 표면입니다. Feature 부착의 uses:는 부착된 Feature가 선언한 소켓만 지정할 수 있고, Release의 엣지별 uses:는 소비하는 Component가 선언한 소켓만 지정할 수 있습니다. 이 두 곳에서 잘못된 이름은 이미 빌드를 중단시키므로 경고가 더할 것이 없습니다.
파이프라인 위치. 이 린트는 해석 단계에서, 카탈로그 인식 의미 검사와 같은 패스에서, 해석된 Aggregate를 대상으로 실행됩니다. 모든 컴포넌트 인스턴스 자체의 소켓 이름을 해당 인스턴스의 Component 타입에 선언된 소켓 이름과 대조하며, 근접 오타 쌍마다 경고를 하나씩 출력합니다. 하위 aggregate에서 들어온 컴포넌트는 대상이 아닙니다. 그 내부 컴포넌트는 이 패스가 실행된 후에 그래프에 합쳐지기 때문입니다.
출력 형태:
lint: uses socket name is a near miss for a declared socket (Aggregate aggregate, at .spec.components.web, "databses", on component type "core/devtool/adminer", near the declared socket "databases")첫 번째로 인용된 값은 작성자가 쓴 소켓 이름이며, 경고의 첫 문장이 다루는 대상입니다. 그 뒤의 두 값은 각각 무엇인지 밝히는 단어로 소개됩니다. 하나는 소켓이 지정된 Component 타입이고, 다른 하나는 그 이름과 편집 한 번 차이인 선언된 소켓입니다. 경고가 명시하지 않는 결과는 위에서 설명한 것입니다. 철자가 틀린 이름은 애드혹 연결이므로 셀렉터도 엣지별 계약도 없으며, 작성자가 의도한 소켓은 연결되지 않은 채 남습니다.
에디터 표시. 이 경고는 언어 서버를 통해 에디터 진단에도 경고 심각도로 전달되며, 문제가 되는 이름을 담은 uses: 블록이 있는 컴포넌트에 위치합니다. 터미널 출력을 읽지 않는 작성자도 이 쌍을 볼 수 있습니다. 이 경고는 아티팩트 렌더링 단계 이전에 발생하므로 별도 설정이 필요 없습니다. serve.build_on_inspect가 켜져 있든 아니든 에디터 세션에 표시됩니다.
임계값과 그 트레이드오프. 이 린트는 편집 거리가 1인 경우에만, 그리고 두 이름이 모두 네 글자 이상인 경우에만 이름을 짝짓습니다. 이는 attachment-slot 근접 오타 린트와 같은 기준이며 이유도 같습니다. 그보다 짧으면 거의 모든 짧은 이름이 서로 편집 한 번 차이 안에 들어오므로, 짝을 지으면 신호가 아니라 잡음이 생깁니다. 편집 한 번을 넘으면 그 쌍은 더 이상 오타처럼 보이지 않습니다. 문자 교환은 두 번이 아니라 한 번의 편집으로 셉니다. 두 문자가 뒤바뀌는 것이 가장 흔한 실수이며, 더 엄격하게 세면 이를 놓치게 되기 때문입니다.
작성 참고. 이 린트는 권고 사항일 뿐 빌드 판정을 바꾸지 않습니다. 컴파일러는 작성자가 소켓에 어떤 이름을 붙이는지 단속하지 않습니다. 선언된 소켓과 비슷한 이름으로 의도적으로 애드혹 연결을 만드는 작성자(선언된 caches 소켓과 별개로 다른 용도의 cache 연결을 두는 경우)는 이 경고를 무시해도 됩니다. 엣지는 작성한 그대로 동작합니다. 이 경고를 억제하는 플래그는 없으며, 필요하지도 않습니다. 판정에 아무런 영향을 주지 않기 때문입니다.
Undeclared-provides-key 린트
발생 조건: 컴포넌트 인스턴스에 바인딩된 Recipe가 provides: 아래에 키를 게시했는데, 그 인스턴스의 Component 타입이 자신의 spec.schema.provides: 계약에서 그 키를 선언하지 않은 경우입니다.
존재 이유. Component가 선언한 것보다 많이 게시하는 것은 허용되며 앞으로도 허용됩니다. provides 계약은 부분집합을 요구하고 상위집합을 허용하므로, Component의 계약을 충족하면서 추가 키도 내보내는 Recipe는 그 계약을 이행하는 Recipe입니다. 이 린트가 알려 주는 것은 어느 쪽에서도 보이지 않는 결과입니다. uses: 엣지를 통해 읽는 소비자는 대상의 Recipe가 마침 내보내는 내용이 아니라 대상의 선언된 계약을 봅니다. 이것이 Recipes의 상호 교체 가능성을 유지하는 방식입니다. 하나의 Component를 구현하는 두 Recipes가 소비자에게 같은 표면을 제공하므로, 둘을 교체해도 소비자가 의존하게 된 키가 조용히 사라질 수 없습니다. 따라서 선언되지 않은 키는 엣지를 넘어 전달되지 않으며, 그 키를 읽는 소비 측 템플릿은 실패하지 않고 빈 값을 렌더링합니다.
이 결과는 원인이 있는 곳, 즉 키를 게시한 Recipe에서 보고됩니다. 그곳에서만 이를 지목할 수 있기 때문입니다. 소비자 쪽에서 그 키는 컴파일러가 특정 대상에 귀속시킬 수 없는 템플릿 참조이며, 추측하는 진단은 진단이 없는 것보다 나쁩니다. 그래서 두 가지는 의도적으로 같은 위치에 두지 않습니다. 빈 값은 소비자 쪽에 나타나고 설명은 여기에 나타나며, 둘 다 같은 빌드 출력에 나타납니다.
비교 대상. 바인딩된 Recipe가 작성한 provides: 키를 Component 타입이 선언한 spec.schema.provides: 키와 비교합니다. 이 선언된 집합은 inject: 블록 안의 from: 키를 검사할 때 쓰는 집합과 같으므로, 둘은 Component가 무엇을 선언하는지에 대해 일치합니다. 비교는 유사성 검사가 아니라 정확한 비교이므로, 위의 두 near-miss 린트와 달리 임계값이 없고 이름을 짝짓지 않습니다.
비교하는 Recipe는 인스턴스가 실제로 바인딩된 Recipe이며, 렌더링이 바인딩할 때 쓰는 것과 같은 인스턴스 이름과 카탈로그 타입으로 찾습니다. 따라서 Manifest의 인스턴스별 Recipe 재정의는 무시되지 않고 그대로 반영됩니다. 타입이 어떤 카탈로그 Component로도 해석되지 않는 컴포넌트 인스턴스는 건너뜁니다. 선언을 읽지 못한 것은 아무것도 선언하지 않은 것과 같지 않기 때문입니다.
파이프라인 위치. 이 린트는 해석 단계에서 카탈로그 인식 의미 검사와 같은 패스에서, 해석된 Aggregate를 대상으로 실행됩니다. 렌더링 전에 실행되므로 aggrega build뿐 아니라 aggrega validate --release에서도 나타납니다. Aggregate의 루트에 선언된 Components와 서브시스템에 중첩된 컴포넌트가 모두 대상입니다. 하위 Aggregate에서 들어오는 컴포넌트는 대상이 아닙니다. 그 내부 컴포넌트는 이 패스가 실행된 뒤에 그래프에 합쳐지므로, 그러한 컴포넌트의 선언되지 않은 키는 여전히 소비자에게 전달되지 않지만 이를 알려 주는 권고는 없습니다.
출력 형태. 컴포넌트 인스턴스와 키마다 한 줄이며, 키를 게시한 Recipe와 그 키를 선언하지 않은 Component를 지목합니다.
lint: Recipe publishes a provides key its Component does not declare (Recipe broker-with-region, at .spec.provides.region, "region", on component type "core/ai-model/openai-compatible", bound to component instance "gateway")결과는 그것을 가진 인스턴스에 속하므로, 한 Component 타입의 인스턴스 열 개가 같은 선언되지 않은 키를 게시하면 한 줄이 아니라 열 줄이 출력되고, 각 줄은 자신의 인스턴스를 지목합니다. 모든 줄은 키를 게시한 Recipe에 귀속됩니다. 문제를 해결하려면 그 문서를 수정해야 하기 때문입니다. 순회는 결정적이므로 같은 입력은 매번 같은 권고 순서를 만듭니다.
에디터 표시. 이 권고는 언어 서버를 통해 에디터 진단에도 경고 심각도로 전달되며, type:으로 Recipe를 바인딩하는 컴포넌트 인스턴스에 위치합니다. 터미널 출력을 읽지 않는 작성자도 이를 볼 수 있습니다. 아티팩트 렌더링 단계 전에 발생하므로 별도 설정이 필요 없습니다. serve.build_on_inspect가 켜져 있든 아니든 에디터 세션에 표시됩니다.
작성 참고. 이 린트는 권고일 뿐 빌드 판정을 바꾸지 않습니다. Component가 선언한 것보다 많이 게시하는 Recipe도 빌드됩니다. 해결 방법은 둘 중 하나이며, 어느 쪽이 맞는지는 작성자가 판단합니다. 소비자가 읽도록 의도한 키라면 Component에 선언하고, Recipe 자체의 작업 상태라면 선언하지 않은 채 두되, 그런 상태는 locals:에 두는 것이 맞습니다. 반대의 경우는 권고가 아닙니다. Component가 선언한 키를 Recipe가 게시하지 않으면 계약이 이행되지 않아 빌드가 중단됩니다.
Ghost Infrastructure Tracker 경고
발생 조건: 작성자가 선언한 키가 노드에 도달했지만, 바인딩된 Recipe가 선언한 어떤 템플릿도 그 키를 참조하지 않을 때입니다. 읽히지 않은 키는 조용한 인프라가 됩니다. 즉 개발자나 운영자가 요청했지만 Recipe가 렌더링된 출력에 연결하지 않은 구성입니다. 트래커는 이를 드러내어, 작성된 내용과 출력에 담긴 내용 사이의 불일치가 조용히 묻히지 않고 보이도록 합니다.
비교되는 작성 키. 노드마다 세 그룹입니다.
.values— 노드 자신의 개발자 측 기둥입니다..infra— 노드 자신의 운영자 측 기둥입니다..context.uses.<alias>.values— 노드가 소비하는 각uses:엣지에 실린 연결별 값입니다. 이 그룹은 별도 처리 없이 소비자 범위로 한정됩니다. 노드의uses맵에는 그 노드가 출발점인 엣지만 있으므로, 읽히지 않은 연결별 값은 항상 그것을 작성한 노드에 귀속되며 엣지의 대상에 귀속되는 일은 없습니다.
수집되는 참조. 바인딩된 Recipe가 선언한 모든 템플릿입니다. 경고는 키를 아무것도 읽지 않는다고 말하며, 이는 Recipe 전체에 대한 주장입니다. 따라서 Recipe 전체보다 좁은 범위를 보면 경고는 근사치가 아니라 거짓이 됩니다. 예를 들어 source: 좌표가 소비하는 키는, 그 키가 지정한 버전을 가져온 바로 그 실행에서 읽히지 않았다고 보고될 것입니다. 읽는 블록은 다음과 같습니다.
valuesMapping:, 공급자에게 전달되는 값 오버레이입니다.source:— 단일 문자열로 작성된 경우 필드 전체, 객체로 작성된 경우 그 안의 모든 문자열 값 필드입니다. source 좌표는 소비하는 인스턴스마다 평가되는 템플릿이므로,.values나.infra에서 선택한 버전, 차트 이름, git 참조, 모듈 하위 디렉터리는 해당 키를 읽습니다.locals:와provides:, 각 항목입니다.assertions:, 각 항목입니다.workload:, 합성된 Workload 본문입니다.artifacts:, 각 항목의 내용입니다.pipeline:, 각 단계의with:입력과when:게이트입니다.
다음 세 가지 한계가 있으며, 세 가지 모두 선택이 아니라 정직하게 주장할 수 있는 범위의 한계입니다. 각각은 판독 범위를 넓히는 대신 판독을 침묵시키며, 이것이 비용이 가장 적은 방향입니다. 보고되지 않은 키는 독자에게 Recipe를 읽으면 여전히 찾을 수 있는 권고 하나를 놓치게 할 뿐이지만, 잘못 보고된 키는 정상적으로 동작하는 설정이 무시되었다고 알려 줍니다.
- 인라인
valuesMapping:이 없는 Recipe는 전혀 읽지 않습니다. 다른 템플릿이 무엇을 하든 그 키는 보고되지 않고 건너뜁니다. - Recipe가 파일이나 라이브러리 참조에서 가져오는 블록은 이 시점에 확보되어 있지 않으므로 그 참조를 수집할 수 없습니다. 이 경우 노드의 키는 보고되지 않고 모두 건너뜁니다. 가져온
valuesMapping:, 가져온workload:, 가져온artifacts:항목 모두 마찬가지입니다. - 파싱에 실패한 템플릿은 참조 집합을 전혀 내놓지 않습니다. 모든 키를 읽히지 않았다고 보고하면 같은 템플릿에 대해 평가가 내는 파싱 진단이 묻히므로, 대신 아무것도 보고하지 않습니다.
artifacts:항목은 표준{{ }}구분자로 읽는데, 이는 모든 공급자가 그 필드에 선언하는 쌍이 아닙니다. 잘못된 쌍으로 읽으면 그런 본문은 작성자가 쓴 적 없는 참조를 내놓거나 파싱되지 않으며, 두 결과 모두 경고를 침묵시킬 뿐입니다.
소켓의 valueSchema는 결코 지적되지 않습니다. usesSchema.<socket>.valueSchema는 연결별 값이 충족해야 하는 계약을 선언합니다. 이는 작성된 인스턴스가 아니라 스키마이며 비교 대상 입력에 포함되지 않으므로 보고될 수 없습니다. 소켓에 선언된 기본값이 만들어 내는 것은 다른 인스턴스와 같으며, 그 자체로 읽힘 여부가 판단됩니다.
기둥 전체를 가리키는 참조는 그 아래의 모든 키를 읽힌 것으로 셉니다. {{ .infra.port }}는 port를 읽힌 것으로 표시하고 기둥의 나머지 키는 경고 대상으로 남겨 둡니다. {{ optional .infra `port` 8080 }}는 .infra 맵 전체를 함수에 넘기므로, 수집된 참조는 그 아래의 키가 아니라 기둥을 가리키고, 그 기둥의 모든 키가 읽힌 것으로 세어지며, 기둥은 아무 경고도 내지 않습니다. 기둥을 range로 순회하거나 index로 uses 항목 하나에 접근할 때도 마찬가지입니다. 키별 검사를 원하는 Recipe 작성자는 키별 참조를 작성합니다.
이는 위의 모든 블록에 적용되므로, 조용한 기둥을 놓친 경고로 오해하기 전에 알아 둘 만합니다. source: 버전을 {{ optional .infra `source_version` "1.2.3" }}로 작성한 Recipe는 .infra 맵 전체를 함수에 넘긴 것이므로, 그 Recipe는 자신이 렌더링하는 어떤 노드의 어떤 .infra 키에 대해서도 아무것도 보고하지 않습니다. .values 기둥은 영향을 받지 않습니다. 둘은 따로 셉니다.
파이프라인 내 위치. 트래커는 기본 렌더링 단계에서 템플릿 평가와 함께 실행됩니다. Recipe의 각 템플릿을 파싱하고 순회하여 참조하는 점 표기 필드 경로(.values.port, .infra.replicas, .context.uses.<alias>.values.retry_budget)를 수집합니다. 각 그룹의 확정된 키 집합을 그 참조들의 합집합과 비교하며, 그 차이가 읽히지 않은 집합입니다. 순회 대상은 작성된 그대로의 Recipe입니다. source: 좌표는 이 인스턴스에 대해 템플릿이 만들어 낸 값이 아니라 템플릿 텍스트로 읽습니다.
출력 형태. 읽히지 않은 키마다 한 줄이며, 노드, 그룹의 경로, 키, 그리고 어떤 템플릿도 그 키를 읽지 않는 Recipe를 명시합니다.
warning: node "data.main-db": .values key "database_name" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "data.main-db": .infra key "storage_class" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "frontend": .context.uses.my-api.values key "retry_budget" is read by no template in recipe "helm-web-ui-sourced-with-artifacts" — correct the spelling, or remove the key이 줄은 Recipe의 필드를 명시하지 않으며, 이는 의도된 것입니다. 키를 작성한 사람은 개발자, 운영자 또는 그 키가 실린 uses: 엣지의 작성자이고, 그 누구도 Recipe를 편집하지 않습니다. 참조를 찾은 블록을 명시하면 그 독자에게 열어 보지도 않는 문서의 좌표를 건네는 셈이 됩니다. 이 줄이 제시하는 두 가지 해결책은 그들이 실행할 수 있는 두 가지입니다. 흔한 원인은 키의 오타이며, 애초에 읽힐 일이 없던 키는 삭제할 만합니다.
순서는 고정되어 있습니다. 노드의 .values, 그다음 .infra, 그다음 엣지가 출력된 순서대로 각 uses 별칭이 오며, 각 그룹 안에서 키는 정렬됩니다. 따라서 같은 입력은 매 실행마다 같은 경고 순서를 만들어 냅니다.
편집기 표시. 이 경고는 언어 서버가 IR 그래프를 검사하면서 아티팩트 렌더링 단계를 실행하는 경우에만 편집기 진단에 나타납니다. 즉 aggrega serve --build-on-inspect, 또는 이 플래그가 재정의하는 serve.build_on_inspect 구성 키이며, 기본값은 꺼짐입니다. 이 설정은 빌드가 렌더링 중에 내는 권고를 추가할 뿐, 빌드를 중단시키는 검사는 하나도 추가하지 않습니다. 항목은 작성 키가 아니라 노드를 가리키므로 Aggregate의 kind: 키에 표시됩니다.
치명적 중단이 아니라 경고인 이유. 개발자는 조건부 템플릿 로직에서 정당하게 서로 다른 .values 부분 집합을 소비할 수 있습니다. 예를 들어 템플릿이 .values.mode로 분기하는 Recipe는 mode를 읽지만 .values.replication_password는 mode == "replication"일 때만 조건부로 읽습니다. 정적 순회로는 참조되지 않은 키가 상관없는 것인지 버그인지 구별할 수 없습니다. 트래커의 목적은 불일치를 단속하는 것이 아니라 보이게 하는 것이며, 조용한 누락이 트래커가 막는 실패 양상입니다.
Recipe 작성자의 대응. Recipe 작성자가 Recipe가 소비하리라 예상한 키에 대해 Ghost Infrastructure 경고를 보면, 해결책은 그 키를 템플릿에 연결하는 것입니다. 읽히지 않은 키가 의도적인 누락인 경우(차트가 지원하지 않는 기능, Recipe가 의도적으로 무시하는 작성 편의 기능)에는, 작성자가 Recipe의 헤더 주석에 누락을 문서화하여 이후의 독자가 불일치가 의도된 것임을 알 수 있게 할 수 있습니다.
읽히지 않는 선언된 매개변수 경고
발생 조건: Aggregate가 spec.parameters: 아래에 항목을 선언했으나 해당 Aggregate 자체 텍스트의 어떤 {{ .parameters.<key> }} 참조도 그 항목을 읽지 않을 때 발생합니다.
선언된 매개변수는 Release마다 값 하나를 달리하기 위한 작성 수단입니다. Release가 선언을 충족하고, 참조가 충족된 값을 그 값이 속한 컴포넌트 값으로 전달합니다. 아무것도 읽지 않는 선언은 그 변화가 도달할 곳을 남기지 않습니다. Release가 무엇을 제공하든 렌더링된 출력은 같습니다. 이는 아무것도 소비하지 않는 작성된 values 키가 지니는 것과 같은 문제의 매개변수 범위 형태입니다.
기본값은 예외가 아닙니다. 어떤 참조도 읽지 않는 기본값은 Release가 제공한 값과 마찬가지로 출력에 도달하지 않으므로, 기본값이 있는 선언도 기본값이 없는 선언과 똑같이 보고됩니다.
수집되는 참조. Aggregate 자체 텍스트뿐이며 그 밖의 것은 없습니다. 이에 따라 세 가지 결과가 생깁니다.
- Component 스키마의
validate:술어만이 접근하는 매개변수는 여기서 보이지 않습니다. 그러한 술어는 Aggregate의 점 표기 참조가 아니라 해석된 매개변수 맵을 통해 매개변수를 지정하므로, 술어가 읽더라도 선언은 읽히지 않은 것으로 보고됩니다. - 템플릿으로 파싱되지 않는 텍스트는 참조 집합을 만들지 않습니다. 모든 선언을 읽히지 않은 것으로 보고하면 같은 텍스트에 대해 보간이 발생시키는 진단이 묻히므로, 대신 아무것도 보고하지 않습니다.
parameters맵 전체를 지정하는 참조(맵을 순회하거나 index로 항목 하나에 접근하는 경우)는 모든 선언을 읽힌 것으로 계산합니다. 이때 수집된 참조는 그 아래의 키가 아니라 맵을 지정하므로 키별 판단을 내릴 수 없기 때문입니다.
파이프라인 위치. 이 판독은 해석 단계에서, 렌더링 전에 Aggregate의 원시 텍스트와 선언된 매개변수 계약을 대상으로 실행됩니다. 따라서 aggrega build뿐 아니라 aggrega validate에서도 나타납니다.
출력 형태. 읽히지 않는 선언마다 한 줄씩, Aggregate와 선언의 로케이터를 지정합니다.
lint: declared parameter is read by no reference in the Aggregate (Aggregate fullstack-app, at .spec.parameters.unread_probe, "unread_probe")결과는 Aggregate가 매개변수를 선언한 순서대로 나오므로, 같은 Aggregate는 실행할 때마다 같은 순서를 만듭니다. 각 결과에는 문제가 되는 키를 지정하는 선언의 로케이터가 붙습니다. 메시지도 키를 지정하므로, 로케이터를 함께 출력하는 터미널 줄에서는 키가 두 번 나타납니다. 편집기는 메시지를 지정한 위치에 표시할 뿐 로케이터 텍스트는 보여 주지 않으므로, 키를 뺀 메시지는 읽히지 않는 모든 선언에서 똑같이 보이게 됩니다.
편집기 표시. 이 권고는 언어 서버를 통해 경고 심각도로 편집기 진단에도 전달되며, Aggregate 전체가 아니라 로케이터가 지정하는 선언 위치에 표시됩니다. 아티팩트 렌더링 단계 전에 발생하므로 별도 설정이 필요 없습니다. 편집기 세션은 serve.build_on_inspect가 켜져 있든 아니든 이를 표시합니다.
치명적 중단이 아니라 경고인 이유. 매개변수는 그것을 읽을 참조보다 먼저 선언될 수 있으며, 정적 탐색으로는 이를 실수와 구별할 수 없습니다. 작성된 키 판독이 권고만 하는 것과 같은 이유입니다. 컴파일러는 작성자가 어떤 설정 항목을 노출하는지 단속하지 않습니다.
Provider 바인딩의 제공되지 않는 기능 경고
발생 조건: 워크스페이스 구성의 plugins.providers 아래 항목이 capability를 지정하고 uri는 지정하지 않았는데, 빌드가 읽는 provider 플러그인 중 어느 것도 그 기능을 제공하지 않을 때 발생합니다. 빌드가 읽는 플러그인은 카탈로그 디렉터리에 있는 플러그인, 컴파일러에 내장된 provider, 그리고 lockfile에 기록된 플러그인입니다.
존재 이유. 바인딩은 Recipe의 capability:가 해당 기능을 요청할 때만 읽히며, 플러그인을 지정하지 않은 항목은 그 항목이 없어도 기능 해석이 선택했을 것 이외에는 아무것도 선택하지 않습니다. 따라서 기능 이름의 철자가 틀린 항목(helm 대신 hlem)은 아무것도 참조하지 않고 아무것도 바꾸지 않으며, 이 경고가 없다면 아무것도 그 사실을 알려 주지 않습니다.
fatal halt가 아니라 경고인 이유. 바인딩은 워크스페이스 전체에 대해 한 번 작성되지만, 빌드는 하나의 Release를 대상으로 합니다. 해당 capability를 제공하는 플러그인은 워크스페이스의 다른 Release만 읽는 플러그인일 수 있으며 이 빌드에서는 보이지 않으므로, 여기서 중단하면 추측에 근거해 적법한 워크스페이스를 거부하게 됩니다. 플러그인도 함께 지정하는 항목은 다른 경우입니다. pull은 Recipe가 사용하는지와 관계없이 그러한 항목을 모두 해석하므로, 빌드는 해당 플러그인을 보유하고 그 플러그인이 무엇을 제공하는지 알고 있으며, 그 플러그인이 제공하지 않는 capability는 중단을 일으킵니다. fatal-halts.md의 “A plugins.providers binding names a plugin that does not serve the capability (해당 바인딩이 capability를 제공하지 않는 플러그인을 지정함)”을 참조하십시오. 빌드가 읽는 어떤 플러그인이 실제로 제공하는 capability에 대한 항목은, 이 Release의 Recipe가 사용하는지와 관계없이 아무것도 보고되지 않습니다.
파이프라인 내 위치. Release의 모든 빌드와 모든 검증은 Release의 그래프를 분석하기 전에 합성된 워크스페이스 구성의 각 항목(레이어와 그에 딸린 providers_append를 함께)을 읽습니다. 따라서 이 경고는 aggrega validate --release와 aggrega build에서 나타나며, aggrega pull에서도 나타납니다. pull은 빌드가 가져오는 외부 입력을 찾기 위해, 곧 기록할 lockfile을 기준으로 Release를 한 번 렌더링하기 때문입니다. 이 판단은 어떤 플러그인이 Recipe를 렌더링하는지에 아무런 영향을 주지 않으며, 그것은 lockfile에서 읽습니다.
출력 형태. 합성된 목록에 담긴 순서대로 항목마다 한 줄씩, 기능 이름과 함께 한 번의 편집 거리에 있는 제공되는 기능이 있으면 그것도 표시합니다:
warning: plugins.providers entry names a capability no provider-rendering plugin the build reads serves: capability "hlem", which is one edit from "helm"; the entry names no plugin, so it selects nothing a Recipe would not resolve without it, and none of the plugins this build reads — in the catalog directories, inside the compiler, or among those the lockfile records — serves the capability: correct its spelling, or keep it where the plugin serving it is one only another Release reads임계값. 철자 제안은 편집 거리가 1이고 두 이름이 모두 네 글자 이상일 때만 제시됩니다. 위의 근접 불일치 lint와 같은 기준이며 이유도 같습니다.
에디터 표시. 이 경고는 language server를 통해 경고 심각도로 에디터 진단에 전달됩니다. 항목이 편집 중인 문서가 아니라 구성 파일에 있으므로, 키 위가 아니라 해당 문서의 맨 앞에 표시됩니다.
엔터티별 메타데이터 지원 범위
어떤 엔터티 엔벨로프가 metadata.labels와 metadata.annotations를 가지는지는 종류에 따라 다릅니다. Component, Feature 및 라이브러리 종류는 둘 다 가지고, Aggregate는 labels만 가지며, Recipe, FeatureRecipe, Manifest, Release, Plugin은 엔벨로프 수준에서 두 키 모두 허용하지 않습니다. 언어 현황에 엔터티별 현황이 정리되어 있으며, 이 페이지를 참조해야 합니다.
에디터 표시. 어떤 설정에서도 이를 다루는 권고는 없습니다. 엔터티는 이 키들을 가지거나 허용하지 않거나 둘 중 하나이므로 보고할 것이 없으며, 종류가 허용하지 않는 키는 렌더링 단계가 나중에 보고하는 것이 아니라 문서가 로드될 때 해당 스키마가 판단하는 문제이기 때문입니다. 작성자는 경고를 기다리지 말고 현황 페이지를 확인해야 합니다.
지원되지 않는 필드 경고
작성한 내용 중 대상이 반영할 수 없는 모든 것은 하나의 클래스가 다룹니다. 이 클래스에는 두 가지 구성원, 즉 대상이 표현할 수 없는 Workload 필드와 대상이 처리하지 않는 aggrega.ai/ 어노테이션이 있으며, 둘은 하나의 클래스 코드와 하나의 억제 플래그를 공유합니다. “이 대상이 무시하는 것들”을 끄고 싶은 작성자는 스위치를 하나씩 끄기보다 이들을 한꺼번에 끄고 싶어 하기 때문입니다.
대상이 표현할 수 없는 Workload 필드
대상마다 충실도가 다릅니다. 어떤 대상이 기본적으로 표현하는 Workload 필드가 다른 대상에서는 대응하는 것이 없을 수 있습니다. 예를 들어 Docker Compose에는 스케줄링 제약, 서비스 계정, 우선순위 클래스라는 개념이 없습니다. Workload가 이러한 필드를 선언하고 대상이 이를 표현할 수 없으면, 해당 필드는 경고와 함께 생략되며 작성된 필드마다 경고가 하나씩 발생합니다. 조용히 버려지지도 않고 치명적 오류로 처리되지도 않습니다.
치명적 중단과의 차이는 세분성입니다. 지원되지 않는 형태는 빌드를 명시적으로 중단시킵니다. 대상이 그 모양의 워크로드를 전혀 생성할 수 없기 때문입니다. 표현할 수 없는 필드를 가진 지원되는 형태는 해당 필드를 뺀 채로 렌더링되며, 그 사실을 알립니다.
compose 대상에서 이 클래스는 현재 scheduling, serviceAccount, replicas, runtimeClassName, priorityClassName, imagePullSecrets, dnsPolicy, dnsConfig.options, 컨테이너의 runAsNonRoot, 그리고 nvidia.com/gpu를 제외한 모든 확장 리소스 키(예: amd.com/gpu)를 다룹니다. 제외된 그 키는 NVIDIA GPU용으로 예약되어 있기 때문입니다. 아래의 경우에는 같은 클래스의 부분 변형이 발생하며, 이때 필드는 제거되지 않고 축소됩니다:
persistentTemplate— 레플리카별 볼륨 템플릿을 사용할 수 없으므로, 볼륨은 사라지지 않고 하나의 공유 영구 볼륨으로 합쳐집니다.as: env를 가진 컨테이너attachments항목 — compose는 attachment에서 환경 변수를 가져올 수 없으므로, 해당 변수는 빈 값으로 출력됩니다. 경고는 항목을 작성된 좌표(containers.<name>.attachments.<KEY>, 위치 기반 init 항목의 경우initContainers[<i>].attachments.<KEY>)로 지칭하므로, 어떤 변수가 비어 있고 어느 컨테이너에 속하는지 분명히 알 수 있습니다.as: file을 가진 항목은 정상적으로 바인드 마운트되며 아무것도 발생시키지 않습니다.- 어떤 컨테이너도 마운트하지 않는
volumes항목 — 경고는 볼륨을 작성된 좌표(volumes.<name>)로 지칭합니다. 출력에 무엇이 나타나는지는 변형에 따라 다릅니다.persistent또는persistentTemplate볼륨은 여전히 명명된 볼륨으로 선언되어 생성된 뒤 사용되지 않은 채 남고,configmap,secret,ephemeral볼륨은 컨테이너의 마운트 지점을 통해서만 출력에 나타나므로 마운트하는 것이 없으면 선언이 아무런 출력도 만들지 않습니다. 어느 쪽이든 작성한 볼륨은 아무 역할도 하지 않으므로, 컨테이너에서 마운트하거나 제거하십시오. 워크로드의 모든 컨테이너는 init 컨테이너를 포함하여 마운트 주체로 간주되므로, init 컨테이너만 마운트하는 볼륨은 아무것도 발생시키지 않습니다. - 둘 이상의 프로브 슬롯을 선언하는
health블록 — compose 서비스는healthcheck를 하나만 가지므로, 우선순위live > ready > startup에 따라 하나의 슬롯만 유지되고 선언된 나머지 슬롯은 출력 어디에도 나타나지 않습니다. 경고는 블록을 작성된 좌표(containers.<name>.health, 위치 기반 init 항목의 경우initContainers[<i>].health)로 지칭하고, 변환된 슬롯과 버려진 슬롯을 모두 명시하므로, 출력에서 어떤 프로브가 활성화되어 있고 작성된 어떤 의도가 효력이 없는지 분명히 알 수 있습니다. 슬롯 하나만 선언하는 블록은 손실 없이 변환되며 아무것도 발생시키지 않습니다. initContainers도 선언하는 워크로드의hostNetwork— 워크로드 자체의 서비스는 노드의 네트워크에서 실행되지만, 각 init 컨테이너는 별도의 서비스가 되어 독자적으로 경계 네트워크에 참여합니다. 메인 서비스의 네임스페이스를 공유하면 메인 서비스가 그 컨테이너를 기다리는 것이 순환이 되기 때문입니다. 이는 모든 컨테이너가 하나의 네임스페이스를 공유하는, 모델링 대상인 pod 형태보다 좁으므로, 실행 시점에 발견되도록 두지 않고 그 차이를 명시합니다. init 컨테이너 없이hostNetwork를 선언하는 워크로드는 손실 없이 변환되며 아무것도 발생시키지 않습니다.
대상이 처리하지 않는 어노테이션
aggrega.ai/ 어노테이션은 provider가 읽어서 자신이 렌더링하는 대상에 적용하는 플랫폼 지시문입니다. 예를 들어 네임스페이스, 레지스트리 접두사, 서비스 계정이 있습니다. provider가 그중 어느 것을 읽는지는 입력 종류별로 이루어지는 해당 provider 자체의 선언입니다. 스스로 합성하는 배포 단위의 모든 필드를 소유하는 provider라도, 벤더링된 아티팩트를 렌더링할 때는 같은 값을 넣을 곳이 없는 경우가 많기 때문입니다. Well-Known Annotations가 그 매트릭스입니다.
노드 자체의 Recipe와 그 노드에 연결된 각 feature는 따로 렌더링되며, 각각 자신의 capability:가 지정하는 대상을 통해, 자신의 source:, workload:, artifacts:가 선언하는 입력 종류로 렌더링됩니다. 이러한 어노테이션이 그중 하나의 렌더링에 도달했는데, 확인된 대상의 선언이 그 렌더링이 선언하는 어느 입력 종류에서도 해당 키를 다루지 않으면, 대상은 그 키에 대해 아무것도 적용하지 않으며, 빌드는 키, 대상, 그리고 그 렌더링이 선언하는 모든 입력 종류를 명시하는 경고로 이를 알립니다.
warning: node "frontend" (provider "helm-chart"): target "helm-chart" does not support annotation aggrega.ai/namespace on sourced input and ignored it다음 결과는 어노테이션이 렌더링에 도달하는 방식에서 비롯되며, 각각 의도된 것입니다.
- 작성한 한 줄이 여러 경고를 만들 수 있습니다. 경계 어노테이션은 그 아래의 모든 component로 전파되며, 그 component들은 서로 다른 대상과 서로 다른 입력 종류를 통해 렌더링될 수 있습니다. 각 경고는 하나의 렌더링에 대한 사실이므로, 해당 키를 처리할 수 없는 렌더링마다 경고를 하나씩 받게 되며, 이를 통해 출력의 어느 부분이 영향을 받는지도 알 수 있습니다.
- 노드에 연결된 feature는 노드의 Recipe가 아니라 자신의 FeatureRecipe를 기준으로 판단됩니다. 자체 리소스를 생성하는 attachment는 자신의 FeatureRecipe가 지정하는 대상을 통해, 그 FeatureRecipe가 선언하는 입력 종류로 리소스를 렌더링합니다. 따라서 노드 자체의 대상이 적용하는 어노테이션이 attachment의 파일에는 아무 영향도 주지 않을 수 있으며, 그 반대도 마찬가지입니다. 서로 다른 파일이므로 각각에 대해 독립적으로 알림을 받습니다. 명명된 component가 아니라 경계에 연결된 feature도 마찬가지입니다. FeatureRecipe가
source:,workload:,artifacts:중 어느 것도 선언하지 않는 attachment는 자체 파일을 렌더링하지 않습니다. 값을 주입하거나, 해당 Feature가 가진uses엣지를 통하거나, 다른 것이 출력한 문서에 대한 파이프라인을 통해 기여합니다. 따라서 어노테이션이 빠질 자체 출력이 없으며, 이에 대해서는 아무런 경고도 발생하지 않습니다. - 둘 이상의 입력 종류를 선언하는 렌더링은 그 모두를 기준으로 판단됩니다. 선언된 종류들은 덧셈으로 합성되고 그 출력은 합쳐지므로, 대상이 그중 어느 하나에서라도 키를 읽으면 이를 적용하고 값이 렌더링된 출력에 나타납니다. 이 경우 보고할 것이 없으므로 아무런 경고도 발생하지 않습니다. 경고는 선언된 모든 종류가 키를 놓칠 때만 나타나며, 그 모두를 명시합니다 —
on sourced or synthesized input. - 접두사가 붙지 않은
aggrega.ai/키만 검사합니다.compliance.aggrega.ai/data-class나 직접 정의한acme.aggrega.ai/team처럼 하위 접두사가 붙은 키는 사용자의 어휘이며, 컴파일러는 이를 해석하지 않고 그대로 전달합니다. 이러한 키에 대해서는 어떤 경우에도 경고가 발생하지 않습니다. - 지원 선언을 전혀 하지 않는 대상은 아무것도 발생시키지 않습니다. 경고는 작성한 내용을 provider가 읽는다고 밝힌 내용과 비교합니다. 아무것도 밝히지 않은 provider에는 비교할 대상이 없으며, 침묵에서 거부를 추론하면 provider 작성자가 한 적 없는 주장을 보고하게 됩니다. 키를 하나도 읽지 않는 provider는
terraform처럼readsNoWellKnownAnnotations: true로 그렇다고 밝히며, 그러면 그 렌더링 중 하나에 도달하는 모든 순수 키에 대해 경고가 발생합니다.
중단이 아닌 경고인 이유. 이종 대상에 걸친 component들을 정당하게 포함하는 경계에는 특정 키를 처리할 수 없는 노드가 항상 있기 마련입니다. 이는 실수가 아니라 여러 대상에 걸친 Release의 정상적인 형태이므로, 빌드를 거부하면 올바른 Releases를 거부하게 됩니다. 값은 손대지 않은 채 그대로 전달되며, 경고가 그 사실을 알려 줍니다.
클래스 코드와 대역 외 보장
각 경고는 안정적이고 기계로 매칭할 수 있는 클래스 코드 unsupported-field를 포함하므로, 도구는 메시지 텍스트를 파싱하는 대신 클래스를 매칭할 수 있습니다. 클래스의 모든 구성원, 즉 완전히 생략된 필드, 축소된 형태의 필드, 적용되지 않은 어노테이션은 모두 이 하나의 코드를 포함하며, 이 덕분에 단일 필터로 클래스 전체를 억제할 수 있습니다. 경고는 렌더링된 아티팩트와 별도로 대역 외로 전달되므로 경고가 표시되든 그렇지 않든 렌더링된 바이트는 바이트 단위로 동일합니다. 경고를 억제해도 출력은 바뀌지 않습니다.
편집기 표시. 이 클래스의 모든 구성원은 언어 서버가 IR 그래프를 검사하는 동안 아티팩트 렌더링 단계를 실행하는 경우에만 편집기 진단에 도달합니다. 이는 aggrega serve --build-on-inspect, 또는 이 플래그가 재정의하며 기본값이 꺼짐인 serve.build_on_inspect 구성 키로 설정합니다. 이 설정은 빌드가 렌더링 중에 발생시키는 권고를 추가하며, 빌드를 중단시키는 검사는 하나도 추가하지 않습니다. 위의 클래스 코드는 터미널 줄에서와 마찬가지로 게시된 진단에도 함께 전달되므로, 편집기 클라이언트는 작성자가 읽는 것과 같은 클래스를 매칭합니다. 각 항목은 작성 키가 아닌 노드와 대상을 지정하므로 Aggregate의 kind: 키에 표시됩니다.
클래스 억제하기
렌더링하는 두 명령 모두 --no-unsupported-field-warnings를 받으며, 이 플래그는 이 클래스만 억제하고 다른 모든 렌더링 경고는 계속 표시합니다:
aggrega build --release release.yaml --no-unsupported-field-warningsaggrega validate ./catalog/recipe/compose/mariadb/1.0.0/recipe.yaml --no-unsupported-field-warnings이 플래그는 표시에만 영향을 주며 렌더링된 출력을 바꾸지 않습니다. aggrega lint에는 렌더링 패스를 실행하지 않으므로 이에 해당하는 플래그가 없습니다. 이 명령은 게시 관례만 검사하므로 렌더링 경고가 발생할 수 없습니다.
축소된 충실도를 의도적으로 받아들인 경우에 이 플래그를 사용합니다. 예를 들어 로컬 개발용 compose 대상에서는 프로덕션 Workload의 스케줄링 및 서비스 계정 필드가 효과가 없을 것으로 예상됩니다. 그 밖의 경우에는 플래그를 사용하지 마십시오. 이 경고를 통해 작성한 필드가 대상에 도달하지 않는다는 사실을 알 수 있습니다.
민감하다고 선언된 값이 리터럴로 전달됨
발생 조건: 어떤 attachment가 슬롯을 채우면서, 스키마가 민감하다고 선언한 데이터를 대상이 배포 시점에 해석하는 참조가 아니라 리터럴 값으로 전달 키에 넣는 경우입니다.
출력 형태. 전달 키마다 한 줄이 출력되며, attachment 인스턴스, 키가 들어가는 전달 메커니즘, 키 자체를 명시하고, 이를 렌더링한 노드와 대상에 귀속됩니다:
warning: node "db" (provider "compose"): attachment "user_password" delivers a value declared sensitive to env delivery key "MARIADB_PASSWORD" as a literal; where the target supports it, fill the slot with an attachment that delivers a reference instead클래스 코드. 이 권고는 안정적이고 기계적으로 매칭할 수 있는 클래스 코드 sensitive-by-value를 가지므로, 도구는 메시지 텍스트를 파싱하는 대신 클래스를 매칭합니다. 이 코드는 터미널 출력 줄과 언어 서버가 게시하는 구조화된 진단 모두에 포함되므로, 작성자와 편집기 클라이언트가 같은 클래스를 읽습니다. 단, 언어 서버가 이 권고를 게시하는지 여부 자체는 아래의 편집기 가시성 조건에 따릅니다.
편집기 가시성. 이 권고는 언어 서버가 IR 그래프를 검사하는 동안 아티팩트 렌더링 단계를 실행하는 경우에만 편집기 진단에 나타납니다. 즉 aggrega serve --build-on-inspect, 또는 이 옵션이 재정의하는 serve.build_on_inspect 구성 키를 사용하는 경우이며, 이 키는 기본적으로 꺼져 있습니다. 이 설정은 빌드가 렌더링 중에 발생시키는 권고를 추가할 뿐, 빌드를 중단시키는 검사는 하나도 추가하지 않습니다. 항목은 작성 키가 아니라 노드와 대상을 지정하므로 Aggregate의 kind: 키 위에 표시됩니다.
이것은 별도의 클래스이며, --no-unsupported-field-warnings는 이를 포함하지 않습니다. 이 플래그는 위의 unsupported-field 클래스를 숨길 뿐이며, 이 권고는 그와 함께 계속 표시됩니다. 이 권고를 숨기는 플래그는 없습니다.
빌드는 성공하며 렌더링된 바이트는 변경되지 않습니다. 이 권고는 unsupported-field 클래스와 마찬가지로 렌더링된 아티팩트와 별도의 경로로 전달되므로, 해당 줄이 표시되든 표시되지 않든 출력에 도달하는 내용은 동일합니다.
민감하다고 선언된 값이 values 매핑을 거쳐 대상에 도달하는 경우
발생 조건: source:에서의 렌더링이 valuesMapping:의 출력을 대상에 넘기는데, 그 매핑이 읽는 값의 엔터티가 values 리프를 민감하다고 선언한 경우입니다. 즉 Recipe의 매핑이 그 Component가 선언한 리프를 다루거나, 컴포넌트에 부착된 Feature의 FeatureRecipe 매핑이 그 Feature가 선언한 리프를 다루는 경우입니다. 매핑은 출력 키를 스스로 만들어 내는 하나의 템플릿이므로 어떤 선언도 그 키를 지칭하지 않으며, 대상은 해당 리프에 대해 키별 민감성 표시를 받지 못합니다. 이는 선언이 어떤 렌더링된 키에도 도달하지 못하면서도 작성자가 여전히 조정 수단을 가진 유일한 렌더링 형태입니다.
출력 형태. 선언된 리프마다 한 줄이 출력되며, 작성된 좌표의 리프와 결합을 제어하는 매핑을 가진 Recipe 또는 FeatureRecipe를 지칭하고, 이를 렌더링한 노드와 대상에 귀속됩니다. 부착된 Feature에 대한 줄은 부착된 이름으로 시작합니다. 하나의 컴포넌트가 하나의 Feature를 여러 번 부착할 수 있어 그렇지 않으면 각 줄이 동일해지기 때문입니다. 아래 두 번째 줄은 컴포넌트 api에 token으로 부착된 Feature입니다:
warning: node "api" (provider "terraform"): "values.token" is declared sensitive, but recipe "terraform/api" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a recipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with them warning: node "api" (provider "terraform"): attachment "token": "values.token" is declared sensitive, but FeatureRecipe "terraform/api-token" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a FeatureRecipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with them조정 수단이란. 매핑이 없으면 소스 렌더링이 받는 값은 선언된 리프 경로 자체를 키로 가지므로, 선언이 렌더링된 키와 정확히 결합되고 표시가 함께 전달됩니다. Terraform 대상에서는 민감하다고 선언된 모듈 입력에 설명된 생성된 override 파일이 이에 해당합니다. 매핑이 있으면, 실제로 도달하는 표시는 매핑의 출력 전체를 대상으로 하며, 그것도 매핑이 선언된 값을 읽는 경우에만 해당합니다. 이 표시는 플러그인이 거부하거나 경고할 때 구성하는 텍스트를 좌우할 뿐, 렌더링된 바이트는 전혀 바꾸지 않습니다.
세 가지 형태는 의도적으로 경고하지 않습니다. 아티팩트 전용 렌더링과 워크로드 전용 렌더링은 대상에 values 맵을 전혀 넘기지 않으므로, values 리프는 어떻게 작성되든 그곳에서 표시할 렌더링된 키가 없습니다. 경계에 부착된 Feature도 FeatureRecipe가 무엇을 매핑하든 경고를 발생시키지 않습니다. 경계에는 values: 블록이 없으므로 그러한 부착은 빈 values 필러를 대상으로 렌더링되고, 그 Feature의 values 리프는 그곳에서 어떤 데이터도 담을 수 없으며, 매핑을 제거해도 아무것도 표시되지 않습니다. 각각은 작성자가 바꿀 수 있는 것이 아니라 해당 형태의 영구적인 속성이므로, 이에 대한 경고는 모든 빌드에서 발생하면서도 할 일을 알려 주지 못합니다. 대신 이 한계는 리프를 민감하다고 선언하기에서 설명합니다. valuesMapping:이 없는 source:에서의 렌더링도 경고하지 않습니다. 그 경우에는 표시가 도달하기 때문입니다.
클래스 코드. 이 권고는 안정적이고 기계로 대조할 수 있는 클래스 코드 sensitivity-not-conveyed를 가지므로, 도구는 메시지 텍스트를 파싱하지 않고 클래스를 대조합니다. 어시스턴트의 build 도구는 각 결과를 이 코드와 함께 advisories 아래에 나열합니다. 이 코드는 등록된 조건이 아니라 결과의 클래스를 지칭하므로 이 페이지 상단의 표에는 해당 행이 없습니다.
편집기 표시. 이 권고는 언어 서버가 Release를 렌더링할 때마다 경고 심각도로, 터미널 빌드가 출력하는 것과 같은 줄을 담아 편집기 진단에 도달합니다. 즉 요청받은 빌드나 빌드 미리보기, 또는 aggrega serve --build-on-inspect나 이 플래그가 재정의하는 serve.build_on_inspect 설정 키(기본값은 꺼짐)를 사용한 IR 그래프 검사의 경우입니다. 이 항목은 작성 키가 아니라 노드와 대상을 지칭하므로 Aggregate의 kind: 키에 표시됩니다.
이는 독립된 클래스이며 --no-unsupported-field-warnings의 적용 대상이 아닙니다. 이 플래그는 대상의 충실도 알림을 억제하는데, 이는 다른 이유로 내려지는 다른 판단입니다. 이 권고는 그와 별개로 여전히 표시됩니다. 이 권고를 억제하는 플래그는 없습니다.
빌드는 성공하며 렌더링된 바이트는 변경되지 않습니다. 이 권고는 부재, 즉 어떤 렌더링된 키도 표시를 갖지 않는다는 사실을 보고하며, 매핑은 일반적이고 지원되는 형태이므로 중단할 이유가 없고, 이 줄이 표시되든 아니든 출력의 어떤 것도 바뀌지 않습니다.
엔진이 초기화할 때 가져오는 Terraform 모듈 호출
발생 조건: 빌드가 벤더링하는 Terraform 모듈 또는 Recipe의 작성된 Terraform 본문이 module 블록을 선언하고, 그 source를 Terraform이 빌드가 배치한 파일에서 읽지 않고 구성을 초기화할 때 다운로드하는 경우입니다. 레지스트리 주소, git·Mercurial·HTTP 아카이브 URL, S3 또는 GCS 버킷, 절대 경로, 또는 벤더링된 모듈 밖으로 올라가 빌드가 벤더링하지 않은 파일을 가리키는 로컬 경로가 이에 해당합니다. 잠금은 벤더링된 모듈의 커밋과 아카이브 다이제스트를 고정하고, Terraform 자체의 의존성 잠금 파일은 provider만 기록하므로, 이러한 호출이 가리키는 모듈은 그때 엔진이 선택하는 버전으로 가져오게 되며 이 빌드가 기록하는 어떤 것도 이를 보장하지 않습니다.
읽는 대상. 모듈이 호출될 때 엔진이 로드하는 구성 파일, 즉 모듈 자체 디렉터리에 직접 있는 파일과 거기서 로컬 source가 도달하는 각 디렉터리의 파일을 읽으며, 아무것도 호출하지 않는 디렉터리의 파일은 읽지 않습니다. 따라서 모듈의 examples/ 또는 tests/ 디렉터리에 작성된 호출은 보고되지 않습니다. source가 말하는 내용만 읽고 그 source가 가리키는 모듈은 읽지 않습니다. Recipe의 spec.boundary.artifacts 아래 파일은 컴파일러가 직접 평가하고 기록하며 어떤 provider에도 전달되지 않으므로, 그 안에 작성된 module 블록은 읽히지 않고 경고도 발생하지 않습니다. provider 페이지의 구조적 입력 검증에서 규칙 전체를 설명합니다.
출력 형태. 호출마다 한 줄씩 출력하며, 노드와 provider를 명시한 뒤 블록, 그 블록이 있는 파일과 줄, 작성된 그대로의 source를 표시합니다. 모듈 밖으로 올라가는 source는 다운로드를 명시하는 대신 그 사실을 표시합니다.
warning: node "app" (provider "terraform"): module "vpc" (main.tf, line 2) has the source "terraform-aws-modules/vpc/aws", which Terraform downloads when the configuration is initialised, at whatever version it then selects, so no commit or digest this build records covers that module warning: node "app" (provider "terraform"): module "shared" (main.tf, line 2) has the local source "../shared", which resolves outside the module this build placed, so Terraform reads whatever sits at that path when the configuration is initialised rather than files this build vendored호출은 엔진이 도달하는 순서대로 나타납니다. 먼저 모듈 자체 디렉터리, 다음으로 로컬 source가 처음 도달하는 순서대로 각 디렉터리, 그리고 파일 안에서는 블록이 작성된 순서를 따르므로, 같은 입력은 매 실행마다 같은 순서를 만듭니다. 렌더링하는 모든 실행이 이 경고를 발생시킵니다. aggrega build, 빌드가 무엇을 가져오는지 알아내기 위해 Release를 한 번 렌더링하는 aggrega pull, 그리고 워크스페이스가 모듈을 보유한 Recipe에 대해 그 Recipe를 단독으로 렌더링하는 aggrega validate가 해당합니다.
클래스 코드. 각 경고는 안정적이고 기계가 매칭할 수 있는 클래스 코드 module-fetched-at-init를 가지므로, 도구는 메시지 텍스트를 파싱하는 대신 클래스를 매칭합니다. 이 코드는 구조화된 진단과 함께 전달됩니다. 어시스턴트의 build 도구는 각 결과를 이 코드와 함께 advisories 아래에 나열하고, 언어 서버는 각 항목에 이 코드를 게시합니다. 이 코드는 등록된 조건이 아니라 결과의 한 클래스를 가리키므로, 이 페이지 상단의 표에는 행이 없습니다.
편집기 표시. 언어 서버가 Release를 렌더링할 때마다 이 경고는 aggrega-build 계층에서 경고 심각도로 편집기 진단에 표시됩니다. 요청받은 빌드나 빌드 미리 보기, aggrega serve --build-on-inspect를 사용한 IR 그래프 검사, 또는 이 플래그가 재정의하며 기본값이 꺼져 있는 serve.build_on_inspect 구성 키가 이에 해당합니다. 항목은 작성 키가 아니라 노드를 가리키므로 Aggregate의 kind: 키에 표시됩니다.
이 경고는 별도의 클래스이며, 어떤 플래그로도 끌 수 없습니다. --no-unsupported-field-warnings는 지원되지 않는 필드 클래스를 끄며 이 경고에는 적용되지 않습니다.
빌드는 성공하며 렌더링된 바이트는 변경되지 않습니다. 경고는 렌더링된 아티팩트와 별도의 경로로 전달되므로, 경고 표시 여부와 관계없이 벤더링된 모듈, 작성된 본문, 루트 구성은 바이트 단위로 동일합니다.
중단이 아니라 경고인 이유. 다른 모듈을 호출하는 모듈은 정당한 입력입니다. Terraform이 호출된 모듈을 가져오고 구성은 동작합니다. 작성자가 포기하는 것은 그 모듈에 대한 빌드의 고정이며, 이는 거부할 결함이 아니라 보고할 사실이고, 그 가져오기를 받아들일지는 작성자가 판단할 일입니다.
A plugin ran with no recorded digest to check it against (대조할 기록된 다이제스트 없이 플러그인이 실행됨)
발생 조건: 컴파일러가 플러그인을 실행하려 하고, 기록된 다이제스트가 그 플러그인의 바이트를 관리하도록 되어 있으며, 워크스페이스에 해당 플러그인의 다이제스트가 기록되어 있지 않을 때 발생합니다. 플러그인은 실행됩니다. 이 경고는 실행된 바이트를 누군가 검토한 바이트와 아무것도 비교하지 않았다는 사실을 알려 줍니다.
aggrega pull은 획득한 모든 플러그인의 다이제스트를 Release의 lockfile에 기록하며, 이후의 모든 해석은 찾은 바이트를 그 다이제스트와 비교합니다. 아직 pull하지 않은 워크스페이스나, 구성이 나중에 연결한 플러그인보다 lockfile이 오래된 워크스페이스에는 그 플러그인의 다이제스트가 없습니다. 따라서 비교할 대상이 없으며, 이 줄이 없다면 비교는 조용히 통과됩니다.
파이프라인 단계, 프로바이더, 또는 verdict 역할에 연결된 플러그인으로서 그 Plugin 엔티티가 카탈로그 디렉터리 중 하나에 작성된 경우에도 다이제스트가 없으며, pull을 해도 생기지 않습니다. pull은 그러한 엔티티를 고정하지 않으며, 빌드는 pull이 기록한 내용과 대조하지 않고 매번 .wasm을 새로 읽습니다(일반적인 경우 엔티티 옆에서 읽습니다). transform 역할에 연결되고 그곳에 작성된 플러그인은 예외입니다. 그 바이트는 렌더링 출력을 형성하므로 pull은 해당 플러그인에 대해 찾은 .wasm의 다이제스트를 기록하며, 일단 기록되면 빌드는 그 플러그인을 다이제스트와 대조하고 이 줄은 해당 플러그인에 대해 발생하지 않습니다.
warning: plugin "governance/label-injector:1.0.0" resolved from cache with no recorded digest to check it against, so it runs unverified; run `aggrega pull --release <release>` to record it warning: plugin "pipeline-step/patch" resolved from local with no recorded digest to check it against, so it runs unverified; it is read from beside its Plugin entity in a catalog directory on every build, and a pull records its digest only for a plugin attached at a transform role; otherwise publish the plugin and reference the published entity to have its digest recorded이것이 빌드, 풀 또는 검증이 다른 경고와 함께 표시하는 줄입니다. 그러한 실행 밖에서 플러그인을 해석하는 명령 — 워크스페이스 자체의 명령줄 플러그인을 설치, 나열 또는 실행하는 경우, 또는 aggrega lint가 린트에 사용하는 플러그인을 해석하는 경우 — 은 같은 문장을 들여쓰기 없이 별도의 줄에 출력합니다.
이 줄은 바이트의 출처를 aggrega pull과 aggrega plugin list가 사용하는 것과 같은 단어로 명시하고, 그 출처에 해당하는 내용으로 끝납니다. 콘텐츠 캐시에서 온 바이트의 경우 해결 방법은 Release를 pull하는 것입니다. 그러면 다이제스트가 기록되어 이후 그 플러그인의 모든 실행이 검증된 실행이 됩니다. 카탈로그 디렉터리의 Plugin 엔티티 옆에서 읽은 바이트의 경우, pull은 transform 역할에 연결된 플러그인에 대해서만 다이제스트를 기록하며 줄에도 그렇게 표시됩니다. 그곳에 작성된 다른 플러그인은 pull로 바뀌지 않으며, 기록된 다이제스트의 관리를 받게 하려면 플러그인을 게시하고 게시된 엔티티를 참조해야 합니다.
명령이 그 플러그인을 몇 번 해석하든, 명령마다 플러그인당 한 번만 표시됩니다. 렌더링은 노드마다 한 번씩 프로바이더를 해석하고, 자체 잠금 파일을 채우는 빌드는 Release를 두 번 이상 렌더링할 수 있으므로, 매번 줄을 반복하면 묻혀 버립니다. 에디터 서비스는 실행되는 동안 자체 오류 스트림에 한 번만 표시하지만, 응답하는 모든 요청에서는 에디터에 새로 보고합니다. 따라서 에디터가 어느 응답을 참고하든, 그 응답을 통해 해당 실행이 검증 없이 사용한 플러그인을 알 수 있습니다.
에디터 표시. 이 경고는 실행의 다른 권고와 함께 경고 심각도로 에디터 진단에 표시됩니다. Release의 검증은 이를 그 Release의 Aggregate에 게시하고, 에디터가 요청한 빌드나 빌드 미리보기는 aggrega-build 계층에 게시합니다. 작성한 키가 아니라 플러그인을 지목하므로 파일의 맨 앞에 배치됩니다. 각 실행은 해석한 것을 보고하므로, 이 항목은 실행이 플러그인을 검증 없이 해석하는 동안 남아 있다가 그렇지 않은 첫 실행에서 사라집니다. 이 경고는 판정을 바꾸지 않고 해석을 실패시키지도 않으므로, 세션의 응답은 경고가 표시되는지와 관계없이 동일합니다.
두 가지 해석은 아무것도 발생시키지 않으며, 둘 다 누락이 아닙니다.
- 컴파일러가 자체적으로 내장한 플러그인.
aggrega pull은 가져온 것을 기록하는데, 바이너리에 포함되어 배포되는 바이트에는 가져올 것이 없습니다. 따라서 이런 플러그인에는 다이제스트가 기록되지 않으며, 이를 바꾸기 위해 실행할 수 있는 것도 없습니다. 바이너리가 곧 그 바이트의 신원입니다. 컴파일러 자체 플러그인과 그 버전은aggrega plugin list로 나열되며 lockfile의toolchain섹션에 기록됩니다. - 다이제스트가 처음부터 적용될 의도가 없는 해석.
aggrega validate --plugin ./some.wasm은 명령줄에서 지정한 파일을 가리키고,aggrega lint는 검사하는 아티팩트 자체를 조사합니다. 두 경우 모두 플러그인은 신뢰받는 도구가 아니라 검사 대상이므로, 대조할 기록이 없습니다.
중단이 아니라 경고인 이유. 아직 아무도 준비하지 않은 워크스페이스에서도 문서를 읽는 것은 가치가 있습니다. 누군가 aggrega pull을 실행할 때까지 validate나 lint를 거부하면, 보고 명령이 가장 유용한 바로 그 순간에 사용할 수 없게 됩니다. aggrega build는 lockfile이 아예 없으면 아티팩트를 생성하지 않으므로, 빌드에서는 lockfile에 다이제스트가 기록되지 않은 플러그인에 대해서만 이 경고가 나타납니다. 일반적인 경우는 카탈로그 디렉터리에서 엔티티 옆에서 읽은 플러그인입니다.
lockfile이 없으면 대신 거부하는 경우. 에디터가 컴파일러 서비스에 Release의 그래프를 요청했는데 워크스페이스에 lockfile이 아예 없으면, 서비스는 그래프를 그리지 않고 중단하여 lockfile을 요구합니다. lockfile이 존재하지만 단지 플러그인의 다이제스트를 기록하지 않은 경우는 위의 경우에 해당합니다. 플러그인은 실행되며, 이 경고로 그 사실을 알게 됩니다. 그려진 그래프는 독자가 추론의 근거로 삼는 것이며, 검증되지 않은 바이트로 만든 그래프는 검증된 그래프와 똑같아 보일 것입니다. aggrega serve를 참조하십시오.
A published archive carries an entry Windows cannot use (게시된 아카이브에 Windows에서 사용할 수 없는 항목이 있음)
발생 조건 aggrega push 또는 그 --dry-run이 게시하는 아카이브의 항목 중 하나에 Windows가 그대로 담을 수 없는 부분이 있을 때 발생합니다. 즉 CON, PRN, AUX, NUL, COM1, LPT1처럼 Windows가 장치용으로 예약한 이름(대소문자와 뒤따르는 확장자에 관계없이)이거나, 마침표나 공백으로 끝나는 부분입니다. aux/x.yaml은 디렉터리에, report.와 COM1.yaml은 파일 이름에 그런 부분이 있습니다. Windows에서 aggrega는 그런 항목의 압축 해제를 거부하므로 Windows 워크스페이스는 해당 버전을 전혀 사용할 수 없습니다. 게시물은 그것을 가져가는 모든 사람을 위한 것이므로 이 경고는 모든 플랫폼에서 발생하며, Windows 사용자보다 먼저 작성자가 이를 알게 되는 수단입니다.
읽는 대상. 아카이브가 담게 될 이름들입니다. 엔터티 문서 자체의 파일 이름, 그리고 엔터티가 그 옆에 명시하는 각 파일, 즉 Bundling이 나열하는 파일입니다. 따라서 스키마 파일을 가져오는 con.yaml이라는 문서는 자신의 이름 때문에 경고를 받습니다. 아무것도 명시하지 않는 엔터티는 문서만으로 게시되며, 소비자는 이를 작성한 이름이 아니라 제품이 정한 이름으로 배치하므로 파일 이름이 무엇이든 경고를 받지 않습니다. Plugin은 아카이브를 게시하지 않으므로 역시 경고를 받지 않습니다.
출력 형태. 항목마다 한 줄씩 표준 오류로, 이름이 구성되는 순서(문서가 먼저, 그다음 문서가 담는 파일들을 사전순으로)대로 출력되며, 표준 출력에 나오는 드라이 런이나 게시 자체의 보고보다 앞에 나옵니다:
warning: an entry this publication carries cannot be used on Windows (the entry "aux/x.yaml", its segment "aux"). Windows reserves device names such as CON, PRN, AUX, NUL, COM1 and LPT1, in any letter case and whatever extension follows, and does not hold a segment ending in a full stop or a space as written, so a workspace on Windows refuses to unpack the entry. This warning does not stop the publication; rename that segment to publish a version Windows can use첫 번째로 인용된 값은 아카이브가 부르는 항목 이름입니다. 두 번째는 그 세그먼트(슬래시로 구분되는 부분) 중 Windows가 담을 수 없는 첫 번째 것으로, 이름을 바꿔야 할 부분입니다. 이 줄은 해당 조건의 고정 문장으로 시작합니다. 빌드가 평가하는 규칙이 아니라 게시 과정에서 발생하므로 이 페이지 상단의 표에는 행이 없으며, 모든 조건의 표에 E0344로 나열되어 있습니다.
아무것도 거부하지 않습니다. push 또는 그 드라이 런은 경고가 없을 때와 똑같이 진행되거나 거부되며, 종료 방식도 같습니다.
그 밖에 전달되는 곳. 어시스턴트의 publish-entity 도구는 같은 항목들을 windows_unusable_entries로 응답하고, aggrega serve는 aggrega/publishEntity에 대해 이를 windowsUnusableEntries로 응답합니다. 해당 항목이 없으면 각각 생략됩니다. aggrega mcp와 aggrega serve를 참조하십시오. 서비스는 보고를 요청한 요청에 대해 게시 보고의 나머지 내용과 함께 경고 줄 자체도 전달합니다.
에디터 표시. 진단으로는 표시되지 않습니다. 게시는 빌드가 아니므로 여기서는 문제 목록에 아무것도 전달되지 않습니다. 서비스를 통해 게시하는 에디터는 응답의 windowsUnusableEntries를 읽습니다.
중단이 아니라 경고인 이유. 그런 이름은 합법적이며 Linux와 macOS는 파일을 이름 그대로 사용하므로, 게시를 거부하면 누가 가져갈지에 대한 추측만으로 동작하는 엔터티를 거부하게 됩니다. 이름을 바꿀지는 작성자가 결정할 일입니다.