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

치명적 중단

치명적 중단은 출력이 생성되기 전에 빌드를 멈추는 컴파일 타임 오류입니다. 각 중단은 문제가 있는 파일, 엔터티, 필드를 지목하고, 컴파일러가 무엇을 해석하지 못했는지 설명하며, 이를 해결하는 구체적인 작성 변경 사항을 안내합니다. 컴파일러는 입력을 조용히 수정하거나 다시 쓰지 않습니다. 무언가 잘못되면 빌드가 멈추고 그 위치를 알려 줍니다.

이 카탈로그는 각 중단이 발생하는 컴파일 단계별로 구성되어 있습니다.

아래 각 항목은 해당 항목이 설명하는 조건에 대해 빌드가 출력하는 메시지를 인용합니다. 메시지는 조건을 서술하는 고정된 문장과 그 뒤에 해당 발생 건이 제공한 내용으로 이루어집니다. 터미널에서 이 메시지는 프레임 안에 나타납니다. 프레임은 범주와 조건의 짧은 코드를 담은 대괄호 머리말, 문제가 있는 파일과 키를 가리키는 포인터와 그 뒤에 (instance <name>) 형태로 붙는 실패 대상 인스턴스(파일이 해당하지 않으면 instance <name> 형태의 인스턴스만), 그리고 그 아래 줄의 메시지로 구성됩니다. 따라서 빌드에서 붙여 넣은 줄 전체는 여기의 항목과 일치하지 않지만, 그 안의 메시지는 일치합니다. 프레임의 전체 내용은 error-translation.md에서 설명합니다.

빌드에서 진단의 대괄호 머리말에 있는 짧은 코드(문자 E와 네 자리 숫자)를 가지고 왔다면, 이 페이지 하단의 빌드가 출력한 짧은 코드로 중단 찾기에서 시작하십시오. 이 절은 여기에 수록된 모든 조건을 빌드가 해당 조건에 대해 출력하는 짧은 코드와 함께 나열합니다.

파일을 로드할 때

컴파일러는 빌드가 참조하는 모든 Aggregate, Manifest, Component, Feature, Recipe, FeatureRecipe, Plugin, Release를 읽고, 각각을 해당 스키마에 대해 검증한 뒤, Release의 타입이 지정된 매개변수를 Aggregate에 보간합니다.

YAML anchor aliased inside its own content (YAML 앵커가 자신의 내용 안에서 별칭으로 참조됨)

문서가 &name으로 노드에 앵커를 지정한 뒤, 그 앵커가 포함하는 내용 안의 어딘가에서 *name으로 별칭을 참조하는 경우입니다. 별칭을 확장하면 앵커가 재현되고, 그 앵커의 내용에는 다시 별칭이 들어 있으므로 문서는 끝이 없는 구조를 기술하게 됩니다. 읽을 수 있는 유한한 대상이 없으니 검증은 말할 것도 없으며, 빌드는 끝날 수 없는 순회를 시작하는 대신 중단됩니다.

YAML을 트리로 읽는 과정에서는 별칭이 확장되지 않으므로, 이런 형태의 문서는 아무 문제 없이 읽히고 무언가가 이를 순회할 때에만 실패합니다. 따라서 거부는 읽기와 순회 사이에서 이루어집니다. 그리고 빌드는 작성된 YAML을 여러 지점에서 읽으므로, 같은 조건을 여러 지점에서 만날 수 있습니다. 네 지점에서 이를 보고하며, 각 지점은 같은 설명을 해당 표면에서 문서의 위치를 알려 주는 정보로 감쌉니다.

  • 엔터티 파일을 읽을 때. 빌드는 해당 엔터티가 스키마에 대해 검사되기 전에 중단되므로, 이 중단은 필드가 아니라 앵커를 지목하며 줄과 열 정보를 포함하지 않습니다. 이 시점의 문서에는 진단이 유용하게 가리킬 수 있는 위치가 없기 때문입니다.
  • 스키마 본문을 컴파일할 때. spec.schema: 필러는 파일을 읽은 뒤 compact form에서 JSON Schema 문서로 컴파일되므로, 이 중단은 그 컴파일에 앞서서가 아니라 컴파일 도중에 발생하며 줄 정보를 포함합니다. 앞선 읽기 단계에서 잡을 수 없는 형태는 $jsonschema: 탈출구 본문입니다. 탈출구 본문은 주변 파일을 읽는 동안에는 블록 스칼라, 즉 앵커가 없는 일반 텍스트이며, 그 앵커는 해당 텍스트 자체가 한 단계 아래에서 파싱될 때에야 비로소 앵커가 됩니다. 순환이 그러한 블록 안에 있었던 경우, 이 중단은 해당 순환을 포함한 본문의 키워드로 $jsonschema도 함께 지목합니다.
  • Plugin이 로드될 때의 provider Plugin 워크로드 스키마. spec.provider.workloadSchema는 블록 스칼라로 작성됩니다. Plugin 파일 자체를 읽는 동안에는 일반 텍스트이며 그 시점에는 앵커가 없고, 그 앵커는 해당 텍스트가 한 단계 아래에서 독립된 문서로 파싱될 때에야 비로소 앵커가 됩니다. 그 파싱과 뒤따르는 컴파일은 모두 Plugin이 로드될 때 일어나므로, 이 중단은 파일을 읽을 때가 아니라 그 시점에 발생하며 줄 정보를 포함합니다. 순환이 스키마 본문 안의 $jsonschema: 탈출구 내부에 있었던 경우, 이 중단은 해당 순환을 포함한 본문의 키워드로 $jsonschema도 함께 지목합니다. 이 필드의 작성 방법은 ../entities/plugin.md를 참조하십시오.
  • provider가 렌더링된 CloudFormation 프래그먼트를 읽을 때. cloudformation Recipe는 프래그먼트를 작성하며, artifacts: 본문은 템플릿입니다. 따라서 provider가 읽는 것은 그 템플릿이 렌더링된 결과 텍스트로, 파일을 읽는 동안에는 존재하지 않았던 내용입니다. 그러므로 이 중단은 모든 스키마 검사가 이미 통과된 뒤, 출력을 렌더링하는 도중에 발생합니다. 프래그먼트 작성 방법은 ../providers/cloudformation.md를 참조하십시오.

거부되는 것은 재귀이며, 재사용이나 깊이는 결코 거부되지 않습니다. 공유 내용에 앵커를 지정하고 여러 곳에서 참조하는 것은 지원되는 작성 패턴이며(../entities/aggregate.md의 “YAML anchor patterns (defs: block)”와 ../entities/manifest.md의 “YAML anchors for DRY manifests” 참조), 확장된 뒤 종료되는 참조는 몇 번 나타나든, 문서가 얼마나 깊게 중첩되든 정상적으로 로드됩니다. 깊이 자체는 결코 이 중단의 이유가 되지 않습니다. 중단되는 것은 빌드가 아직 앵커 내부에 있는 동안 그 앵커에 도달하는 경우이며, 그 아래에 선언된 두 번째 앵커를 통해 간접적으로 도달하는 경우도 포함됩니다. 메시지는 루프가 되돌아가 닫히는 앵커를 지목하며, 이 앵커가 반드시 문서의 가장 바깥쪽 앵커인 것은 아닙니다.

출력되는 메시지. 네 가지 모두 같은 설명을 담고 있으며, 이는 의도된 것입니다. 네 지점에서 만나는 하나의 조건이므로, 한 번 읽는 법을 익힌 작성자가 다시 익힐 필요가 없어야 합니다. 문서의 위치를 알려 주는 틀만 다릅니다.

anchor &<anchor> is aliased by *<anchor> inside its own content, so the document expands without end; point that alias at content declared outside &<anchor>, or write the content out in full (앵커가 자신의 내용 안에서 별칭으로 참조되어 문서가 끝없이 확장됩니다. 해당 별칭이 그 앵커 바깥에 선언된 내용을 가리키도록 하거나, 내용을 전부 직접 작성하십시오)

엔터티 파일의 경우, 해당 파일을 읽던 엔벨로프 검사와 파일을 읽은 경로가 틀을 이룹니다.

document envelope validation failed: envelope: parse <path>: <the explanation above> (문서 엔벨로프 검증 실패: 엔벨로프: 해당 경로 구문 분석: 위의 설명)

스키마 본문의 경우, 스키마 내 위치와, 순환이 $jsonschema: 블록 안에 있었다면 탈출구 키워드가 틀을 이룹니다. 빌드는 이를 CATALOG_ERROR 태그 아래에 보고하며, 이 태그는 파일, 엔터티, 그리고 본문 컴파일에 실패한 필러도 함께 지목합니다.

compactform at <schema-path>:<line> (keyword "$jsonschema"): <the explanation above>

provider Plugin의 워크로드 스키마에도 같은 compact-form 틀이 붙습니다. 다른 점은 이를 감싸는 CATALOG_ERROR 태그로, 엔터티와 그 필러 대신 Plugin과 spec.provider.workloadSchema를 지목합니다.

렌더링된 프래그먼트의 경우, 이를 읽은 provider가 틀을 이룹니다.

cloudformation-provider: parse fragment: <the explanation above> (cloudformation-provider: 프래그먼트 구문 분석: 위의 설명)

해결 방법: 별칭이 현재 자신을 포함하고 있는 앵커 바깥에 선언된 내용을 가리키게 하거나, 반복되는 내용을 사용하는 위치에 전부 직접 작성하십시오. Aggregate나 Manifest에서는 루트 수준의 defs: 블록이 공유 앵커를 두기에 자연스러운 곳입니다. 이 블록은 이를 참조하는 모든 블록 바깥에 있으므로, 여기에 선언된 앵커는 자기 자신 내부에서 도달될 수 없습니다. defs: 블록이 없는 다른 엔터티 종류에서는 참조하는 블록이 그 하위 요소가 아닌 곳에 공유 내용의 앵커를 지정하십시오. 앵커는 몇 곳에서든, 어떤 깊이에서든 참조될 수 있습니다. 앵커가 취할 수 없는 단 하나의 형태는 앵커가 포함하는 내용 안으로 되돌아가는 참조입니다.

중단을 어디에서 만났든 같은 해결 방법이 적용되며, 틀을 보면 어느 문서를 열어야 하는지 알 수 있습니다. 엔터티 파일 자체, 스키마 필러 안의 $jsonschema: 블록, provider Plugin 안의 workloadSchema 본문, 또는 provider가 렌더링된 출력을 읽은 artifacts: 본문입니다. 마지막 경우 앵커는 렌더링된 텍스트가 아니라 작성한 템플릿 안에 있습니다. 렌더링은 그것을 충실히 재현했을 뿐입니다.

Parameter type mismatch / contract violation (매개변수 타입 불일치 / 계약 위반)

Release가 제공한 값의 타입이나 형태가 Aggregate가 해당 매개변수에 선언한 것과 일치하지 않습니다. 매개변수 계약 검증기는 템플릿 보간이 실행되기 전에 타입 불일치, enum 위반, 범위 위반, 패턴 위반, 선언된 format의 유효한 인스턴스가 아닌 문자열, validate: 조건식 실패, 누락된 필수 매개변수를 잡아냅니다. format에 지정할 수 있는 이름과 각각이 검사하는 내용은 명명된 형식에 나열되어 있습니다.

출력되는 메시지 — 조건을 서술하는 문장, 그다음 문제가 된 엔터티, 필드 경로, 제약 세부 정보가 이어집니다:

parameter contract violated (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" expected type <declared type>; got <received type>) (매개변수 계약 위반: 매개변수에 선언된 타입과 받은 값의 타입이 다름)

required: true로 선언되었고 default:도 없으며 Release가 제공한 값도 없는 매개변수의 경우, 보고서는 다른 조건과 다른 짧은 코드를 담습니다:

required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release) (필수 매개변수가 제공되지 않음: 필수 매개변수를 Release가 제공하지 않음)

필드 경로 뒤의 세부 정보만 충족되지 않은 제약에 따라 달라집니다. 문장과 그것을 둘러싼 괄호 안의 틀은 매번 같으므로, 문장은 일치 여부를 확인할 부분이고 세부 정보는 읽을 부분입니다. 빌드가 출력하는 세부 정보는 제약 종류마다 하나씩 다음과 같습니다:

parameter "<parameter>" value <value> not in enum [<members>] (매개변수 값이 enum에 없음) parameter "<parameter>" value "<value>" does not match pattern "<pattern>" (매개변수 값이 패턴과 일치하지 않음) parameter "<parameter>" value "<value>" is not a valid <format>: <reason> (매개변수 값이 유효한 형식이 아님) parameter "<parameter>" value <value> above max <max> (매개변수 값이 최댓값을 초과함) parameter "<parameter>" failed validate predicate (매개변수가 validate 술어를 통과하지 못함) parameter "<parameter>" validate predicate error: <detail> (매개변수 validate 술어 오류)

형식 실패의 <reason>은 해당 형식 자체의 용어로 값에 무엇이 잘못되었는지 알려 줍니다. 중첩된 계약 안의 값은 경로로 지칭되므로, items: 계약이 선언한 format은 모든 요소에서 검사되며 보고서는 실패한 요소를 지칭합니다. 예를 들어 hosts 매개변수의 두 번째 요소는 .spec.parameters.hosts.1에서 보고되고, 그 세부 정보는 "hosts.1"을 지칭합니다.

validateMessage:를 선언한 매개변수는 그 세부 정보 전체를 자신의 텍스트로 대체하므로, 보고서는 parameter contract violated (Aggregate, at .spec.parameters.<parameter>, <the validateMessage you wrote>)로 표시됩니다. 틀은 그대로이고, 제약 세부 정보가 있을 자리에 작성한 문장이 들어갑니다.

작성된 그대로는 아무것도 제약할 수 없는 계약도 같은 조건에 해당합니다. 유효한 정규 표현식이 아닌 pattern:은 Aggregate의 매개변수 계약을 읽을 때, 즉 Release 값을 검사하기 전에 거부되므로, Release가 해당 매개변수를 제공하는지와 관계없이 빌드를 중단합니다. 보고서는 키 — .spec.parameters.<parameter>.pattern, 또는 .spec.parameters.<parameter>.items.pattern처럼 중첩된 계약을 거치는 경로 — 를 가리키며, 그 세부 정보는 선언, 패턴, 이유를 지칭합니다:

parameter "<parameter>" pattern "<pattern>" does not compile: <reason> (매개변수 패턴을 컴파일할 수 없음)

지원되는 집합 밖의 형식을 지정한 format:도 아무것도 제약할 수 없으며, 같은 시점, 즉 Release 값을 검사하기 전에 거부되므로 이 역시 Release가 해당 매개변수를 제공하는지와 관계없이 빌드를 중단합니다. 중첩된 계약 안 — items:, properties: 또는 valuesType: 아래 — 에서는 이 조건이 이를 거부합니다. 보고서는 .spec.parameters.<parameter>.items.format과 같은 키를 가리키며, 그 세부 정보는 선언, 작성된 형식, 지원되는 모든 이름을 지칭합니다:

parameter "<parameter>.items": format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date (형식이 지원되지 않음. 지원되는 형식은 email, uri, hostname, ipv4, ipv6, uuid, date-time, date입니다)

매개변수 자체의 선언에서는 같은 이름이 한 단계 더 일찍, format에 지원되는 이름만 허용하는 Aggregate의 스키마에 의해 거부됩니다. 이 거부는 문서가 자기 종류의 스키마를 충족하지 못한 것으로, 고유한 짧은 코드 E0215를 가진 별개의 조건입니다. 그리고 해당 이름을 담은 Aggregate가 로드되지 않았으므로, aggrega pull과 aggrega validate --release는 Release의 aggregate: 참조를 해석할 수 없음(E0170)으로 보고한 뒤에 이를 나열합니다:

document envelope validation failed (Aggregate, at <path>); <line>:<column>: spec.parameters.<parameter>.format: enum: <format> does not equal any of: [email uri hostname ipv4 ipv6 uuid date-time date]. correct the document to match its kind’s schema (문서 엔벨로프 검증 실패: format 값이 [email uri hostname ipv4 ipv6 uuid date-time date] 중 어느 것과도 일치하지 않음. 문서를 해당 종류의 스키마에 맞게 수정하십시오)

조건식 오류 세부 정보는 validate: 조건식이 판정을 내리지 못하는 두 가지 경우를 모두 다룹니다. 해당 표면이 등록하지 않은 함수, 그리고 .value 이외의 것에 대한 참조입니다. 각각은 값이 아니라 조건식에 대해 보고되며, 해석할 수 없었던 대상을 지칭합니다.

validate: 조건식은 검증 대상 값을 .value로 읽으며, 그것이 조건식이 정의하는 유일한 이름입니다. 그 밖의 것을 지칭하는 조건식은 실행되기 전에 거부되므로, 잘못 입력한 참조는 아무것도 아닌 것으로 해석되어 검증에 실패한 값으로 나타나는 대신 이름 지정 실수로 보고됩니다.

해결 방법: Release 값을 매개변수에 선언된 type / enum / min / max / pattern / format 제약에 맞게 변경하거나, 누락된 필수 매개변수를 제공하거나, 컴파일되지 않는 pattern:을 수정하거나, 지원되지 않는 형식을 지정한 format:을 명명된 형식 중 하나로 바꾸거나 제거하거나, .value 이외의 것을 지칭하거나 true 또는 false 이외의 것을 렌더링하는 validate: 조건식을 수정하거나, 실제로 필요한 형태를 받아들이도록 Aggregate의 선언을 넓히십시오.

Recipe shape rules (Recipe 형태 규칙)

Recipe는 세 가지 입력 종류(sourced, synthesized, artifacts)로 출력을 구성하며, 이는 ../../architecture/16-recipe-input-composition.md에 설명되어 있습니다. 유효한 Recipe의 형태는 아래의 구성 규칙으로 제약됩니다. 규칙마다 검사 시점이 다르므로(Recipe를 로드할 때, 노드를 렌더링할 때, 또는 출력을 내보낼 때) 각 항목에서 해당 조건이 검사되는 시점을 확인하십시오.

각 규칙은 제약하는 대상으로 이름이 붙습니다. 번호는 없으며 예약된 번호도 없습니다. 이름은 Recipe의 어느 부분을 열어야 하는지 알려 주며, 아래 목록이 늘어나거나 순서가 바뀌어도 계속 같은 것을 가리킵니다. CI 게이트, 이슈, 런북 등에 조건을 지속적으로 기록해야 할 때는 그 코드를 사용하십시오. 코드는 sentinels.md가 해당 조건에 대해 나열하는 식별자이며, 주변 패키지가 발전해도 고정된 채로 유지됩니다.

Recipe 형태 중단도 같은 방식으로 구성됩니다. 규칙을 명시하는 문장으로 시작하고, 이어서 해당 Recipe가 제공한 내용을 밝힌 뒤, 그에 특정한 세부 사항이 이어집니다:

<the rule's sentence> (Recipe <name>:<version>, rule <rule-name>, at <position>). <rule-specific detail>

맨 앞의 문장은 규칙마다 고정되어 있습니다. 어느 단계에서 감지하든 해당 규칙이 중단될 때마다 같은 텍스트이므로 출력에서 대조할 부분이며, sentinels.md가 해당 규칙의 조건에 대해 나열하는 텍스트입니다. 그 뒤의 모든 내용은 문제가 된 Recipe에 따라 달라집니다. 괄호 안의 값은 어느 문서인지, 이름으로 어느 규칙인지, 어디인지를 알려 주며, 마지막 문장은 해당 발생에 대한 조언입니다. 위치는 규칙이 문서 전체에 관한 경우 Recipe를 로드한 파일이고, 규칙이 그 안의 한 가지에 관한 경우 작성한 키로 가는 점 구분 경로(.spec.outputComponentLabels.hosting)입니다. 자체에 점을 포함한 키는 두 개의 세그먼트로도 똑같이 읽히지 않게 하나의 세그먼트로 표기할 수 없으므로, 경로는 그 키를 담은 블록에서 멈추고 조언에서 키를 대신 인용합니다.

빌드는 전체 줄을 CATALOG_ERROR 태그 아래에 출력하며, 이는 실패의 원인이 Aggregate나 Release가 아니라 카탈로그 엔터티(Recipe 또는 그것이 바인딩된 provider)에 있음을 나타냅니다. Recipe를 로드한 파일이 태그 옆에 출력되므로, 키에 위치가 지정된 규칙이라도 어느 파일을 열어야 하는지 알 수 있습니다.

valuesMapping requires source (valuesMapping에는 source가 필요함)

Recipe가 valuesMapping을 선언했지만 source는 선언하지 않았습니다. 오버레이할 소스가 없으면 매핑된 값을 받을 대상이 없습니다. 이 규칙은 Recipe를 로드할 때 검사됩니다.

출력되는 메시지:

Recipe: valuesMapping requires source (Recipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended)

해결 방법: valuesMapping 옆에 source: 포인터(차트, 모듈 또는 compose 파일 참조)를 추가하거나, valuesMapping을 제거하고 다른 입력 종류(합성 출력에는 workload:, 직접 매니페스트 출력에는 artifacts:)를 채택하십시오.

workload: requires a provider that can synthesize (workload:에는 합성할 수 있는 provider가 필요함)

Recipe가 Workload 합성을 구현하지 않는 provider에 대해 workload:(합성 모드)를 선언했습니다. 합성 모드 지원은 provider의 속성입니다. 표준 라이브러리 카탈로그는 관례에 따라 합성이 가능한 provider에 workloadSchema를 선언하지만, 검사는 해당 필드의 존재 여부가 아니라 provider의 기능을 기준으로 합니다.

두 곳에서 보고하며, 그중 한 곳만 빌드를 결정합니다. 중단은 렌더링 시점에, 노드의 provider가 바인딩되고 그 Recipe가 선언한 입력 종류를 읽은 뒤에 발생하므로 해당 보고는 노드를 지목합니다. aggrega validate는 노드가 바인딩되기 전에 Recipe만 읽어 같은 결과를 더 일찍 보고하므로, 해당 보고는 대신 Recipe와 그 버전을 지목합니다. 두 보고가 읽는 Recipes의 집합은 같지 않습니다. 이른 보고는 workload:를 선언한 모든 Recipe에 대해 발생하는 반면, 중단은 노드가 선언한 입력 종류 중 provider가 처리할 수 없는 모든 입력 종류에 대해 발생합니다. 따라서 workload:와 source:를 함께 쓴 Recipe도 중단되며, workload 때문에 중단됩니다. provider가 렌더링할 수 있는 입력 종류를 선언한다고 해서 지원되지 않는 입력 종류가 관문을 통과하지는 않습니다.

여기에는 한 가지 제한이 있습니다. artifacts:는 노드가 선언한 유일한 종류일 때만 독립 artifacts 지원 여부를 기준으로 검사됩니다. source:나 workload:와 함께 쓰이면 그 파일은 구성된 출력으로 함께 전달되며, 이는 해당 기능이 관장하지 않습니다.

렌더링 시점에 출력되는 메시지입니다. 실패가 귀속되는 범주는 메시지 안이 아니라 진단의 대괄호 머리말에 표시됩니다. 메시지는 조건을 명시하는 고정 문장으로 시작하고, 이어서 노드, provider, 거부된 선언 종류, 그리고 해당 provider가 지원하는 종류를 밝힙니다. 노드가 provider가 처리할 수 없는 종류를 두 개 선언한 경우 source → workload → artifacts 순서에서 첫 번째 것이 보고되므로, 결과는 Recipe의 한 줄에 관한 것으로 유지됩니다:

provider does not support the node’s input kind (node "<node-id>"). provider "<provider-name>" does not support <mode> recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports <mode>

머리말에는 범주와 이 조건의 짧은 코드 E0265가 표시되며, 이 중단을 지속적으로 명명해야 할 때(지속적 통합 게이트, 이슈, 런북 등) 기록할 식별자입니다. 번호는 한 번 부여되면 고정되므로 주변 문구가 개선되어도 그대로 유지됩니다. 모든 조건의 표에서 번호를 찾을 수 있으며, 식별자가 아니라 텍스트로 작업할 때는 위의 첫 문장을 대조하십시오.

이른 보고도 같은 조건이므로, aggrega validate는 같은 절을 해당 블록을 지닌 Recipe 아래에, 그것을 읽은 곳을 접두사로 붙이고 이 조건의 짧은 코드를 머리에 두어 보고합니다:

input-kind: [E0265] Recipe "<name>:<version>": provider "<provider-name>" does not support synthesized recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports synthesized (입력 종류: 이 프로바이더는 합성형 레시피를 지원하지 않습니다. 지원되는 입력 종류 중 하나를 선언하거나, 합성을 지원하는 프로바이더를 대상으로 지정하십시오)

카탈로그 전체에 대해서는 한 줄입니다. --release를 사용하면 헤드가 절 위의 별도 줄에 놓입니다. 같은 발견 사항에 대한 에디터의 진단은 E0265를 코드로 가집니다.

해결 방법: Recipe를 합성하는 provider(가장 흔히 helm 또는 compose)에 바인딩하거나, Recipe를 다른 입력 종류(직접 매니페스트 출력에는 artifacts:, 차트/모듈이 있으면 source: + valuesMapping:)로 옮기십시오.

provider별 Workload 내용 검증. 현재 provider의 workloadSchema는 문서화 용도일 뿐 Workload 본문을 검증하지 않으며, 본문은 플랫폼이 소유한 내장 Workload 스키마로 검증됩니다. Wasm 기반 Workload 합성기가 출시되면 workloadSchema는 합성기가 Workload 본문을 검증하는 provider별 계약이 됩니다(별개의 내용 수준 중단).

The provider does not support omits (provider가 omits를 지원하지 않음)

Recipe 또는 FeatureRecipe가 omits:를 선언했지만, 이를 렌더링하는 provider는 렌더링된 문서를 제외한다고 선언하지 않습니다. 소스가 렌더링하는 결과에서 문서를 제외하는 일은 provider만 할 수 있습니다. 소스가 어떤 문서를 렌더링하고 각 문서의 이름이 무엇인지는 provider만 알기 때문입니다. 따라서 이를 수행하지 않는 provider는 항목이 지정한 모든 문서를 렌더링하고 성공을 보고하게 됩니다. 대신 빌드는 렌더링이 시작되기 전에 거부하므로, 이 키가 아무 일도 하지 않은 채 조용히 넘어가는 일은 없습니다.

provider가 문서를 제외하는지는 컴파일러가 보유한 provider 목록이 아니라 provider 자신이 지원 항목에 대해 선언한 내용에서 읽습니다. 항목의 when:이 무엇을 렌더링하든 모든 항목이 포함됩니다. provider가 키를 따를 수 있는지는 빌드가 어떤 항목을 유지하는지에 좌우되지 않기 때문입니다. helm, compose, cloudformation provider는 이 키를 따릅니다. helm-chart와 terraform은 소스를 배포 시점에 렌더링되도록 넘기므로 빌드 시점에는 제외할 렌더링된 문서가 없으며, 둘 다 거부됩니다.

거부 여부는 모든 component의 Recipe와 모든 attachment의 FeatureRecipe가 바인딩되고 각 provider가 자신을 기술한 시점에 결정됩니다. 이는 첫 component가 렌더링되기 전이자 어떤 항목도 평가되기 전이므로, 여기서 거부된 빌드는 아무것도 렌더링하지 않습니다. 이 검사는 소스를 렌더링하는 모든 문서에 대해 이루어집니다. 즉 component의 Recipe, attachment가 component에 바인딩하는 FeatureRecipe(해당 attachment를 가진 component마다 한 번씩), 그리고 boundary에 대해 한 번 생성하는 FeatureRecipe(이를 선언한 boundary에서 한 번)입니다. 문제가 있는 모든 문서는 한 번의 빌드에서 보고되며, 둘 이상이면 결과는 documents declaring omits whose provider does not honour them 아래에 묶입니다. 빌드가 확인할 수 없는 provider에 바인딩된 문서는 여기서 보고되지 않습니다. 그 빌드는 provider가 선택되는 지점에서 바인딩을 지목하며 중단됩니다.

출력되는 메시지의 위치는 Recipe의 항목이면 components: 아래 component 자신의 키(subsystem 안에 작성된 component는 먼저 해당 subsystem의 키 아래), component에 붙은 FeatureRecipe의 항목이면 이를 작성한 features: 블록의 attachment 키, boundary에 대해 한 번 생성하는 FeatureRecipe이면 Release의 .spec.boundaries.<boundary>.features.<attachment>입니다. 카테고리는 대괄호로 묶인 헤드에 표시되며, 메시지는 provider를 먼저, 그다음 문서가 렌더링하는 대상 component를 지목합니다.

provider does not support omits ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it leaves rendered documents out; remove the omits key, or render the source through a provider whose contract declares it (provider가 omits를 지원하지 않음. 이 provider의 계약은 렌더링된 문서를 제외한다고 선언하지 않습니다. omits 키를 제거하거나, 계약에 이를 선언한 provider를 통해 소스를 렌더링하십시오)

FeatureRecipe의 결과는 component 다음에 attachment를 지목하며(node "<node-id>", attachment "<attachment>"), boundary에 대해 한 번 생성하는 FeatureRecipe의 결과는 component 대신 boundary와 attachment를 지목합니다: boundary "<boundary>", attachment "<attachment>".

헤드에는 이 조건의 짧은 코드 E0335가 포함됩니다.

해결 방법: omits: 키를 제거하거나, 이 키를 따르는 provider를 통해 소스를 렌더링하십시오. helm-chart 또는 terraform Recipe가 로컬 chart나 module을 소스로 사용하는 경우에는, Recipe 옆의 .aggregaignore에 한 줄을 추가하면 다음에 Recipe가 고정될 때부터 해당 소스의 파일이 대신 제외됩니다. aggrega pin을 참조하십시오.

The provider does not support boundary artifacts (provider가 boundary artifacts를 지원하지 않음)

Recipe가 spec.boundary.artifacts(Recipe가 렌더링되는 boundary의 공유 출력에 들어갈 파일)를 선언했지만, 이를 렌더링하는 provider는 그러한 파일을 받아들인다고 선언하지 않습니다. 컴파일러는 이 파일들을 provider가 boundary에 대해 조립하는 결과 옆에 직접 쓰며 provider에게는 하나도 넘기지 않으므로, 그곳에 놓인 파일이 의미를 갖는지는 provider 대상의 특성입니다. 이를 읽지 않는 대상은 파일을 함께 배포하되 무시하게 되어, 파일에 담긴 구성이 끝내 적용되지 않습니다. 대신 빌드는 렌더링이 시작되기 전에 거부합니다.

provider가 이 파일을 받아들이는지는 컴파일러가 보유한 provider 목록이 아니라 provider 자신이 지원 항목에 대해 선언한 내용에서 읽습니다. 항목이 무엇으로 렌더링되든 모든 항목이 포함됩니다. terraform provider는 이를 받아들여 각 파일을 boundary의 루트 구성 옆에 씁니다. helm, compose, helm-chart, cloudformation은 받아들이지 않으며 거부됩니다.

거부 여부는 모든 component의 Recipe가 바인딩되고 각 provider가 자신을 기술한 시점에 결정됩니다. 이는 첫 component가 렌더링되기 전이자 어떤 항목도 평가되기 전이므로, 여기서 거부된 빌드는 아무것도 렌더링하지 않습니다. 문제가 있는 모든 Recipe는 한 번의 빌드에서, 렌더링하는 component마다 한 번씩 보고됩니다. 결과가 둘 이상이면 Recipes declaring boundary artifacts whose provider does not accept them 아래에 묶입니다. 빌드가 확인할 수 없는 provider에 바인딩된 Recipe는 여기서 보고되지 않습니다. 그 빌드는 provider가 선택되는 지점에서 바인딩을 지목하며 중단됩니다.

출력되는 메시지는 수정할 위치인 Recipe의 .spec.boundary에 위치합니다. 카테고리는 대괄호로 묶인 헤드에 표시되며, 메시지는 provider를 먼저, 그다음 Recipe가 렌더링하는 대상 component를 지목합니다.

provider does not support boundary artifacts ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it accepts files written to a boundary’s shared output; remove the boundary block, or render the Recipe through a provider whose contract declares it (provider가 boundary artifacts를 지원하지 않음. 이 provider의 계약은 boundary의 공유 출력에 쓰인 파일을 받아들인다고 선언하지 않습니다. boundary 블록을 제거하거나, 계약에 이를 선언한 provider를 통해 Recipe를 렌더링하십시오)

헤드에는 이 조건의 짧은 코드 E0351이 포함됩니다.

해결 방법: boundary: 블록을 제거하거나, 이를 받아들이는 provider를 통해 Recipe를 렌더링하십시오. boundary가 아니라 component에 속하는 파일은 대신 artifacts: 항목으로 작성합니다.

At least one input kind must be present (입력 종류가 하나 이상 있어야 함)

Recipe가 입력 종류를 하나도 선언하지 않았습니다. valuesMapping과 짝을 이루는 source도, workload:도, artifacts:도 없습니다. 이러한 Recipe는 출력을 생성하지 않으며 렌더링 표면도 없습니다. 이 규칙은 Recipe가 로드될 때 검사됩니다.

그런 형태의 Recipe 파일은 먼저 Recipe 스키마에 걸립니다. 스키마는 모든 프로바이더에서 source, valuesMapping, workload 또는 artifacts 중 하나를 요구하므로, 이 규칙이 실행되기 전에 문서 엔벌로프 검사가 E0215로 파일을 거부하며, 키마다 하나의 분기를 보여 줍니다:

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec: no anyOf branch matched: branch[0]: validation: required: missing properties: [“source”]; branch[1]: validation: required: missing properties: [“valuesMapping”]; branch[2]: validation: required: missing properties: [“workload”]; branch[3]: validation: required: missing properties: [“artifacts”]. correct the document to match its kind’s schema (문서 엔벌로프 검증 실패(Recipe): spec: 일치하는 anyOf 분기가 없음: 분기 0에 필수 속성 “source”가 없음, 분기 1에 필수 속성 “valuesMapping”이 없음, 분기 2에 필수 속성 “workload”가 없음, 분기 3에 필수 속성 “artifacts”가 없음. 문서를 해당 종류의 스키마에 맞게 수정하십시오)

출력되는 메시지:

Recipe: at least one input kind required (Recipe <name>:<version>, rule input-kinds, at <path>). declare one of: source (with valuesMapping), workload, artifacts (Recipe: 입력 종류가 하나 이상 필요함. 다음 중 하나를 선언하십시오: source(valuesMapping 포함), workload, artifacts)

해결 방법: Recipe의 작성 의도에 맞는 입력 종류를 추가합니다. 빌드가 프로비저닝하지 않는 서비스(이미 다른 곳에서 실행 중인 데이터베이스나 API)를 위한 Recipe는 endpoint(그리고 선택적으로 port)를 가진 form: reference의 workload:를 선언하고, 다른 Recipe와 마찬가지로 연결 값을 provides: 아래에 게시합니다. helm은 이를 ExternalName Service로 렌더링하고, compose는 이에 대해 아무것도 렌더링하지 않으며, 두 경우 모두 소비자는 게시된 값을 읽습니다.

artifacts: 항목 키는 고유해야 합니다

Recipe가 artifacts: 아래에 같은 키를 가진 항목을 둘 이상 선언했습니다. 키는 출력 파일 이름을 결정합니다(항목의 본문을 인라인으로 작성하든 항목별 $import:로 로드하든 마찬가지입니다). 중복 키가 있으면 같은 boundary 디렉터리에 같은 이름의 파일이 출력됩니다.

빌드는 문서를 타입이 지정된 형태로 디코딩하는 중에 Recipe를 거부하며, 반복된 키와 그 키가 다시 나타나는 줄을 지목합니다. 이 단계는 envelope 스키마 검사 후, 형태 규칙 전에 실행되므로, 중복된 artifacts: 키를 가진 Recipe는 스키마가 유효하다고 보고된 뒤 이 중단이 보고되며, 나머지 형태 규칙은 이에 대해 보고하지 않습니다.

해결 방법: 충돌하는 항목 키 중 하나의 이름을 바꿔 각 artifacts: 항목이 고유한 파일 이름을 갖도록 하십시오.

Emission-time filename collision across input kinds (출력 시점에 입력 종류 간 파일 이름 충돌)

Recipe와 FeatureRecipe는 각각 파일을 생성하는 입력 종류를 선언합니다. 프로바이더가 렌더링하는 source:, 프로바이더가 합성하는 workload:, artifacts: 항목, 그리고 단계에서 파일을 출력할 수 있는 pipeline:입니다. 이들은 각자 다른 것과 독립적으로 출력 이름을 정하며, 그 이름들이 서로 다르다고 선언하는 곳은 없습니다. 따라서 둘이 하나의 이름으로 파일을 생성할 수 있고, 그중 하나만 남게 됩니다. 빌드는 중단되며 해당 출력 이름과 그것을 생성한 모든 블록을 함께 보고합니다.

이 검사는 출력하는 문서마다 한 번씩, 해당 문서 자체의 출력이 완료되는 즉시 그리고 그 출력이 어떤 조립에 합류하기 전에 실행됩니다. 출력하는 문서는 세 가지이며 각각 따로 검사됩니다. 컴포넌트 자체의 Recipe, 어태치먼트가 컴포넌트에 바인딩하는 FeatureRecipe, 그리고 경계 범위 어태치먼트가 바인딩하는 FeatureRecipe입니다. 이들을 분리해 두기 때문에 진단이 올바른 문서를 지목할 수 있습니다. 어태치먼트의 파일은 호스트 컴포넌트의 식별자로 렌더링되므로, 어태치먼트의 FeatureRecipe에서 발생한 충돌은 호스트가 아니라 그 FeatureRecipe에 대해 보고됩니다.

충돌하는 이름은 각각 따로 보고되므로, 블록들이 두 이름에서 겹친 문서는 두 이름을 모두 보고합니다. 발견 사항은 수정을 위해 편집할 문서에 위치가 지정됩니다. Recipe의 경우 컴포넌트 인스턴스이고, 어태치먼트의 경우 FeatureRecipe 자체이며, 이때 발견 사항에는 어태치먼트 이름도 함께 표시됩니다. 컴포넌트나 경계는 여러 어태치먼트를 바인딩할 수 있기 때문입니다.

하나의 블록이 한 이름으로 여러 파일을 출력하는 경우는 이 중단에 해당하지 않습니다. 이는 두 블록이 겹치는 것이 아니라 단일 기여자이며, 한 블록 안의 중복된 artifacts: 키는 문서를 디코딩하는 동안 거부됩니다.

출력되는 메시지:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>) (입력 종류 간 파일 이름 충돌: 두 입력 종류 블록이 하나의 출력 이름으로 파일을 생성했습니다)

FeatureRecipe에서 발생한 충돌에는 어태치먼트도 함께 표시됩니다.

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>, attachment <instance>) (입력 종류 간 파일 이름 충돌: 두 입력 종류 블록이 하나의 출력 이름으로 파일을 생성했습니다. 첨부 항목 포함)

해결 방법: 직접 관리하는 입력 종류 쪽에서 충돌하는 파일의 이름을 변경합니다. 충돌이 Workload에서 변환된 파일 이름과 artifacts: 항목 사이에서 발생한 경우, Workload에서 변환된 이름은 프로바이더의 변환 관례를 따릅니다(예: helm의 경우 <release-name>-deployment.yaml이며, 여기서 release 이름은 {{ .context.rendered_name }}입니다). artifacts: 파일 이름을 프로바이더가 합성하지 않는 이름으로 조정하십시오.

An output-label key uses a reserved namespace (출력 레이블 키가 예약된 네임스페이스를 사용합니다)

Recipe가 aggrega.ai/ 또는 app.kubernetes.io/ 아래의 레이블 키를 지정합니다. 렌더링된 출력에 리터럴 레이블을 찍는 블록인 outputLabels:에서, 또는 값이 출력으로 승격되는 컴포넌트 레이블 키를 지정하는 블록인 outputComponentLabels:에서입니다. 두 접두사는 모두 플랫폼 자체의 출처 키 공간에 속합니다. 이들은 빌드가 직접 찍는 키이므로, 이를 찍는 Recipe는 리소스의 출처를 나타내는 공간에 값을 쓰게 됩니다. 이를 예약해 두면 Recipe의 레이블 집합이 출처 집합과 겹치지 않으므로, 둘을 병합할 때 조정할 필요가 없습니다. 이 규칙은 Recipe를 로드할 때 검사됩니다.

예약은 루트 자체에만 적용됩니다. 예를 들어 component.aggrega.ai/hosting처럼 자체 네임스페이스 안쪽에 예약된 루트를 포함할 뿐인 키는 플랫폼이 소유하지 않는 별개의 키 공간이며, 계속 작성할 수 있습니다.

출력 메시지입니다. 하나의 조건이 두 블록을 모두 다루므로 그 문장으로는 둘 중 어느 블록이 작성되었는지 알 수 없습니다. 뒤따르는 안내에서 입력한 키와 그 키를 입력한 블록을 인용하여 블록을 지목합니다.

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-labels, at .spec.outputLabels). key "<key>" in outputLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (Recipe output-labels 제약: 키가 예약된 네임스페이스를 사용합니다. outputLabels의 키가 예약된 네임스페이스를 사용합니다. 두 접두사는 플랫폼 출처 정보용으로 예약되어 있습니다)

승격 블록에 작성된 키는 해당 블록의 규칙 이름으로 보고되며 안내에서 그 블록을 지목합니다.

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels). key "<key>" in outputComponentLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (Recipe output-labels 제약: 키가 예약된 네임스페이스를 사용합니다. outputComponentLabels의 키가 예약된 네임스페이스를 사용합니다. 두 접두사는 플랫폼 출처 정보용으로 예약되어 있습니다)

리터럴 블록의 키는 정렬된 순서로, 승격 블록의 키는 작성한 순서로 검사되므로, 여러 곳에서 규칙을 위반한 Recipe는 항상 같은 것을 먼저 보고합니다.

해결 방법: 키를 직접 소유한 네임스페이스(자체 도메인 또는 component.aggrega.ai/…와 같은 하위 접두사 네임스페이스)로 옮기거나, 원하는 값이 빌드가 이미 찍는 값이라면 키를 삭제합니다. 렌더링된 리소스가 갖는 출처 키는 ../providers/well-known-annotations.md에 나열되어 있으며, 이를 다시 읽는 데에는 Recipe 선언이 필요하지 않습니다.

A promoted component label is also declared literally (승격된 컴포넌트 레이블이 리터럴로도 선언되어 있습니다)

Recipe가 하나의 키를 outputComponentLabels:와 outputLabels: 양쪽에 지정합니다. 두 블록은 서로 다른 출처에서 같은 레이블 표면에 값을 찍습니다. 앞의 블록은 컴포넌트가 가진 값을 승격하고, 뒤의 블록은 Recipe 작성자가 입력한 값을 씁니다. 따라서 양쪽에 지정된 키는 두 개의 후보 값을 갖게 되며 어느 쪽이 우선하는지 정할 근거가 없습니다. 이 규칙은 Recipe를 로드할 때 위의 예약 네임스페이스 규칙 다음에 검사되므로, 둘 다 위반한 Recipe는 예약 네임스페이스를 먼저 보고합니다. 그 오류의 해결 방법은 다른 블록의 내용에 좌우되지 않기 때문입니다.

출력되는 메시지:

recipe output-component-labels constraint: key is also declared in outputLabels (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels.<key>). key "<key>" is promoted through outputComponentLabels and also declared literally in outputLabels; keep whichever source the label should come from and drop the other (Recipe output-component-labels 제약: 키가 outputLabels에도 선언되어 있습니다. 키가 outputComponentLabels를 통해 승격되면서 outputLabels에도 리터럴로 선언되어 있습니다. 레이블 값이 와야 할 출처 하나를 남기고 다른 하나를 삭제하십시오)

해결 방법: 레이블 값을 어디에서 가져올지 정하고 다른 선언을 삭제합니다. 값이 컴포넌트가 가진 값을 따라야 해서 하나의 Recipe에 바인딩된 두 컴포넌트가 각자의 값을 찍어야 한다면 outputComponentLabels: 항목을 유지하고, 값이 Recipe 고유의 것으로 Recipe가 어디에 바인딩되든 같다면 outputLabels: 항목을 유지합니다.

FeatureRecipe 형태 규칙

FeatureRecipe는 Recipe와 같은 입력 종류로 출력을 구성하며, 아래의 구성 규칙은 Recipe를 제약하는 것과 같은 방식으로 FeatureRecipe를 제약합니다. 이 규칙은 FeatureRecipe를 로드할 때 검사되며, Recipe 형태 중단과 같은 형식, 즉 규칙의 문장, 오류가 있는 문서, 규칙 이름, 해당 발생에 대한 안내 순으로 CATALOG_ERROR 태그 아래에 보고됩니다.

여기에는 의도적으로 최소 하나의 입력 종류 규칙이 없으며, 이것이 Recipe와의 차이점입니다. 프로바이더와 구현 대상만 선언하는 FeatureRecipe는 정당한 순수 배선 어태치먼트입니다. 아무것도 렌더링하지 않으며, 그 효과는 구현하는 Feature가 전달하는 연결입니다. injectMapping:만 선언하는 FeatureRecipe도 마찬가지로 정당합니다.

A FeatureRecipe’s valuesMapping requires source (FeatureRecipe의 valuesMapping에는 source가 필요합니다)

FeatureRecipe가 valuesMapping을 선언했지만 source는 선언하지 않았습니다. values 매핑은 오버레이이므로, 오버레이할 대상인 차트, 모듈 또는 파일이 없으면 매핑된 값이 도달할 곳이 없습니다.

출력되는 메시지:

FeatureRecipe: valuesMapping requires source (FeatureRecipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (FeatureRecipe: valuesMapping에는 source가 필요합니다. valuesMapping과 함께 source: 포인터를 선언하십시오(오버레이를 의도하지 않았다면 valuesMapping을 제거하십시오))

해결 방법: 오버레이가 작성된 대상인 source: 포인터를 추가하거나, valuesMapping을 제거하고 attachment가 다른 방식으로 작업하도록 합니다. 자체 파일을 내보내려면 artifacts:를, 전달하는 내용의 형태를 바꾸려면 injectMapping:을 사용하고, 순수 배선 attachment라면 둘 다 사용하지 않습니다.

A pipeline declares one step id twice (파이프라인이 하나의 단계 id를 두 번 선언함)

Recipe 또는 FeatureRecipe가 spec.pipeline의 두 단계에 같은 id를 선언합니다. 단계는 반환하는 출력을 자신의 id로 게시하고, 같은 파이프라인의 이후 단계는 이를 .steps.<id>.outputs로 읽으므로, 두 단계가 id를 공유하면 이후 단계는 의도한 단계가 아니라 둘 중 마지막으로 게시한 단계의 출력을 읽게 됩니다.

이 규칙은 한 문서 자체의 파이프라인에 적용됩니다. 컴포넌트의 Recipe와 그 컴포넌트에 연결된 FeatureRecipes는 각자 파이프라인을 따로 실행하고, 각 파이프라인은 단계 출력 없이 시작하므로, Recipe 단계와 연결된 FeatureRecipe 단계는 같은 id를 가질 수 있습니다.

어떤 스키마도 이 규칙을 표현할 수 없습니다. JSON Schema에는 항목이 필드 중 하나를 기준으로 고유한 목록을 나타내는 키워드가 없기 때문입니다. 따라서 스키마를 인식하는 편집기는 그런 문서를 받아들이며, 검사는 문서를 읽을 때 스키마 검사 직후에 실행됩니다. Recipe 또는 FeatureRecipe를 읽는 모든 표면이 이를 보고합니다. 파일 또는 카탈로그 전체에 대한 aggrega validate, 카탈로그를 로드하는 빌드, 가져온 엔터티를 받아들이는 pull, 편집기의 진단, 그리고 기록되지 않고 거부되는 문서 편집입니다. 스키마 검사에도 실패하는 문서는 스키마의 결과를 먼저 보고하고, 그것이 수정되면 이 거부를 보고합니다.

반복될 때마다 별도의 결과가 되며, 반복된 id 위치에 표시되고 그 id를 처음 선언한 단계를 줄과 열과 함께 알려 줍니다. id가 세 번 나타나면 이후의 두 단계 모두 첫 번째 단계를 가리킵니다.

두 번째 단계가 첫 번째 단계의 id를 반복하는 FeatureRecipe에 대해 출력되는 메시지입니다. 범주와 이 조건의 단축 코드 E0370은 대괄호로 묶인 머리부에 표시됩니다:

a pipeline declares one step id twice (FeatureRecipe, at <path>); <line>:<column>: spec.pipeline[1].id: step id "<id>" is already declared at spec.pipeline[0].id (line <line>, column <column>). give each step of the pipeline its own id, and point every .steps.<id> reference a later step makes at the step it means (파이프라인이 하나의 단계 id를 두 번 선언합니다. spec.pipeline[1].id의 단계 id가 이미 spec.pipeline[0].id에 선언되어 있습니다. 파이프라인의 각 단계에 고유한 id를 부여하고, 이후 단계가 만드는 모든 단계 참조가 의도한 단계를 가리키도록 하십시오)

해결 방법: 두 단계 중 하나의 이름을 바꿔 각 id가 한 번만 선언되도록 합니다. 그런 다음 이후 각 단계의 with: 및 when: 템플릿에서 유지한 id를 가리키는 .steps.<id> 참조를 확인하고, 각각이 실제로 그 출력을 의도한 단계를 가리키도록 합니다. 이름을 바꿔야 두 단계의 출력에 각각 따로 접근할 수 있습니다.

A document declares an API version this compiler no longer reads (문서가 이 컴파일러가 더 이상 읽지 않는 API 버전을 선언함)

문서의 apiVersion 행이 aggrega.ai/v1alpha1을 선언합니다. apiVersion 행을 가진 모든 문서 종류는 이 컴파일러가 읽는 유일한 버전인 aggrega.ai/v1beta1을 선언하며, 이전 버전에서의 변환은 이루어지지 않습니다. 문서는 읽히는 시점에, 다른 어떤 것도 검사되기 전에 거부됩니다. 다른 모든 발견 사항은 컴파일러가 읽지 않는 버전의 문서에 관한 것이 되기 때문입니다.

문서를 읽는 모든 표면이 이를 보고합니다. aggrega validate, 빌드, 가져온 엔터티를 받아들이는 pull, 편집기의 진단, 그리고 문서 편집이 그렇습니다. 컴파일러가 한 번도 읽은 적 없는 버전을 선언하는 문서는 대신 해당 종류의 스키마에 의해 E0215로 거부됩니다.

Component에 대해 출력되는 메시지입니다. 카테고리와 이 조건의 단축 코드 E0373은 대괄호로 묶인 머리 부분에 표시됩니다:

a document declares an API version this compiler no longer reads (Component, at <path>); 1:1: apiVersion: the document declares aggrega.ai/v1alpha1, and this compiler reads aggrega.ai/v1beta1. change the apiVersion line to apiVersion: aggrega.ai/v1beta1 (문서가 이 컴파일러가 더 이상 읽지 않는 API 버전을 선언함 (Component); 1:1: apiVersion: 문서가 aggrega.ai/v1alpha1을 선언하며, 이 컴파일러는 aggrega.ai/v1beta1을 읽습니다. apiVersion 행을 aggrega.ai/v1beta1로 변경하십시오)

해결 방법: 문서의 apiVersion 행을 apiVersion: aggrega.ai/v1beta1로 변경합니다. 각 종류의 필드는 두 버전 사이에 변경된 것이 없으므로 이 행이 변경의 전부입니다.

A plugin declares a plugin ABI version this compiler no longer speaks (플러그인이 이 컴파일러가 더 이상 지원하지 않는 플러그인 ABI 버전을 선언함)

플러그인이 플러그인 ABI v1alpha1을 선언합니다. 이 컴파일러는 플러그인 ABI v1beta1만 지원하고 다른 것은 지원하지 않으므로, 이전 ABI를 대상으로 빌드된 플러그인은 실행되지 않고 거부됩니다. 플러그인은 두 곳에서 ABI를 명시하며, 각각이 이 하나의 조건으로 거부됩니다. 로드될 때 게스트가 반환하는 describe() 보고서와 Plugin 엔터티의 spec.abiVersion이며, 후자는 엔터티를 읽는 시점에 다른 어떤 것도 검사되기 전에 거부됩니다. 이 컴파일러가 한 번도 지원한 적 없는 ABI 버전을 선언하는 플러그인도 설명자 검사(E0085) 또는 Plugin 스키마(E0215)에 의해 거부됩니다.

로드 시점의 게스트에 대해 출력되는 메시지입니다. 카테고리와 이 조건의 단축 코드 E0374는 대괄호로 묶인 머리 부분에 표시됩니다:

plugin "<plugin>" declares abi_version “v1alpha1”, and this compiler speaks “v1beta1”; rebuild the plugin against the current plugin kit and publish it again: a plugin declares a plugin ABI version this compiler no longer speaks (플러그인이 abi_version “v1alpha1”을 선언하며, 이 컴파일러는 “v1beta1”을 지원합니다. 현재 플러그인 키트를 대상으로 플러그인을 다시 빌드하고 다시 게시하십시오: 플러그인이 이 컴파일러가 더 이상 지원하지 않는 플러그인 ABI 버전을 선언함)

Plugin 엔터티에 대해 출력되는 메시지입니다:

a plugin declares a plugin ABI version this compiler no longer speaks (Plugin, at <path>); <line>:<column>: spec.abiVersion: the Plugin declares abiVersion v1alpha1, and this compiler speaks v1beta1. rebuild the plugin against the current plugin kit and publish it again; its Plugin entity then declares abiVersion: v1beta1 (플러그인이 이 컴파일러가 더 이상 지원하지 않는 플러그인 ABI 버전을 선언함 (Plugin); spec.abiVersion: Plugin이 abiVersion v1alpha1을 선언하며, 이 컴파일러는 v1beta1을 지원합니다. 현재 플러그인 키트를 대상으로 플러그인을 다시 빌드하고 다시 게시하십시오. 그러면 Plugin 엔터티가 abiVersion v1beta1을 선언합니다)

해결 방법: 플러그인 키트의 현재 버전을 대상으로 플러그인을 다시 빌드하고 다시 게시합니다. 이 버전은 게스트의 describe() 보고서에 v1beta1을 기록하므로, 그 옆에 생성되는 엔터티도 abiVersion: v1beta1을 선언하게 됩니다. 엔터티의 행만 편집하는 것으로는 충분하지 않습니다. 게스트 자체는 여전히 이전 ABI를 보고하며, 로드될 때 거부됩니다.

An artifact carries a media type this compiler no longer reads (아티팩트가 이 컴파일러가 더 이상 읽지 않는 미디어 유형을 지님)

레지스트리에서 가져온 아티팩트가 이전 버전이 게시할 때 사용하던 미디어 유형, 즉 매니페스트의 아티팩트 유형, 구성 또는 레이어 중 하나에 접미사와 함께 있는 application/vnd.aggrega.<kind>.v1alpha1을 지니고 있습니다. 이 컴파일러는 v1beta1 미디어 유형을 게시하고 읽으므로, 아티팩트는 매니페스트를 읽는 시점에, 그 내용이 하나라도 취해지기 전에 이름이 명시되어 거부됩니다. 카탈로그 엔터티, 플러그인과 그 실행 파일, 문서 번들 모두 마찬가지입니다. 레지스트리 인덱싱은 이러한 아티팩트를 건너뛰며 그 이유를 명시합니다. Aggrega 고유의 application/vnd.aggrega. 네임스페이스 밖에 있는 미디어 유형은 결코 이 조건에 해당하지 않습니다.

이전 버전이 게시한 Component에 대해 출력되는 메시지입니다. 카테고리와 이 조건의 단축 코드 E0375는 대괄호로 묶인 머리 부분에 표시됩니다:

"<reference>" carries media type “application/vnd.aggrega.component.v1alpha1+yaml”, and this compiler reads “application/vnd.aggrega.component.v1beta1+yaml”; publish the artifact again with the current release: oci: artifact carries a media type this compiler no longer reads (미디어 유형 “application/vnd.aggrega.component.v1alpha1+yaml”을 지니고 있으며, 이 컴파일러는 “application/vnd.aggrega.component.v1beta1+yaml”을 읽습니다. 현재 버전으로 아티팩트를 다시 게시하십시오: oci: 아티팩트가 이 컴파일러가 더 이상 읽지 않는 미디어 유형을 지님)

해결 방법: aggrega의 현재 버전으로 아티팩트를 다시 게시합니다. 현재 버전은 v1beta1 미디어 유형을 기록합니다. 다른 사람이 게시하는 아티팩트는 그 사람이 다시 게시해야 하며, 그렇게 할 때까지는 읽을 수 없습니다.

A file cannot be read, or its bytes do not parse (파일을 읽을 수 없거나 그 바이트가 파싱되지 않음)

빌드가 읽어야 했던 파일, 또는 카탈로그 전체 검사가 카탈로그 디렉터리 아래에서 읽은 Aggrega 문서가 그 파일을 지정하거나 읽은 표면에서 사용할 수 있는 내용을 하나도 내놓지 못했습니다. 디스크에서 읽을 수 없었거나, 바이트를 파싱했지만 깔끔하게 파싱되지 않은 경우입니다. 스키마에 대해 검사할 내용도, 배치할 컴포넌트도, 렌더링할 템플릿도 없으므로 그 이후의 어떤 단계도 이 파일에 대해 실행되지 않습니다.

이 조건은 형식을 명시하지 않으며, 이는 의도된 것입니다. 이 조건이 다루는 파일 대부분은 YAML로 읽히지만, Recipe의 workload, values-mapping, artifact 본문은 Go 템플릿 소스로 읽히며 파싱되지 않습니다. YAML을 전제하는 문장은 템플릿 파일에 대한 진단을 그 파일의 형식에 관한 잘못된 주장으로 시작하게 됩니다. 두 실패 중 어느 것이 어떤 종류의 파일에서 발생했는지는 문장 뒤의 절이 알려 줍니다.

빌드의 시작점이 되는 문서인 Aggregate, Release, Manifest가 가장 흔한 대상이며, 이 셋 중 하나를 읽는 모든 지점에서 이 중단이 발생합니다. 진단은 어떤 문서를 읽고 있었는지와 그 문서를 읽은 경로를 알려 줍니다. 경로를 보면 파일이 없는 경우와 형식이 잘못된 경우를 구별할 수 있습니다. 읽기 실패는 운영 체제가 제시한 이유를 인용하고, 파싱 실패는 YAML 파서가 제시한 이유를 인용하며 여기에는 파서가 처리를 포기한 줄이 포함됩니다.

파일을 읽을 수 없었던 경우 출력되는 메시지:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to read file: <underlying reason>) (파일 로드 실패: 파일을 읽을 수 없거나 바이트를 구문 분석할 수 없음. 파일 읽기 실패)

텍스트가 파싱되지 않은 경우:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to unmarshal YAML: <underlying reason>) (파일 로드 실패: 파일을 읽을 수 없거나 바이트를 구문 분석할 수 없음. YAML 언마셜 실패)

읽고 있던 문서가 Release 또는 Manifest이면 Aggregate 자리에 해당 이름이 나타납니다. 같은 조건은 Aggregate에 선언된 parameters: 블록에서 읽어 들이는 파라미터 계약도 다룹니다. 이 계약은 무엇이든 보간되기 전에 Aggregate 자체의 텍스트에서 읽힙니다.

Release의 parameters: { $import: … }가 빌드가 가져올 수 없는 파일을 지정하는 경우에도 여기에서 보고됩니다. 경로가 빌드가 읽을 수 있는 파일을 가리키지 않는 경우와, 파일은 읽었지만 바이트가 파싱되지 않는 경우 모두 해당합니다. 대상은 Release이며, 절에는 해당 파일을 가리킨 키가 표시됩니다:

file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to read file: <underlying reason>) (파일 로드 실패: 파일을 읽을 수 없거나 바이트를 구문 분석할 수 없음. 파일 읽기 실패) file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to unmarshal YAML: <underlying reason>) (파일 로드 실패: 파일을 읽을 수 없거나 바이트를 구문 분석할 수 없음. YAML 언마셜 실패)

상대 경로는 명령을 어디에서 실행하든 그 경로를 작성한 Release(명령이 지정한 Release 또는 그 extends: 체인의 한 링크)가 있는 디렉터리를 기준으로 해석되므로, 명령줄과 편집기는 같은 파일을 읽습니다. 절대 경로는 그 자체로 위치를 지정합니다. 빌드가 실행되는 체크아웃에 해당 위치의 파일이 있는지 확인하십시오. 로컬 머신에는 있지만 버전 관리에서 제외된 파라미터 파일은 지속적 통합 실행 중에는 존재하지 않으며, 이것이 이 오류를 접하는 흔한 경우입니다. 워크스페이스 밖으로 나가는 경로, 또는 워크스페이스 밖에서 지정된 Release의 경우 그 Release 자체 디렉터리 밖으로 나가는 경로는 전혀 읽히지 않으며, 아래의 “A reference to another file leads out of the directory it must stay inside (다른 파일에 대한 참조가 머물러야 할 디렉터리 밖으로 나감)”에서 보고됩니다.

빌드가 가져올 수 없는 파일을 지정하는 스키마 $import:도 여기에서 보고됩니다. 오류의 원인이 같기 때문입니다. 지시문은 올바른 형식이지만 지정한 파일이 문서를 내놓지 못했습니다. 이 경우 대상은 세 문서 중 하나가 아니라 카탈로그 엔터티이므로, 절에는 해석 중이던 스키마 표면(spec.schema, spec.schema.values 같은 그 필러, 또는 usesSchema 소켓의 valueSchema)이 표시되며, 소스 포인터는 지시문이 작성된 줄입니다:

file load failed: the file could not be read, or its bytes did not parse. <surface>: read imported schema <value>: <the operating system's reason> (파일 로드 실패: 파일을 읽을 수 없거나 바이트를 구문 분석할 수 없음. 가져온 스키마 읽기)

엔티티 자체의 디렉터리를 아예 확정하지 못하는 드문 실패에서는 read 대신 resolve imported schema path가, 파일을 읽었지만 그 텍스트가 올바른 YAML이 아닌 경우에는 parse imported schema가 표시됩니다. 작성한 지시문 자체의 오류(옆에 있는 형제 키, 경로가 아닌 값, 구문 분석은 되었지만 맵이 아닌 가져온 내용)는 다른 조건이며, 아래의 “A schema $import: cannot be applied (스키마 $import:를 적용할 수 없음)”에서 보고됩니다.

Recipe 또는 FeatureRecipe의 valuesMapping:, workload:, artifacts.<name>: 가져오기도 여기에서 보고되며, 이유와 해결 방법도 같습니다. 지시문은 올바른 형식이지만 지정한 파일이 내용을 내놓지 못했습니다. 이 세 본문은 문서가 아니라 Go 템플릿 소스이므로 읽기만 실패할 수 있으며, 이 시점에서는 아무것도 이를 파싱하지 않습니다. 엔터티와 경로를 지정한 키가 절에 포함되며, 소스 포인터는 가져온 파일 자체의 경로입니다:

file load failed: the file could not be read, or its bytes did not parse (Recipe <name> valuesMapping file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (파일 로드 실패: valuesMapping 파일 가져오기. 파일이 아닌 라이브러리 항목을 의도했다면 참조에 프래그먼트가 필요하므로 참조 전체를 따옴표로 감싸십시오) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> workload file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (파일 로드 실패: workload 파일 가져오기. 파일이 아닌 라이브러리 항목을 의도했다면 참조에 프래그먼트가 필요하므로 참조 전체를 따옴표로 감싸십시오) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> artifact <key> file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (파일 로드 실패: artifact 파일 가져오기. 파일이 아닌 라이브러리 항목을 의도했다면 참조에 프래그먼트가 필요하므로 참조 전체를 따옴표로 감싸십시오)

라이브러리 참조와 경로를 구별하는 것은 프래그먼트입니다. <Library>#/mappings/<entry>는 라이브러리를 기준으로 해석되고, 프래그먼트가 빠진 같은 텍스트는 일반 상대 경로입니다. 일반 YAML 값은 # 앞의 공백이 주석을 여는 곳에서 끝나므로 프래그먼트는 모르는 사이에 사라지기 쉽습니다. 따라서 $import: LibBeta:1.0.0 #/workloads/Web은 빌드에 LibBeta:1.0.0으로 전달되고, 빌드는 Recipe 옆에서 그 이름의 파일을 찾습니다. 프래그먼트를 유지하려면 참조 전체를 따옴표로 감싸십시오.

FeatureRecipe의 같은 세 키도 같은 조건을 보고하며 같은 방식으로 읽힙니다. artifacts 가져오기는 Release의 수명 동안 두 번 읽히므로(aggrega pull이 내용 핀을 고정할 때 한 번, 항목이 렌더링될 때 다시 한 번), 같은 파일 누락이 두 시점 중 먼저 도달하는 쪽에서 이 조건으로 보고됩니다. $import: 옆의 형제 키나 호스트를 포함한 oci:// 참조처럼 지시문 자체의 형태 결함은 다른 조건이며 해당 항목에서 보고됩니다.

카탈로그 전체에 대한 aggrega lint와 aggrega validate도 여기에서 보고합니다. 대상은 카탈로그 디렉터리 아래에 있고 Aggrega apiVersion(들여쓰기 없이 apiVersion:으로 시작하고 값이 aggrega.ai/로 시작하는 줄)을 선언하면서, 읽을 수 없거나, 파싱되지 않거나, 검사가 읽는 엔벌로프로 디코딩되지 않는(예: 목록으로 작성된 metadata) 문서입니다. 이 문서를 가리키는 경로를 작성한 사람은 없습니다. 카탈로그 디렉터리에 있기 때문에 검사가 읽은 것입니다. 각 검사는 중단하기 전에 모든 파일을 읽으므로 한 번의 실행으로 이러한 문서를 모두 지정하며, 그 밖에는 아무것도 검사하지 않고 요약도 출력하지 않습니다. Aggrega apiVersion을 선언하지 않은 YAML(Helm 차트의 템플릿 포함)은 건너뜁니다. 헤더는 문서 수를 세고 해당 파일을 지정하며, 그 아래에 각 문서가 읽기 또는 파서 자체의 이유와 함께 나열됩니다.

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (카탈로그 디렉터리 아래의 여러 문서가 Aggrega apiVersion을 선언했지만 로드할 수 없어 아무것도 검사하지 않았습니다) file load failed: the file could not be read, or its bytes did not parse (catalog document, failed to unmarshal YAML: <the parser's reason>) (파일 로드 실패: 파일을 읽을 수 없거나 바이트를 파싱할 수 없습니다(카탈로그 문서, YAML 역마샬링 실패))

파싱은 되지만 디코딩되지 않는 문서에는 failed to decode the envelope:과 그 줄, 그리고 디코더가 그곳에서 발견한 내용(목록으로 작성된 metadata의 경우 line 4 (metadata): a list is written where a map is expected)이 붙고, 읽을 수 없는 파일에는 failed to read file:과 운영 체제의 이유가 붙습니다. 불러올 수는 있지만 어떤 카탈로그에도 없는 종류를 선언하는 문서는 같은 중단에서 명시되고, 같은 머리부에서 집계되며, 자체 조건 아래에 나열됩니다. 아래의 “A catalog document declares a kind a catalog does not hold (카탈로그 문서가 카탈로그에 없는 종류를 선언함)”를 참조하십시오.

해결 방법: 문서 이름이 아니라 메시지에 있는 경로를 확인하십시오. 참조가 예상치 못한 곳으로 해석될 때마다 둘은 달라집니다. 읽기 실패의 경우 해당 경로에 파일이 있는지, 경로가 참조하는 문서에 작성된 대로 표기되어 있는지, 빌드에 파일을 읽을 권한이 있는지 확인하십시오. 로컬에는 있지만 빌드 에이전트의 체크아웃에는 없는 파일이 흔한 경우입니다. 파싱 실패의 경우 파서가 지정한 줄에서 파일을 여십시오. 콜론을 포함한 따옴표 없는 값, 들여쓰기에 사용된 탭, 잘못된 키 아래에 들여쓴 목록 항목이 대부분의 원인입니다.

A catalog document declares a kind a catalog does not hold (카탈로그 문서가 카탈로그에 없는 종류를 선언함)

카탈로그 디렉터리 아래의 문서가 Aggrega apiVersion(들여쓰기 없이 apiVersion:으로 시작하고 값이 aggrega.ai/로 시작하는 줄)과 어떤 카탈로그에도 없는 kind를 선언합니다. Componnent 같은 철자 오류, component처럼 대소문자가 잘못된 종류, 또는 kind가 아예 없는 경우입니다. 카탈로그는 각 문서를 그 문서가 선언하는 종류 아래에 정리하므로, 그런 문서는 어떤 카탈로그에도 들어가지 않습니다. 빌드, inspect, 그리고 카탈로그를 로드하는 다른 모든 명령은 이를 건너뛰며, 그 문서가 선언하려던 엔터티에 대한 참조는 아무것으로도 해석되지 않습니다.

카탈로그는 Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate 및 Plugin 문서를 담습니다. 그 밖의 세 가지 종류는 정당하게 카탈로그 디렉터리에 있을 수 있으며 여기서 보고되지 않습니다. 엔터티 옆에 둔 Manifest와 Release, 그리고 그것을 가져오는 Recipe 또는 FeatureRecipe의 디렉터리에 있는 Workload입니다.

카탈로그 전체를 대상으로 하는 aggrega validate와 aggrega lint, 그리고 같은 디렉터리를 순회하는 Release 범위의 lint가 이를 보고합니다. 각각 중단하기 전에 모든 파일을 읽으므로, 한 번의 실행에서 그런 문서를 모두, 아예 불러올 수 없는 문서와 함께, 그 수를 세고 파일을 나열하는 하나의 머리부 아래에 명시합니다. 아무것도 검사되지 않고 요약도 출력되지 않습니다. 각 문서는 선언한 종류와 함께 나열되며, 그 줄은 카탈로그가 담는 종류로 끝납니다:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (카탈로그 디렉터리 아래의 여러 문서가 Aggrega apiVersion을 선언하지만 불러올 수 없어 아무것도 검사되지 않았습니다) catalog document declares a kind a catalog does not hold (kind “Componnent”). a catalog holds Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate and Plugin documents, and passes over a Workload, a Manifest or a Release; correct the kind, or move the file out of the catalog directories (카탈로그 문서가 카탈로그에 없는 종류를 선언합니다. 카탈로그는 Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate 및 Plugin 문서를 담고 Workload, Manifest 또는 Release는 건너뜁니다. 종류를 수정하거나 파일을 카탈로그 디렉터리 밖으로 옮기십시오)

종류를 선언하지 않은 문서의 경우 kind "<kind>" 대신 no kind가 표시됩니다.

빌드는 그런 문서에서 멈추지 않습니다. 모든 로드가 그렇듯 그 문서를 건너뛰며, 어떤 Release도 도달하지 않는 문서는 빌드를 실패시키지 않습니다. Release가 실제로 그 엔터티에 도달하면 빌드는 아래의 “A reference names no entity the catalog holds (참조가 카탈로그에 있는 어떤 엔터티도 가리키지 않음)”에 따라 그 참조에서 멈추고, 그 파일이 참조가 요구하는 이름을 선언하면 그 실패 아래의 메모가 그 파일을 명시합니다. 해당 항목을 참조하십시오.

해결 방법: 메시지가 명시하는 파일을 열고 그 kind를 문서의 실제 종류로 수정합니다. 철자와 대소문자 모두 의미가 있습니다. 아예 카탈로그 엔터티가 아닌 파일은 카탈로그 디렉터리 아래에 두면 안 됩니다. 밖으로 옮기거나, 다른 도구의 문서라면 Aggrega의 것이 아닌 apiVersion을 지정하십시오.

A path names content outside the entity’s own directory (경로가 엔티티 자체 디렉터리 밖의 콘텐츠를 가리킴)

엔티티의 콘텐츠는 엔티티 자체 디렉터리에 있습니다. 엔티티의 게시물이 담는 모든 파일을 그곳에서 가져오기 때문입니다. 그 디렉터리를 벗어나는 경로는 엔티티와 함께 전달되지 않는 파일을 가리키므로, 엔티티를 받는 사람에게는 그 파일이 없으며, 그 파일에 대해 기록된 pin은 받는 사람이 얻을 수 없는 바이트를 보증하게 됩니다.

따라서 엔티티가 자신이 담는 콘텐츠에 대해 쓰는 모든 경로는 엔티티 파일이 있는 디렉터리를 기준으로 읽히며, 그 안에 머물러야 합니다. 여기에는 Recipe와 FeatureRecipe의 source:(단순 경로 또는 구조화된 형식의 url:), 각 valuesMapping:, workload:, artifacts: 항목이 $import:로 가져오는 파일, 그리고 Component나 Feature가 전체로, pillar별로, 또는 usesSchema 소켓의 valueSchema와 infraSchema로 가져오는 모든 스키마가 포함됩니다. 디렉터리를 벗어나는 형태는 세 가지입니다. 디렉터리 위로 올라가는 경로, 작성된 머신의 위치를 가리키는 절대 경로, 그리고 디렉터리 안에서 작성되었지만 도중의 심볼릭 링크가 밖으로 데려가는 경로입니다. 마지막 경우는 경로상의 디렉터리나 끝의 파일이 엔티티 디렉터리 밖으로 이어지는 링크인 경우입니다. 올라갔다가 다시 안으로 돌아오는 경로(./charts/../values.tmpl)는 디렉터리 안의 일반 경로이며, 디렉터리 안의 다른 곳으로 이어지는 링크를 거치는 경로도 마찬가지입니다. 디렉터리 자체 이름으로 다시 들어오는 경로(1.0.0이라는 디렉터리에서 작성된 ../1.0.0/values.tmpl)는 거부됩니다. 디렉터리 이름은 전달되는 내용에 포함되지 않기 때문입니다. 게시된 엔티티는 소비자의 캐시가 이름 붙인 디렉터리에서 읽히며, 그곳에서는 그 이름으로 아무것도 찾을 수 없습니다. 밖으로 이어지는 링크를 거치는 경로가 거부되는 이유는, 그렇지 않으면 게시물이 링크가 가리키는 바이트를 그 위치가 어디든 엔티티 내부의 이름으로 담게 되기 때문입니다.

엔티티를 읽는 모든 곳에서 거부됩니다. 카탈로그 전체에 대한 aggrega validate, 엔티티 자체 파일에 대한 aggrega validate, aggrega pull, aggrega build는 엔티티 파일을 읽을 때 이를 거부하며, Recipe나 FeatureRecipe의 aggrega pin과 네 가지 종류 중 어느 것이든 aggrega push도 무언가를 가져오거나 쓰거나 게시하기 전에 거부합니다. 템플릿으로 작성된 source:는 빌드가 평가하기 전까지 아무것도 가리키지 않으므로, 디렉터리 밖의 경로를 만드는 템플릿은 값이 생기는 시점에 빌드가 거부합니다.

Release는 다르며, 엔티티 참조도 다릅니다. Release는 다른 엔티티(자신의 Aggregate, Manifest, 확장하는 Release)를 가리키고 게시되지 않으므로, 읽는 어떤 것도 어디로 전달되지 않습니다. 그 경로들과 Release의 parameters:가 가져오는 파일은 작성된 그대로 읽힙니다. Aggregate의 type은 Aggregate가 담는 콘텐츠가 아니라 식별자로 다른 엔티티를 가리키며, 역시 자체 방식으로 해석됩니다. 즉 카탈로그 디렉터리, 캐시, 레지스트리를 통해 해석되며 파일 경로로 해석되는 일은 없습니다.

출력되는 메시지이며, 작성된 그대로의 경로를 표시합니다:

a path names content outside the entity’s own directory ("<path>"). remediation: move the file into the directory holding the entity, or a directory beneath it, and name it with a path relative to that directory. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a path that leaves it points at a file that would not travel with the entity (경로가 엔터티 자체 디렉터리 밖의 콘텐츠를 가리킵니다(위의 경로). 해결 방법: 파일을 엔터티가 있는 디렉터리 또는 그 아래 디렉터리로 옮기고, 그 디렉터리에 대한 상대 경로로 지정합니다. 엔터티의 게시물이 담는 모든 파일은 엔터티 자체 디렉터리에서 가져오므로 엔터티의 콘텐츠는 그 디렉터리에 있습니다. 그 디렉터리를 벗어나는 경로는 엔터티와 함께 전달되지 않는 파일을 가리킵니다)

그리고 링크가 디렉터리 밖으로 데려가는 경로의 경우, 링크와 그 링크가 이어지는 곳을 표시합니다:

a path names content outside the entity’s own directory ("./frag/fragment.yaml", the link <entity-directory>/frag leads to <elsewhere>/frag). remediation: replace the link with a copy of what it leads to, placed inside the directory holding the entity. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a link leading out of it would carry the bytes it points at under a name inside the entity (경로가 엔터티 자체 디렉터리 밖의 콘텐츠를 가리킵니다(위의 경로와, 디렉터리 밖으로 이어지는 링크). 해결 방법: 링크를 그 링크가 가리키는 대상의 사본으로 바꾸어 엔터티가 있는 디렉터리 안에 둡니다. 엔터티의 게시물이 담는 모든 파일은 엔터티 자체 디렉터리에서 가져오므로 엔터티의 콘텐츠는 그 디렉터리에 있습니다. 그 디렉터리 밖으로 이어지는 링크는 자신이 가리키는 바이트를 엔터티 안의 이름으로 담게 됩니다)

경로를 읽어 온 필드는 메시지 위 줄에 표시됩니다: resolve Recipe source …, resolve Recipe artifact "<key>" $import target …, spec.schema.values: imported schema …, 또는 템플릿 source의 경우 node "<name>" source.

해결 방법: 파일을 엔티티 디렉터리 또는 그 아래 디렉터리로 옮기고, 그 디렉터리 기준의 상대 경로로 작성합니다. 링크가 경로를 밖으로 데려가는 경우, 링크를 그 대상의 복사본으로 바꾸어 엔티티 디렉터리 안에 둡니다. 여러 Recipes가 공유하는 차트는 각각 따로 게시되므로 각 Recipe의 디렉터리에 복사합니다. 여러 Components가 공유하는 스키마는 SchemaLibrary에 두고 각 Component가 식별자로 참조하며, 여러 Recipes가 공유하는 매핑, 워크로드 또는 아티팩트 본문은 해당 라이브러리 종류에 둡니다.

Recipe의 source:가 획득 방법을 아는 것이 없는 kind를 지정함

Recipe의 source:는 가리키는 대상이 어떤 종류인지, 즉 차트, 모듈, compose 프로젝트 중 무엇인지를 나타내며, 각 종류는 그 종류를 처리하는 소스 어댑터가 획득합니다. 이 조건은 어떤 소스 어댑터도 처리하지 않는 종류를 보고하므로, 이 프로그램에 포함된 어떤 것도 소스를 가져올 수 없습니다. FeatureRecipe의 source:에도 같은 규칙이 적용됩니다.

이는 문서를 읽을 때, 아무것도 가져오기 전에 거부됩니다. Recipe만 따로 검사해도 거부되며, 그 Recipe에 도달하는 모든 Release에서도 거부됩니다. 시도할 수 있는 것이 없었으므로 아무것도 시도되지 않았습니다. 이 점이 실행되었다가 실패한 획득과 구별되는 부분입니다.

문서, 작성된 종류, 처리되는 종류를 지정하는 출력 메시지:

no source adapter serves the source kind (Recipe <name>:<version>, rule source-kind, at <file>). the source names kind "<kind>"; name a kind a source adapter serves (<the served kinds>), or write the source as a single URI whose shape names its kind (이 소스 종류를 처리하는 소스 어댑터가 없습니다(Recipe, 규칙 source-kind). 소스가 이 종류를 지정합니다. 소스 어댑터가 처리하는 종류를 지정하거나, 형태로 종류를 알 수 있는 단일 URI로 소스를 작성하십시오)

해결 방법: source:의 종류를 도구 체인이 처리하는 종류로 수정합니다. 철자 오류와 실제로 어댑터가 없는 종류는 같은 메시지를 만들며, 메시지는 작성한 종류를 처리되는 종류들과 나란히 인용하므로, 먼저 그 목록과 철자를 대조해 확인합니다. 이 목록은 Recipe 페이지에도 설명되어 있습니다. 의도한 대로 철자가 쓰였다면 그 종류는 이 빌드가 획득할 수 있는 것이 아니며, Recipe의 어떤 작성 변경으로도 획득할 수 있게 되지 않습니다. 대신 source:가 처리되는 형식을 가리키게 하거나, 형태로 종류를 알 수 있는 단일 URI로 작성합니다.

No source adapter is registered in this program for a source kind (이 프로그램에 소스 종류에 대한 소스 어댑터가 등록되어 있지 않음)

소스는 그 종류에 대해 등록된 어댑터가 가져옵니다. 이 조건은 어댑터가 등록되지 않은 종류로 디스패치된 가져오기를 보고합니다. 어떤 어댑터도 처리하지 않는 작성된 종류는 해당 Recipe를 읽을 때 거부되므로(위의 “A Recipe’s source: names a kind nothing knows how to acquire (Recipe의 소스가 획득 방법이 없는 종류를 지정함)” 참조), 작성자가 쓰는 어떤 것도 여기에 도달하지 않습니다. 이 조건이 보고하는 것은 자신이 처리하는 종류의 어댑터 없이 조립된 프로그램, 또는 Aggrega의 Go 패키지 위에 구축되어 스스로 조립한 종류를 디스패치하는 프로그램입니다.

종류를 지정하는 출력 메시지:

kind "<kind>": no source adapter is registered in this program for the source kind (이 프로그램에 이 소스 종류에 대한 소스 어댑터가 등록되어 있지 않습니다)

해결 방법: 엔티티 파일의 어떤 내용도 이 문제의 원인이 아닙니다. 실행 중인 바이너리를 빌드한 사람에게 보고하십시오.

A source URL carries a credential (소스 URL에 자격 증명이 포함됨)

소스 url은 작성한 그대로 기록됩니다. Release의 잠금 파일, Recipe 옆의 entity.lock, 소스 캐시에 기록되며, Recipe 자체도 커밋하고 게시할 수도 있는 파일입니다. 따라서 URL에 작성된 자격 증명은 URL이 가는 모든 곳으로 전달됩니다. 이 조건은 Recipe의 source:에서 url이 호스트 앞에 사용자를 작성한 경우를 보고합니다. https://user:token@host/…, 또는 https://token@host/…처럼 토큰만 작성한 경우입니다. HTTP로 접근하는 서비스는 흔히 사용자 자리에 토큰을 받기 때문입니다. http와 https에서는 그곳에 작성된 모든 사용자가 해당되며, 다른 스킴에서는 비밀번호만 해당됩니다. 그곳에 단독으로 작성된 사용자는 계정을 가리키기 때문입니다. ssh://git@github.com/…은 허용되며, SSH 에이전트가 키를 제공합니다. FeatureRecipe의 source:에도 같은 규칙이 적용됩니다.

이는 문서를 읽을 때, 아무것도 가져오기 전에 거부됩니다. Recipe만 따로 검사해도 거부되며, 검증, pull, pin, 빌드 중 어느 것에서든 그 Recipe에 도달하는 모든 Release에서도 거부됩니다. 메시지는 호스트를 지정하며 자격 증명은 절대 지정하지 않습니다. 검사는 URL에서 호스트 앞에 작성된 부분만 읽으므로, 쿼리 문자열이나 경로에 담긴 토큰은 감지되지 않으며 URL의 나머지 부분과 마찬가지로 작성된 그대로 기록됩니다.

http 또는 https에서 출력되는 메시지로, 문서, 키, 호스트를 지정한 다음 자격 증명을 둘 곳을 알려 줍니다:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a user or password for host <host>; remove it from the URL and write the credential in the netrc file instead, as an entry “machine <host> login <user> password <secret>” (the file NETRC names, else .netrc in your home directory, or _netrc in %USERPROFILE% on Windows) (소스 URL에 자격 증명이 포함되어 있습니다(Recipe, 규칙 source-url). spec.source.url이 이 호스트의 사용자 또는 비밀번호를 지정합니다. URL에서 제거하고 대신 netrc 파일에 machine, login, password 항목으로 자격 증명을 작성하십시오(NETRC가 지정하는 파일, 없으면 홈 디렉터리의 .netrc, Windows에서는 %USERPROFILE%의 _netrc))

그리고 다른 스킴에서는 비밀번호를 제거하는 것이 해결책입니다:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a password for host <host>; remove it from the URL, which is written into the lockfile and the cache as authored (소스 URL에 자격 증명이 포함되어 있습니다(Recipe, 규칙 source-url). spec.source.url이 이 호스트의 비밀번호를 지정합니다. URL은 작성된 그대로 잠금 파일과 캐시에 기록되므로 URL에서 제거하십시오)

해결 방법: url에서 사용자와 비밀번호를 제거하여 호스트를 지정하는 URL만 남깁니다. http 또는 https로 가져오는 소스의 경우, netrc 파일에 해당 호스트의 machine 항목으로 자격 증명을 넣습니다. 이 파일은 기존 Helm 차트 저장소, compose 조각, HTTP 또는 HTTPS를 통한 Git 저장소를 가져올 때마다 읽힙니다. 어떤 파일의 어떤 항목인지는 인증에서 설명합니다. SSH를 통한 Git 저장소의 경우 SSH 에이전트가 키를 제공하며 사용자는 그대로 두어도 됩니다. 자격 증명이 포함된 상태로 Recipe를 이미 커밋하거나 게시했다면 자격 증명은 그 기록에 남아 있습니다. 서버에서도 자격 증명을 변경하십시오.

A {{ .parameters.* }} reference cannot be interpolated (parameters 참조를 보간할 수 없음)

Aggregate의 텍스트는 문서로 읽히기 전에 템플릿으로 평가되며, 이를 통해 {{ .parameters.<key> }} 참조가 Release가 제공한 값으로 대체됩니다. 이 중단은 그 평가를 완료할 수 없을 때 발생합니다. 텍스트가 템플릿으로 파싱되지 않거나, 파싱은 되지만 실행 중에 실패하는 경우입니다.

보간은 Aggregate가 YAML로 파싱되기 전에 일어납니다. 그래서 여기서 발생한 오류는 Aggregate 내부의 키가 아니라 Aggregate 전체에 대해 보고됩니다. 그 시점에는 문서에 아직 키가 없기 때문입니다. 참조를 따옴표 없이 둘 수 있는 것도 같은 이유입니다. 치환은 원시 바이트에서 일어나고, 이후 YAML 자체의 따옴표 규칙이 값의 타입을 결정하므로, 따옴표 없는 참조는 값의 본래 타입을, 따옴표로 감싼 참조는 문자열을 산출합니다.

Release가 제공하지 않은 키를 지정하는 참조는 이 중단에 해당하지 않습니다. 없는 키는 여기서 빈 값으로 해석되며, 위의 “Parameter type mismatch / contract violation (매개변수 타입 불일치 / 계약 위반)”에서 설명하는 매개변수 검사가 그 타입과 계약을 기준으로 이를 잡아냅니다. 이 중단이 보고하는 것은 템플릿 엔진이 아예 처리할 수 없었던 텍스트입니다. 닫히지 않은 {{, 철자가 틀린 함수 이름, 단계들이 서로 맞지 않는 파이프라인 등이 그 예입니다. Release가 해당 매개변수를 제공하지 않았는데 index를 통해 매개변수를 읽는 경우({{ index .parameters "db_size" }})는 실행 중 실패이며, 이 중단이 키 이름과 함께 이를 보고합니다. 아래의 “A template indexes a map with a key the map does not hold (템플릿이 맵에 없는 키로 맵을 인덱싱함)”에서 설명하듯이, index는 모든 템플릿 표면에서 맵에 없는 키에 대해 중단합니다.

전혀 파싱되지 않는 텍스트는 Aggregate 자체의 경로를 명시한 채 거부됩니다. 그 파일은 무엇이 읽기도 전에 이미 손에 있기 때문입니다. 컴포지션이 가져오는 모듈은 한 단계 안쪽에서 같은 방식으로 평가되며, 이때 텍스트는 빌드에 전달되는 것이 아니라 카탈로그에서 읽힙니다. 어느 경우든 이 중단은 같은 조건이며 같은 코드를 가집니다. 모듈의 경우에는 따라가던 import와 모듈 텍스트를 읽어 온 파일도 명시하며, 포함된 메시지는 종류만 명시합니다. 따라서 그 메시지가 알려 주는 위치는 시작한 Aggregate가 아니라 모듈 자체 텍스트 안의 위치입니다.

파싱되지 않는 템플릿, 컴포지션이 가져오는 모듈의 같은 오류, 실행 중 실패하는 템플릿에 대해 출력되는 메시지:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate <path>, “template parse error: <underlying reason>”) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>)

Aggregate의 텍스트에는 루트가 .parameters 하나뿐이므로, 다른 루트를 통한 참조({{ .values.app_token }} 또는 {{ $.values.app_token }})는 아무것도 읽지 못하고 실행 중에 실패합니다. 이때 이유는 읽은 참조를 지정하는 것으로 시작합니다:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, the template reads <reference>, and an Aggregate’s text defines no root but .parameters; template execution error: <underlying reason>) (잘못된 매개변수 참조: parameters 표현식이 선언된 매개변수를 가리키고 Go 템플릿으로 파싱되는지 확인하십시오(Aggregate, 템플릿이 이 참조를 읽지만 Aggregate의 텍스트에는 .parameters 외의 루트가 정의되어 있지 않음, 템플릿 실행 오류))

해결 방법: Aggregate를 열고 근본 원인을 읽으십시오. 근본 원인은 텍스트 내의 위치와 실패한 구문을 알려 줍니다. 모든 {{에 대응하는 }}가 있는지, 호출한 함수가 해당 표면이 제공하는 함수인지(매개변수 보간은 Sprig의 함수만 제공하므로 optional 헬퍼는 여기서 사용할 수 없습니다), 파이프라인의 각 단계가 앞 단계의 출력을 받아들이는지 확인하십시오. 근본 원인이 index가 찾지 못한 키를 가리키는 경우, 설정되지 않았을 수 있는 매개변수는 점 표기({{ .parameters.db_size }})나 Sprig의 get 또는 hasKey로 읽으십시오. 다른 루트를 통한 참조를 가리키는 경우, 그 값을 Aggregate의 매개변수로 선언하고 {{ .parameters.<key> }}로 읽으십시오. 템플릿으로 의도하지 않은 것을 가리키는 경우(n8n 표현식에서 나온 undefined variable "$json", 또는 Flowise 노드 이름을 딴 함수 등)에는 텍스트에 주석을 포함해 자체 이중 중괄호가 들어 있는 것입니다. 자체 이중 중괄호를 포함한 텍스트에서 설명하듯이, 그 안의 각 {{를 {{"{{"}}로 작성하십시오.

The Release directory declares one Aggregate or Manifest twice (Release 디렉터리가 하나의 Aggregate 또는 Manifest를 두 번 선언함)

aggregate: 또는 manifest: 참조가 순수 식별자인 Release는 먼저 Release 자체 디렉터리를 스캔하여 해석되는데, 그 스캔에서 같은 metadata.name을 가진 Aggregates 두 개(또는 Manifests 두 개)가 발견되었습니다. 순수 식별자 참조는 그 이름으로 엔터티를 지정하므로, 두 번 사용된 이름에 대해서는 디렉터리가 답할 수 없습니다.

스캔은 참조가 요청한 이름만이 아니라 디렉터리 전체를 거부합니다. 스캔은 Release 옆에 있는 모든 Aggregate와 모든 Manifest를 읽으므로, 어느 참조도 지정하지 않은 충돌 쌍도 빌드를 중단시킵니다. 이 Release가 그 엔터티를 읽으려던 것이든 아니든 디렉터리 자체가 모호하기 때문입니다. 경로로 작성된 참조(./aggregate.yaml, ../shared/manifest.yaml)는 엔터티가 아니라 파일을 가리키며 스캔 없이 해석되므로, aggregate:와 manifest:가 모두 경로인 Release는 스캔을 실행하지 않습니다.

이는 카탈로그의 중복 식별자 거부에 대응하는 같은 디렉터리 버전이며, 두 경우는 따로 보고됩니다. 그래야 메시지가 미처 생각하지 못했을 수 있는 카탈로그 계층이 아니라 현재 작업 중인 디렉터리를 가리키기 때문입니다.

출력되는 메시지:

duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory>

두 Manifests가 충돌하는 경우에는 Aggregate 대신 Manifest가 표시됩니다.

해결 방법: 두 엔터티 중 하나에 다른 metadata.name을 지정하거나, Release 디렉터리 밖으로 옮기십시오. 같은 이름의 서로 다른 Aggregates를 실제로 배포하는 두 Releases는 각각 별도의 디렉터리에 두어야 합니다. Release를 형제 파일로 복사하면서 그 안의 내용 이름을 바꾸지 않는 것이 이 문제가 생기는 흔한 경우입니다.

A Release’s aggregate: or manifest: reference resolves to nothing (Release의 aggregate 또는 manifest 참조가 아무것으로도 해석되지 않음)

Release가 순수 식별자로 Aggregate 또는 Manifest를 지정했지만, 순수 식별자를 조회하는 어느 표면(Release 자체 디렉터리, 카탈로그, 레지스트리)에서도 그 이름의 엔터티를 찾지 못했습니다.

어디에서도 일치하는 항목이 없을 때 출력되는 메시지:

aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry

Release 디렉터리에 인덱싱할 수 없는 파일이 있으면 보고 내용이 달라집니다. 정직하게 주장할 수 있는 범위가 달라지기 때문입니다. 그런 파일이 해당 엔터티였을 수도 있으므로, 메시지는 확인할 수 없는 부재를 단정하는 대신 그 가능성을 알리고, 파일을 읽지 못하게 한 파싱 실패를 함께 전달합니다:

aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure>

그리고 파싱할 수 없는 파일이 참조가 직접 지정한 파일인 경우:

aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure>

해결 방법: 참조 대상이 실제로 없다면 철자를 고치거나(식별자는 파일 이름이 아니라 엔터티의 metadata.name입니다), 엔터티를 Release 디렉터리나 빌드가 읽는 카탈로그에 추가하십시오. 메시지가 파싱할 수 없는 파일을 지정한다면 그 파일부터 고치십시오. 파싱 실패 내용이 메시지에 인용되어 있으며, 이를 고치면 같은 수정으로 참조도 해결되는 경우가 많습니다. ./ 또는 ../ 참조는 식별자가 아니라 경로이며 경로로 해석되므로, 앞의 점 여부에 따라 찾아야 할 실수가 둘 중 어느 쪽인지 달라집니다.

A component is placed in more than one boundary (컴포넌트가 둘 이상의 경계에 배치됨)

Release의 경계 트리가 하나의 컴포넌트를 서로 다른 두 경계에 배치합니다. 두 배치는 병합되지도, 순위가 매겨지지도 않으며, 그럴 수도 없습니다. 컴포넌트의 경계는 그 출력이 기록되는 위치, 놓이는 하위 디렉터리, 참여하는 sync wave, 상속하는 경계 어노테이션과 경계 인프라를 결정하는 반면, 엣지별 uses: 표면은 별도의 순회가 읽습니다. 두 번 지정된 컴포넌트는 출력 위치는 한 배치에서, 엣지별 구성은 다른 배치에서 가져오게 됩니다.

경계는 세 가지 방식으로 컴포넌트를 배치하며, 세 가지 모두 해당합니다. components: 바로 아래에 컴포지션이 완료된 후 갖는 id로 지정하면 배치됩니다. 라우팅 항목 자체의 components: 안에 해당 하위 모듈 내부의 로컬 이름으로 지정해도 배치됩니다. 그리고 하위 모듈 전체를 aggregates: 아래로 라우팅하면 그 모듈에 포함된 모든 컴포넌트가 배치됩니다. 따라서 이 중단은 하나의 하위 모듈이 두 경계로 라우팅된 경우, 한 모듈은 한 경계로 라우팅되고 그 안에 중첩된 모듈은 다른 경계로 라우팅된 경우, 그리고 컴포넌트가 한 경계에서 지정되었는데 그 컴포넌트를 포함한 모듈이 다른 경계로 라우팅된 경우도 포괄합니다.

모듈을 경계로 라우팅하면서 그 컴포넌트 중 하나를 같은 경계 아래에 지정하는 것은 충돌이 아니며(두 배치 모두 컴포넌트가 속할 곳에 동의합니다) 빌드됩니다. 하나의 경계 아래 같은 id를 두 번 쓰는 것은 이 경우에도 충돌입니다. 경계의 components:에 있는 항목과 경계의 라우팅 항목 안에 있는 같은 컴포넌트의 항목은 하나의 컴포넌트에 대한 구성을 담은 두 항목이며, 둘 중 어느 것을 선택할 근거가 없습니다.

문제가 되는 배치는 모두 보고됩니다. 여러 컴포넌트를 두 번 배치한 Release는 한 번의 빌드에서 문제 항목마다 이 중단을 하나씩 내며, 각각은 대상 항목의 키에서 보고됩니다. 따라서 여러 개가 함께 나타나면 하나의 결함이 여러 번 기록된 것이 아니라 한 번의 빌드가 발견한 모든 것을 지정한 것입니다.

메시지가 이미 적용 중이라고 보고하는 배치가 항상 파일에서 먼저 작성된 배치는 아닙니다. 경계 자체의 components: 항목은 라우팅 항목이 지정하는 컴포넌트와 경계가 라우팅하는 하위 모듈보다 먼저 읽히고, 경계는 그 안에 중첩된 경계보다 먼저 읽히며, 나란히 작성된 경계는 나타나는 순서대로 읽힙니다. 앞선 배치 여러 개가 충돌하는 경우 가장 먼저 읽힌 것이 지정됩니다. 두 위치는 순서와 관계없이 모두 지정되며, 어느 쪽도 다른 쪽보다 우선하지 않습니다.

출력 메시지입니다. 문장은 규칙을 말하고, 이어지는 내용은 문제 항목, 두 배치 각각이 속한 경계, 각각이 작성된 블록, 그리고 둘을 모두 담은 파일을 지정합니다. 한 경계의 components: 아래 항목이 다른 경계의 앞선 항목과 만나는 경우:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, "<component>", named in the components block of boundary "<boundary-b>", while it is already named in the components block of boundary "<boundary-a>", that earlier entry naming "<component>", both declared in "<path>") (컴포넌트가 둘 이상의 경계에 선언됨: 각 컴포넌트는 정확히 하나의 경계에 선언하십시오)

경계를 지정하는 두 절은 각 항목이 작성된 블록에 맞게 표현됩니다. 문제 항목은 다음 중 하나를 사용합니다.

  • named in the components block of boundary "<boundary>" — 경계 자체의 components: 맵;
  • named inside a routing entry in boundary "<boundary>" — 해당 경계의 aggregates: 아래 라우팅 항목의 components: 맵;
  • routed as a sub-module into boundary "<boundary>" — 라우팅 항목 자체.

같은 문장에 이어지는 앞선 배치는 다음 중 하나를 사용합니다.

  • while it is already named in the components block of boundary "<boundary>";
  • while it is already named inside a routing entry in boundary "<boundary>";
  • while it is already placed by a sub-module routed into boundary "<boundary>".

두 절은 독립적으로 선택되므로 어떤 조합이든 나타날 수 있으며, that earlier entry naming은 앞선 배치가 가리킨 대상을 담습니다. 즉 컴포넌트의 id, 또는 라우팅된 하위 모듈이 배치한 경우 하위 모듈의 접두사입니다.

문제 항목이 라우팅 항목 자체인 경우 그것이 가리키는 대상은 단일 컴포넌트가 아니라 하위 모듈이며, 메시지는 모듈 접두사를 컴포넌트 이름처럼 표시하지 않고 그렇게 명시합니다. 다음은 다른 경계로 라우팅된 앞선 하위 모듈과 만나는 경우입니다.

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, sub-module "<module>", routed as a sub-module into boundary "<boundary-b>", while it is already placed by a sub-module routed into boundary "<boundary-a>", that earlier entry naming "<module>", both declared in "<path>") (컴포넌트가 둘 이상의 경계에 선언됨: 각 컴포넌트는 정확히 하나의 경계에 선언하십시오)

해결 방법: 두 배치 중 의도하지 않은 쪽을 삭제합니다. 메시지가 둘 다 지정하므로 선택은 컴파일러가 아니라 작성자에게 있습니다. 직접 선언과 라우팅된 모듈이 충돌하는 경우, 컴포넌트가 모듈과 함께 속할지 단독으로 속할지 결정합니다. 모듈을 라우팅하면 모듈에 포함된 다른 모든 것과 함께 배치되고, 직접 지정하면 그것들과 분리됩니다. 두 라우팅 항목이 하나의 모듈을 차지하는 경우 의도하지 않은 라우팅을 제거합니다. 모듈을 경계로 라우팅하면 그 모듈에 포함된 모든 컴포넌트가 그곳에 배치되므로, 그런 항목 두 개는 같은 컴포넌트 집합을 차지합니다.

A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Manifest 어노테이션 바인딩이 예약된 접두사를 사용함)

Manifest가 순수한 aggrega.ai/ 접두사로 시작하는 키 아래에 어노테이션 바인딩을 선언합니다. 이 접두사는 빌드가 스스로 출력하는 키를 기록하는 곳이므로, 그 안의 키를 차지하는 바인딩은 작성자의 라우팅과 플랫폼 자체의 출력을 하나의 키 공간에 두어 같은 이름을 두고 경쟁하게 만듭니다.

이것은 중단이며, 권고일 수 없습니다. 예약은 그 키 공간을 플랫폼의 것으로 만드는 전부입니다. 바인딩을 받아들이고 나중에 언급하면 충돌이 빌드에 남게 됩니다.

이 규칙은 작성된 바인딩이 차지하는 키 공간에 관한 것이므로, 제시된 Manifest가 바인딩을 선언하지 않은 키는 보고되지 않고 넘어갑니다. 위반할 바인딩이 없기 때문입니다.

출력 메시지입니다. 문제가 되는 키가 문장의 주제이므로 맨 앞에 오고, 그 뒤의 값들은 각각 무엇인지 소개된 뒤 나옵니다.

manifest annotation binding uses reserved prefix (Manifest, at <field-path>, "<key>", reserved prefix "aggrega.ai/", routing to Feature "<feature-uri>", author the binding under a domain of your own such as "feature.<your-domain>/") (Manifest 어노테이션 바인딩이 예약된 접두사를 사용함)

해결 방법: 바인딩 키를 직접 관리하는 네임스페이스로 변경합니다. 하위 접두사가 붙은 키는 지원되는 형태이며 예약되어 있지 않습니다. 표준 라이브러리 단축키에는 feature.aggrega.ai/…를, 엔터프라이즈 단축키에는 acme.aggrega.ai/…, compliance.example.com/…과 같은 자체 도메인을 사용합니다. 키 이름을 바꾸면 작성자가 바인딩을 트리거하기 위해 컴포넌트에 쓰는 내용이 바뀌므로, 같은 편집에서 그 키를 사용하는 어노테이션도 업데이트합니다. 순수 접두사 아래의 플랫폼 자체 키는 ../providers/well-known-annotations.md에 나열되어 있습니다.

Two Manifest annotation bindings compete for one routing slot (두 Manifest 어노테이션 바인딩이 하나의 라우팅 슬롯을 두고 경합함)

하나의 Manifest 안에 있는 두 어노테이션 바인딩이 같은 pillar를 통해 같은 경로로 같은 Feature에 라우팅됩니다. 바인딩의 역할은 어노테이션 값이 어디에 놓이는지를 지정하는 것이며, 두 바인딩이 하나의 목적지를 지정하면 값에 두 개의 경로가 생기고 확장 시점에 그중 하나를 고를 근거가 없습니다.

대상 Feature마다 주어진 경로와 pillar 쌍은 하나의 바인딩만 선언할 수 있습니다. 같은 Feature를 서로 다른 경로로 대상으로 하는 두 바인딩은 평범한 작성 방식이며 빌드됩니다. 같은 경로를 서로 다른 두 Features로 라우팅하는 두 바인딩도 마찬가지입니다.

바인딩은 Manifest가 선언한 순서대로 순회되므로, 메시지가 먼저 지정하는 바인딩이 항상 문서에서 앞에 있는 바인딩입니다.

출력되는 메시지:

manifest annotation bindings collide on same Feature path+pillar (Manifest, at <path>, annotation bindings "<first-key>" and "<second-key>" both target Feature "<feature-uri>" with path "<path>" routing to pillar "<pillar>"; only one binding may declare a given (path, pillar) pair per Feature) (같은 Feature 경로+pillar에서 manifest 어노테이션 바인딩이 충돌함)

해결 방법: 어느 바인딩이 목적지를 소유할지 결정하고 다른 바인딩의 maps.infra 또는 maps.values 목록에서 해당 경로를 제거하거나, 두 번째 바인딩을 완전히 삭제합니다. 두 어노테이션 키가 하나의 Feature 필드에 도달하도록 하려고 두 바인딩을 만든 경우에는 바인딩 하나만 남기고 두 어노테이션 키가 모두 그 바인딩을 통해 라우팅되도록 합니다. 서로 다른 두 값이 두 곳에 놓이도록 의도한 경우에는 잘못 작성된 경로를 수정합니다.

A Release reached resolution without passing through the load path (Release가 로드 경로를 거치지 않고 해석 단계에 도달함)

Release가 비어 있지 않은 최상위 components: 영역과 합성된 default 경계를 모두 가진 채 해석 단계에 도달했습니다. 이 조합은 정상적으로 로드된 Release에서는 만들어질 수 없습니다. 로드 경로는 최상위 components: 블록을 기본 경계로 접어 넣은 뒤 비우며, 둘 다 직접 작성한 문서는 여기까지 오기 전에 스키마에서 거부됩니다.

따라서 이 중단은 작성한 내용을 보고하는 것이 아닙니다. 무언가가 로드 경로를 우회하여 해석 단계에 도달했음을 보고하는 것으로, 대개는 파일에서 읽은 것이 아니라 임베딩 프로그램이 메모리에서 구성한 Release입니다. 그리고 두 컴포넌트 영역이 서로 일치하지 않는 문서로 빌드를 진행하지 않고 그 자리에서 멈춥니다. 어느 순서로 읽든 컴포넌트를 조용히 누락하거나 중복하는 출력이 만들어지며, 경계 순회와 에지별 순회는 그것이 어느 컴포넌트인지에 대해서조차 서로 일치하지 않습니다.

출력되는 메시지:

release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary): construct releases through the normalization core (types.NormalizeRelease via the load path), not a hand-built literal (release가 정규화되지 않은 채 resolve에 도달함(합성된 기본 경계와 함께 비어 있지 않은 루트 components가 있음): 수작업 리터럴이 아니라 정규화 코어(로드 경로를 통한 types.NormalizeRelease)를 통해 release를 구성하십시오)

해결 방법: YAML을 작성하는 중이라면 할 일이 없습니다. aggrega build, aggrega validate 또는 편집기에서 이 중단이 발생했다면 보고할 만한 컴파일러 결함이 있다는 뜻이며, 빌드하던 Release에는 잘못이 없습니다. 컴파일러를 임베딩하여 자체 코드에서 Release 값을 만드는 경우에는 구조체를 직접 조립하지 말고 로드 경로를 통해 구성하여, 루트 컴포넌트를 기본 경계로 접어 넣는 정규화가 실행되도록 합니다.

A library reference expands into itself (라이브러리 참조가 자기 자신으로 확장됨)

문서 간 참조 체인이 이미 도달한 문서로 되돌아오므로, 확장이 끝나지 않습니다. 두 가지 작성 영역이 같은 상황에 도달하며, 둘 다 한 파일 안의 무언가가 아니라 라이브러리 엔터티 사이의 체인입니다. 하나는 스키마 pillar에서 SchemaLibrary 엔트리로 가는 $ref:가 참조를 거쳐 되돌아오는 경우이고, 다른 하나는 MappingLibrary 또는 WorkloadLibrary 엔트리로 가는 $import:가 같은 일을 하는 경우입니다.

체인은 정규 키, 즉 레지스트리 호스트와 버전 표기를 제거한 라이브러리의 식별자와 엔트리 이름으로 비교되므로, 경로상에서 같은 엔트리를 두 가지 방식으로 지정하여 순환이 검사를 피할 수는 없습니다. 확장된 뒤 종료되는 참조는 몇 번 나타나든, 체인이 얼마나 깊든 문제가 없습니다. 깊이 자체만으로는 이 중단이 발생하지 않으며, 하나의 라이브러리 엔트리를 여러 곳에서 재사용하는 것은 라이브러리가 존재하는 이유인 패턴입니다.

$import: 체인의 경우 출력되는 메시지입니다. 순회한 순서대로 전체 루프를 나열하므로 어느 단계가 루프를 닫는지 확인할 수 있습니다.

circular reference expansion: <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> (순환 참조 확장)

$ref: 체인은 대신 compact-form 컴파일러가 보고하며, 읽고 있던 문서와 키워드를 함께 표시합니다.

compactform at <consumer-file> (keyword "$ref"): circular cross-document $ref expansion: <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> (순환 문서 간 $ref 확장)

해결 방법: 메시지의 체인을 읽고 의도하지 않은 단계에서 끊습니다. 순환은 대개 두 라이브러리 엔트리가 서로를 확장하도록 작성되었음을 뜻합니다. 공유 부분을 둘 다 참조하는 세 번째 엔트리로 합치거나, 둘 중 하나에 인라인으로 넣습니다. 마지막으로 표시된 단계가 루프를 닫은 단계이지만 반드시 잘못된 단계는 아닙니다. 어느 연결을 끊을지는 사용자가 결정할 일이기 때문에 체인 전체가 출력됩니다.

같은 상황은 위의 “YAML anchor aliased inside its own content(자체 내용 안에서 별칭된 YAML 앵커)”에 설명된 앵커 재귀 거부의 근거이기도 합니다. 그것은 단일 문서 자체 텍스트 안의 루프이고, 이것은 문서 사이의 루프입니다. 메시지의 체인을 보면 둘을 한눈에 구분할 수 있습니다. 문서 사이의 루프는 라이브러리 엔트리를 나열하고, 문서 안의 루프는 앵커를 지정합니다.

A declared schema cannot be resolved (선언된 스키마를 해석할 수 없음)

스키마가 무언가를 검증하는 데 사용되는 시점에 도달했지만 스키마로 조립할 수 없었습니다. 가장 흔한 원인은 해석 가능한 대상을 지정하지 않는 $ref:입니다. JSON Schema 메타 스키마를 충족하지 않는 스키마도 같은 중단에 도달하며, 조건부 키워드 아래에서 자체적으로 해석할 수 없는 then: 또는 else: 분기도 마찬가지입니다.

거부는 스키마에 대해 무엇이든 검증되기 전에 이루어지며, 그 순서가 핵심입니다. 읽을 수 없는 스키마를 건너뛰면 그 스키마가 다루는 모든 것이 검증되지 않은 채 빌드가 성공을 보고하게 됩니다. 이는 실행을 멈춘 검사가 멈췄다는 사실조차 알리지 않는 것과 같습니다.

스키마 내부의 위치, 해석할 수 없었던 키워드, 해석 과정에서 보고된 내용을 담아 출력되는 메시지입니다.

validator/jsonschema: schema resolution failed (at <path-inside-the-schema>, keyword "<keyword>", <what resolution reported>) (스키마 해석 실패)

실패가 스키마 내부의 키워드가 아니라 스키마 루트에서 발생한 경우에는 위치와 키워드가 생략되고 문장에는 보고된 이유만 담깁니다.

해결 방법: 메시지가 지정한 위치에서 스키마를 엽니다. 대개 $ref:가 원인입니다. 대상이 존재하는지, 문서 내 참조가 #/$defs/… 경로를 정확히 표기하는지, 문서 간 참조가 빌드의 의존성 클로저에 실제로 있는 SchemaLibrary 엔트리를 지정하는지 확인합니다. 메시지가 then: 또는 else: 분기를 지정하는 경우, 그 분기는 그 자체로 하나의 스키마이므로 자체적으로 해석 가능해야 합니다.

An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (두 확장 키워드 중 하나의 술어를 평가할 수 없음)

스키마가 템플릿 값을 갖는 두 확장 키워드 중 하나를 선언했지만 그 템플릿을 사용할 수 없습니다. 문자열이 아니거나, 템플릿으로 파싱되지 않거나, 실행 중 실패했거나, true 또는 false 이외의 것을 렌더링한 경우입니다.

x-aggrega-when:은 스키마의 조건부 분기가 적용되는지를 결정하고, x-aggrega-validate:는 값이 스키마 자체 키워드로는 표현할 수 없는 규칙을 충족하는지를 결정합니다. 둘 다 판정으로 읽히므로, 판정이 아닌 결과는 해석되지 않고 거부됩니다. 빈 문자열을 렌더링하는 술어는 false로 읽혀, 그것이 강제하려고 작성된 규칙을 조용히 무력화하게 됩니다.

출력되는 메시지:

validator/jsonschema: x-aggrega extension evaluation failed (at <path-inside-the-schema>, keyword "x-aggrega-validate", <what evaluation reported>) (validator/jsonschema: x-aggrega 확장 평가 실패)

조건부의 술어가 문제인 경우에는 키워드 자리에 "x-aggrega-when"이 오며, 보고된 이유는 템플릿 오류, 즉 파싱 위치, 누락된 함수, 또는 템플릿이 생성한 불리언이 아닌 값을 나타냅니다.

해결 방법: 메시지가 가리키는 위치에서 스키마를 열고 보고된 이유를 읽습니다. 키워드의 값이 문자열인지, 템플릿이 파싱되는지, 그리고 템플릿이 따라가는 모든 경로가 검증 대상 값에 실제로 존재하는지 확인합니다. 술어는 값을 .value로 읽으며, 다른 것을 참조하는 것이 가장 흔한 실수입니다. 이유가 index가 찾지 못한 키를 가리키는 경우에는 hasKey로 키 존재를 검사하거나 대신 get으로 읽습니다. 아래 “A template indexes a map with a key the map does not hold (템플릿이 맵에 없는 키로 맵을 인덱싱함)”에서 설명하듯이 index는 맵에 없는 키에서 중단되기 때문입니다. 템플릿이 마지막에 true 또는 false를 생성하도록 합니다. 비교식은 그렇게 하지만, 단순히 값을 렌더링하는 템플릿은 그렇지 않습니다.

A Workload does not satisfy the Workload schema (Workload가 Workload 스키마를 충족하지 않음)

Recipe 또는 FeatureRecipe의 workload: 블록을 읽어 Workload 스키마에 대해 검사했으나, 하나 이상의 필드가 이를 충족하지 않습니다. 철자가 틀린 키, 잘못된 타입의 값, 누락된 필수 필드, 선언된 범위나 열거형을 벗어난 값 등이 해당됩니다.

보고는 그룹화됩니다. 하나의 중단이 문제가 있는 모든 필드를 담으므로, 실수가 네 개인 Workload는 빌드마다 하나씩이 아니라 한 번의 빌드에서 네 개 모두를 알려 줍니다. 헤더는 Workload, 이를 선언한 Recipe, 파일을 나타내며, 그 아래의 각 항목은 Workload 내부의 필드 경로, 스키마가 그곳에서 요구한 내용, 그리고 제시할 수 있는 경우 해결 방법을 나타냅니다.

출력되는 메시지:

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage) (workload 검증 실패): .containers.<name>.<field>: <what the schema required> — <the fix, where one can be stated> .initContainers[<i>].<field>: <what the schema required> — <the fix, where one can be stated>

필드별 세부 정보가 없는 실패, 즉 블록을 읽고 부족함을 발견한 것이 아니라 블록을 아예 읽을 수 없었던 경우에는 전체 이유를 단일 항목으로 담습니다.

workload: 템플릿이 민감한 것으로 선언된 값을 읽는 경우, 어떤 항목도 값을 인용하지 않습니다. 렌더링된 문서의 어느 필드가 그 값에서 왔는지 알 수 없으므로, 텍스트에 값이 담길 수 있는 모든 항목은 값 자리에 <redacted>를 넣어 스키마의 제약을 기술하고 이유를 밝히는 안내로 끝맺으며, 값에서 도출한 해결 방법은 담지 않습니다.

.containers.main.imagePullPolicy: against /$defs/container: enum: <redacted> does not satisfy enum ["Always","Never","IfNotPresent"] (the value is withheld because the template that rendered this document reads a value declared sensitive)

값을 인용하지 않는 항목, 즉 누락된 키나 Workload가 허용하지 않는 키는 다른 템플릿과 동일하게 표시됩니다. vocabulary/compact-form-authoring.md의 “What a refusal says about a declared value”를 참조하십시오.

workload: 블록은 Aggregate나 Release가 아니라 Recipe 작성자가 작성하므로, 빌드는 이 중단을 CATALOG_ERROR 태그로 보고합니다.

해결 방법: 나열된 필드 경로에서 Recipe를 열고 각각을 수정합니다. 경로는 Workload 자체의 루트부터 주어지므로, .containers.main.health.ready는 main 컨테이너의 health 키 아래에 있는 ready 블록입니다. 이름이 있는 컨테이너는 키로, init 컨테이너는 위치로 지정되므로 두 경로의 형태가 다릅니다. 각 필드가 허용하는 내용은 Workload 작성 레퍼런스에 있습니다.

스키마가 텍스트를 원하는 필드가 값이 숫자나 불리언이어서 거부되었다면, 거의 항상 따옴표 없는 템플릿 표현식이 원인입니다. workload: 블록은 검사 전에 렌더링되므로, 따옴표 없이 작성된 표현식은 맨 텍스트로 확장되고 YAML은 그 텍스트를 보이는 그대로의 타입으로 읽습니다. 정수 코어 크기 수량, 숫자로만 이루어진 버전, 포트, 그리고 yes, no, on, off라는 단어는 모두 텍스트가 아닌 것으로 읽힙니다. 항목은 YAML이 어떤 타입으로 읽었는지 알려 주며, 해결책은 Recipe에서 표현식에 따옴표를 붙이는 것입니다. cpu: {{ .infra.compute.cpu }}가 아니라 cpu: "{{ .infra.compute.cpu }}"로 작성하면 운영자가 무엇을 제공하든 값이 텍스트로 유지됩니다. 여기서 운영자의 값 자체는 문제가 아니며 Release에서 그 값에 따옴표를 붙여도 아무것도 바뀌지 않습니다. 따옴표는 Recipe에서 표현식을 감싸야 합니다.

A Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Workload 연결이 엔터티가 선언하지 않은 슬롯이나 슬롯이 금지하는 전달 방식을 지정함)

workload: 블록 안에 있는 컨테이너의 attachments: 항목은 연결 슬롯을 참조하는데, 이 참조가 Component나 Feature가 featuresSchema에서 선언한 슬롯과 맞지 않습니다. connection:으로 연결을 지정하는 항목이라면 해당 연결의 소켓이 선언한 슬롯과 맞지 않는 경우입니다. 연결을 지정하는 envFrom 항목에도 같은 연결 규칙이 적용됩니다. 발견 항목은 다음 중 어떤 경우에 해당하는지 알려 줍니다.

  • 슬롯이 선언되지 않았습니다. 항목의 from:이 엔터티의 featuresSchema에 없는 슬롯을 지정합니다. 철자가 틀렸거나, 한쪽에서만 이름이 바뀐 슬롯입니다.
  • 슬롯이 블랙박스입니다. 슬롯이 빈 inject: 허용 목록을 선언하므로 전달은 Recipe 자체의 내부 배선에만 맡겨집니다. 이러한 슬롯은 내부에서 채워지고 소비되므로 Workload가 접근할 수 없습니다.
  • 전달 방식이 슬롯의 허용 목록에 없습니다. 항목의 as:가 슬롯의 inject: 목록이 허용하지 않는 메커니즘을 지정합니다.
  • 컴포넌트가 맺지 않은 연결입니다. 항목의 connection:이 컴포넌트의 어떤 연결에도 쓰이지 않은 별칭을 지정합니다.
  • 연결의 소켓이 슬롯을 선언하지 않습니다. 항목의 from:(envFrom에서는 secret:)이 해당 연결이 거치는 소켓에서 선언하지 않은 슬롯을 지정합니다.
  • 슬롯이 합성된 이름으로 작성되었습니다. 항목의 from:(또는 secret:)이 연결의 첨부가 컴포넌트에서 갖는 이름, 즉 별칭, 점, 슬롯을 이은 이름을 connection: 없이 쓴 것입니다. 연결의 슬롯은 연결을 지정해야만 참조할 수 있습니다.

모든 컨테이너의 잘못된 항목이 함께 보고되므로 한 번의 빌드로 모두 확인할 수 있습니다. 발견 항목은 Workload, 해당 Recipe, 파일을 지정하는 하나의 헤더 아래에 묶입니다.

출력되는 메시지:

workload featuresSchema cross-check failed (Workload in Recipe <name>:<version>, at <path>, featuresSchema stage): .containers.<name>.attachments.<KEY>.from: references slot "<slot>" which is not declared in the Component’s featuresSchema — either declare the slot in the Component (or Feature) featuresSchema, or rename the reference to an existing slot .containers.<name>.attachments.<KEY>.from: slot "<slot>" is blackbox (no inject: allowlist) and cannot be referenced from a Workload attachments entry — blackbox slots are delivered by Recipe-internal plumbing; remove the Workload-side reference, or widen the slot’s inject allowlist if Workload-side delivery is intended .containers.<name>.attachments.<KEY>.as: delivery mechanism "<as>" is not permitted by slot "<slot>" (inject allowlist: [<mechanisms>]) — use one of the allowlisted delivery mechanisms ([<mechanisms>]), or widen the slot’s inject allowlist in the Component/Feature featuresSchema .containers.<name>.attachments.<KEY>.connection: names connection "<alias>" for slot "<slot>", but the component draws no connection under that alias — name a connection the component draws (<aliases>), or remove connection to read a slot the Component declares for its own attachments .containers.<name>.attachments.<KEY>.from: names slot "<slot>" of connection "<alias>", which socket "<socket>" does not declare — name a slot socket "<socket>" declares (<slots>), or declare the slot in that socket’s featuresSchema .containers.<name>.attachments.<KEY>.from: names "<alias>.<slot>", the name the compiler composes for slot "<slot>" of connection "<alias>"; a slot a connection’s socket declares is named by naming the connection — write connection: <alias> beside from: <slot>

envFrom 항목에서는 같은 발견 항목이 .containers.<name>.envFrom[<i>].connection과 .containers.<name>.envFrom[<i>].secret에 위치합니다.

해결 방법: 각 발견 항목은 양쪽을 모두 지정하므로, 어느 쪽을 바꿀지 선택하면 됩니다. 선언되지 않은 슬롯이라면 from:의 철자를 고치거나 엔터티의 featuresSchema에 슬롯을 선언합니다. 필드 경로의 .from 접미사가 참조 위치를 가리킵니다. 블랙박스 슬롯이라면 Workload 쪽 참조를 제거하고 Recipe가 자료를 전달하게 합니다. Workload 쪽 전달이 정말로 필요하다면 슬롯에 inject: 허용 목록을 지정합니다. 거부된 메커니즘이라면 as:를 허용 목록에 있는 것으로 바꾸거나 사용하려는 메커니즘을 목록에 추가합니다. 컴포넌트가 맺지 않은 연결이라면 별칭을 발견 항목이 나열한 것 중 하나로 고치거나, Aggregate 또는 Release에서 연결을 맺습니다. 소켓이 선언하지 않은 슬롯이라면 발견 항목이 나열한 슬롯 중 하나를 지정하거나, Component에서 소켓의 featuresSchema에 슬롯을 선언합니다. 합성된 이름이라면 발견 항목이 보여 주는 대로 연결과 슬롯을 따로 작성합니다.

A Workload references a slot whose fill publishes no locator (Workload가 채움이 로케이터를 게시하지 않는 슬롯을 참조함)

컨테이너의 attachments: 항목이 슬롯을 참조로 지정하는데, 그 슬롯을 채우는 첨부가 이러한 참조가 읽는 provides 키를 게시하지 않습니다. 슬롯을 이름으로 참조한다는 것은 슬롯이 나타내는 리소스를 렌더링된 출력에서 리소스의 이름과 그 안의 필드로 지정해 달라고 요청하는 것입니다. 둘 다 게시하지 않는 채움에는 가리킬 로케이터가 없으므로 참조를 어떤 것으로도 바꿀 수 없습니다.

필요한 키는 항목에 따라 다르며, 발견 항목이 어떤 키를 요구했는지 알려 줍니다. 자체 key:를 지정하는 항목은 필드를 직접 제공하므로 리소스의 name만 게시되면 됩니다. 이 덕분에 여러 키를 가진 리소스를 참조할 수 있습니다. key:를 지정하지 않는 항목은 슬롯이 게시한 단일 필드를 읽으므로 name과 key가 모두 있어야 합니다.

이 검사는 키가 있는지만 확인하며 값은 결코 살펴보지 않습니다. 잘못된 항목은 모두 하나의 헤더 아래에 함께 보고됩니다.

출력되는 메시지:

workload attachment slot is not referenceable (Workload in Recipe <name>:<version>, at <path>, slotReferenceability stage): .containers.<name>.attachments.<KEY>.from: slot "<slot>" is not referenceable: its resolved provides does not expose "<key>" (a workload attachment reference reads the provides keys name and key) — reference a slot filled by an attachment whose schema.provides declares the keys this reference reads, or deliver it through the slot’s inject pipe rather than a workload reference

해결 방법: 두 가지 방향이 있으며, 어느 쪽이 맞는지는 의도에 따라 다릅니다. 참조가 올바르다면 슬롯을 채우는 첨부를 바꿔야 합니다. schema.provides가 name을 선언하는 Feature를 첨부합니다. 항목이 자체 키를 지정하지 않는다면 key도 선언해야 합니다. 그러면 가리킬 로케이터가 생깁니다. 자료를 출력에서 이름으로 지정할 의도가 처음부터 없었다면 참조를 제거하고 대신 슬롯의 inject: 파이프로 전달합니다. 이 파이프는 값이 있는 위치를 가리키는 포인터가 아니라 값 자체를 전달합니다.

A container gives one environment variable two values (컨테이너가 하나의 환경 변수에 두 값을 지정함)

workload: 블록의 한 컨테이너가 같은 환경 변수를 두 번 지정합니다. 한 번은 variables의 키로, 또 한 번은 as: env로 전달되는 attachments 항목의 키로 지정합니다. 메인 컨테이너와 init 컨테이너가 각각 검사되며, component의 Recipe가 렌더링하는 Workload와 FeatureRecipe가 렌더링하는 Workload(component에 연결된 것과 boundary에 선언된 것 모두)에서 똑같이 검사됩니다. 검사는 템플릿이 렌더링한 상태의 Workload를 읽습니다.

하나를 고르지 않고 중단하는 이유. 컨테이너의 환경은 이 두 컬렉션으로부터 고정된 순서로 작성됩니다. helm 및 compose provider는 attachment에서 읽은 항목을 모두 먼저 쓰고 일반 variables를 그 뒤에 씁니다. 따라서 두 방식으로 모두 지정된 이름은 그 순서상 우선하는 값으로 프로세스에 전달되는데, 이는 작성한 내용이 아니라 두 종류가 놓이는 위치에 따른 결과이므로 빌드는 이 쌍을 렌더링하지 않고 거부합니다. 검사는 어떤 provider가 Workload를 렌더링하든 한 번 실행되며, Workload의 다른 검사 이후, 그리고 artifacts: 항목이 평가되거나 provider에 Workload가 전달되기 전에 실행되므로 거부된 쌍은 결코 렌더링되지 않습니다. as: file로 전달되는 attachments 항목은 환경에 설정되지 않고 파일로 마운트되므로 쌍을 이루지 않습니다.

검사는 이름만 비교하며 값은 읽지 않으므로, 어떤 결과도 값을 인용하지 않습니다. 두 종류의 환경 항목은 비교 대상이 아닙니다. envFrom 항목은 지정한 ConfigMap 또는 Secret의 키를 설정하는데 이 키는 빌드 실행 시점에 알 수 없으며, 파이프라인 단계가 렌더링된 문서에 쓰는 항목은 검사가 읽는 Workload의 일부가 아닙니다.

각 쌍은 별개의 결과로, Workload를 선언하는 Recipe 또는 FeatureRecipe의 workload: 키에 위치하며 변수와 컨테이너를 지정합니다. 메인 컨테이너는 키로, init 컨테이너는 initContainers 목록에서의 위치로 지정합니다. 결과는 메인 컨테이너가 작성된 순서대로 먼저 나오고, 이어서 init 컨테이너가 위치 순으로 나오며, 한 컨테이너 안에서는 attachments 항목이 작성된 순서를 따릅니다.

Recipe의 Workload에서 메인 컨테이너의 쌍에 대해 출력되는 메시지입니다. 범주와 이 조건의 짧은 코드 E0345는 대괄호로 묶인 머리 부분에 표시되며, 위치는 <path> at .spec.workload로 표시됩니다:

a container declares one environment variable twice ("<NAME>", container "<container>"). Rename one of the two, or write them under complementary template conditions so that only one of them renders (컨테이너가 하나의 환경 변수를 두 번 선언합니다. 둘 중 하나의 이름을 바꾸거나, 하나만 렌더링되도록 상호 보완적인 템플릿 조건 아래에 작성하십시오)

init 컨테이너의 쌍은 대신 목록에서의 위치를 지정하며(init container "initContainers[<i>]"), FeatureRecipe의 결과는 컨테이너 뒤에 이를 바인딩하는 attachment를 attachment "<attachment>"로 지정합니다. component는 여러 attachment를 가질 수 있고 그 FeatureRecipes는 별개의 문서이기 때문입니다.

하나의 Workload에 여러 쌍이 있으면 결과는 문서를 지정하는 줄 아래에 묶입니다. containers of the Workload this Recipe renders name one environment variable twice, 또는 FeatureRecipe의 경우 containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice입니다.

빌드는 이 중단을 CATALOG_ERROR 태그로 보고합니다. workload: 블록은 Aggregate나 Release가 아니라 Recipe 또는 FeatureRecipe의 작성자가 작성하기 때문입니다.

해결 방법: 컨테이너가 둘 중 어느 것을 받아야 하는지 결정합니다. 둘 다 필요하면 하나의 이름을 바꿔 프로세스가 두 변수를 보게 합니다. 둘이 대안 관계라면(예: credential이 연결되지 않았을 때의 일반 대체값) 정확히 하나만 렌더링되도록 상호 보완적인 조건으로 감쌉니다. 변수는 {{ if not (hasKey (default dict .features) "<slot>") }} 아래에, attachments 항목은 {{ if hasKey (default dict .features) "<slot>" }} 아래에 작성하거나, 하나의 {{ if }}/{{ else }}의 두 분기에 작성합니다. 이렇게 감싼 쌍은 렌더링된 Workload에 둘 중 하나만 존재하므로 검사에 도달하지 않습니다.

A Release’s parameters: block is written in neither of its two shapes (Release의 parameters: 블록이 두 형태 중 어느 것으로도 작성되지 않음)

Release는 Aggregate가 선언한 parameters를 두 가지 방식 중 하나로 채우며, 블록은 그 형태로 판독됩니다. 매개변수 이름을 제자리에 작성한 값에 매핑하는 매핑이거나, 값이 해당 값을 담은 YAML 파일의 경로인 정확히 하나의 키 $import:로 된 매핑입니다. 둘 다 아닌 블록은 Aggregate의 선언과 값을 대조하기 전, 읽는 시점에 거부됩니다.

세 가지 형태가 거부됩니다. 매핑이 전혀 아닌 parameters: 값(스칼라 또는 목록). 다른 키와 함께 $import:를 가진 매핑으로, 가져온 값과 작성한 값을 동시에 요구하면서 이를 결합하는 규칙을 제공하지 않습니다. 그리고 값이 일반 문자열이 아닌 $import:로, 어떤 파일도 지정하지 않습니다.

Release 스키마도 같은 두 형태를 선언하므로, 세 가지 중 하나를 담은 Release 파일은 먼저 E0215로 문서 엔벌로프 검사에 걸립니다. 이 검사는 두 형태를 모두 시도하고 각각이 실패한 이유를 알려 줍니다. 다음은 목록의 경우입니다:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.parameters: no oneOf branch matched (2 branches tried): branch[0]: type: expected object, got array; branch[1]: type: expected object, got array. correct the document to match its kind’s schema (문서 엔벌로프 검증 실패(Release). spec.parameters: 일치하는 oneOf 분기가 없습니다(분기 2개 시도): branch[0]: 타입: 객체가 필요하지만 배열입니다. branch[1]: 타입: 객체가 필요하지만 배열입니다. 종류의 스키마에 맞게 문서를 수정하십시오)

$import:가 다른 키와 함께 있는 경우 두 번째 분기는 additionalProperties: unexpected property: "<key>"로 끝나고, $import:가 문자열이 아닌 목록으로 작성된 경우에는 validation: type: array has type "array", want "string"으로 끝납니다.

값이 매핑이 아닐 때 출력되는 메시지로, 그곳에 작성된 것(예: a list)을 지정합니다:

parameters: shape must be an inline object or {$import: }: line <line>: <shape> is written where a map is expected (parameters: 형태는 인라인 객체이거나 $import만 있는 매핑이어야 합니다: 맵이 필요한 위치에 다른 형태가 작성되었습니다)

그리고 $import:가 다른 항목과 매핑을 공유하거나 경로가 아닌 것을 지정할 때:

parameters: shape must be an inline object or {$import: }: $import: must be the only key (got <n> keys) at line <line> ($import:는 유일한 키여야 합니다) parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line> ($import 값은 문자열 스칼라여야 합니다)

해결 방법: 메시지가 지정한 줄에서 Release를 엽니다. parameters: 아래에 값을 제자리에 작성하거나, 블록 전체를 값이 따옴표로 묶인 경로인 단일 $import: 항목으로 바꿉니다. 작성한 값 과 공유 기본값을 담은 가져온 파일을 모두 원했다면, 작성한 값을 import를 가진 Release를 extends:하는 Release로 옮깁니다. 여러 parameters 소스를 계층화하는 것이 extends: 체인의 용도이며, 이 하나의 키는 설계상 단일 소스에서 읽힙니다.

An inline-or-import field is written in neither shape (인라인 또는 가져오기 필드가 두 형태 중 어느 것으로도 작성되지 않음)

Recipe 또는 FeatureRecipe가 작성하는 세 필드, 즉 artifacts.<name>: 항목, valuesMapping:, workload:는 같은 두 형태를 받아들입니다. 본문을 문자열 스칼라로 그 자리에 작성하거나(여러 줄인 경우에는 보통 | 블록으로 작성합니다), 값을 정확히 하나의 키 $import:를 가진 매핑으로 작성하여 본문이 있는 위치를 대신 지정합니다. $import:가 지정할 수 있는 대상은 필드마다 다릅니다. artifacts 항목은 로컬 경로 또는 ArtifactLibrary의 번들을 가져오고, valuesMapping:과 workload:는 로컬 경로 또는 식별자로 지정한 라이브러리의 항목을 가져옵니다.

하나의 리더가 세 필드를 모두 검사하므로, 어느 필드에 문제가 있든 거부되는 경우는 같은 세 가지입니다. 키를 둘 이상 가진 매핑, 단일 키가 $import가 아닌 매핑, 값이 일반 문자열이 아닌 $import:입니다. 스칼라도 매핑도 아닌 값(대개 리스트)은 형태만으로 거부됩니다.

Recipe와 FeatureRecipe 스키마는 세 필드 각각에 대해 같은 두 형태를 선언하므로, 이 중 하나를 담은 파일은 먼저 E0215로 문서 엔벌로프 검사에 걸립니다. 이 검사는 필드를 지정하고 각 형태가 실패한 이유를 알려 줍니다. 첫 번째 분기는 그 자리에 작성하는 형태이고, 두 번째는 $import: 형태입니다:

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec.artifacts.<name>: no oneOf branch matched (2 branches tried): branch[0]: validation: type: object has type “object”, want “string”; branch[1]: additionalProperties: unexpected property: “<key>”. correct the document to match its kind’s schema (문서 엔벌로프 검증 실패(Recipe). spec.artifacts의 이 항목에 일치하는 oneOf 분기가 없습니다(분기 2개 시도): branch[0]: 검증: 타입이 객체이지만 문자열이 필요합니다. branch[1]: additionalProperties: 예상하지 못한 속성입니다. 종류의 스키마에 맞게 문서를 수정하십시오)

이것은 $import: 옆에 키를 가진 매핑의 경우입니다. $import가 아닌 단일 키는 required: missing required property: $import, additionalProperties: unexpected property: "<key>"로 끝나고, 목록은 type: expected object, got array로 끝나며, 문자열이 아닌 $import:는 type: array has type "array", want "string"처럼 문자열이 필요한 위치에서 발견된 타입을 지정합니다.

출력되는 메시지입니다. 각 메시지는 문제가 있는 필드에 해당하는 문장으로 시작하고, 이어서 리더가 무엇을 어디에서 발견했는지를 알려 줍니다.

artifacts entry: shape must be a string scalar or {$import: }: got <n> keys at line <line> (artifacts 항목: 형태는 문자열 스칼라 또는 $import 하나만 가진 매핑이어야 합니다. 해당 줄에서 여러 개의 키를 발견했습니다) valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> (valuesmapping: 형태는 문자열 스칼라 또는 $import 하나만 가진 매핑이어야 합니다. 해당 줄에서 다른 키를 발견했습니다) workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line> (workload: 형태는 문자열 스칼라 또는 $import 하나만 가진 매핑이어야 합니다. $import 값은 문자열 스칼라여야 합니다)

세 필드 모두 이 끝맺음 중 어느 것이든 보고할 수 있습니다. 두 형태 어느 것도 아닌 값은 line <line>: <shape> is written where text or a map is expected로 끝나며, 작성된 것(가장 흔하게는 a list)을 지정합니다.

해결 방법: 메시지가 지정한 행에서 엔티티를 엽니다. 본문을 블록 스칼라로 그 자리에 작성하거나, 값 전체를 단일 $import: 항목으로 바꿉니다. $import:와 다른 키를 함께 가진 매핑은 두 형태 중 어느 것도 아닙니다. 추가 키를 가져오는 파일 안으로 옮기거나 본문을 그 자리에 작성하십시오. 철자가 틀린 $import(대개 $가 빠진 경우)는 일반 키로 읽히며, $import가 아닌 단일 키로 보고됩니다.

A reference to a library entry carries whitespace (라이브러리 항목에 대한 참조에 공백이 포함됨)

라이브러리 안의 항목을 지정하는 참조는 끊김 없는 하나의 토큰으로 작성합니다. 라이브러리, 선택 사항인 :<version> 하한, 그리고 #와 항목의 경로 순입니다. 예: BaseWorkloads:1.0.0#/workloads/StatelessService. 어느 부분에도 공백은 허용되지 않습니다. 라이브러리 이름과 항목 이름은 모두 라이브러리 스키마에 의해 식별자 철자로 제한되고 버전은 버전일 뿐이므로, 참조 안 어디에든 있는 공백, 탭, 줄바꿈은 세 부분 어디에도 속하지 않습니다.

이 거부는 식별자로 라이브러리 항목을 지정하는 모든 곳에 적용됩니다. $import:로 작성된 valuesMapping:, workload:, artifacts.<name>: 항목, 그리고 스키마 $ref:입니다. $import:로 작성된 로컬 경로에는 #가 없고 라이브러리 항목에 대한 참조가 아니므로, 공백이 들어 있는 경로는 영향을 받지 않습니다.

이를 정리하지 않고 거부할 가치가 있는 이유는, 그런 값의 앞부분이 대개 그 자체로 하나의 참조이기 때문입니다. 공백에서 잘라 내면 그 참조가 해석되고 작성자가 쓴 나머지는 조용히 버려집니다. 게다가 빌드의 두 단계가 같은 양을 버린다는 보장이 없으므로, 한쪽은 다른 쪽이 보지 못한 의존성을 기록할 수 있습니다. 거부하면 값이 한 가지 의미만 갖게 됩니다.

거부는 참조를 읽어 온 문서의 행에서 보고됩니다.

library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line> (라이브러리 참조: 라이브러리 항목에 대한 참조에는 공백이나 줄바꿈이 들어갈 수 없습니다)

참조가 빌드에 도달하는 곳이 하나 더 있습니다. 빌드가 이미 해석한 라이브러리 항목의 본문으로, 첫 행의 필드 루트 $import:가 다른 라이브러리의 항목을 가리키는 경우입니다. 이 참조는 빌드가 연 문서에서 읽은 것이 아니므로 행 없이 보고됩니다.

library reference: a reference to a library entry carries no whitespace or line break: "<reference>" (라이브러리 참조: 라이브러리 항목에 대한 참조에는 공백이나 줄바꿈이 들어갈 수 없습니다)

해결 방법: 메시지가 지정한 행에서 엔티티를 열고 참조를 붙여 하나의 토큰으로 만듭니다. 흔한 원인은 # 앞의 줄바꿈입니다. 열 너비에 맞추려고 두 줄로 나눈 참조는 YAML에서는 하나의 값으로 읽히지만 여기서는 깨진 참조가 되므로, 아무리 길어도 한 줄로 작성하십시오. 다른 원인은 닫는 따옴표 앞의 후행 공백입니다. 이 공백은 버전 하한 안에 들어가서, 어떤 게시된 아티팩트에도 없는 버전을 지정하게 됩니다. 두 번째 형태의 경우 참조는 메시지에서 바로 앞에 이름이 나온 라이브러리 안에 있으므로, 그 라이브러리가 항목을 선언한 곳에서 수정하십시오.

A library entry’s body is not the shape that library holds (라이브러리 항목의 본문이 해당 라이브러리가 담는 형태가 아님)

라이브러리는 다른 엔티티가 가져갈 이름 있는 본문을 게시하며, 라이브러리 종류마다 담는 형태가 하나씩 정해져 있습니다. MappingLibrary 항목과 WorkloadLibrary 항목은 각각 하나의 템플릿 본문을 담으므로 항목의 값은 스칼라이며, 실제로는 | 블록입니다. ArtifactLibrary 항목은 번들, 즉 하나의 이름 아래 함께 묶이는 파일들을 담으므로, 항목은 출력 파일 이름에서 해당 파일 본문으로의 매핑이고 그 아래의 각 본문은 스칼라입니다.

본문은 작성된 그대로 캡처되며 라이브러리를 로드할 때 파싱되지 않습니다. 본문 안의 템플릿은 가져오는 곳에서 파싱되므로, 여기서 검사하는 것은 형태뿐입니다. 템플릿이 전혀 아닌 본문도 문제없이 로드되고, 무언가가 그것을 렌더링하는 시점에 실패합니다.

출력 메시지로, 각각 줄과 그곳에 작성된 것(예: a list)을 지정합니다:

mappinglibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (mappinglibrary: 항목 본문은 문자열 스칼라여야 합니다: 텍스트가 필요한 위치에 다른 형태가 작성되었습니다) workloadlibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (workloadlibrary: 항목 본문은 문자열 스칼라여야 합니다: 텍스트가 필요한 위치에 다른 형태가 작성되었습니다) artifactlibrary: entry must be a mapping of filename to a string body: line <line>: <shape> is written where a map is expected (artifactlibrary: 항목은 파일 이름을 문자열 본문에 대응시키는 매핑이어야 합니다: 맵이 필요한 위치에 다른 형태가 작성되었습니다)

그리고 항목은 매핑이지만 파일 중 하나가 스칼라가 아닌 번들의 경우에는 해당 파일을 지정합니다.

artifactlibrary: entry must be a mapping of filename to a string body: file "<filename>": line <line>: <shape> is written where text is expected (artifactlibrary: 항목은 파일 이름을 문자열 본문에 대응시키는 매핑이어야 합니다: 이 파일에서 텍스트가 필요한 위치에 다른 형태가 작성되었습니다)

빌드는 이를 읽고 있던 파일을 지정하는 CATALOG_ERROR 태그 아래에 보고하며, 그 아래에 위 문장이 표시됩니다.

해결 방법: 본문을 해당 키 아래에 블록 스칼라로 작성합니다. 첫 행이 YAML 키처럼 보이는 본문(YAML을 생성하는 템플릿은 대개 그렇습니다)은 블록 스칼라가 없으면 중첩 매핑으로 읽히며, 이것이 흔한 원인입니다. ArtifactLibrary의 경우 출력 파일 이름마다 키를 하나씩 작성하고 각 본문을 별도의 블록 스칼라로 작성하십시오. 번들을 하나의 본문으로 작성하는 것이 또 하나의 흔한 형태 실수입니다.

$instantiate: 참조를 해석할 수 없음

SchemaLibrary는 spec.templates 아래에 재사용 가능한 형태를 선언할 수 있으며, 각 형태는 고유한 $params를 가집니다. 그러면 스키마 항목은 $instantiate: 아래에 그 이름을 적고 $args: 아래에 매개변수를 제공하여 형태를 인스턴스화합니다. 치환은 문자 그대로 이루어집니다. 템플릿 본문의 $<name> 스칼라가 인수의 값으로 대체됩니다. 표현식 평가, 조건문, 반복문은 없으며, 치환된 값은 추가 마커를 검사하지 않고 그대로 삽입됩니다.

세 가지 결함이 인스턴스화를 거부합니다. $instantiate: 아래의 이름이 라이브러리가 선언한 이름이 아닌 경우입니다. 템플릿이 default: 없이 선언한 매개변수에 대한 항목이 $args: 아래에 없는 경우입니다. 또는 인수의 값이 해당 매개변수가 선언한 타입이 아닌 경우입니다. 선언된 매개변수를 가리키지 않는 $args: 키도 무시되지 않고 같은 방식으로 보고되므로, 인수 이름의 오타는 조용히 기본값이 적용되는 매개변수가 아니라 거부가 됩니다.

출력되는 메시지:

schemalibrary: template not found: "<template-name>" not declared in spec.templates schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>") schemalibrary: template parameter type mismatch: <what the type check found> schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params

해결 방법: 템플릿을 찾을 수 없는 경우, 이름을 라이브러리가 spec.templates 아래에 선언한 이름으로 수정하고, 의도한 라이브러리를 가져오고 있는지 확인합니다. 매개변수가 누락된 경우, $args:에 추가하거나 템플릿에서 매개변수에 default:를 지정하여 호출자가 생략할 수 있게 합니다. 타입이 일치하지 않는 경우, 인수를 선언된 타입으로 바꾸거나 매개변수의 type:을 넓힙니다. 메시지가 선언되지 않은 인수를 가리키는 경우, 철자를 수정하거나 제거합니다.

A schema uses a JSON Schema keyword the library does not admit (스키마가 라이브러리에서 허용하지 않는 JSON Schema 키워드를 사용함)

$dynamicAnchor와 $dynamicRef는 SchemaLibrary 내용에서 허용되지 않습니다. 이 키워드들은 참조가 어떤 스키마로 해석될지를 값이 검증되는 시점까지 미루므로, 라이브러리 항목의 의미가 그 항목이 말하는 내용이 아니라 어디에서 가져왔는지에 따라 달라집니다. 그리고 컴파일러는 모든 검증보다 먼저 라이브러리의 형태를 해석하므로, 지연된 참조가 해석될 대상이 없습니다.

거부는 세 지점에서 적용되며, 이들이 함께 키워드가 들어올 수 있는 두 경로를 모두 막습니다. 스키마 항목은 라이브러리가 로드될 때 검사됩니다. 템플릿 본문도 라이브러리가 로드될 때 검사되므로, 키워드를 문자 그대로 포함한 템플릿은 처음 인스턴스화하는 빌드가 아니라 그 시점에 실패합니다. 그리고 인스턴스화 후 치환된 본문이 다시 검사되므로, 키워드를 인수 값으로 제공해도 앞의 두 검사를 통과하지 못합니다.

출력되는 메시지:

schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line>

해결 방법: 지연된 참조를 $defs 항목을 직접 가리키는 $ref로 바꿉니다. 형태가 실제로 용도마다 달라지는 경우, 그 변화를 $params를 가진 템플릿으로 표현하고 용도마다 인스턴스화합니다. 이것이 이 표면이 제공하는 치환이며, 결과에 대해 무엇이든 검증되기 전에 해석됩니다.

A document nests deeper than the reader will descend (문서가 리더가 내려갈 수 있는 깊이보다 깊게 중첩됨)

작성된 모든 매핑은 키가 작성된 순서를 보존하는 구조로 읽힙니다. 그 순서가 렌더링된 출력에 반영되며, 빌드가 실행마다 바이트 단위로 동일하게 만드는 요소의 일부이기 때문입니다. 이 리더는 제한된 수준, 즉 100단계까지만 내려가고 그보다 깊이 내려가기를 거부하므로, 그렇지 않으면 리더 자체의 스택을 소진시킬 입력이 거부로 보고됩니다.

출력되는 메시지:

a document nests too many levels deep: it is read at most 100 levels deep (문서의 중첩 수준이 너무 깊습니다: 최대 100단계까지만 읽습니다)

해결 방법: 실제로 작성된 문서는 몇 단계만 중첩되므로, 100단계에 이르는 문서는 생성되었거나, 기계 번역되었거나, 실수로 자기 자신을 참조하는 것입니다. 자기 자신으로 확장된 값을 찾아봅니다. 자신이 속한 내용을 참조하는 YAML 앵커는 위의 별도 중단으로 거부되지만, 같은 형태를 반복해서 출력하는 생성기는 그렇지 않습니다. 깊이가 실제로 필요한 경우, 깊은 분기를 별도의 엔티티로 분리하고 이름으로 참조합니다.

A provider declares a well-known annotation at a scope it does not render (provider가 렌더링하지 않는 범위에서 잘 알려진 어노테이션을 선언함)

provider를 제공하는 Plugin은 자신에 대해 서로 일치해야 하는 두 가지를 말합니다. spec.provider.wellKnownAnnotations 아래에는 자신이 처리하는 어노테이션을 각각 읽는 범위와 함께 나열합니다. contract.inputKinds 아래에는 어떤 입력 종류를 렌더링하는지를 밝힙니다. 같은 엔티티가 주장하지 않는 입력 종류의 범위에 선언된 키는 한 파일 안에서 두 진술이 서로 모순되는 것이므로, 엔티티는 로드될 때 거부됩니다.

이 검사는 엔티티를 자기 자신과 비교하는 것이므로 플러그인 바이너리가 필요 없으며, 엔티티가 읽히는 모든 곳에서 발생합니다. 아티팩트를 한 번도 가져오지 않은 머신에서의 카탈로그 탐색도 포함됩니다.

두 가지 항목은 의도적으로 비교하지 않습니다. 경계 범위 항목은 입력 종류를 지정하지 않습니다. 어느 한 노드의 렌더링 경로가 아니라 경계 전체에 대해 한 번 해석되기 때문입니다. 범위를 전혀 선언하지 않은 항목은 경로별 주장을 하지 않습니다. 플러그인이 어딘가에서 그 키를 읽는다는 것만 말합니다.

이 거부가 입증하지 않는 것은 남아 있는 선언이 참이라는 점입니다. provider를 제공하는 플러그인이 읽는다고 말하는 키를 실제로 읽는지는 아무것도 증명할 수 없습니다. 작성된 두 필드를 비교해서 할 수 있는 일은 둘 다 참일 수 없는 쌍을 거부하는 것입니다. provider가 실제로 렌더링하는 범위에 선언되었지만 플러그인이 그곳에서 아무것도 읽지 않는 키는 여기서 통과합니다.

출력되는 메시지:

provider "<plugin-name>" declares well-known annotation "<key>" at scope "<scope>", but its contract.inputKinds.<field> is not claimed; declare the key only at a scope the provider renders, or claim the input kind: wellKnownAnnotations: a key is declared at a scope the provider’s contract does not render

해결 방법: 메시지는 양쪽을 모두 알려 줍니다. 어노테이션의 scope: 목록에서 해당 범위를 제거하여 provider가 실제로 렌더링하는 범위만 남기거나, provider가 실제로 그 입력 종류를 렌더링한다면 contract.inputKinds 아래에서 해당 입력 종류를 주장합니다.

A compact-form schema uses a keyword the compact form does not know (compact-form 스키마가 compact form이 알지 못하는 키워드를 사용함)

compact form으로 작성된 스키마에 compact-form 키워드도 아니고, 이 형식이 그대로 통과시키는 JSON Schema 키워드도 아니며, 이 형식이 예약한 세 가지 마커인 $jsonschema:, $mode:, $ref: 중 하나도 아닌 키가 있습니다. 알 수 없는 키는 버려지지 않고 스키마를 읽을 때 거부됩니다. 잘못 입력된 제약 조건이 무시되면 아무 제약도 없는 것이 되며, 강제되는 것처럼 보이지만 아무것도 강제하지 않는 스키마는 실패하는 스키마보다 나쁘기 때문입니다.

이 거부는 스키마가 컴파일되는 곳이면 어디서든 발생합니다. SchemaLibrary의 항목은 카탈로그가 로드될 때 컴파일됩니다. Component의 spec.schema, 소켓별 valueSchema와 infraSchema, 그리고 Feature와 provider Plugin이 선언하는 스키마는 카탈로그를 읽을 때 컴파일됩니다. Component 또는 Feature의 spec.schema는 이 조건을 직접 보고하며 엔티티와 필드를 지정합니다. 소켓의 valueSchema 또는 infraSchema는 아래의 “A declared schema contract cannot be read as a schema (선언된 스키마 계약을 스키마로 읽을 수 없음)” 안에서 보고되며, 여기 인용된 문장을 세부 내용으로 담습니다.

compact-form 컴파일러 자체의 문장은 스키마 내부의 위치, 소스 줄, 인식하지 못한 키를 명시합니다.

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): unknown keyword

문서 간 $ref: 옆에 작성된 키도 같은 조건으로 보고되지만 별도의 문장을 가집니다. 이러한 참조에는 세 가지 형제 키만 함께 올 수 있기 때문입니다.

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): cross-document $ref sibling not allowed (allowed: properties, required, description)

그리고 그 형제 키가 병합된 형태를 다시 열려고 한 경우에는 문장에 대신 사용할 방법이 담깁니다.

compactform at <path-inside-the-schema>:<line> (keyword "additionalProperties"): cross-document $ref sibling not allowed (allowed: properties, required, description); use $jsonschema: to embed an open-object schema if the merged shape must accept arbitrary properties

이 오류가 기록되는 조건은 compactform: unknown keyword이며, 짧은 코드도 이 조건으로 해석됩니다.

해결 방법: 문장이 가리키는 위치의 키를 compact-form-authoring.md의 키워드 어휘와 대조하여 수정합니다. 철자 오류가 가장 흔한 원인입니다. 형태에 compact form이 지원하지 않는 JSON Schema 키워드가 꼭 필요하다면, 해당 부분을 JSON Schema를 그대로 포함하는 $jsonschema: 아래에 작성합니다. 문서 간 참조 옆에는 properties:, required:, description:만 두고, 그 밖의 것은 참조가 가리키는 라이브러리 항목에 작성합니다.

A compact-form schema declares a field literally named type (compact form 스키마가 문자 그대로 type이라는 이름의 필드를 선언함)

compact form은 매핑의 의미를 내용의 형태로 판단합니다. type: 키는 제약 조건 리프를, 구조적 JSON Schema 키워드는 그대로 통과시킬 조각을, 일반 이름으로 된 매핑은 자식이 스키마인 객체를 나타냅니다. 이름이 type인 필드를 선언하는 스키마는 이러한 해석으로 구분할 수 없는 유일한 형태입니다. 제약 조건 리프처럼 보이지만 필드가 하나인 객체를 의도한 것이므로, 이 형식은 작성자에게 compact 또는 jsonschema로 설정한 $mode: 키로 어느 쪽인지 밝히도록 요구합니다.

이 조건은 다른 값으로 작성된 $mode:가 보고하는 조건입니다. 이 마커는 모호성을 해소하기 위해 존재하므로, 아무것도 해소하지 못하는 값은 추측하지 않고 거부합니다.

compact-form 컴파일러 자체의 문장:

compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema

이 오류가 기록되는 조건은 compactform: ambiguous dispatch — $mode required이며, 짧은 코드도 이 조건으로 해석됩니다.

해결 방법: 매핑이 필드 중 하나가 우연히 type이라는 이름인 compact-form 객체라면 $mode: compact를, 매핑이 작성된 그대로 받아들여야 할 JSON Schema 조각이라면 $mode: jsonschema를 설정합니다. 둘 다 의도한 것이 아니라면 필드 이름을 바꾸면 마커 없이도 모호성이 해소됩니다.

A $jsonschema: escape carries content that is not a schema ($jsonschema: 탈출구가 스키마가 아닌 내용을 담고 있음)

$jsonschema: 키는 compact form이 표현하지 못하는 형태를 위해 JSON Schema 조각을 그대로 포함합니다. 포함된 내용은 작성된 그대로 받아들여지며 변환되지 않으므로, 반드시 스키마여야 합니다. 즉, YAML로 파싱되는 블록 스칼라이거나 중첩된 매핑이어야 합니다. 둘 다 아닌 내용은 검증 대상으로 넘겨지지 않고 여기서 거부됩니다. 넘겨지면 실패가 스키마가 아니라 스키마의 소비자에 대해 보고되기 때문입니다.

네 가지 형태가 이 조건으로 보고되며, 문장이 어느 경우인지 알려 줍니다. 이스케이프 본문이 YAML로 파싱되지 않는 경우. 이스케이프의 값이 블록 스칼라도 매핑도 아닌 경우. properties: 키에 이름과 스키마의 매핑이 아닌 것이 있는 경우. 그리고 최상위 수준에서 컴파일러에 전달된 문서가 비어 있거나 리더가 처리 규칙을 갖지 않은 노드를 포함하는 경우입니다.

compact-form 컴파일러 자체의 문장:

compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): expected block-scalar string or nested mapping compactform at <path-inside-the-schema>:<line> (keyword "properties"): expected a mapping of property names to schemas compactform: unsupported YAML node kind

이 오류가 기록되는 조건은 compactform: $jsonschema content invalid이며, 짧은 코드도 이 조건으로 해석됩니다.

해결 방법: 이스케이프 본문을 $jsonschema: 아래에 블록 스칼라로 작성합니다. 그렇지 않으면 첫 줄이 YAML 키로 읽히는 본문이 주변 매핑에 흡수되며, 이것이 흔한 원인입니다. 또한 담긴 내용이 그 자체로 유효한 JSON Schema인지 확인합니다. 조각이 compact form으로 표현할 수 있을 만큼 작다면 이스케이프를 없애는 것이 더 간단합니다.

A compact-form constraint does not apply to the type it was written on (compact-form 제약 조건이 작성된 타입에 적용되지 않음)

compact-form 제약 조건은 필드의 선언된 타입에 따라 분기됩니다. min:과 max:는 숫자에서는 수치 범위, 문자열에서는 길이 범위, 배열에서는 개수 범위가 됩니다. 따라서 제약 조건은 그 제약을 받아들이는 타입의 필드에 있어야 하며, 분기가 답을 가지려면 타입이 단일 값이어야 합니다.

네 가지 형태가 이 조건으로 보고됩니다. type:이 없거나 유니온을 지정하는 곳에 작성되어 어떤 범위를 의도했는지 정할 수 없는 제약 조건. 객체나 불리언처럼 그런 종류의 범위를 받지 않는 타입에 작성된 제약 조건. 값이 스칼라 이름도 이름의 시퀀스도 아닌 type:. 그리고 스칼라 이름이 아닌 값이 주어진 valuesType:입니다.

compact-form 컴파일러 자체의 문장:

compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to a single declared type (integer/number/string/array); type: is unresolved (union or absent) — narrow type: to a single value or remove this constraint compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> compactform at <path-inside-the-schema>:<line> (keyword "type"): expected a scalar type name or a sequence of type names (JSON Schema 2020-12 array-of-types); got unsupported node kind compactform at <path-inside-the-schema>:<line> (keyword "valuesType"): expected a scalar type name

이 오류가 기록되는 조건은 compactform: constraint not valid for declared type이며, 짧은 코드도 이 조건으로 해석됩니다.

해결 방법: 문장은 제약 조건과 그것이 만난 타입, 양쪽을 모두 명시합니다. type:이 유니온이면 단일 이름으로 좁히고, 없으면 추가하며, 필드가 실제로 여러 타입 중 어느 것이든 받는다면 제약 조건을 제거합니다. 타입에 따라 달라져야 하는 범위는 $jsonschema: 아래에 대안의 집합으로 표현하며, 각 분기가 자체 타입과 자체 범위를 가집니다.

$ref:가 컴파일러가 해석할 수 있는 형식으로 작성되지 않음

스키마는 $ref:로 다른 형태를 참조하며, 같은 문서 안에서 참조하거나 문서를 넘어 SchemaLibrary 항목을 참조합니다. 참조가 실패하는 두 가지 방식을 두 조건이 각각 다루며, 어느 쪽인지는 문장이 알려 줍니다. 참조가 컴파일러가 읽을 수 있는 형식으로 작성되지 않았거나, 형식은 올바르지만 존재하지 않는 대상을 가리키는 경우입니다.

참조를 읽을 수 없는 경우. 값이 비어 있거나, 문서 간 형식이 <Library>#/schemas/<Entry>가 아니거나, 버전을 @로 구분한 경우입니다. 마지막 경우는 이 형식에서 가장 흔한 실수이므로 일반적인 오류 대신 올바른 표기와 함께 보고됩니다.

compactform at <path-inside-the-schema>:<line> (keyword "$ref"): expected a non-empty reference URL compactform at <consumer-document> (keyword "$ref"): cross-document $ref shape must be <LibraryName>#/schemas/<EntryName>: <the value as written> compactform at <consumer-document> (keyword "$ref"): cross-document $ref version separator is ’:’, not ’@’ — use <the corrected value>: <the value as written>

이들이 기록되는 조건은 compactform: $ref unresolvable입니다.

대상이 존재하지 않는 경우. 참조는 올바르게 읽히지만 라이브러리나 그 안의 항목이 없거나, 해석에 사용할 라이브러리 카탈로그가 아예 제공되지 않은 경우입니다.

compactform at <consumer-document> (keyword "$ref"): SchemaLibrary <library> not found in catalog (referenced from <consumer-document>): <the value as written> compactform at <consumer-document> (keyword "$ref"): entry <entry> not found in SchemaLibrary <library>: <the value as written> compactform at <path-inside-the-schema>:<line> (keyword "$ref"): cross-document $ref but no SchemaLibrary catalog supplied: <the value as written>

이들이 기록되는 조건은 compactform: cross-document $ref target not found입니다.

두 경우를 구분하기 때문에 보고에 따라 조치할 수 있습니다. 첫 번째는 지금 보고 있는 문서에서 다시 작성할 값이고, 두 번째는 빌드가 무엇을 볼 수 있는지에 관한 문제입니다. 자기 자신으로 확장되는 참조는 또 다른 세 번째 경우이며, 위의 “A library reference expands into itself (라이브러리 참조가 자기 자신으로 확장됨)”로 보고됩니다.

해결 방법: 읽을 수 없는 참조라면 값을 다시 작성합니다. 문서 간 참조는 <Library>#/schemas/<Entry>, 같은 문서 안의 참조는 #/$defs/<name>로 쓰고, 최소 버전 앞에는 @ 대신 :를 사용합니다. 대상이 없다면 항목 이름을 그것을 게시하는 라이브러리와 대조해 확인하고, 라이브러리가 Release의 의존성 폐포에서 도달 가능한지 확인합니다. 어떤 것도 의존성을 선언하지 않은 라이브러리는 로드되지 않으므로, 그 안을 가리키는 올바른 참조도 아무것으로도 해석되지 않습니다.

라이브러리가 아티팩트 캐시에만 있는 경우. 캐시에는 가져오기가 넣어 둔 것이 보관되며, 캐시된 라이브러리는 Release의 lockfile에 있는 항목이 그 다이제스트를 보증하는 경우에만 카탈로그 콘텐츠로 간주됩니다. 어떤 lockfile 항목도 고정하지 않고 어떤 카탈로그 디렉터리도 제공하지 않는 SchemaLibrary를 캐시가 보유하고 있으면, 보고서 뒤에 remediation: 줄이 이어지며 그러한 각 라이브러리와 그것을 보고한 명령에 맞는 조치를 알려 줍니다:

  • aggrega build와 aggrega validate --release는 Release의 lockfile을 읽으므로, 이들의 줄은 라이브러리를 해석하고 그 항목을 기록하는 aggrega pull --release <release>, 또는 카탈로그 디렉터리 아래에 라이브러리를 작성하는 방법을 안내합니다.
  • 인수 없는 aggrega validate, 그리고 --release 지정 여부와 관계없이 엔티티 경로를 준 aggrega validate는 카탈로그 디렉터리에서만 라이브러리를 읽고 lockfile은 읽지 않으므로, 기록된 항목이 있어도 판정은 바뀌지 않습니다. 이들의 줄은 그 사실을 알리고, 카탈로그 디렉터리 아래에 라이브러리를 작성하거나, aggrega pull --release <release>를 실행한 뒤 aggrega validate --release <release>를 실행하도록 안내합니다. 후자는 lockfile이 고정한 라이브러리를 기준으로 Release를 검사합니다.

그러한 라이브러리를 찾지 못한 pull은 A reference names no entity the catalog holds (참조가 카탈로그에 없는 엔티티를 가리킴) 항목 아래에서 별도의 줄과 함께 이를 보고합니다.

$ref:가 레지스트리 위치로 라이브러리를 지정함

문서 간 $ref:는 라이브러리를 식별자로 지정합니다. 즉 라이브러리의 이름만 쓰고 그 뒤에 #과 항목 경로를 붙이며, 라이브러리가 게시된 레지스트리로는 지정하지 않습니다. 이름이 어느 레지스트리를 통해 해석되는지는 워크스페이스 구성이 정하고 어느 버전을 사용할지는 lockfile이 정하므로, 호스트를 담은 참조는 빌드가 결정해야 할 두 가지를 스키마에 고정하게 되고, 스키마를 다른 워크스페이스로 옮기면 깨진 참조가 됩니다.

호스트가 포함된 값이 여전히 라이브러리와 항목으로 파싱되면, 문장은 대신 사용할 식별자 형식의 표기를 함께 알려 줍니다.

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity (use <Library>#/schemas/<Entry>): <the value as written> (문서 간 $ref에 레지스트리 호스트가 포함되어 있습니다. 라이브러리를 식별자로 참조하십시오)

그렇지 않으면 문장은 값 뒤에서 끝납니다.

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity: <the value as written> (문서 간 $ref에 레지스트리 호스트가 포함되어 있습니다. 라이브러리를 식별자로 참조하십시오)

이 오류가 기록되는 조건은 compactform: cross-document $ref carries a registry host; reference the library by identity이며, 짧은 코드는 이 조건으로 해석됩니다.

해결 방법: 호스트와 라이브러리 이름 앞의 모든 것을 제거하여 <Library>#/schemas/<Entry>만 남깁니다. 최소 버전이 필요하다면 라이브러리 이름 뒤에 :<version> 형식으로 작성합니다. Recipe와 FeatureRecipe의 $import: 필드에도 같은 규칙이 적용되며, 이는 아래의 “A library $import: addresses its library by registry location (라이브러리 $import:가 레지스트리 위치로 라이브러리를 지정함)”로 따로 보고됩니다.

A schema $import: cannot be applied (스키마 가져오기 지시문을 적용할 수 없음)

Component 또는 Feature의 spec.schema(블록 전체 또는 그 필러 하나)와 usesSchema 소켓의 valueSchema: 또는 infraSchema:는 각각 엔티티 옆의 파일을 지정하는 $import:로 작성할 수 있습니다. 가져오기는 엔티티가 로드될 때 적용되므로, 이후의 모든 판독기는 포인터가 아니라 가져온 계약을 보게 됩니다. 이 조건은 작성한 내용에 문제가 있을 때 발생합니다. 즉 지시문 자체에 문제가 있거나, 지시문이 지정한 파일의 내용이 잘못된 형태인 경우입니다.

이러한 결함이 하나의 조건인 이유는 각각이 같은 표면을 사용할 수 없게 만들고 해야 할 일도 같기 때문입니다. 지시문을 고치거나 지시문이 지정한 파일을 고치면 됩니다. 진단은 고정된 문장으로 시작한 뒤 어떤 결함인지 알려 주므로, 문장은 매칭할 부분이고 그 뒤의 절은 조치할 내용입니다.

a schema $import: could not be applied. <surface>: <the clause for this occurrence>

절은 읽은 표면(spec.schema, spec.schema.values와 같은 그 필러, 또는 소켓의 valueSchema)을 지정하고 그 뒤에 구체적인 결함을 적습니다. 결함과 각각의 의미는 다음과 같습니다.

  • $import: must be the only key when a schema is imported from a file. (파일에서 스키마를 가져올 때는 이 지시문이 유일한 키여야 함) 지시문이 작성된 스키마 내용과 같은 매핑에 함께 있습니다. $import:는 값 전체를 대체하므로, 형제 키는 결합할 대상이 없습니다.
  • $import: value must be a path to a file. (이 지시문의 값은 파일 경로여야 함) 값이 비어 있거나 단일 문자열이 아닙니다.
  • $import: takes a file path beside this entity, not a registry location <value>. (이 지시문은 레지스트리 위치가 아니라 이 엔터티 옆의 파일 경로를 받음) 값이 레지스트리를 가리킵니다. 이름이 어느 레지스트리를 통해 해석되는지는 워크스페이스 구성이 정하므로, 스키마 표면에는 레지스트리가 들어가지 않습니다. 메시지는 대신 사용할 참조 형식을 알려 줍니다.
  • $import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead. (이 지시문은 이 엔터티 옆의 파일 경로를 받으므로, 해당 SchemaLibrary 항목은 대신 참조 키워드로 참조해야 함) 값이 라이브러리 항목을 가리킵니다. 라이브러리 항목은 가져오는 것이 아니라 참조하는 것이며, 항목을 해석하는 키워드는 $ref:입니다.
  • imported schema <value> must be a YAML map of schema content; it is not. (가져온 스키마는 스키마 내용의 YAML 맵이어야 하지만 그렇지 않습니다.) 파일을 찾아 읽고 파싱했지만 그 결과가 스칼라나 시퀀스이므로 대체할 스키마 내용이 없습니다.

헤더에는 범주와 이 조건의 짧은 코드 E0266이 포함되며, 이 코드는 지속적 통합 게이트, 이슈, 런북 등에서 이 중단을 지속적으로 지칭해야 할 때 기록할 식별자입니다. 번호는 한 번 부여되면 고정되므로 주변 문구가 개선되어도 바뀌지 않으며, 모든 조건의 표에서 이를 찾을 수 있습니다.

형식은 올바르지만 빌드가 가져올 수 없는 파일을 지정하는 지시문은 다른 곳에서 다른 코드로 보고됩니다. 해석되지 않는 경로, 존재하지 않거나 읽을 수 없는 파일, YAML로 파싱되지 않는 바이트는 작성한 내용의 결함이 아니며(판단할 가져온 문서가 없으므로), 따라서 로드 오류로서 위의 “A file cannot be read, or its bytes do not parse (파일을 읽을 수 없거나 바이트가 파싱되지 않음)”로 보고되며, 그 항목에 각 경우가 담는 절이 설명되어 있습니다. 누락되었거나 읽을 수 없는 가져오기 파일을 잡으려는 경우에는 그 조건에 매칭하고 그 코드를 기록하십시오.

경로는 엔티티 파일이 있는 디렉터리를 기준으로 해석되며, 이는 가져오기를 지원하는 다른 모든 필드와 같은 기준입니다. 가져온 내용 자체가 $import:를 선언하면 이를 따라가며, 이미 처리 중인 파일로 되돌아가는 연쇄는 여기가 아니라 위의 “A library reference expands into itself (라이브러리 참조가 자기 자신으로 확장됨)”로 보고됩니다. 가져오기로 들여온 파일 안에 작성한 지시문은 그 파일과 그 안의 줄에서 보고되는데, 수정해야 할 곳이 바로 그곳이기 때문입니다. 엔티티에 작성한 지시문은 엔티티에서 보고됩니다.

해결 방법: $import:를 해당 매핑의 유일한 키로 만들고, 엔티티 옆에 있으며 최상위가 스키마 내용의 맵인 YAML 파일의 상대 경로를 지정합니다. SchemaLibrary가 게시하는 형태를 사용하려면 대신 $ref: <Library>#/schemas/<Entry>를 사용합니다. 라이브러리 항목은 가져오는 것이 아니라 참조하는 것입니다.

A schema block names a key that is not a data pillar (스키마 블록이 데이터 필러가 아닌 키를 지정함)

Component 또는 Feature의 spec.schema 블록은 엔티티의 데이터 필러를 담으며, 허용되는 키는 다음 세 가지뿐입니다. 개발자가 인스턴스마다 채우는 형태인 values, 운영자가 제공하는 물리적 크기인 infra, 그리고 엔티티가 이를 소비하는 쪽에 노출하는 키인 provides입니다. 이 조건은 블록의 최상위에 다른 키가 있을 때 발생합니다.

이 집합은 열려 있지 않고 닫혀 있으며, 이는 각 필러의 내용이 닫힌 방식으로 검증되는 것과 같은 이유입니다. 합법적인 표면을 열거하는 블록에서는 그 표면 밖의 모든 것이 오류가 됩니다. 아무것도 인식하지 않는 키는 어떤 것도 컴파일하거나, 검증에 사용하거나, 소비자에게 전달하지 않는 계약을 담게 되므로, 그 아래에 작성한 내용은 선언된 것처럼 보이지만 아무 효과가 없습니다. 이는 아예 작성하지 않은 계약보다 알아차리기 어려우며, 그래서 잘못된 키를 무시하는 대신 블록을 거부합니다.

진단은 고정된 문장으로 시작한 뒤 엔티티, 규칙, 키가 작성된 위치, 그리고 대신 작성할 내용을 알려 줍니다.

a schema block declares a key that names no data pillar (<Kind> <name>, rule schema-pillars, at .spec.schema.<key>). rename "<key>" to one of the pillar keys, or remove it and the contract beneath it; allowed: values, infra, provides. See vocabulary/data-pillars.md for the canonical pillar set.

헤더에는 범주와 이 조건의 짧은 코드 E0267이 포함되며, 이 코드는 지속적 통합 게이트, 이슈, 런북 등에서 이 중단을 지속적으로 지칭해야 할 때 기록할 식별자입니다. 번호는 한 번 부여되면 고정되므로 주변 문구가 개선되어도 바뀌지 않으며, 모든 조건의 표에서 이를 찾을 수 있습니다.

그 위치에 작성되는 두 가지는 이 집합의 키가 아니며, 어느 쪽도 여기서 보고되지 않습니다. 엔티티 옆의 파일을 지정하는 $import:는 블록을 읽기 전에 그 파일의 내용으로 대체되므로, 이 조건이 검사하는 것은 가져온 문서 자체의 최상위입니다. 가져온 파일 안의 잘못된 키는 여기서 보고되지만 지시문 자체는 보고되지 않습니다. 또한 extends를 선언하는 Component는 블록 대신 단순 문자열 inherited를 작성하며, 이는 키가 전혀 없는 스칼라입니다.

해결 방법: 문장은 만난 키와 허용되는 세 키를 알려 주므로, 가장 흔한 원인인 오타나 필러 이름이 복수형인데 단수형으로 쓴 경우는 진단만으로 알 수 있습니다. 잘못된 키 아래의 내용이 필러에 속한다면 소유 관계에 따라 values:, infra: 또는 provides: 아래로 옮깁니다. 어느 필러가 무엇을 소유하는지는 data-pillars.md에 나와 있습니다. 그 자체로 스키마 내용으로 의도한 것이라면 필러 옆이 아니라 한 단계 더 깊은 필러 안에 있어야 합니다. SchemaLibrary가 게시한 형태는 블록 수준이 아니라 필러 안에 작성한 $ref: <Library>#/schemas/<Entry>로 참조합니다.

A plugin asks the host to parse a source while a parse is already running for it (이미 파싱이 실행 중인 상태에서 플러그인이 호스트에 소스 파싱을 요청함)

플러그인은 호스트에 소스를 파싱하여 결과를 돌려 달라고 요청할 수 있습니다. 따라서 어떤 형식의 문서가 필요한 플러그인이 그 형식의 리더를 직접 갖출 필요가 없습니다. 호스트는 파싱 결과를 생성하는 플러그인을 실행하고 그 결과를 반환합니다. 이 조건은 그렇게 호출된 플러그인이 다시 자신의 파싱을 요청할 때 발생합니다. 그 요청은 이미 실행 중인 같은 메커니즘에 다시 진입하게 되므로, 호스트는 더 깊이 내려가지 않고 거부합니다. 이 메커니즘이 제공하는 것은 한 단계이며, 거부가 이를 한 단계로 제한합니다.

거부는 빌드가 아니라 플러그인에 전달됩니다. 호스트는 그 자리에서 멈추고 되돌아가지 않습니다. 아래 문장과 거부를 나타내는 코드를 담은 실패 엔벨로프로 호출에 응답하며, 요청한 플러그인은 이를 자신의 요청에 대한 응답으로 받습니다. 이후 빌드가 어떻게 되는지는 그 플러그인이 응답을 어떻게 처리하는지에 달려 있습니다. 이를 치명적으로 처리하는 플러그인은 빌드를 종료하고, 보고만 하고 계속 진행하는 플러그인은 그렇지 않습니다. 거부 자체는 어느 경우든 같습니다.

이는 특정 플러그인 한쪽의 잘못이 아닙니다. 이 보호 장치는 특정한 한 쌍이 아니라 요청이 거쳐 간 모든 플러그인 쌍에 적용되므로, 메커니즘에 다시 진입하는 곳이면 어디서든 같은 거부가 발생합니다.

플러그인이 받는 형태의 출력 메시지:

aggrega_parse_source: producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call (aggrega_parse_source: 생산자-소비 재진입 거부: 호스트를 통해 호출된 생산자는 추가 생산자-소비 호출을 할 수 없습니다)

해결 방법: 사용자 파일의 어떤 것도 이 문제를 일으키지 않으며 작성 내용을 바꿔도 해결되지 않습니다. 이는 빌드에 구성된 플러그인의 특성입니다. 파싱 도중에 파싱을 요청하는 플러그인을 수정해야 하므로, 메시지를 인용하여 해당 플러그인 배포자에게 이 조건을 보고하십시오. 그 플러그인이 직접 작성한 것이라면, 자신이 파싱을 처리하는 중에 호스트에 다른 소스의 파싱을 요청하지 말고 전달받은 소스를 직접 읽도록 하십시오.

The workspace configuration is invalid (워크스페이스 구성이 유효하지 않습니다)

워크스페이스는 루트에 있는 .aggrega-config.yaml로 기술됩니다. 이 파일은 어느 레지스트리에 게시하고 어느 레지스트리에서 가져오는지, 아티팩트 캐시가 어디에 있는지, 어떤 플러그인이 어느 소켓에 연결되는지, 각 레지스트리의 서명 방침이 무엇인지를 담습니다. 이후의 모든 것이 이 파일에서 읽히므로, 엔티티 파일을 하나라도 열기 전에 이 파일을 읽고 스키마에 대해 검사합니다.

파일이 없는 것은 실패가 아닙니다. 구성 파일이 없는 워크스페이스는 문서화된 기본값을 받으므로, 이 중단은 존재하지 않는 파일을 지목하는 일이 없습니다. 값을 담고 있던 파일을 지목하며, 환경 변수가 재정의하여 스키마가 보지 못하는 설정의 경우에는 그 변수를 지목합니다.

검사는 문서가 타입이 지정된 설정으로 변환되기 전에 실행됩니다. 이 순서 덕분에 메시지는 가리킬 필드 없이 더 뒤의 어딘가에서 타입 불일치를 보고하는 대신, 스키마가 거부한 필드 경로를 지목할 수 있습니다.

다음 형태는 단순한 스키마 거부를 넘어 여기에서 보고됩니다. 각각 스키마만으로는 조치하기에 너무 일반적인 내용만 말할 수 있기 때문입니다. 아래에 아무것도 없이 작성된 workspace: 키, 최상위 수준에 속하는 키를 workspace: 아래에 작성한 경우, 파일이 사용하지 않는 이름 아래에 작성된 cache: 블록, 레지스트리 호스트를 작성하는 방식으로 작성되지 않은 레지스트리 호스트, 그리고 스키마는 허용하지만 워크스페이스가 사용할 수 없는 값을 가진 세 설정, 즉 절대 경로이거나 워크스페이스 루트 자체를 지목하는 artifact_cache_dir, 게시 가능한 아티팩트 종류가 아닌 것을 지목하는 signing.kinds 항목, 그리고 uri가 oci://로 작성된 레지스트리 위치인 plugins.providers 또는 providers_append 항목입니다. 프로바이더 바인딩은 플러그인을 그 식별자, 즉 provider/<name>과 선택적인 :<version>으로 지정합니다. capability를 해석할 때 바인딩이 대조되는 것이 바로 이 식별자이기 때문입니다. 레지스트리 위치는 플러그인이 어디에 게시되었는지를 말할 뿐 그것이 어느 플러그인인지는 말하지 않으므로, 그렇게 작성된 항목은 결코 아무것도 선택할 수 없습니다. function:으로 진입 함수를 지정하고 uri:는 지정하지 않은 항목도, 그것이 plugins.linter 또는 linter_append 항목이거나 판정 역할(ir-verdict 또는 render-verdict)의 plugins.governance 또는 governance_append 항목이면 여기에서 보고됩니다. 이 연결들은 uri로 플러그인을 선택하므로, 그러한 항목은 아무 플러그인도 연결하지 않고 그것이 지정하는 함수는 결코 호출되지 않습니다. 린트는 그 항목이 없는 것처럼 계속 실행되고, 빌드는 나중에 그 항목이 지정한 적 없는 플러그인을 해석하는 시점에야 중단될 것입니다.

구성이 나열하는 카탈로그 디렉터리는 — workspace.catalog_dirs 또는 catalog_dirs_append 아래에 있든, workspace.releases 아래 Release 자체의 항목에 있든, 구성을 읽어 오는 어느 파일에 있든 — 디렉터리가 아닐 때에도 여기에서 보고됩니다. 즉 그 경로에 아무것도 없거나, 파일 또는 아무 곳도 가리키지 않는 링크가 그 자리에 있는 경우입니다. 이 판정은 카탈로그를 그 디렉터리를 통해 읽으려는 시점에 이루어지므로, 카탈로그를 읽는 모든 명령은 무엇이든 읽거나 쓰기 전에 이를 거부하며, 카탈로그를 읽지 않는 명령은 그대로 실행됩니다. 이를 무시하고 계속 읽으면 나열한 것보다 적은 카탈로그를 대상으로 빌드하게 되며, 어느 것이 빠졌는지 알려 주는 것이 없습니다. AGGREGA_CATALOG_DIRS가 나열하는 디렉터리에도 같은 규칙이 적용되며, 거부 메시지는 파일 대신 그 변수를 지목합니다.

레지스트리 호스트, 즉 registries 항목의 host, 또는 default_registry가 해당 항목 중 하나를 name:으로 지목하지 않을 때 시작하는 호스트(지목하는 경우에는 그 항목의 호스트를 나타냅니다)는 호스트 그 자체로 작성합니다. 소문자로, 점을 포함하거나, localhost이거나, 단일 이름 뒤에 포트가 오거나, IP 주소(IPv6는 대괄호 안에)이며, 각각 선택적 :port를 가질 수 있고 스킴이나 자격 증명은 없습니다. registries 항목의 호스트는 경로를 갖지 않습니다. default_registry는 호스트 뒤에 /와 저장소 경로를 붙일 수 있으며, 저장소 경로는 /로 이어진 소문자 세그먼트로, 태그, 다이제스트, 끝의 /가 없습니다. 다른 표기로 호스트를 지목하는 값은 작성해야 할 표기를 지목하며 거부됩니다(default_registry의 경우 경로를 포함한 전체 위치). 이는 해당 호스트 아래에 유지되는 신뢰 정책이 그 값에 적용되도록 하기 위함이며, HTTPS로 접근하는 호스트의 포트 443도 해당 호스트의 기본 포트이므로 여기에 포함됩니다. 저장소 경로가 아닌 경로는 그 앞의 호스트를 지목하며 거부되고, 항목의 name: 뒤에 경로가 오는 경우는 대신 작성할 두 표기, 즉 이름만 쓰거나 항목의 호스트 뒤에 경로를 쓰는 표기를 지목하며 거부됩니다. 이름은 그 항목의 호스트를 나타낼 뿐 그 아래의 위치를 나타내지 않기 때문입니다. 호스트를 전혀 지목하지 않는 값, 즉 어떤 항목도 갖지 않는 포트 없는 단일 이름이나 공백 또는 중괄호가 들어 있는 텍스트는 호스트가 아니라는 이유로 거부되며, default_registry의 경우 거부 메시지는 항목의 이름을 써도 된다고 알려 줍니다. AGGREGA_DEFAULT_REGISTRY도 같은 방식으로 읽히고 같은 방식으로 거부되며, 이때는 변수를 지목합니다.

출력되는 메시지. 스키마 거부는 파일, 필드 경로, 스키마가 말한 내용을 지목합니다:

workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid (워크스페이스 구성이 유효하지 않습니다)

수정 안내 형태는 파일로 시작하고, 필드 경로와 스키마 거부 대신 해당 형태에 관한 문장을 제시합니다. 워크스페이스 루트를 지목하는 artifact_cache_dir:

<path>: artifact_cache_dir "<value>" names the workspace root itself; a catalog directory at the workspace root would then be stepped over as cache, leaving nothing to load — give the cache its own subdirectory (for example .aggrega/cache): workspace configuration is invalid (artifact_cache_dir 값이 워크스페이스 루트 자체를 가리킵니다. 그러면 워크스페이스 루트의 카탈로그 디렉터리가 캐시로 간주되어 건너뛰어지고 로드할 것이 남지 않습니다. 캐시에 별도의 하위 디렉터리를 지정하십시오: 워크스페이스 구성이 유효하지 않습니다)

사용할 수 없는 signing.kinds 항목. 모든 종류를 포괄하는 와일드카드도 함께 지목합니다:

<path>: signing.kinds entry "<kind>" is not a signable artifact kind; use a catalog entity or plugin kind, or "all" for every kind: workspace configuration is invalid (signing.kinds 항목이 서명 가능한 아티팩트 종류가 아닙니다. 카탈로그 엔티티 또는 플러그인 종류를 사용하거나, 모든 종류에는 all을 사용하십시오: 워크스페이스 구성이 유효하지 않습니다)

레지스트리 위치로 작성된 프로바이더 바인딩으로, 항목과 capability, 작성해야 할 형식을 알려 줍니다:

<path>: plugins.providers[<n>] binds capability "<capability>" to "oci://<registry>/<repository>", which is where a plugin is published rather than which plugin it is; a provider binding names its plugin by its identity — write uri: provider/<name>, with an optional :<version>: workspace configuration is invalid (plugins.providers 항목이 capability를 레지스트리 위치에 바인딩합니다. 이는 플러그인이 게시된 위치일 뿐 어느 플러그인인지가 아닙니다. 프로바이더 바인딩은 플러그인을 그 식별자로 지정하므로 uri에 플러그인의 식별자를 선택적인 버전과 함께 작성하십시오: 워크스페이스 구성이 유효하지 않습니다)

진입 함수는 지정하고 플러그인은 지정하지 않은 린터 또는 판정 역할 거버넌스 연결로, 목록, 항목, 함수를 지목합니다. 여기서는 plugins.linter의 경우입니다:

<path>: plugins.linter[<n>] names the entry function "<function>" but no plugin uri; an attachment on this list selects its plugin by uri, so this one attaches no plugin and "<function>" is never called — add the uri of the plugin that exports it: workspace configuration is invalid (plugins.linter 항목이 진입 함수를 지정하지만 플러그인 URI가 없습니다. 이 목록의 연결은 URI로 플러그인을 선택하므로 이 항목은 아무 플러그인도 연결하지 않으며 그 함수는 결코 호출되지 않습니다. 그 함수를 내보내는 플러그인의 URI를 추가하십시오: 워크스페이스 구성이 유효하지 않습니다)

다른 표기로 작성된 레지스트리 호스트(여기서는 HUB.AGGREGA.AI):

<path>: default_registry "HUB.AGGREGA.AI" is not written as the registry host it names; write "hub.aggrega.ai" — lowercase, with no scheme, path, credentials or default port — which is the spelling that host’s trust policy is kept under: workspace configuration is invalid (default_registry 값이 가리키는 레지스트리 호스트의 표기로 작성되지 않았습니다. 스킴, 경로, 자격 증명, 기본 포트 없이 소문자로 작성하십시오. 이것이 해당 호스트의 신뢰 정책이 보관되는 표기입니다: 워크스페이스 구성이 유효하지 않습니다)

저장소 경로 앞의 호스트가 다른 표기로 작성된 기본 레지스트리(여기서는 GHCR.io/acme). 작성해야 할 전체 위치를 지목합니다:

<path>: default_registry "GHCR.io/acme" is not written as the registry location it names; write "ghcr.io/acme" — the registry host lowercase, with no scheme, credentials or default port, followed by the repository path — which keeps that host’s trust policy applying to it: workspace configuration is invalid (default_registry 값이 가리키는 레지스트리 위치의 표기로 작성되지 않았습니다. 스킴, 자격 증명, 기본 포트 없이 소문자로 쓴 레지스트리 호스트 뒤에 리포지토리 경로를 작성하십시오. 그래야 해당 호스트의 신뢰 정책이 계속 적용됩니다: 워크스페이스 구성이 유효하지 않습니다)

항목의 이름 뒤에 경로가 오는 경우(여기서는 local/acme이며, local이라는 항목은 127.0.0.1:5000을 위한 것입니다):

<path>: default_registry "local/acme" is the name of the registries entry "local" followed by a path, and an entry’s name stands for that entry’s host alone; write "local" to use the entry, or its host followed by the path, "127.0.0.1:5000/acme": workspace configuration is invalid (default_registry 값이 registries 항목의 이름 뒤에 경로가 붙은 형태이며, 항목의 이름은 그 항목의 호스트만을 나타냅니다. 항목을 사용하려면 이름만 쓰거나, 그 호스트 뒤에 경로를 붙여 작성하십시오: 워크스페이스 구성이 유효하지 않습니다)

호스트를 지목하지 않는 값. 이 문장은 호스트가 취하는 형태를 나열합니다:

<path>: registries[<n>].host "<value>" is not a registry host; write a lowercase host name containing a dot (registry.example.com), localhost, a single name followed by a port (registry:5000), or an IP address, an IPv6 one in brackets — each with an optional :port and nothing else: workspace configuration is invalid (registries 항목의 host 값이 레지스트리 호스트가 아닙니다. 점을 포함한 소문자 호스트 이름, localhost, 포트가 붙은 단일 이름, 또는 IP 주소(IPv6는 대괄호로 묶음)를 작성하십시오. 각각 선택적인 :port만 붙일 수 있으며 그 밖의 것은 붙일 수 없습니다: 워크스페이스 구성이 유효하지 않습니다)

아무것도 존재하지 않는 나열된 카탈로그 디렉터리로, 파일과 행, 목록, 작성된 그대로의 항목, 그리고 해석된 경로를 지목합니다. 목록은 workspace.catalog_dirs, workspace.catalog_dirs_append, 또는 `catalog_dirs` of the `workspace.releases` entry "release.yaml"와 같은 Release 항목의 목록입니다:

<path>:<line>: the `workspace.catalog_dirs` entry "<entry>" names <directory>, which does not exist; create that directory, or remove the entry: workspace configuration is invalid (이 항목이 지목하는 디렉터리가 존재하지 않습니다. 그 디렉터리를 만들거나 항목을 제거하십시오: 워크스페이스 구성이 유효하지 않습니다)

그리고 비어 있는 workspace: 표시:

workspaceconfig: <path>: workspace must be a mapping; write workspace: {} to mark a workspace root with no catalog directories: workspace configuration is invalid (workspace는 매핑이어야 합니다. 카탈로그 디렉터리가 없는 워크스페이스 루트를 표시하려면 빈 매핑을 작성하십시오: 워크스페이스 구성이 유효하지 않습니다)

두 가지는 잘못된 위치에 작성된 키를 지목합니다. default_registry, offline, auto_pull, artifact_cache_dir는 모두 workspace: 아래가 아니라 최상위 수준에 위치하며, 파싱 캐시의 블록은 parse_cache:입니다. 각 메시지는 어떤 키를 의미하는지와 그 키가 어디에 속하는지를 알려 줍니다.

해결 방법: 메시지가 지목하는 파일을 열고 메시지가 인용하는 필드 경로로 이동합니다. 메시지에 수정 안내 문장이 있으면 올바른 표기나 위치를 직접 지목하므로 더 읽을 필요가 없습니다. 대신 스키마 거부가 있으면 필드 경로가 문제의 키이고, 거부 내용은 스키마가 그 자리에 무엇을 원했는지를 말합니다. 엔티티 페이지는 이 파일을 다루지 않으므로 엔티티 계약을 찾기보다 거부 내용을 읽으십시오. artifact_cache_dir는 워크스페이스 루트를 기준으로 한 상대 경로로 작성하며, 워크스페이스 루트의 카탈로그 디렉터리가 캐시로 오인되어 건너뛰어지지 않도록 자체 하위 디렉터리가 필요합니다. 레지스트리 위치로 작성된 프로바이더 바인딩은 플러그인의 식별자로 직접 다시 작성합니다. oci://hub.aggrega.ai/plugin/provider/compose는 provider/compose가 됩니다. 그렇게 고치기 전까지는 aggrega plugin remove를 포함해 이 파일을 읽는 모든 명령이 이를 거부하기 때문입니다. aggrega plugin add provider는 식별자 형식을 스스로 작성합니다. 함수는 지정하고 플러그인은 지정하지 않은 린터 또는 판정 역할 거버넌스 항목에는 그 함수를 내보내는 플러그인의 uri를 추가합니다. 그런 플러그인이 없으면 항목을 제거합니다. 린터 목록에서는 그 후 린터가 구성되지 않았을 때처럼 표준 린터가 실행됩니다. 디렉터리가 아닌 나열된 카탈로그 디렉터리는 거부 메시지가 지목하는 경로에 만들거나, 거부 메시지가 지목하는 행에서 그 항목을 제거합니다. 나열된 형제 체크아웃 없이 가져온 프로젝트 사본에서는 그 항목을 제거합니다.

A plugin binding sets a key the socket it attaches to does not read (플러그인 바인딩이 연결된 소켓이 읽지 않는 키를 설정함)

워크스페이스 구성의 소켓은 두 가지 방식으로 플러그인을 연결하며, 한 방식에 속한 키는 다른 방식에서는 아무 의미가 없습니다. 키를 받아들이고 조용히 무시하는 대신 구성을 거부하므로, 운영자는 나중에 그 설정이 왜 효과가 없었는지 궁금해하는 대신 그 설정이 아무 작용도 하지 않는다는 것을 알게 됩니다.

두 가지 불일치는 서로 거울상입니다.

  • capability로 바인딩된 횡단 소켓. governance, linter, importer 소켓은 uri:로 플러그인을 직접 연결합니다. governance 또는 linter 플러그인은 어떤 capability도 제공하지 않으므로, 그곳의 capability: 바인딩은 아무것도 없는 대상에서 조회되어 아무것과도 일치하지 않습니다. 즉 결코 해석될 수 없는 연결입니다. importer는 자신이 처리하는 형식을 알리지만, 어떤 형식이 필요한지는 연결이 아니라 import가 정합니다. importer 연결은 uri:로 importer를 지정하며, import가 요청하는 형식을 알리는 importer들 중에서 그것을 선택하는 것이 바로 이 지정입니다.
  • 참조 대상이 없는 키를 설정한 프로바이더 소켓. 프로바이더 바인딩은 capability와 그것을 제공하는 플러그인을 지정하며, 플러그인은 선택 가능한 하나의 진입점이 아니라 고정된 export 집합을 구동하므로 function:은 그 위에서 아무것도 가리키지 않습니다. with:는 다른 이유로 거부됩니다. 프로바이더의 렌더 구성은 Recipe에 작성하므로, 이를 워크스페이스 바인딩에 두면 개발자와 운영자 분리의 잘못된 쪽에 놓이게 됩니다.

출력되는 메시지. 횡단 소켓의 capability:

workspaceconfig: the <socket> socket is bound by capability "<capability>", but the cross-cutting sockets attach by uri: their plugin serves no capability, so a capability lookup matches nothing; attach it with uri: instead: a cross-cutting socket is bound by capability but attaches by uri (해당 소켓이 capability로 바인딩되었지만 횡단 소켓은 uri로 연결됩니다. 이 소켓의 플러그인은 capability를 제공하지 않으므로 capability 조회는 아무것과도 일치하지 않습니다. 대신 uri로 연결하십시오: 횡단 소켓이 capability로 바인딩되었지만 uri로 연결됨)

프로바이더 바인딩의 효과 없는 function::

workspaceconfig: the provider socket binding for capability "<capability>" sets function:, but a provider drives a fixed set of phase-keyed exports rather than one selectable entry, so function: names nothing there; remove it: a provider socket binding sets a field with no referent on that socket (해당 capability의 provider 소켓 바인딩이 function 키를 설정하지만, provider는 선택 가능한 단일 진입점이 아니라 단계별로 키가 지정된 고정된 export 집합을 구동하므로 이 키는 그곳에서 아무것도 가리키지 않습니다. 제거하십시오: provider 소켓 바인딩이 해당 소켓에서 참조 대상이 없는 필드를 설정함)

그리고 효과 없는 with:는 같은 형태로 보고되며, 구성이 대신 있어야 할 위치를 지정합니다:

workspaceconfig: the provider socket binding for capability "<capability>" sets with:, but provider render configuration belongs in the Recipe, not the workspace provider binding; remove it: a provider socket binding sets a field with no referent on that socket (해당 capability의 provider 소켓 바인딩이 with 키를 설정하지만, provider 렌더링 구성은 워크스페이스 provider 바인딩이 아니라 Recipe에 속합니다. 제거하십시오: provider 소켓 바인딩이 해당 소켓에서 참조 대상이 없는 필드를 설정함)

.aggrega-config.yaml에 작성된 function:은 위의 문장에 도달하지 않습니다. 워크스페이스 구성의 스키마는 provider 바인딩에 그런 키를 선언하지 않으므로 파일이 먼저 E0224로 거부되며, 해결책은 같습니다. 키를 제거하십시오:

workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid (workspaceconfig: plugins.providers 항목의 function: /$defs/FixedEntryPluginRef에 대해 예상하지 못한 속성 “function”: 워크스페이스 구성이 유효하지 않습니다)

해결 방법: 수정은 .aggrega-config.yaml에서 하며, 각 메시지가 정확한 수정 내용을 지정합니다. governance, linter 또는 importer 연결에서는 capability:를 연결하려던 플러그인의 uri:로 바꾸십시오. 프로바이더 바인딩에서는 지정된 키를 제거하고, 그것이 with:였다면 그 구성을 해당 프로바이더를 통해 렌더링하는 Recipe로 옮기십시오. Recipe가 그 구성을 읽는 곳입니다.

A capability is bound to more than one provider plugin (capability가 둘 이상의 프로바이더 플러그인에 바인딩됨)

capability는 워크로드를 아티팩트로 바꾸는 한 가지 방식을 지정하며, 해석된 워크스페이스에서는 정확히 하나의 플러그인이 이를 제공합니다. 하나의 capability에 대한 바인딩이 두 개이면 둘 중 어느 것이 렌더링하는지에 대한 답이 없습니다. 또한 워크스페이스 구성은 공유 파일, 워크스페이스 파일, 그리고 각각이 기여할 수 있는 append 보조 파일 등 여러 계층으로 조립되므로, 두 번째 바인딩은 첫 번째를 볼 수 없었던 작성자의 계층에서 기여되는 경우가 많습니다.

이를 드러내는 것이 바로 이 거부입니다. 하나의 바인딩이 조용히 우선하게 두면, 렌더링된 출력이 어느 계층이 마지막에 읽혔는지에 따라 달라지게 됩니다.

capability와 규칙을 지정하는 출력 메시지:

workspaceconfig: capability "<capability>" is bound to more than one provider plugin; keep exactly one plugins.providers entry per capability: capability is bound to more than one provider plugin (해당 capability가 둘 이상의 provider 플러그인에 바인딩되었습니다. capability당 plugins.providers 항목을 정확히 하나만 유지하십시오: capability가 둘 이상의 provider 플러그인에 바인딩됨)

해결 방법: 메시지가 지정하는 capability에 대해 plugins.providers 항목을 하나만 남기고 다른 하나를 제거하십시오. 두 항목이 서로 다른 구성 계층에서 왔다면, 직접 관리하는 계층을 수정해야 합니다. 자신의 항목을 제거하면 공유 계층이 기여한 항목을 채택하게 되고, 자신의 항목을 유지하려면 공유 계층의 항목을 제거해야 합니다. 둘 다 실제로 워크스페이스에 필요한 두 플러그인은 서로 다른 두 capability를 제공하는 것이므로, 둘 다 원한다면 하나의 capability를 두 번 바인딩하는 대신 각각에 고유한 capability를 부여하십시오.

An importer is attached by more than one plugins.importer entry (하나의 임포터가 둘 이상의 항목으로 연결됨)

plugins.importer 항목은 자신의 uri가 지정하는 importer를 연결합니다. 그 importer가 import가 요청하는 형식을 알리는 경우, 항목은 그 importer의 어느 버전이 실행될지 정하고 항목의 with.sources와 with.settings를 전달합니다. 하나의 항목이 하나의 importer에 대해 이 일을 하므로, 같은 importer(같은 버전이든 다른 버전이든 같은 식별자)를 지정하는 두 번째 항목은 아무도 읽지 않으며, 그 with는 아무런 알림 없이 어떤 importer에도 전달되지 않습니다. 따라서 어떤 명령이 읽든 구성은 로드될 때 거부됩니다.

워크스페이스 구성은 전역 파일, 프로젝트 루트부터 명령이 실행되는 디렉터리까지의 각 .aggrega-config.yaml, 각각이 가질 수 있는 importer_append 보조 파일, 그리고 파이프라인의 .aggrega-config-append-ci.yaml 등 여러 파일로 조립되므로, 두 번째 항목은 첫 번째와 다른 파일에 작성되는 경우가 많습니다. 메시지는 importer와 두 항목을 지정하며, 앞선 항목을 먼저, 각각 작성된 키와 위치, 작성된 파일, 그리고 그곳에 작성된 그대로의 uri로 나타냅니다.

판정 대상은 importer 목록뿐입니다. governance와 linter 목록은 하나의 플러그인이 여러 번 연결되는 것을 허용하며, 각 연결은 자체 with를 가집니다. uri가 파일 시스템 경로인 항목은 importer를 지정하지 않으므로 비교되지 않습니다.

출력되는 메시지:

importer "<identity>" is attached by <key>[<position>] in <file> (uri "<uri>") and again by <key>[<position>] in <file> (uri "<uri>"); keep exactly one plugins.importer entry per importer, its uri naming the version you want: importer is attached by more than one plugins.importer entry (해당 임포터가 한 파일의 항목으로 연결되고 다른 항목으로 다시 연결되었습니다. 임포터당 plugins.importer 항목을 정확히 하나만 유지하고, 그 uri가 원하는 버전을 가리키도록 하십시오: 임포터가 둘 이상의 plugins.importer 항목으로 연결됨)

해결 방법: 메시지가 지정하는 importer에 대해 항목을 하나만 남기고(uri가 원하는 버전을 지정하고, 그 importer에 전달하려는 with를 가진 항목) 다른 하나를 제거하십시오. 두 항목이 서로 다른 파일에 있다면 직접 관리하는 파일을 수정해야 합니다. 자신의 항목을 제거하면 다른 파일의 항목을 채택하게 되고, 자신의 항목을 유지하려면 다른 파일의 항목을 제거해야 합니다.

A provider binding names a capability containing a colon (프로바이더 바인딩이 콜론을 포함한 capability를 지정함)

Recipe의 capability:는 마지막 콜론까지를 capability 이름으로, 그 뒤를 버전 고정으로 읽습니다. helm:1.0.0은 버전 1.0.0의 capability helm을 요청합니다. plugins.providers 항목은 그 이름으로 조회되므로 바인딩이 지정하는 capability에는 콜론이 들어가지 않으며, capability에 콜론이 들어간 항목은 어떤 Recipe도 도달할 수 없습니다. 구성에 읽히지 않은 채 남겨 두는 대신, 어떤 명령이 읽든 구성은 로드될 때 거부됩니다.

판정 대상은 프로바이더 목록뿐입니다. importer 목록도 같은 항목 형태를 공유하지만, 그 플러그인은 uri:로 연결되고 형식을 import:<format>으로 지정하며, 이때 콜론은 이름의 일부입니다. 바인딩의 uri:는 여전히 :<version>으로 끝날 수 있으며, 이 부분은 이 규칙이 읽는 부분이 아닙니다.

capability를 지정하는 출력 메시지:

the provider socket binding for capability "<capability>": a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so the capability a binding names carries no colon; bind the capability name alone and let each Recipe pin the version it needs: a provider socket binding names a capability containing a colon, which no Recipe can select (해당 capability의 provider 소켓 바인딩: Recipe의 capability 참조는 마지막 콜론까지의 capability와 그 뒤의 버전 고정으로 읽히므로, 바인딩이 지정하는 capability에는 콜론이 들어가지 않습니다. capability 이름만 바인딩하고 각 Recipe가 필요한 버전을 고정하게 하십시오: provider 소켓 바인딩이 콜론을 포함한 capability를 지정하며, 어떤 Recipe도 이를 선택할 수 없음)

해결 방법: 항목에는 capability 이름만 작성하고(capability: helm), 버전은 있어야 할 곳에서 고정하십시오. Recipe는 필요한 프로바이더 버전을 자신의 capability:에서 고정하며, 플러그인의 특정 버전을 선택해야 하는 바인딩은 이를 플러그인 식별자에 uri: provider/helm:1.0.0처럼 작성합니다.

A governance attachment declares no role, or one that is not a known role (거버넌스 연결이 역할을 선언하지 않았거나 알려지지 않은 역할을 선언함)

거버넌스 연결은 역할을 지니며, 연결이 어디에서 실행되고 무엇을 할 수 있는지를 정하는 것은 플러그인이 스스로 선언한 종류가 아니라 이 역할입니다. 즉 빌드를 수락하거나 거부하는지, 그래프를 읽는지 렌더링된 아티팩트를 읽는지가 역할로 정해집니다. 연결은 이 역할을 읽어 디스패치되므로, 역할이 없거나 아무도 인식하지 못하는 역할을 지닌 연결은 어디에도 연결되지 않고 아무 말 없이 건너뛰어집니다.

거부는 바로 이러한 침묵을 막습니다. 구성되었지만 한 번도 참조되지 않은 거버넌스 플러그인은 거버넌스를 전혀 거치지 않은 빌드와 똑같은 출력을 만들어 내며, 결과물 어디에도 지금 가진 것이 어느 쪽인지 알려 주는 정보가 없습니다.

출력되는 메시지는 둘 다 연결을 지목하고 존재하는 역할을 나열합니다. 역할이 없는 경우:

workspaceconfig: governance attachment "<uri>" declares no role; set role: to one of <the known roles>: a governance attachment declares no role or an unknown role (workspaceconfig: governance 연결이 역할을 선언하지 않습니다. 알려진 역할 중 하나로 role을 설정하십시오: governance 연결이 역할을 선언하지 않거나 알 수 없는 역할을 선언합니다)

인식할 수 없는 역할인 경우:

workspaceconfig: governance attachment "<uri>" declares unknown role "<role>"; use one of <the known roles>: a governance attachment declares no role or an unknown role (workspaceconfig: governance 연결이 알 수 없는 역할을 선언합니다. 알려진 역할 중 하나를 사용하십시오: governance 연결이 역할을 선언하지 않거나 알 수 없는 역할을 선언합니다)

해결 방법: plugins.governance 아래의 연결에서 role:을 메시지가 나열하는 역할 중 하나로 설정합니다. 어느 역할을 고를지는 플러그인 자체가 아니라 플러그인에게 무엇을 시키고 싶은지에 대한 결정입니다. 수락하거나 거부하는 역할은 빌드를 읽고 판정을 반환하며, 변환하는 역할은 플러그인이 전달받은 것을 변경하도록 허용하는 명시적인 지시입니다. 메시지가 전체 목록을 나열하므로 사용할 철자는 메시지 안에 있습니다.

A registry alias matches more than one host (레지스트리 별칭이 둘 이상의 호스트와 일치함)

워크스페이스 구성에서 레지스트리에 짧은 별칭을 부여하면 명령과 참조가 호스트를 전부 적지 않고도 레지스트리를 지정할 수 있습니다. 별칭은 정확히 하나의 호스트를 선택합니다. 이 조건은 어떤 토큰이 두 레지스트리 항목의 별칭과 일치할 때 보고됩니다. 어느 호스트를 의도했는지 답할 수 없으며, 하나를 고르면 작성자가 지정하지 않은 레지스트리로 아티팩트를 보내거나 그곳에서 가져오는 일이 아무 말 없이 일어나게 됩니다.

별칭, 그 별칭을 주장한 항목 수, 해당 호스트를 지목하는 출력 메시지:

registry alias "<alias>" matches <count> hosts (<hosts>); address the registry by host or remove the duplicate alias: registry alias matches more than one host (레지스트리 별칭이 여러 호스트와 일치합니다. 호스트로 레지스트리를 지정하거나 중복된 별칭을 제거하십시오: 레지스트리 별칭이 둘 이상의 호스트와 일치합니다)

해결 방법: .aggrega-config.yaml을 열어 메시지가 나열하는 호스트 중 하나에만 별칭을 부여하거나, 호스트로 레지스트리를 지정하고 참조에서 별칭을 뺍니다. 메시지가 별칭을 가진 모든 호스트를 지목하므로 살펴볼 항목은 메시지 안에 있습니다. 항목들이 서로 다른 구성 계층에서 온 경우에는 본인이 소유한 계층을 수정합니다.

The lockfile does not satisfy its schema (락파일이 스키마를 충족하지 않음)

release의 락파일은 빌드가 무엇으로 해석되었는지를 기록합니다. 빌드가 도달하는 모든 엔터티, 라이브러리, 플러그인에 대해 선택된 버전과 그 버전의 바이트 다이제스트를 기록합니다. 락파일은 타입이 지정된 고정값으로 변환되기 전에 읽혀 스키마에 대해 검사되므로, 맞지 않는 문서는 구멍 난 고정값을 아무 말 없이 만들어 내는 대신 실패한 필드 경로와 함께 거부됩니다.

락파일은 기계가 작성합니다. 락파일은 release를 해석하는 pull이 생성하며, 나중에 같은 빌드가 같은 방식으로 해석되도록 커밋됩니다. 따라서 스키마 실패는 의도적으로 작성된 것이라기보다 거의 항상 수동 편집, 문서를 절반만 해석된 상태로 남긴 병합, 또는 파일의 이전 형태에 맞춰 작성된 락파일(예를 들어 entities에 kind가 없는 락파일) 때문입니다.

락파일이 없는 것은 다른 조건이며 다르게 보고됩니다. 락파일은 필수이므로, 락파일이 없으면 빌드가 락파일을 찾는 지점에서 이를 생성하는 pull을 실행하라는 안내와 함께 보고됩니다.

파일, 필드 경로, 스키마 자체의 이의를 지목하는 출력 메시지:

lockfile: <path>: <field-path>: <the schema's own objection>: lockfile: file failed schema validation (lockfile: 파일이 스키마 검증에 실패했습니다)

빌드와 aggrega pull --verify는 락파일을 다시 작성하는 명령을 덧붙입니다:

…: lockfile: file failed schema validation; run aggrega pull --release <release> to write it again from the Release (lockfile: 파일이 스키마 검증에 실패했습니다. 이 명령을 실행해 Release에서 다시 작성하십시오)

완전히 비어 있는 문서는 지목할 필드가 없으므로 별도로 보고됩니다:

lockfile: <path>: document is empty (lockfile: 문서가 비어 있습니다)

해결 방법: 락파일을 수동으로 고치지 마십시오. release에 대해 pull을 다시 실행하면 수행한 해석 결과로 문서가 다시 작성되며, 그 결과를 커밋합니다. 다시 해석해야 고정값이 release가 실제로 도달하는 것과 일치하는 문서가 만들어집니다. 병합 후에 실패했다면 편집이 아니라 다시 pull하여 충돌을 해결해야 파싱은 되지만 잘못된 버전을 고정하는 문서를 피할 수 있습니다. 메시지의 필드 경로를 먼저 읽어 볼 만합니다. 손상이 한 항목에 있는지 문서의 전체 구조에 있는지 알려 줍니다.

카탈로그를 해석할 때

로드가 끝나면 컴파일러는 Manifest의 두 계층(type 맵, 그다음 name 맵)을 순회하여 모든 Component에 대한 Recipe를 고르고, Manifests, Components 또는 Features에 있는 모든 extends 체인을 순회합니다. Release 자체의 extends 체인도 같은 순회로 따라가되 한 단계 더 일찍 따라갑니다. 즉 Release를 해석하는 시점에, 그 Release가 지정하는 Manifest나 Aggregate를 찾기 전에 따라가므로, 아래 조건들은 체인이 제공하려던 형제 포인터가 아니라 Release를 기준으로 보고됩니다.

Cyclic extends chain (순환하는 extends 체인)

extends 포인터 체인이 자기 자신으로 되돌아옵니다. extends를 선언하는 모든 종류(Component, Feature, Manifest, Release)는 하나의 체인 순회로 처리되므로, 루프는 어디에서 발견되든 같은 문구로 보고됩니다.

출력되는 메시지. 조건을 명시하는 문장이 맨 앞에 오고, 그다음 해석이 시작된 엔터티와 이를 거부한 규칙, 그리고 루프를 닫는 간선, 즉 문제의 extends:를 가진 엔터티와 그것이 선언한 참조가 옵니다:

cyclic extends chain (<kind> <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (순환 extends 체인: 해당 엔터티가 확장하는 참조가 이미 체인 안에 있습니다. 해당 엔터티의 extends를 제거하거나 체인 밖의 엔터티를 가리키도록 하십시오)

처음 명시된 엔터티와 간선에 명시된 엔터티는 대개 다르며, 바로 그것이 요점입니다. 루프는 그 위의 모든 엔터티를 기준으로 보고되지만, 수정해야 할 extends: 줄은 간선이 지정하는 줄입니다. 제목이 아니라 간선을 따라가십시오.

Manifest의 경우 <kind>는 Manifest이고, 각 엔터티는 metadata.name으로 지정되며, <reference>는 작성된 그대로의 extends: 값입니다. 즉 ./base.yaml 같은 상대 경로이거나 Release 옆에 있는 Manifest의 순수한 metadata.name입니다. 두 형식 중 어느 것을 썼는지는 보고 내용을 바꾸지 않습니다. Manifest 링크는 해석되는 파일이므로, 우연히 같은 metadata.name을 선언한 두 Manifest 파일은 두 개의 링크이며, 둘을 거치는 체인은 루프가 아닙니다.

Release도 같은 방식으로 읽히며, 보호하는 형태가 흔한 것이므로 파일 동일성이 더 중요합니다. <kind>는 Release이고, <reference>는 extends:가 지정하는 상대 경로이며, Release 링크는 해석되는 파일입니다. 환경이 아니라 배포 시스템을 이름으로 하는 두 Release 파일, 즉 둘 다 metadata.name: shared-release이고 하나가 다른 하나를 확장하는 경우는 두 개의 링크이며, 둘을 거치는 체인은 루프가 아닙니다.

루프는 길이와 관계없이 루프로 보고됩니다. 체인 순회는 끝이 있는 체인에만 깊이 제한을 적용하므로, 제한보다 많은 엔터티에 걸친 순환도 지나치게 깊은 체인이 아니라 여기에서 보고됩니다. 루프의 해결책은 결코 루프를 줄이는 것이 아닙니다.

해결 방법: 간선이 지정하는 엔터티를 열고, 그 extends:를 제거하거나 아직 체인에 없는 엔터티를 가리키도록 하십시오. 여러 계층이 내용을 공유하려던 경우라면, 중복된 내용을 하나의 기본 엔터티로 합치면 루프와 중복이 함께 제거됩니다.

Recipe implements does not match the mapped component type (Recipe의 구현 선언이 매핑된 컴포넌트 타입과 일치하지 않음)

Manifest의 매핑 항목이 가리키는 Recipe의 spec.implements: 선언이 해당 매핑 항목의 component-type 키와 일치하지 않습니다. spec.implements는 디스패치 메커니즘이 아니라 일관성 기준점입니다. 매핑 값이 Recipe를 직접 지정하며, 이 검사는 작성자가 지정한 Recipe가 작성자가 매핑한 타입을 선언하는지 확인합니다.

이 검사는 어떤 Recipe도 해석되기 전에 합성된 Manifest를 읽으므로, 그 하위 증상이 아니라 작성자가 쓴 매핑 항목을 보고합니다.

출력되는 메시지:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (manifest mapping "<component-type>" -> "<recipe-uri>", recipe spec.implements is "<recipe-implements>", expected "<component-type>", or a type "<component-type>" extends) (Manifest 매핑 항목이 가리키는 레시피의 spec.implements가 매핑된 컴포넌트 타입 또는 피처 타입 키와 일치하지 않음)

Release의 의존성을 읽는 모든 명령이 이 검사를 수행하며, 다른 점은 각 명령이 결과로 무엇을 하는가입니다. aggrega build와 aggrega pull은 중단됩니다. 둘 다 이후에 사용할 결과물, 즉 렌더링된 아티팩트와 lockfile을 생성하기 때문입니다. aggrega validate와 aggrega lint는 찾아낸 다른 모든 진단과 함께 이 결과를 보고한 뒤 0이 아닌 코드로 종료합니다. 이 명령들의 역할은 워크스페이스의 잘못된 점을 모두 알려 주는 것이므로, 결함 하나로 보고가 중단되지 않습니다. 편집기에서는 이 결과가 다른 진단과 나란히 게시되며, 해당 문서가 보고할 다른 내용에는 영향이 없습니다. 표시 위치에 유의하십시오. 편집기는 이 결과를 Aggregate가 아니라 매핑이 작성된 Manifest에, 결과가 지목하는 매핑 항목의 키 위에 게시합니다. extends로 상속한 항목처럼 Manifest의 열린 텍스트에 그 항목이 작성되어 있지 않으면 Manifest의 첫 줄에 게시합니다. 워크스페이스의 어떤 문서도 지목하지 않는 Release의 다른 의존성 수준 결과는 Aggregate에 남습니다. aggrega validate를 실행하면 어떤 문서를 열어 두었든 보고됩니다.

카탈로그에 없는 Recipe를 지정하는 매핑 항목은 이 조건에 해당하지 않습니다. 검사는 비교할 대상이 없어 해당 항목을 건너뛰며, 해석할 수 없는 Recipe는 레시피를 해석할 때 보고됩니다.

FeatureRecipe 항목도 같은 형태를 따릅니다. features.type 매핑 검사는 manifest feature mapping ... featurerecipe spec.implements is ... (expected ...)를 출력하며, feature 쪽은 매핑 키 자체와 대조하므로 extends 대안을 언급하지 않습니다.

components.type 키는 다른 버전의 인스턴스에 도달할 때마다 인스턴스별로도 판정됩니다. 인스턴스의 정확한 타입을 지정하지 않는 키는, 그 정확한 타입을 지정하는 키가 없고 같은 베이스에 대해 작성된 다른 키도 없을 때 타입의 베이스를 통해 그 인스턴스에 도달합니다. 따라서 버전 없이 작성된 키나 다른 버전을 지정하는 키가 도달할 수 있습니다. 그러므로 항목만으로는 해당 Recipe가 맞는지 판단할 수 없으며, 빌드는 키가 이런 방식으로 도달하는 각 컴포넌트 인스턴스에 대해 Recipe를 다시 판정합니다. 이때 키 자리에는 빌드가 인스턴스를 컴파일하는 버전의 인스턴스 자체 타입이 들어갑니다. 즉 인스턴스가 지정하는 버전, 또는 버전을 지정하지 않는 인스턴스라면 카탈로그에 있는 해당 Component의 가장 높은 버전입니다. 인스턴스의 버전을 Recipe의 spec.implements:가 충족하지 않으면(정확히 일치, 캐럿 범위, 버전 없음, 또는 인스턴스 타입이 extends하는 베이스를 통한 경우 중 어느 것으로도) 이 조건이 발생하며, Manifest 파일이 아니라 인스턴스의 .spec.components.<instance> 경로에서 보고됩니다:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (Manifest, at .spec.components.<instance>, "<instance>", of type "<component-type>", compiled as "<component-type>:<version>", reached through manifest mapping key "<key>", mapped to recipe "<recipe-uri>", whose spec.implements is "<recipe-implements>"). map this type at this version to a recipe that implements it, with a mapping key naming the version (Manifest 매핑 항목이 가리키는 레시피의 spec.implements가 매핑된 컴포넌트 타입 또는 기능 타입 키와 일치하지 않습니다(Manifest, 이 인스턴스의 타입과 컴파일 버전, 도달한 매핑 키, 매핑된 레시피와 그 spec.implements). 이 버전의 이 타입을 그것을 구현하는 레시피에, 버전을 지정하는 매핑 키로 매핑하십시오)

compiled as 값은 타입이 버전을 지정하지 않는 인스턴스에만 나타납니다. 버전을 지정하는 인스턴스는 of type에 그 버전을 표시합니다. 인스턴스 자체의 버전을 지정하는 키는 항목에 대한 검사가 이미 판정했으므로 두 번째 판정이 필요하지 않으며, 키 때문에 이미 거부된 항목은 위와 같이 한 번만 보고되고 인스턴스마다 다시 보고되지 않습니다. aggrega build와 aggrega pull은 이로 인해 중단되며, aggrega validate --release는 이를 보고하고 0이 아닌 값으로 종료합니다. aggrega lint는 Manifest의 매핑 항목을 판정할 뿐 그 항목이 도달하는 인스턴스는 판정하지 않으므로 이를 보고하지 않습니다.

해결 방법: Recipe의 spec.implements: 선언을 Manifest의 component-type 키와 일치하도록 고치거나, Manifest 항목이 spec.implements:가 component-type 키와 일치하는 Recipe를 가리키도록 변경하십시오. 키가 다른 버전으로 도달하는 인스턴스의 경우, 인스턴스의 버전을 지정하는 매핑 키를 추가하여 그것을 구현하는 Recipe에 매핑하거나, 도달하는 키가 그런 Recipe를 가리키도록 하십시오.

Manifest mapping value is not a shape a recipe reference accepts (Manifest 매핑 값이 레시피 참조가 허용하는 형태가 아님)

Manifest 매핑 값이 참조 문법으로 표현할 수 없는 형태로 Recipe 또는 FeatureRecipe를 지정합니다. 레시피 참조는 순수한 이름, 버전이 붙은 이름, capability로 한정된 이름, 또는 버전이 붙은 capability 한정 이름을 허용하며, /는 최대 하나입니다. 그보다 많은 것을 담은 값(core/helm/eso-aws-fetcher:1.0.0 같은 component-type 형식의 경로)은 카탈로그에 무엇이 있든 결코 카탈로그 엔터티를 지정할 수 없습니다.

형태는 Manifest가 합성될 때, 무엇이든 조회하기 전에 판정됩니다. 판정은 문자열의 구분자 수를 세어 내려지므로 카탈로그가 전혀 필요하지 않습니다. 그 시점에 판정하기 때문에 진단이 정확해집니다. 값이 의도한 레시피는 실제로 존재하고 이름도 올바른 경우가 많은데, 그것이 없다고 안내받으면 엉뚱한 것을 찾게 됩니다. Release의 의존성을 해석하는 모든 명령이 이를 같은 방식으로 보고하므로, 어떤 명령을 실행하는지에 좌우되지 않습니다.

출력되는 메시지:

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries <n> slash-separated segments; a recipe reference accepts "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (Manifest 매핑 값의 레시피 참조 형식이 잘못됨: 매핑 값에 슬래시로 구분된 세그먼트가 허용 개수보다 많습니다. Manifest의 매핑 값을 수정하십시오)

features 섹션은 자체 좌표를 기준으로 같은 메시지를 출력하며, 피처 레시피 참조는 그렇게 명시됩니다.

capability 세그먼트에 버전 고정이 들어 있는 값(compose:1.2.3/svc:1.0.0)도 아무것도 조회하기 전에 같은 방식으로 거부되므로, 레지스트리에서 아무것도 가져오지 않습니다. 고정은 Recipe가 선언하는 capability에 작성하며, 그곳에서 해당 capability를 제공하는 플러그인의 어느 버전이 렌더링할지를 선택합니다. 참조는 Recipe를 버전 없는 capability로 지정합니다(compose/svc:1.0.0).

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries a version pin in its capability segment <segment>; a pin belongs on the capability the recipe declares, and a recipe reference names the recipe by its bare capability, as "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (Manifest 매핑 값의 레시피 참조 형식이 잘못되었습니다: 이 매핑 키의 값은 capability 세그먼트에 버전 고정을 담고 있습니다. 고정은 레시피가 선언하는 capability에 작성하며, 레시피 참조는 버전 없는 capability로 레시피를 지정합니다. Manifest의 매핑 값을 수정하십시오)

해결 방법: 매핑 값을 문법이 허용하는 형태로 줄이십시오. 레시피는 구현하는 component-type 경로가 아니라 자체 metadata.name으로 식별되며, 선택적으로 앞에 spec.capability를, 뒤에 버전을 붙입니다. 매핑의 키는 컴포넌트 타입이고, 매핑의 값은 레시피입니다.

카탈로그에 없는 레시피를 지정하는 올바른 형태의 값과 혼동하지 마십시오. 그것은 실제로 존재하지 않는 엔터티이며, 여전히 그렇게 보고되어 URI와 이를 참조한 매핑 항목을 명시합니다.

Several Recipes implement one Component type (여러 Recipes가 하나의 Component 타입을 구현함)

둘 이상의 Recipes가 spec.implements: 아래에 같은 Component 타입을 선언합니다. 한 타입에 대해 정확한 버전을 지정한 Recipes가 둘 있거나, 버전이 없는 Recipe가 버전이 고정된 Recipe와 함께 있는 경우입니다.

이 조건 자체로는 중단이 발생하지 않으며, 빌드가 해소해야 하는 모호성도 아닙니다. Recipe 선택은 매핑으로만 이루어집니다. spec.implements:를 읽어 후보 중에서 고르는 과정은 없으므로, 한 타입을 구현하는 Recipes가 몇 개이든 인스턴스를 렌더링하는 것은 Manifest가 그 인스턴스를 매핑한 Recipe입니다. spec.implements:는 일관성 기준점으로 읽히며, 작성자가 매핑한 Recipe가 매핑 대상 타입을 선언하는지 확인하는 데 쓰이고, 중단 메시지가 제안하는 고정 후보의 출처로도 쓰입니다. 선택에는 결코 관여하지 않습니다.

대신 마주치는 것은 Manifest가 아무것에도 매핑하지 않은 인스턴스에 대한 중단이며, 이 중단은 해당 타입을 구현하는 모든 Recipe를 나열하므로 그중 하나를 고정할 수 있습니다. 아래의 “No Recipe is mapped for a component or feature instance (컴포넌트 또는 피처 인스턴스에 매핑된 Recipe가 없음)”를 참조하십시오. 이 중단은 타입을 구현하는 Recipe가 하나이든 다섯이든 같은 방식으로 보고되므로, 별도로 찾아볼 모호성 조건이 없습니다.

해결 방법: 매핑을 추가합니다. 타입을 키로 하는 항목은 해당 타입의 모든 인스턴스를 라우팅하고, 이름을 키로 하는 항목은 이름이 지정된 인스턴스 하나를 라우팅하며 먼저 읽힙니다. 따라서 이름 키 항목은 한 인스턴스에 형제 인스턴스와 다른 Recipe를 지정하는 방법이기도 합니다.

Divergent Release (extends + aggregate pointer) (분기된 Release(extends + aggregate 포인터))

Release가 extends:를 사용해 기본 Release로부터 상속하면서 자체 aggregate: 포인터도 선언합니다. Release JSON Schema는 스키마 검증(Layer 1, 즉 엔벌로프 검사) 단계에서 allOf 제약을 통해 이 형태를 거부합니다. extends:가 있으면 aggregate:는 금지되고, extends:가 없으면 aggregate:와 manifest:가 모두 필수입니다.

이 조건은 일반적인 엔벌로프 위반으로 중단되므로, 진단은 해당 클래스의 형태를 따릅니다. error-translation.md의 “The document-envelope failure class”를 참조하십시오. 진단은 이 위치에서 허용되지 않는 키를 가리킵니다.

document envelope validation failed (Release, at <path>); <line>:<column>: spec.aggregate: value matches a shape that is not allowed here. correct the document to match its kind’s schema (문서 엔벨로프 검증에 실패했습니다. spec.aggregate: 값이 이 위치에서 허용되지 않는 형태와 일치합니다. 문서를 해당 kind의 스키마에 맞게 수정하십시오)

해결 방법: 자식 Release에서 aggregate: 필드를 제거합니다. 상속은 자식이 부모와 같은 Developer Intent를 배포하도록 의도적으로 강제합니다. 다른 Aggregate를 배포해야 한다면 extends: 없이 새 Release를 작성하십시오.

A feature attached by both the Aggregate and the Release cannot be merged (Aggregate와 Release 양쪽에서 연결된 기능을 병합할 수 없음)

로컬 Manifest가 기본 Manifest를 extends하면 두 계층(type: 맵, name: 맵)은 각각 독립적으로 병합됩니다. 각 계층 안에서 자식 키는 최상위 수준에서 부모 키를 덮어씁니다. 이는 깊은 병합이 아니라 얕은 대체입니다. 주어진 키에 대한 자식 항목은 그 키에 대한 부모 항목을 완전히 대체합니다.

같은 피처 인스턴스 이름이 Aggregate 측과 Release 측 모두에 나타나고 병합할 수 없는 상태가 충돌하면(허용되는 infra 계층화를 넘어서는 경우), 컴파일러는 중단하고 조정할 수 없었던 첨부 위치에 진단을 표시합니다. 충돌하는 두 선언은 고정된 순서로, 즉 Aggregate가 선언한 타입이 먼저, 이어서 Release가 선언한 타입이 표시되므로, 두 문서를 모두 열지 않아도 어느 문서가 무엇을 선언했는지 알 수 있습니다.

출력되는 메시지:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<aggregate-declared-type>", "<release-declared-type>") (기능 병합 충돌: 해당 기능에 대한 Aggregate 선언과 Release 선언을 일치시키십시오(Aggregate가 선언한 타입, Release가 선언한 타입))

연결이 가진 첨부에도 마찬가지입니다. 같은 연결에 대해 Aggregate의 연결 항목과 Release의 항목이 모두 한 슬롯 아래에 첨부를 작성하고 서로 다른 Features를 지정하면, 구성이 평탄화된 뒤 빌드는 두 번째 타입이 작성된 Release의 항목에서 중단하며, 두 타입과 슬롯, 연결, 소켓, 컴포넌트를 표시합니다.

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, the Aggregate names "<aggregate-declared-type>", the Release names "<release-declared-type>", for the slot "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Drop the type from the Release’s entry so it sizes the attachment the Aggregate declares, or name the same Feature in both documents. (feature 병합 충돌: 해당 feature에 대한 Aggregate 선언과 Release 선언을 일치시키십시오. Release의 항목에서 type을 제거하여 Aggregate가 선언한 attachment의 크기를 지정하게 하거나, 두 문서에서 같은 Feature를 지정하십시오.)

해결 방법: 두 선언을 조정합니다. 같은 피처 인스턴스에 대한 Aggregate 측 선언과 Release 측 선언은 필러별로 결합됩니다. Aggregate는 values를, Release는 infra를 제공합니다. 양쪽이 필러가 아닌 같은 필드(예: type:)를 지정하면 값이 일치해야 합니다. 한쪽을 다른 쪽에 맞게 수정하거나 중복된 선언을 제거하십시오.

Annotation binding does not resolve against its target Feature (어노테이션 바인딩이 대상 Feature에 대해 해석되지 않음)

Manifest 어노테이션 바인딩의 feature: 필드가 카탈로그에 로드되지 않은 Feature를 지정하거나, 바인딩의 maps.infra / maps.values 목록이 지정된 Feature의 spec.schema에 실제로 없는 점 표기 경로를 선언합니다. 두 조건 모두 워크스페이스 로드를 중단합니다. 그대로 두면 바인딩이 런타임에서 해석할 수 없는 경로로 값을 라우팅하는 Feature 첨부를 합성하게 되기 때문입니다.

하나의 조건이 바인딩 경로가 해석되지 않는 세 가지 경우를 다루며, 진단은 그중 어느 경우에 해당하는지 표시합니다.

  • Feature를 찾을 수 없음. feature: 값이 로드된 카탈로그에 없는 Feature URI를 참조합니다.
  • Feature 스키마가 해석되지 않음. 지정된 Feature는 로드되지만 그 spec.schema:가 JSON Schema 2020-12 표현으로 해석되지 않습니다. 내용이 잘못되었거나, 따라갈 수 없는 문서 간 참조를 지정하는 경우입니다. 이 변형은 해석 실패 자체의 진단을 뒤에 함께 담고 있으므로, 스키마가 해석되지 않은 이유를 같은 중단에서 읽을 수 있습니다.
  • 바인딩 경로가 대상 스키마에 없음. 바인딩의 maps.infra 또는 maps.values 항목이 Feature의 spec.schema.<pillar>.<path>가 선언하지 않은 점 표기 경로를 지정합니다.

출력되는 메시지(Feature를 찾을 수 없음 변형):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", which this build’s catalog does not hold; correct or publish the Feature named under "feature") (annotation 바인딩이 대상 Feature에 대해 해석되지 않습니다. 바인딩이 이 빌드의 카탈로그에 없는 Feature로 라우팅됩니다. feature 아래에 지정된 Feature를 수정하거나 게시하십시오)

출력되는 메시지(스키마가 해석되지 않음 변형):

annotation binding does not resolve against its target Feature (Manifest, annotation binding routes to Feature "<feature-uri>", whose declared schema does not resolve: <resolution failure>) (annotation 바인딩이 대상 Feature에 대해 해석되지 않습니다. 바인딩이 라우팅되는 Feature의 선언된 스키마가 해석되지 않습니다)

이 변형은 Feature와 해석 실패를 표시하지만, 바인딩 키나 소스 위치는 담지 않습니다. 결함이 바인딩이 이름만 지정하는 Feature 자체의 spec.schema:에 있기 때문입니다. 문제의 바인딩은 메시지가 인용하는 Feature URI로 mappings.features.annotations를 검색해 찾으십시오.

출력되는 메시지(경로를 찾을 수 없음 변형):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", at pillar "<pillar>", and path "<path>", which that Feature does not declare a property for under "schema") (annotation 바인딩이 대상 Feature에 대해 해석되지 않습니다. 바인딩이 라우팅되는 pillar와 경로에 대해 해당 Feature가 schema 아래에 속성을 선언하지 않습니다)

해결 방법: 바인딩의 feature: URI가 카탈로그에 존재하며 Recipe가 implements:하는 대소문자 구분 URI와 일치하는지 확인합니다. Feature 스키마가 실제로 선언하는 경로에서 경로를 찾을 수 없음 변형이 발생한다면, 점 표기 경로의 철자(대소문자 구분)와 필러 이름(infra 또는 values)을 확인하십시오.

A bound annotation value does not conform to the target Feature’s schema (바인딩된 어노테이션 값이 대상 Feature의 스키마를 따르지 않음)

작성한 어노테이션이 바인딩을 통해 대상 Feature의 경로로 값을 라우팅하는데, 그 값이 Feature가 해당 경로에 선언한 하위 스키마를 충족하지 않거나 Feature가 그 위치에 속성을 전혀 선언하지 않은 경우입니다. 이 조건은 바인딩이 아니라 값을 대상으로 판단하므로 위의 바인딩 대상 중단과 별개입니다. 앞의 중단은 Manifest가 선언하는 내용을 거부하고, 이 중단은 그것을 통해 작성된 내용을 거부합니다.

찾아낸 경로에서는 전체 검증을 하고, 경로를 찾을 수 없을 때만 소프트 스킵합니다. 바인딩된 하위 키의 하위 스키마를 찾으면, 값은 해당 경로의 완전한 JSON Schema 2020-12 제약 조건 집합(type, enum, pattern, 숫자 범위, 중첩된 object/array 형태)에 대해 검증됩니다. 말단의 $ref / allOf / oneOf는 건너뛰지 않고 스키마의 정의에 대해 해석한 뒤 검증합니다. 소프트 스킵 원칙은 탐색에만 적용됩니다. 탐색기가 바인딩된 리프에 도달하기 전 중간 세그먼트에서 탈출구($ref, patternProperties, oneOf/anyOf/allOf, 또는 스키마 본문을 가진 additionalProperties)를 만나면 경로를 정적으로 해석할 수 없으므로, 검증기는 잘못된 중단의 위험을 감수하는 대신 오류를 발생시키지 않고 계속 진행합니다. 해당 바인딩의 검증은 런타임이 계속 담당합니다.

출력되는 메시지(값 적합성 변형):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> value <value> does not conform to Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure> (annotation 하위 키가 라우팅된 pillar에서 대상 Feature의 스키마를 따르지 않습니다: annotation 하위 키의 값이 Feature의 spec.schema에 맞지 않습니다)

출력되는 메시지(선언되지 않은 하위 키 변형):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> is not declared at Feature <feature-uri> spec.schema.<pillar>.<subkey> (annotation 하위 키가 라우팅된 pillar에서 대상 Feature의 스키마를 따르지 않습니다: annotation 하위 키가 Feature의 spec.schema에 선언되어 있지 않습니다)

이 중단은 Feature 연결로 확장되기 전, 작성된 그대로의 어노테이션에 대해 발생하므로, 진단은 값이 작성된 문서와 범위(Release 측 어노테이션이면 boundary와 component, Aggregate 측 어노테이션이면 component 경로), 그리고 값의 출처인 어노테이션 키를 지정합니다.

거버넌스 플러그인이 주입한 어노테이션도 같은 방식으로 판정되며, 진단은 누가 작성했는지 알려 줍니다. 어노테이션을 주입하도록 연결된 플러그인은 Release 컴포넌트에 값을 설정하므로, 그 값은 운영자가 그곳에 작성한 값과 똑같이 검사됩니다. 하지만 진단이 가리키는 Release 줄은 아무도 작성하지 않은 것입니다. 따라서 진단은 어느 플러그인이 값을 주입했는지와 그 플러그인이 연결된 거버넌스 역할을 덧붙이며, 수정은 Release가 아니라 그 플러그인의 결정에서 해야 합니다.

해결 방법: 바인딩된 값을 선언된 하위 스키마를 충족하도록 수정하거나, 값이 정당하다면 해당 속성의 스키마를 넓힙니다. 선언되지 않은 하위 키 변형은 보통 위의 바인딩 대상 중단이 먼저 잡아냅니다. 이 변형에 도달했다면 바인딩은 경로를 선언하지만 Feature의 스키마에는 그 경로가 없다는 뜻이므로, 둘 중 잘못된 쪽을 수정합니다. 중간의 합성 연산자 때문에 경로를 해석할 수 없고 나중에 런타임이 거부하는 경우에는, 스키마를 좁혀 바인딩의 경로에서 속성이 직접 드러나도록 합니다.

An annotation subkey is not routed by its binding (어노테이션 하위 키가 해당 바인딩으로 라우팅되지 않음)

작성한 어노테이션이 Manifest 어노테이션 바인딩이 소유하는 키 아래에 하위 키를 가지고 있는데, 그중 하나가 바인딩이 라우팅하지 않는 이름입니다. 즉 maps.infra에도 maps.values에도 나열되어 있지 않습니다. 각 하위 키는 바인딩이 그 키에 대해 선언한 Feature 경로로 개별적으로 라우팅되므로, 바인딩이 지정하지 않은 하위 키는 갈 곳이 없습니다. 그 하위 키 없이 어노테이션을 확장하면 작성한 값이 아무 안내 없이 빌드에서 빠지게 되며, 흔한 원인은 하위 키의 철자 오류입니다. 그래서 빌드는 대신 중단하고, 해당 하위 키, 그것이 작성된 어노테이션 키, 그리고 바인딩이 실제로 라우팅하는 모든 하위 키를 지정합니다.

이 중단은 옆의 두 조건과 마찬가지로 Feature 연결로 확장되기 전, 작성된 그대로의 어노테이션에 대해 발생합니다. 위의 “A bound annotation value does not conform to the target Feature’s schema (바인딩된 어노테이션 값이 대상 Feature의 스키마를 따르지 않음)”는 Feature가 값을 거부할 때 바인딩이 라우팅하는 하위 키를 거부하고, 아래의 “An annotation routes through a pillar its authoring side may not use (어노테이션이 작성 측에서 사용할 수 없는 필러를 통해 라우팅됨)”는 잘못된 필러를 통해 라우팅되는 하위 키를 거부합니다. 어떤 바인딩도 소유하지 않는 키는 이 조건에 해당하지 않습니다. 아무것도 그 키를 라우팅하지 않으며 빌드는 이를 건너뜁니다.

문서와 어노테이션이 작성된 위치, 하위 키, 어노테이션 키, 바인딩이 라우팅하는 하위 키를 지정하는 출력 메시지:

annotation subkey is not routed by the annotation’s binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<subkey>", written under annotation "<key>", whose binding routes only "<subkey>, <subkey>") (어노테이션 하위 키가 해당 어노테이션의 바인딩으로 라우팅되지 않습니다(Release, 이 하위 키는 이 어노테이션 아래에 작성되었지만 그 바인딩은 나열된 하위 키만 라우팅함))

Aggregate에 작성된 어노테이션도 같은 방식으로, 그곳에서 작성된 위치로 지정됩니다. 하위 시스템에 작성된 경우 (Aggregate <name>, at .spec.subsystems.<subsystem>.annotations, …)입니다. 빌드는 이를 작성한 문서에 따라 Release 측 어노테이션은 OPS_ERROR 태그로, Aggregate 측 어노테이션은 DEVELOPER_ERROR 태그로 보고합니다.

해결 방법: 하위 키를 메시지에 나열된 하위 키와 비교합니다. 철자 오류라면 바인딩이 라우팅하는 하위 키로 수정합니다. 값이 Feature에 도달해야 한다면 바인딩이 그 값을 라우팅해야 합니다. Manifest에서 바인딩의 maps.infra 또는 maps.values에 경로(Feature의 스키마가 선언하는 경로)를 추가하거나, 어노테이션에서 하위 키를 제거하십시오.

A bare annotation value does not route to exactly one path of its binding (단독 값으로 쓴 어노테이션이 바인딩의 정확히 한 경로로 라우팅되지 않음)

단독 값으로 작성한 어노테이션, 즉 하위 키의 맵이 아니라 feature.aggrega.ai/monitoring: "30s"처럼 쓴 어노테이션은 하위 키를 지정하지 않으므로, 어느 Feature 경로를 채우는지 알려 주는 내용이 없습니다. 이 값은 maps.infra와 maps.values를 함께 세어, 바인딩이 선언하는 유일한 경로에 배치됩니다. 둘 이상의 경로를 선언하는 바인딩은 값이 갈 곳을 여러 개 남기면서 그중 하나를 고를 근거는 남기지 않으므로, 빌드는 하나를 고르는 대신 중단됩니다. 개수는 두 목록을 합쳐 세므로, 한 경로는 infra를 통해, 다른 경로는 values를 통해 라우팅하는 바인딩은 단독 값이 어느 문서에 작성되었든 이를 거부합니다.

이 중단은 옆의 조건들과 마찬가지로, 어노테이션이 Feature 첨부로 확장되기 전에 작성된 그대로의 어노테이션에 대해 발생하므로, 진단은 값이 작성된 문서와 위치를 지목합니다. 이 검사는 작성한 어노테이션마다 한 번 수행됩니다. 경계나 하위 시스템에 작성한 값은 그 안의 컴포넌트가 그 값을 받아들이는지와 관계없이 그곳에서 한 번 거부됩니다. 빌드 안의 그러한 값은 첫 번째 것만이 아니라 모두 보고됩니다. 빌드는 어노테이션을 작성한 문서에 따라 Release 측 어노테이션은 OPS_ERROR 태그로, Aggregate 측 어노테이션은 DEVELOPER_ERROR 태그로 보고합니다. 이 조건은 a scalar annotation value does not route to exactly one path of its binding이며, 이는 aggrega explain이 해당 코드에 대해 출력하는 내용입니다.

출력되는 메시지이며, 어노테이션이 작성된 문서와 위치, 어노테이션 키, 값, 바인딩이 라우팅하는 경로를 지목합니다:

a scalar annotation value does not route to exactly one path of its binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<key>", carrying the bare value "<value>", whose binding routes "<path>, <path>, <path>") (스칼라 어노테이션 값이 바인딩의 정확히 한 경로로 라우팅되지 않음: Release의 이 어노테이션은 단독 값을 담고 있으며, 그 바인딩은 나열된 경로를 라우팅함)

빈 값은 아무것도 쓰지 않으므로, 두 목록 중 하나가 단일 경로를 가지면 그 경로에 배치되며, 두 목록 모두 그렇지 않을 때만 거부됩니다. 경로를 전혀 선언하지 않는 바인딩은 Manifest 스키마가 경로를 요구하므로 Manifest를 로드할 때 거부되며, 따라서 빌드가 그런 방식으로 이 조건에 도달하지는 않습니다.

거버넌스 플러그인이 주입한 어노테이션도 같은 방식으로 판정되며, 옆의 조건들과 마찬가지로 그 진단에는 값을 주입한 플러그인과 그 플러그인이 연결된 거버넌스 역할이 추가됩니다.

해결 방법: 어노테이션을 각 값이 어느 하위 키를 위한 것인지 지정하는 맵으로 작성하여(feature.aggrega.ai/monitoring: {interval: 30s}) 각 값이 자신의 이름으로 라우팅되게 하거나, 단일 값에 다른 어노테이션 키 아래에서 그 값이 채우는 경로만 선언하는 고유한 바인딩을 부여하십시오.

An annotation routes through a pillar its authoring side may not use (어노테이션이 작성 측에서 사용할 수 없는 필러를 통해 라우팅됨)

어노테이션은 작성 측에 따라 나뉘며, 이 구분은 작성되는 다른 모든 필러를 규정하는 구분과 같습니다. Aggregate 측 어노테이션은 values를 대상으로 하는 바인딩 경로로만, Release 측 어노테이션은 infra를 대상으로 하는 경로로만 라우팅할 수 있습니다. 그 밖의 조합은 중단됩니다.

이 구분은 어노테이션 단축 표기가 상대 측의 필러를 작성하는 수단이 되는 것을 막습니다. 개발자의 어노테이션은 values를, 운영자의 어노테이션은 infra 사이징을 제공합니다. 두 필러 모두에 경로를 선언하는 바인딩 자체는 오류가 아닙니다. 각 측은 허용된 부분만 라우팅하며, 상대 측의 경로에는 단순히 도달할 수 없습니다.

하나의 경로를 두 필러 목록 모두에 선언한 바인딩이 이 중단에 가장 자주 이르는 경우입니다. 라우팅 동률 처리는 그런 경로를 infra로 보내므로 Aggregate 측에서는 도달할 수 없게 되고, 그 경로로 라우팅하는 Aggregate 측 어노테이션은 여기서 중단됩니다. 빌드가 이 중단에 이르기 전에 그런 바인딩 형태를 알려 주는 권고는 warnings.md에 설명되어 있습니다.

출력되는 메시지:

annotation routes through a pillar its authoring side may not use: annotation <key> at <source> routes through pillar <pillar> at path <path>, but <side>-side annotations may only route through pillar <permitted-pillar> (annotation이 작성 측에서 사용할 수 없는 pillar를 통해 라우팅됩니다: 해당 경로의 annotation이 이 pillar를 통해 라우팅되지만, 이 측의 annotation은 허용된 pillar를 통해서만 라우팅할 수 있습니다)

거버넌스 플러그인이 주입한 어노테이션은 Release 컴포넌트에 있으므로 Release 측 어노테이션이며, 같은 구분이 적용됩니다. 그 진단은 어느 플러그인이 주입했는지와 그 플러그인이 연결된 거버넌스 역할을 덧붙입니다. 진단이 가리키는 Release 키는 아무도 작성하지 않은 것이기 때문입니다.

해결 방법: 바인딩이 대상으로 하는 필러를 가진 측에서 어노테이션을 라우팅하거나, 작성 측에 허용된 필러를 경로의 대상으로 하는 바인딩을 별도의 어노테이션 키 아래에 추가합니다. 하나의 바인딩이 같은 경로를 두 필러 목록 모두에 선언한 경우에는 이를 두 바인딩으로 나누어 각 측이 도달할 수 있는 경로를 갖도록 합니다. 진단이 주입한 플러그인을 지정하는 경우, 어노테이션은 그 플러그인의 결정에서 나온 것입니다. 플러그인을 수정하거나, 플러그인이 주입할 때 사용하는 바인딩을 수정하십시오.

Authored values or infra do not conform to the declared schema (작성된 values 또는 infra가 선언된 스키마를 따르지 않음)

컴포넌트 인스턴스 또는 연결된 Feature의 해석된 values:나 infra:가 선언된 카탈로그 스키마를 따르지 않는 경우입니다. 빌드는 렌더링 전에 각 필러를 선언된 스키마에 대해 검증하므로, 오타가 난 키, 타입이 잘못된 값, 범위를 벗어난 숫자, 누락된 필수 필드는 배포 시점에 깨진 매니페스트를 만들어 내는 대신 그 출처에서 잡힙니다.

이 검사는 표준 스키마 제약 조건을 다룹니다. 잘못된 타입의 값(스키마가 정수를 선언한 곳의 문자열), 선언된 범위나 enum을 벗어난 값, 선언된 pattern을 만족하지 않는 값, 선언된 format(명명된 형식 중 하나)의 유효한 인스턴스가 아닌 문자열, 그리고 제공되지 않은 필수 필드입니다. 형식 실패는 키워드를 명시하고 값, 형식, 그리고 무엇이 잘못되었는지를 담습니다. aggrega pull과 aggrega validate --release는 ::::이 주어진 uri 필드에 대해 "format", "value \"::::\" is not a valid uri: a URI begins with a scheme followed by a colon, such as https:"와 같이 출력합니다. 이 검사는 기본값을 인식합니다. 스키마가 default:를 지정한 필드는 생략되어도 제공된 것으로 간주되므로, 기본값이 있는 필수 필드는 “누락” 검사에 걸리지 않습니다.

values 필러는 개발자의 작성 영역입니다. 이 필러는 닫힌 방식으로 검증되며, 스키마가 선언하지 않은 속성은 오타일 가능성이 높은 것으로 보고 거부됩니다. 자체 문서 안에서 합성하는 values 스키마(로컬 #/$defs $ref 또는 allOf)는 해석된 뒤 그 정의 맥락에 대해 검증됩니다.

infra 필러는 운영자의 사이징 영역이며, Component가 schema.infra 필러를 선언한 경우에만 검사됩니다. 그 선언이 컴포넌트가 선택하는 계약입니다. values 필러가 schema.values에 대해 검증되는 것과 똑같이, infra 필러는 그 선언에 대해서만 닫힌 방식으로 검증됩니다. Component가 선언하지 않은 키는 오타로 거부되고, 선언한 키는 타입과 범위가 적용됩니다. replicas와 같이 provider가 덧붙이는 키를 검증받으려는 컴포넌트는 그 키를 자신의 schema.infra에 선언합니다. provider가 받아들이는 어휘는 작성된 infra 영역에 덧붙여지는 것이 아니라 해당 Recipe의 valuesMapping을 통해 도달합니다.

이 검사는 Release가 배치한 모든 컴포넌트의 사이징을 측정하며, infra: 블록을 전혀 작성하지 않은 항목도 측정합니다. 블록이 없으면 빈 블록으로 간주되므로 default:가 없는 required: 키는 누락으로 보고되며, 이는 그런 키가 잡아내려고 존재하는 경우입니다. 컴포넌트를 배치하는 두 가지 방식 모두 해당됩니다. boundary의 components 아래에 이름을 적어도 배치되고, 컴포넌트를 제공하는 하위 모듈을 aggregates 아래로 라우팅해도 배치됩니다. 라우팅 항목은 개별 컴포넌트에 대해 아무것도 말하지 않고 컴포넌트를 배치하므로, 그렇게 배치된 컴포넌트는 빈 사이징 블록에서 시작하며 해당 타입의 기본값 없는 required: 키는 누락으로 보고됩니다. Release가 어느 방식으로도 배치하지 않은 컴포넌트는 이 계약에 대해 전혀 측정되지 않습니다. 그런 컴포넌트에는 다른 결함이 있으며, 빌드는 대신 그 결함, 즉 어떤 boundary에도 배치되지 않은 컴포넌트를 두 가지 배치 방식과 함께 보고합니다.

이 계약은 컴포넌트가 어디에서 작성되었든 적용됩니다. 하위 모듈이 제공하는 컴포넌트는 Release 자체의 Aggregate가 선언하는 컴포넌트와 똑같이 측정됩니다. 컴포넌트가 얼마나 깊이 중첩되어 있는지는 해당 타입의 어떤 제약 조건이 적용되는지에 영향을 주지 않습니다.

Feature 첨부도 같은 방식으로, 첨부된 Feature가 선언한 schema.values / schema.infra에 대해 검증됩니다. 첨부는 하나의 표면을 공유하므로, 자격 증명 Feature(feature.aggrega.ai/kind: secret 레이블이 붙은 것)도 다른 첨부와 정확히 같은 방식으로 자신이 선언한 스키마에 대해 측정됩니다. 검사되는 값은 첨부 값이 스코프(component, subsystem, boundary, component별)를 따라 계단식으로 적용된 뒤의 유효 병합 결과입니다. 따라서 한 스코프에서 적법하게 도입되었지만 더 구체적인 스코프에서 부적법한 값으로 재정의된 값은 조각이 아니라 병합 결과에서 포착됩니다. 타입이 스키마를 선언하지 않은 첨부는 검증되지 않습니다. 첨부의 infra는 첨부 자신의 schema.infra에 대해 검증됩니다(첨부는 오버레이이며 provider 합집합을 지니지 않습니다).

첨부의 검사 결과는 실패한 pillar를 작성한 문서에서 보고되며, 그 문서의 이름 아래에서 그 작성자에게 귀속됩니다. 첨부의 values는 그것을 작성한 Aggregate 블록, 즉 컴포넌트 자신의 features: 항목인 .spec.components.<component>.features.<attachment>.values.<field>에서 보고되며(해당 컴포넌트에 도달하는 subsystem 블록보다 우선합니다), 개발자 오류로 처리됩니다. 첨부의 infra는 그것을 작성한 Release 블록, 즉 해당 컴포넌트를 명시한 boundary 아래의 Release 컴포넌트 항목에서 보고되며(boundary 자신의 features: 블록보다 우선합니다), 운영자 오류로 처리됩니다. 그 pillar를 소유한 문서가 작성하지 않은 pillar는 첨부 자체가 작성된 곳, 즉 type이 명시된 곳에서 보고됩니다. 따라서 Release만 만드는 첨부는 values를 지니지 않으므로, 그 Feature의 values가 요구하는 필드를 Release의 항목에서 운영자 오류로 보고하며, 그 경로는 Release가 보유한 경로(컴포넌트의 항목, 또는 boundary가 그 아래 모든 컴포넌트에 대해 만드는 첨부의 경우 boundary의 features: 블록)입니다:

[OPS_ERROR E0168] .spec.boundaries.main.components.app.features.check.values.schema
authored pillar does not conform to its declared schema (Release probe, at .spec.boundaries.main.components.app.features.check.values.schema, values pillar does not conform to the Feature schema: missing required property: schema (required))

같은 첨부를 Aggregate에서 컴포넌트에 작성하면 Aggregate의 이름 아래에서 .spec.components.app.features.check.values.schema에 [DEVELOPER_ERROR E0168]을 보고합니다. 편집기는 각 결과를 그것을 작성한 문서에서, 그 문서가 보유한 해당 경로의 가장 깊은 키에 표시합니다.

연결이 지니는 첨부도 같은 방식으로 측정되며, 그것을 보유하지 않는 컴포넌트 자신의 features: 블록이 아니라 실패한 pillar를 작성한 문서의 연결 항목에서 보고됩니다. 그 values는 Aggregate의 연결 항목인 .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>에서 보고되고(sub-module이 기여한 컴포넌트라면 sub-module 자신의 문서에서), 그 infra는 해당 연결에 대한 Release의 항목에서 보고되며, Release가 boundary를 명시하는 경우 해당 컴포넌트를 명시한 boundary 아래에서 보고됩니다. Release만 만드는 첨부는 두 pillar 모두 Release의 항목에서 보고됩니다. 그런 첨부는 values를 지니지 않으므로, values가 필드를 요구하는 Feature는 운영자가 작성한 그 항목에서 해당 필드가 누락되었다고 보고합니다.

엣지별 연결 구성도 같은 방식으로 소켓의 엣지별 계약에 대해 검증됩니다. 엣지의 개발자 작성 values는 소켓의 valueSchema에 대해, 엣지의 운영자 작성 infra(Release에서 작성)는 소켓의 infraSchema에 대해 검증됩니다. 어떤 pillar에 대해 엣지별 스키마를 선언하지 않은 소켓은 그 pillar에 대해 검증된 구성을 받지 않습니다(생략 = 계약 없음, 검사할 것 없음). 진단은 엣지를 소비자, 소켓, 별칭으로 명시합니다. Release 자신의 Aggregate가 선언한 컴포넌트에서는, Release가 그 연결 중 하나에 대해 작성하는 모든 항목에 대해 운영자의 infra가 측정되며(infra를 지니지 않은 항목도 포함되며, 이것이 기본값 없는 required: 키가 누락으로 보고되는 방식입니다), Release가 boundary를 명시하는 경우 해당 컴포넌트를 명시한 boundary 아래, 운영자가 편집하는 곳인 Release의 그 항목에서 보고됩니다. 개발자의 values는 Aggregate의 연결 항목에서 보고됩니다.

sensitive: true로 선언된 리프는 제약 조건 실패 내용이 숨겨집니다. 실패 텍스트는 문제가 되는 값을 인용하며, 빌드 진단은 빌드를 지켜보는 누구나 읽을 수 있으므로, sensitive로 선언된 리프에서, 또는 sensitive로 선언된 객체 내부 어디에서든 아래의 <constraint failure>는 대신 <redacted>로 표시됩니다. 그 아래에 sensitive로 선언된 리프를 포함하는 위치에서도, pillar 자체를 포함하여 마찬가지입니다. 다른 키워드와 나란히 작성된 $ref는 작성된 위치에서 전체로 검사되므로, 그것이 가리키는 정의 내부의 실패는 그 위치에서 보고되며, 그렇지 않으면 리프의 값을 인용하게 됩니다. 엔터티, 필드 경로, pillar, 계약 이름은 모두 그대로 명시되므로 진단은 여전히 실패가 어디에 있는지 알려 줍니다. 값을 재현할 수 있는 텍스트만 제거됩니다. 민감도는 pillar별로 읽히므로, values와 infra에서 같은 이름을 가진 리프는 그것을 선언한 pillar에서만 숨겨집니다.

출력되는 메시지:

authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (작성된 필러가 선언된 스키마를 따르지 않습니다) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (작성된 필러가 선언된 스키마를 따르지 않습니다) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (작성된 필러가 선언된 스키마를 따르지 않습니다: values 필러가 Feature 스키마를 따르지 않습니다) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.features.<attachment>.infra.<field>, infra pillar does not conform to the Feature schema: <constraint failure>) (작성된 필러가 선언된 스키마를 따르지 않습니다: infra 필러가 Feature 스키마를 따르지 않습니다) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (작성된 필러가 선언된 스키마를 따르지 않습니다: values 필러가 Feature 스키마를 따르지 않습니다) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (작성된 필러가 선언된 스키마를 따르지 않습니다) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (작성된 필러가 선언된 스키마를 따르지 않습니다: values 필러가 Feature 스키마를 따르지 않습니다) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (작성된 필러가 선언된 스키마를 따르지 않습니다: values 필러가 Feature 스키마를 따르지 않습니다) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (작성된 필러가 선언된 스키마를 따르지 않습니다)

해결 방법: 문제가 되는 값을 선언된 스키마를 충족하도록 수정하거나, 값이 정당하다면 선언하는 스키마(Component의 schema.values/schema.infra, 또는 첨부된 Feature의 스키마)를 넓혀 그 값을 선언합니다. 각 pillar가 기대하는 정확한 타입, 범위, 기본값, 필수 필드를 확인하려면 aggrega inspect <component-type>으로 Component의 선언된 스키마를 살펴봅니다.

A declared schema contract cannot be read as a schema (선언된 스키마 계약을 스키마로 읽을 수 없음)

Component 또는 Feature가 검증 기준이 될 것을 아무것도 내지 않는 스키마 계약을 선언하여, 그 계약이 다루는 구성이 아무것에도 대조되지 않습니다. 이 결함을 가질 수 있는 계약은 세 가지이며, 각각 자체 필드에 작성됩니다. 엔티티 자신의 spec.schema, 그리고 의존성 소켓이 선언하는 두 가지 연결별 계약, 즉 연결의 개발자 측을 위한 valueSchema와 운영자 측을 위한 infraSchema입니다. 이 계약들이 참조할 수 있는 SchemaLibrary 항목도 아래 결함 중 세 번째를 가질 수 있으며, 그 경우가 어떻게 보고되는지는 뒤에서 설명합니다.

이 중단에 이르는 결함은 세 가지이며, 그중 두 가지는 계약이 멀쩡해 보이기 때문에 놓치기 쉽습니다. 소켓 계약이 JSON Schema 2020-12로 아예 컴파일되지 않을 수 있습니다. 가장 흔한 원인은 키워드 오타입니다. 엔티티 자체의 spec.schema가 컴파일되지 않는 경우에는 대신 그 컴파일이 만난 compact form 조건으로 보고됩니다(알 수 없는 키워드는 E0120, 타입이 받지 않는 제약은 E0116). 또는 깔끔하게 컴파일되지만 검증기를 만들지 못할 수 있습니다. 본문이 compact form으로는 읽히지만, 속성의 스키마가 와야 할 자리에 단순 스칼라가 있는 경우(items: nonsense)처럼 어떤 것도 대조해 검증할 수 있는 스키마가 아닌 경우입니다. 또는 다른 모든 면에서는 올바르지만 지원 집합 밖의 형식을 지정할 수 있습니다. format: password나 format: emial 같은 오타가 그 예이며, 이는 아무것도 검사하지 않는 제약으로 읽히는 대신 거부되고, 어떤 값이 해당 필드에 도달하는지와 관계없이 거부됩니다. format이 가질 수 있는 이름은 명명된 형식에 나열되어 있습니다. 해결 방법이 같고 어느 것을 넘겨도 결과가 같으므로, 세 가지 모두 하나의 조건입니다.

계약을 선언하지 않는 것과 읽을 수 없는 계약을 선언하는 것은 서로 다른 상황이며, 빌드는 이를 다르게 처리합니다. 아무것도 선언하지 않은 필드는 건너뜁니다. 필러별, 연결별 적합성 검사는 선택 사항이므로, 어느 필러도 제약하지 않는 소켓은 일반적인 작성 방식이며 진단을 일으키지 않습니다. 읽을 수 없는 무언가를 선언한 필드는 거부됩니다. 이를 넘기면 빌드가 성공을 보고하는 동안 그 필드가 다루는 모든 페이로드가 검증되지 않은 채 남게 됩니다. 검사가 멈췄는데 멈췄다고 알려 주는 것이 없는 셈입니다. 따라서 거부가 이 두 경우를 구분해 줍니다. 침묵은 검사할 것이 없었다는 뜻이고, 중단은 무언가 있었으나 읽을 수 없었다는 뜻입니다.

거부는 구성을 작성한 문서가 아니라 계약을 선언한 엔티티를 지목합니다. 수정이 이루어져야 하는 곳이 그곳이기 때문입니다. 계약을 읽을 수 없는 컴포넌트 타입을 받은 Aggregate 작성자는 자신의 파일에서 바꿀 것이 없습니다. 이 거부는 카탈로그를 읽을 때 발생하며, 이 시점에는 선언한 엔티티, 필러, 작성된 필드, 소스 줄이 모두 알려져 있습니다. 따라서 같은 결함은 빌드에서든, aggrega validate에서든, aggrega mcp가 노출하는 빌드 도구에서든 동일하게 보고됩니다. 엔티티가 $import:를 통해 읽는 계약, 즉 전체 spec.schema, 그 필러 하나, 또는 소켓의 계약은 가져온 파일에서 보고됩니다. 위치는 그 파일과 그 안에서 조각이 작성된 줄을 지목하고, 메시지는 여전히 계약을 선언한 엔티티와 필드를 지목합니다. 엔티티 자체의 spec.schema에서 발생하는 컴팩트 형식 중단도 같은 방식으로 위치가 지정됩니다.

지원 집합 밖의 형식을 지정하는 SchemaLibrary 항목은 해당 라이브러리를 읽을 때 이 중단에 이르며, 거부는 라이브러리와 항목을 지목하고 라이브러리 파일 안의 해당 항목을 가리킵니다. 카탈로그 전체에 대한 aggrega validate는 모든 라이브러리를 읽으므로 어떤 스키마가 그 항목을 참조하는지와 관계없이 항목을 보고하지만, 의존성 해석이 그 라이브러리에 도달하지 않는 Release는 그 라이브러리를 읽지 않습니다. 스키마가 $ref:를 통해 그 항목에 도달하는 Release도 거부되지만, 거부 메시지는 형식을 지목하지 않습니다. aggrega pull은 라이브러리를 카탈로그에서 찾을 수 없다고 보고하고(E0114), aggrega validate --release는 참조 대상을 찾을 수 없다고 보고합니다(E0121). 문제가 되는 항목과 이름을 보려면 카탈로그에 대해 aggrega validate를 실행합니다.

메시지는 실패를 만난 도구가 보고한 그대로 실패 내용을 담습니다. 컴파일 실패의 경우 계약 내부의 키, 소스 줄, 문제가 된 키워드를, 검증기를 만들지 못하는 본문의 경우 검증기가 거부한 위치를, 지원 집합 밖의 형식 이름의 경우 필드, 키워드 format, 작성된 이름, 지원되는 모든 이름을 담습니다. 소켓 계약 안의 문서 간 $ref: 중 SchemaLibrary 항목이 로드된 클로저에 없는 것은 aggrega validate가 엔티티나 Release를 검사할 때 같은 중단에 이릅니다. 엔티티 자체의 spec.schema 안에서는 위의 “A $ref: is not written in a form the compiler can resolve (참조가 컴파일러가 해석할 수 있는 형태로 작성되지 않음)”에서 설명하는 대로 보고됩니다. aggrega pull은 Release에 필요한 라이브러리에 대해 두 곳을 모두 읽으므로, 카탈로그에 없는 라이브러리는 두 곳 중 어디에서 참조하든 “A reference names no entity the catalog holds (참조가 카탈로그에 없는 엔티티를 지정함)”(E0114)에서 설명하는 대로 더 일찍 pull을 멈추게 하며, 카탈로그에 있는 라이브러리는 어느 쪽에서 참조하든 잠금 파일에 고정됩니다.

읽을 수 없는 제약 옆에 있는 올바른 제약은 적용되지 않습니다. 계약은 하나의 문서로 읽히므로, 읽을 수 없는 조각 하나가 함께 선언된 모든 제약을 무력화합니다. 그래서 이 중단은 그로 인해 잃는 제약보다 더 가치가 있습니다. 그 대안은 적용되는 것처럼 보이고, 적용되는 것처럼 읽히지만, 아무것도 적용하지 않는 계약이기 때문입니다.

출력되는 메시지는 엔티티와 그 버전, 계약을 선언한 필드를 지목하고, 이어서 그 계약이 제약하는 필러, 그다음 실패 내용을 지목합니다. 다음은 키워드 오타가 있는 소켓 계약의 예입니다.

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.usesSchema.<socket>.valueSchema declares a schema no validator can be built from, so the values it constrains would go unmeasured: compactform at <key>:<line> (keyword "<keyword>"): unknown keyword (선언된 스키마 계약을 사용 가능한 스키마로 컴파일할 수 없어 아무것도 검증되지 않았습니다. 계약이 선언된 곳에서 수정하거나, 다루는 구성에 검증이 필요 없다면 제거하십시오. Component: spec.usesSchema의 소켓 valueSchema가 검증기를 만들 수 없는 스키마를 선언하므로 그것이 제약하는 값은 측정되지 않습니다: 표시된 키와 줄의 compactform(표시된 키워드): 알 수 없는 키워드)

그리고 Component의 values 필러에 지원 집합 밖의 형식 이름이 있는 예입니다.

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.schema.values declares a schema no validator can be built from, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at values.<field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (선언된 스키마 계약을 사용 가능한 스키마로 컴파일할 수 없어 아무것도 검증되지 않았습니다. spec.schema.values가 검증기를 만들 수 없는 스키마를 선언하여 제약 대상 값이 측정되지 않습니다. 해당 형식은 지원되지 않습니다)

Feature는 Feature "<name>:<version>"로, 소켓의 계약은 spec.usesSchema.<socket>.infraSchema 같은 자체 필드로, 필러는 계약이 제약하는 필러인 values, infra 또는 provides로 지목됩니다. 엔티티 자체의 파일을 받은 aggrega validate는 엔티티를 버전 없이 지목합니다. SchemaLibrary 항목은 라이브러리와 항목으로 지목됩니다.

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. SchemaLibrary "<library>": schema "<entry>" names a format no validator can check, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at <field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (선언된 스키마 계약을 사용 가능한 스키마로 컴파일할 수 없어 아무것도 검증되지 않았습니다. 스키마가 검증기가 검사할 수 없는 형식을 지정하여 제약 대상 값이 측정되지 않습니다. 해당 형식은 지원되지 않습니다)

해결 방법: 진단이 지목한 필드를 열고 보고된 키와 줄의 조각을 수정합니다. 대부분은 키워드 오타이며 vocabulary/compact-form-authoring.md의 키워드 어휘와 대조해 확인하거나, 중첩 스키마가 와야 할 자리에 값이 작성된 경우입니다. 실패가 지원되지 않는 형식을 지목하면 명명된 형식 중 하나를 쓰거나 format:을 제거합니다. 비밀 정보를 담는 필드는 대신 sensitive: true를 선언합니다. password는 형식이 아니기 때문입니다. SchemaLibrary 항목의 경우 진단이 지목한 라이브러리 파일에서 수정합니다. 실패가 문서 간 참조를 지목하면 SchemaLibrary 항목이 존재하는지, 그리고 그 라이브러리가 Release의 의존성 클로저에서 도달 가능한지 확인합니다. 해당 필드가 다루는 구성에 정말 검증이 필요 없다면, 아무것도 읽을 수 없는 계약을 남겨 두지 말고 필드를 제거합니다.

Recipe source:가 빈 문자열임

Recipe가 source: "", 즉 빈 문자열을 선언합니다. Recipe의 source:는 두 가지 작성 모드 중 하나를 선택합니다. sourceless 모드는 외부 아티팩트가 없고 출력 전체가 Recipe의 다른 입력 종류에서 만들어지는 모드이며, sourced 모드는 source:가 렌더링할 외부 차트, 모듈 또는 파일을 지정하는 모드입니다. 필드를 생략하면 첫 번째가, 비어 있지 않은 값을 쓰면 두 번째가 선택되며, 빈 문자열은 어느 쪽도 선택하지 않습니다. 따라서 이는 의미 있는 값이 아니라 모호성입니다. null로 작성된 source:는 생략한 것과 같습니다.

컴파일러가 두 해석 중 하나를 대신 고르는 대신 Recipe가 거부됩니다. 빈 source:가 생기는 가장 흔한 경우는 URI를 지우고 키를 남겨 두는 것입니다. 이때 의도는 sourced 모드였으며, 빈 문자열을 sourceless로 받아들이면 아티팩트 없이 컴포넌트가 나가고 두 해석 중 어느 쪽을 택했는지 알리지도 않게 됩니다.

이 규칙은 Recipe를 로드할 때 작성된 값을 그대로 읽어 검사되므로, Recipe를 로드하는 모든 명령은 무언가가 빈 값을 사용하려 하기 전에 이 조건을 지목합니다. Recipe 파일에 대한 aggrega validate는 이를 거부하며, aggrega pull, 빌드, aggrega validate --release, 그리고 aggrega mcp가 제공하는 빌드 도구는 그 Recipe에 도달하는 Release에 대해 이를 보고하되, 이 때문에 더 이상 해석할 수 없게 된 Recipe 참조보다 먼저 보고합니다. 따라서 pull은 빈 참조를 소스 종류를 알 수 없는 참조로 보고하는 대신 이 조건을 지목합니다. 이 검사는 소스가 선언되었는지를 읽는 규칙보다 먼저 이루어지므로, source:가 비어 있는 Recipe는 덧씌울 대상이 없는 valuesMapping이나 누락된 입력 종류가 아니라 source:에 대해 안내받습니다.

출력되는 메시지입니다. 위치는 Recipe를 바인딩하는 컴포넌트가 아니라 빈 source:가 작성된 Recipe 파일과 그 안의 키 .spec.source입니다. 이 항목은 해당 Recipe를 바인딩하는 모든 컴포넌트가 공유하기 때문입니다:

recipe source is an empty string, which names neither sourceless mode nor sourced mode (Recipe <name>:<version>, at .spec.source). omit the source field for sourceless mode, or name a non-empty path or URI for sourced mode (recipe source가 빈 문자열이어서 sourceless 모드도 sourced 모드도 지정하지 않습니다. sourceless 모드라면 source 필드를 생략하고, sourced 모드라면 비어 있지 않은 경로나 URI를 지정하십시오)

빌드는 이 줄을 이 조건의 짧은 코드 E0251과 함께 CATALOG_ERROR 태그 아래에 출력하며, 그 옆에 Recipe 파일을 표시합니다.

해결 방법: Recipe가 sourceless라면 source: 필드를 완전히 생략하거나 null로 설정하고, sourced라면 비어 있지 않은 경로 / URI / 구조화된 소스 객체를 제공합니다.

컴포넌트 또는 기능 인스턴스에 매핑된 Recipe가 없음

인스턴스의 타입에 카탈로그가 보유한 Recipe로 해석되는 Manifest 매핑이 없습니다. Recipe 선택은 매핑 전용입니다. 컴파일러는 spec.implements:를 읽고 후보 중에서 골라 Recipe를 선택하는 일이 결코 없으므로, 매핑되지 않은 타입은 그것을 구현하는 Recipes가 몇 개이든 중단됩니다. implements는 선택에 정보를 제공하고, 선택은 작성자가 하며, Manifest가 그 선택을 기록합니다.

같은 조건은 매핑이 존재하지만 아무 데로도 이어지지 않는 경우에도 적용됩니다. 즉 허용되는 참조 형태의 값이 카탈로그에 없는 Recipe를 가리키는 경우로, 값이 고정한 버전과 다른 버전으로만 존재하는 경우와 두 capability가 모두 같은 단순 이름을 제공하는 경우를 포함합니다. 어느 쪽도 작성자가 선택했다고 할 수 있는 Recipe로 해석되지 않습니다. 어떤 참조로도 표현할 수 없는 형태의 매핑 값은 위의 “Manifest mapping value is not a shape a recipe reference accepts (Manifest 매핑 값이 recipe 참조가 받아들이는 형태가 아님)”에서 따로 보고되므로, 엔티티가 없다는 판정은 해석될 수 있었던 참조에 대해서만 내려집니다.

컴포넌트 인스턴스에 대해 출력되는 메시지입니다. 매핑이 존재하지만 없는 것을 가리키는 경우:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", mapped to recipe "<uri>"). correct the mapping value in the Manifest, or publish the recipe it names (컴포넌트/기능 인스턴스에 대해 해석된 recipe가 없습니다. 해당 타입에 대한 명시적 Manifest 매핑을 추가하십시오. Manifest의 매핑 값을 수정하거나, 매핑이 가리키는 recipe를 게시하십시오)

매핑이 없고 해당 타입을 구현하는 Recipes가 있으면, 그것들이 고정할 후보로 나열됩니다.

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", recipes implementing it "<recipe-uris>"). pin one of them in the Manifest (컴포넌트/기능 인스턴스에 대해 해석된 recipe가 없습니다. 해당 타입에 대한 명시적 Manifest 매핑을 추가하십시오. Manifest에서 그중 하나를 고정하십시오)

그리고 해당 타입을 구현하는 것이 전혀 없으면 나열할 것도 없습니다.

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe in the catalog implements this type; write one, then map the type to it (컴포넌트/기능 인스턴스에 대해 해석된 recipe가 없습니다. 해당 타입에 대한 명시적 Manifest 매핑을 추가하십시오. 카탈로그에 이 타입을 구현하는 recipe가 없습니다. recipe를 작성한 뒤 타입을 그것에 매핑하십시오)

카탈로그 디렉터리를 지정하지 않는 워크스페이스에서는 잠금 파일이 고정한 Recipes만 검색됩니다. 레지스트리의 것은 나열되지 않으며, 해당 타입에 대해 아무것도 매핑하지 않는 Manifest는 아무것도 고정하지 않습니다. 이 경우 고정된 Recipe 중 해당 타입을 구현하는 것이 없으면, 부재에 대한 주장은 카탈로그가 아니라 고정된 항목에 대해 이루어지며 메시지도 그렇게 밝힙니다:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe the lockfile pins implements this type; with no catalog directory, the recipes searched are only those the lockfile pins, not a registry’s; pin one a registry publishes in the Manifest, or write one, then map the type to it (컴포넌트/기능 인스턴스에 대해 해석된 레시피가 없습니다: Manifest에 해당 타입에 대한 명시적 매핑을 추가하십시오(Manifest, 표시된 위치, 표시된 인스턴스와 타입). 잠금 파일이 고정한 레시피 중 이 타입을 구현하는 것이 없습니다. 카탈로그 디렉터리가 없으므로 검색되는 레시피는 레지스트리의 것이 아니라 잠금 파일이 고정한 것뿐입니다. 레지스트리가 게시한 것을 Manifest에 고정하거나, 하나를 작성한 다음 타입을 그것에 매핑하십시오)

Aggregate가 버전 없이 작성한 타입에는 빌드가 그 타입을 컴파일하는 버전, 즉 카탈로그가 보유한 해당 Component의 최고 버전을 구현하는 Recipes가 제시됩니다. 카탈로그가 해당 Component를 1.0.0으로 보유할 때 core/datastore/postgres의 인스턴스에는 spec.implements: core/datastore/postgres:1.0.0을 선언한 모든 Recipe와, 버전 없는 타입 또는 1.0.0을 허용하는 캐럿 범위를 선언한 Recipe가 제시됩니다. 카탈로그에 Component가 없는 타입에는 버전 없는 그 타입 자체를 선언한 Recipes만 제시됩니다.

기능 인스턴스는 이러한 경우를 고유한 형태로, 각각 조건의 문장 뒤에 보고합니다. Aggregate가 버전 없이 작성한 기능 유형은 컴포넌트 유형과 같은 방식으로, 빌드가 그것을 컴파일하는 버전, 즉 카탈로그가 보유한 해당 Feature의 가장 높은 버전에서 매칭되며, <type>:<version>을 명시하는 메시지는 그 버전의 유형, 즉 카탈로그에서 검색된 대상을 가리킵니다. 연결의 컴포넌트가 매핑된 Recipe를 알고 있는 경우, FeatureRecipes는 그 Recipe가 바인딩하는 역량에 따라 구분됩니다. 컴포넌트의 역량에 바인딩하는 것이 먼저 제시되고, 다른 역량에 바인딩하는 FeatureRecipe도 컴포넌트의 출력 안이 아니라 그 옆에 자체 출력으로 렌더링되므로, 컴포넌트의 역량에 바인딩하는 것이 하나도 없으면 대신 그것들이 제시됩니다. 아무 곳으로도 이어지지 않는 매핑은 feature "<instance>" (type "<type>"): the Manifest maps it to feature recipe "<uri>", which is not in the catalog로 표시됩니다. 컴포넌트의 역량에 대해 해당 유형을 구현하는 FeatureRecipes가 있으면 그것들만 나열됩니다: feature "<instance>" (type "<type>"); feature recipes implementing it for capability "<capability>", the capability its component's Recipe binds to: [<recipe-uris>]; pin one in the Manifest. 다른 역량에 대해서만 구현하는 경우: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; feature recipes implementing it for other capabilities: [<recipe-uris>]; pin one of those in the Manifest, and it renders as its own output beside the component's, or write one for "<capability>", then map the type to it. 해당 유형을 구현하는 것이 전혀 없는 경우: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version>; write one, then map the type to it. 그리고 역량을 알 수 없는 경우, 즉 컴포넌트 자체의 매핑이 어떤 Recipe로도 해석되지 않아 그것이 별도로 보고되거나, 연결이 경계에 작성되어 그 컴포넌트들이 여러 역량을 통해 렌더링될 수 있는 경우에는 모든 구현체가 나열됩니다: feature "<instance>" (type "<type>"); feature recipes implementing it: [<recipe-uris>]; pin one in the Manifest. 카탈로그 디렉터리를 지정하지 않는 워크스페이스에서는 잠금 파일이 고정한 FeatureRecipes만 검색됩니다. 레지스트리의 것은 나열되지 않으며, 해당 유형에 대해 아무것도 매핑하지 않는 Manifest는 아무것도 고정하지 않습니다. 이 경우 부재에 대한 주장은 카탈로그가 아니라 고정된 항목에 대해 이루어지며, 메시지도 그렇게 밝힙니다. 해당 유형을 구현하는 것이 없는 경우: feature "<instance>" (type "<type>"); no feature recipe the lockfile pins implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; with no catalog directory, the feature recipes searched are only those the lockfile pins, not a registry's; pin one a registry publishes in the Manifest, where one for another capability renders as its own output beside the component's, or write one for "<capability>", then map the type to it — 그리고 역량을 알 수 없는 경우에는 메시지가 역량을 명시하지 않고 pin one a registry publishes in the Manifest, or write one, then map the type to it로 끝납니다. 고정된 FeatureRecipes가 다른 역량에 대해서만 구현하는 경우, 그 경우의 메시지는 no feature recipe in the catalog implements 대신 no feature recipe the lockfile pins implements로 표시되며, 역량 뒤에는 같은 절이 이어집니다.

해결 방법: 메시지가 요구하는 매핑을 Manifest의 spec.mappings.components.type 아래에 컴포넌트 타입을 키로, Recipe를 값으로 하여 추가합니다. 메시지가 후보를 나열하면 그중 하나를 고릅니다. 그 목록은 빌드가 해석한 버전의 타입을 구현한다고 선언한 Recipes와 정확히 일치합니다. 카탈로그에 없는 Recipe를 가리키면 값을 수정하거나, 빌드가 읽는 카탈로그 디렉터리에 그 Recipe를 추가합니다. 값에 버전이 있으면 카탈로그가 보유한 버전과 일치해야 합니다. 타입을 구현하는 것이 없으면 빠진 것은 Recipe 자체입니다. 검색된 레시피나 기능 레시피가 잠금 파일이 고정한 것뿐이라고 메시지가 말하는 경우, 워크스페이스는 카탈로그 디렉터리를 읽지 않으므로 레지스트리가 해당 타입을 구현하는 Recipe 또는 FeatureRecipe를 게시하고 있을 수 있습니다. Manifest에서 타입을 그것에 매핑해야 pull이 그것을 가져와 고정합니다.

A Manifest name mapping names nothing in the build (Manifest의 name 매핑이 빌드의 아무것도 지정하지 않음)

spec.mappings.components.name 또는 spec.mappings.features.name 아래의 키가 빌드에 있는 어떤 컴포넌트 인스턴스나 attachment도 지정하지 않습니다. name 계층은 실현되는 대상의 정확한 이름으로 일치시킵니다. components.name 키는 Aggregate가 작성한 컴포넌트 인스턴스의 이름과, features.name 키는 attachment 자체의 이름, 즉 컴포넌트의 features:에서 그것이 작성된 키 또는 연결에 작성된 attachment의 경우 <alias>.<slot>과 일치시키며, attachment가 붙은 컴포넌트의 이름과는 절대 일치시키지 않습니다. 아무것도 지정하지 않는 키는 한 번도 참조되지 않습니다. 그 키가 의도했던 모든 인스턴스는 type 계층을 통해 해석되고, 빌드는 무시한 항목에 대해 아무 말 없이 완료됩니다. 그래서 빌드는 무엇이든 렌더링하기 전에 중단합니다.

메시지는 Manifest, 키와 그것이 작성된 섹션, 빌드가 실제로 보유한 해당 종류의 이름(항목의 Recipe 또는 FeatureRecipe가 구현하는 타입을 알고 빌드가 그 타입을 보유하는 경우 그 타입으로 좁혀짐)을 지목하고, 판단할 수 있는 경우 의도했을 법한 이름도 지목합니다. 컴포넌트 이름인 features.name 키에 대해서는 그 컴포넌트가 가진 해당 타입의 attachment를, attachment 이름인 components.name 키에 대해서는 그것을 가진 컴포넌트를, 그 밖의 경우에는 한 번 편집 차이인 이름을 지목합니다.

출력되는 메시지이며, attachment가 붙은 컴포넌트의 이름으로 작성된 features.name 키의 경우입니다.

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<component>" under mappings.features.name: no attachment in this build is named "<component>"; a features.name key names an attachment by its own name — the key it is written under in a component’s features, or <alias>.<slot> for one written on a connection — never the component it is attached to; attachments of type "<feature-type>" in this build: "<attachments>"; "<component>" is a component, and a features.name key names the attachment rather than the component it is attached to — did you mean "<attachment>"? (Manifest의 name 매핑 키가 이 빌드의 어떤 컴포넌트 인스턴스나 attachment도 지정하지 않으므로 이 항목은 아무것도 바인딩하지 않습니다. Manifest의 mappings.features.name 아래 키: 이 빌드에 그 이름의 attachment가 없습니다. features.name 키는 attachment를 그 자체의 이름, 즉 컴포넌트의 features에서 작성된 키 또는 연결에 작성된 것의 경우 별칭과 슬롯으로 지정하며, 붙어 있는 컴포넌트는 절대 지정하지 않습니다. 이 빌드에서 해당 타입의 attachment는 표시된 것과 같습니다. 그 이름은 컴포넌트이며, features.name 키는 붙어 있는 컴포넌트가 아니라 attachment를 지정합니다. 표시된 attachment를 의도했습니까?)

그리고 인스턴스 이름과 한 번 편집 차이인 components.name 키의 경우입니다.

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<key>" under mappings.components.name: no component instance in this build is named "<key>"; a components.name key names a component instance exactly as the Aggregate writes it; component instances of type "<component-type>" in this build: "<instances>"; did you mean "<instance>"? (Manifest의 name 매핑 키가 이 빌드의 어떤 컴포넌트 인스턴스나 attachment도 지정하지 않으므로 이 항목은 아무것도 바인딩하지 않습니다. Manifest의 mappings.components.name 아래 키: 이 빌드에 그 이름의 컴포넌트 인스턴스가 없습니다. components.name 키는 컴포넌트 인스턴스를 Aggregate가 작성한 그대로의 이름으로 지정합니다. 이 빌드에서 해당 타입의 컴포넌트 인스턴스는 표시된 것과 같습니다. 표시된 인스턴스를 의도했습니까?)

아무것도 지정하지 않는 키는 모두 한 번의 빌드에서 Manifest에 작성된 순서대로 보고됩니다.

해결 방법: 키를 메시지가 제안하는 이름이나 메시지가 나열하는 이름 중 하나로 바꿉니다. attachment의 경우 그 컴포넌트의 이름이 아니라 attachment가 작성된 키의 이름으로 바꿉니다. 항목이 더 이상 필요하지 않다면 제거합니다. 그러면 해당 타입의 인스턴스는 type 계층을 통해 해석됩니다.

Manifest가 버전만 다른 두 키를 한 타입에 매핑함

타입 조회가 둘 이상의 Manifest 매핑 키와 일치했습니다. 타입 키는 버전을 가리지 않고 일치시키므로, 별도의 매핑 키로 작성된 core/api-server, core/api-server:1.0.0, core/api-server:2.0.0은 모두 같은 기본 타입에 응답합니다. 그리고 그중 두 개에 도달한 조회는 선택해야 할 Recipes가 두 개이지만 어느 하나를 우선할 규칙이 없습니다.

빌드는 우연히 먼저 읽은 키로 해석하지 않고 중단됩니다. 하나를 고르면 렌더링 출력이 매핑을 순회한 순서에 따라 달라지며, 이는 바이트 단위로 동일한 출력이 배제하는 바로 그것입니다.

출력되는 메시지:

manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous: type "<type>" matches version-distinct keys [<keys>] — pin the authored type’s version or remove the duplicate mapping keys (manifest가 버전만 다른 여러 키를 같은 기본 타입에 매핑합니다. 타입-recipe 조회가 모호합니다. 작성된 타입의 버전을 고정하거나 중복 매핑 키를 제거하십시오)

해결 방법: 두 가지 방향이 있으며 메시지는 둘 다 제시합니다. 중복 매핑 키를 제거하고 해당 타입에 응답해야 할 키 하나만 남깁니다. 추가 키가 버전 업 후 남은 것이라면 이 방법이 맞습니다. 또는 작성 쪽에서 버전을 고정하여 컴포넌트가 선언하는 타입이 의도한 키를 정확히 가리키게 합니다. 여러 키가 의도된 것이고 서로 다른 컴포넌트가 실제로 서로 다른 Recipes를 원한다면 이 방법이 맞습니다.

Two catalog entities in one directory share an identity (한 디렉터리의 두 카탈로그 엔터티가 같은 식별자를 가짐)

같은 카탈로그 디렉터리에서 로드된 같은 종류의 두 엔터티가 같은 식별자를 가집니다. 식별자는 참조가 가리키는 대상이므로, 두 파일이 하나의 식별자를 주장하면 그 식별자에 대한 모든 참조가 두 개의 답을 갖게 됩니다.

디렉터리 안에서는 중단되고, 디렉터리 사이에서는 중단되지 않습니다. 서로 다른 두 카탈로그 디렉터리에 있는 같은 식별자는 먼저 나온 쪽이 우선하는 섀도로 해석됩니다. 즉 먼저 나열된 디렉터리가 우선하며, 이 덕분에 로컬 디렉터리가 게시된 엔터티를 의도적으로 재정의할 수 있습니다. 한 디렉터리 안의 충돌만이 의도적인 것으로 읽을 여지가 없는 작성 실수입니다.

이 규칙은 색인되는 모든 종류에 동일하게 적용됩니다: Component, Feature, Recipe, FeatureRecipe, Plugin, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate. 중단은 두 번째 파일에 위치하며, 충돌한 종류와 식별자를 명시합니다.

출력되는 메시지:

duplicate entity identity within a single catalog directory (Component identity "<identity>")

Component 자리에는 해당 종류 고유의 단어가 들어갑니다. recipe identity, feature recipe identity, Plugin identity, SchemaLibrary identity 등입니다.

해결 방법: 두 엔터티 중 하나의 이름을 바꾸거나, 별도의 디렉터리로 옮깁니다. Recipe나 FeatureRecipe의 경우 식별자에 provider 범위와 버전이 포함되므로, 버전만 다른 두 파일은 충돌하지 않습니다. 이 경우 실제 충돌은 같은 버전이 두 번 게시되었다는 뜻입니다. 새 엔터티를 만들기 위해 엔터티 파일을 복사하고 metadata.name을 바꾸는 것을 잊는 것이 흔한 원인입니다.

두 곳은 한 번에 한 파일씩이 아니라 전체로 읽힙니다. 하나는 이름으로 조회할 때 그 아래의 모든 문서가 답이 될 수 있는 카탈로그 디렉터리이고, 다른 하나는 Release를 담은 디렉터리로, 식별자로 Aggregates와 Manifests를 지정하는 Release는 이 디렉터리를 기준으로 해석됩니다. 이 파일들 사이의 심볼릭 링크는 머신의 어디로든 이어질 수 있으므로, 이러한 각 디렉터리에는 읽기가 머물러야 하는 디렉터리가 있으며, 그 밖으로 이어지는 링크는 읽히지 않습니다. 워크스페이스 경계에서 여기에 적용되는 규칙과 이 규칙이 적용되는 다른 경로를 설명합니다.

그 디렉터리가 무엇인지는 읽히는 디렉터리가 어디에 있는지에 따라 달라집니다.

  • 워크스페이스: 워크스페이스 안에 있는 카탈로그 디렉터리나 Release의 디렉터리의 경우입니다. 이는 아무도 지정하지 않았을 때, 즉 단지 그곳에 있기 때문에 읽힐 때의 워크스페이스 관례상의 catalog 디렉터리에도 적용됩니다. 이때 그 디렉터리는 워크스페이스 자체의 것이므로, 그 자체가 워크스페이스 밖으로 이어지는 링크인 catalog는 읽히지 않습니다.
  • 워크스페이스 밖에 있는, 사용자가 지정한 디렉터리: 그 아래에 있는 것의 경우입니다. --catalog로 전달하거나 워크스페이스 구성이 워크스페이스 전체 또는 하나의 Release에 대해 catalog_dirs 아래에 나열한 카탈로그 디렉터리, 그리고 사용자나 구성이 지정한 Release의 디렉터리 중 워크스페이스 밖에 있는 것이 해당합니다. 디렉터리 자체는 지정한 그대로 사용되며, 링크인 디렉터리는 가리키는 곳에서 읽힙니다. 그 아래에서 읽히는 것은 그 안에 머무릅니다. 관례상의 catalog 디렉터리도 일단 지정하면 여기에 포함됩니다. catalog_dirs 아래에 나열하거나 --catalog로 전달하면, 워크스페이스 밖으로 이어지는 링크인 catalog는 지정한 다른 디렉터리와 마찬가지로 가리키는 곳에서 읽힙니다. 대신 링크가 가리키는 곳을 어떤 표기로든 지정하거나 그 상위 디렉터리를 지정해도 그것을 지정한 것이 됩니다. 지정한 디렉터리가 이미 그곳에 있는 것을 읽으므로, 그 디렉터리를 통해 한 번만 읽힙니다. 구성에 디렉터리를 지정하는 것이 워크스페이스 밖에 보관된 엔터티를 워크스페이스가 읽는 방법입니다.

판정 대상은 읽기가 무언가를 가져올 모든 항목입니다. 즉 YAML 문서처럼 이름 붙은 파일로의 링크와, 자체 문서를 담고 있을 수 있는 디렉터리로의 링크입니다. 읽기가 머물러야 하는 디렉터리 안의 어딘가로 이어지는 링크는 탐색이 그 링크를 만난 곳에서 읽힙니다. 카탈로그 읽기가 아무것도 가져오지 않는 파일(메모 파일, 차트 아카이브 등)로의 링크는 여기서 판정되지 않으며, 아무 곳으로도 이어지지 않는 링크는 그 뒤에 읽을 것이 없습니다.

컴파일이 의존하는 조회는 이러한 링크를 건너뛰지 않고 그 자리에서 멈춥니다. 링크 뒤의 엔터티가 참조가 가리키는 바로 그 엔터티일 수 있으며, 이를 조용히 건너뛰면 이후 카탈로그 디렉터리에 있는 같은 이름의 다른 엔터티가 대신 해석될 수 있기 때문입니다. 따라서 aggrega build, aggrega pull, aggrega validate, 카탈로그를 읽는 모든 경우의 aggrega inspect, 하나의 Release에 대한 린트, 그리고 Release를 빌드, 미리 보기, 그래프 생성, 검증 또는 설명하는 편집기와 어시스턴트의 요청은 모두 아무것도 해석하기 전에 멈추고 해당 링크를 명시합니다. 카탈로그 전체에 대한 린트도 같은 방식으로 멈춥니다. 그 판정은 카탈로그 디렉터리가 담은 모든 문서에 대해 답하는 것이므로, 그중 하나를 읽을 수 없는 상태에서 깨끗한 카탈로그라고 보고하지 않습니다. Release의 디렉터리도 Release가 식별자로 자신의 Aggregate나 Manifest를 지정하거나, Manifest가 그런 방식으로 자신이 확장하는 Manifest를 지정하는 모든 경우에 같은 규칙을 따릅니다. 또한 Release 옆의 문서들 사이에 있는 링크가 참조가 가리키는 것이 아니더라도 스캔은 멈춥니다. 그곳의 중복이 스캔을 멈추는 것과 같은 이유로, 문서 중 하나를 읽을 수 없는 동안에는 디렉터리가 어떤 이름에 대해서도 답할 수 없기 때문입니다. 작업에 지정된 Release, 또는 단독으로 검사하는 Manifest는 그러한 문서에 포함되지 않습니다. 그것은 지정된 곳에서 읽혔으므로, 그 자체가 밖으로 이어지는 링크인 Release는 가리키는 곳에서 읽히며, 그것이 지정하는 대상은 링크 옆, 즉 그것을 지정한 디렉터리에서 찾습니다(링크를 통해 지정된 Release 또는 Manifest).

반면 목록 작성은 이러한 링크를 건너뛰며, 그 뒤에 있는 것은 아무것도 나열하지 않습니다. 편집기의 엔터티 색인, 자동 완성, 그리고 제시하는 후보는 밖으로 이어지는 링크가 나타내는 엔터티를 나열하지 않으며, 엔터티 색인은 워크스페이스 안의 이러한 링크를 읽지 않은 링크 목록에 포함해 명시합니다.

워크스페이스의 구성 파일도 같은 방식으로 워크스페이스에 묶입니다. 워크스페이스 루트부터 명령이 실행되는 디렉터리까지의 모든 .aggrega-config.yaml과, 파이프라인이 그 옆에 두는 .aggrega-config-append-ci.yaml은 워크스페이스 자체의 내용입니다. 워크스페이스 밖으로 이어지는 링크이거나, 밖으로 이어지는 디렉터리 링크를 통해 도달하는 파일은 읽히지 않습니다. 모든 명령, 편집기의 언어 서버, 어시스턴트의 도구는 무엇보다 먼저 구성을 읽으므로, 각각은 남은 것으로 만들어진 구성으로 실행하지 않고 그 자리에서 멈추고 해당 링크를 명시합니다. 언어 서버와 자체 스트림으로 통신하는 어시스턴트의 서버는 이러한 워크스페이스에서도 시작됩니다. Releases와 엔터티의 목록은 아무것도 구성되지 않은 상태로 읽혀 응답하고 해당 파일을 읽지 않은 링크 목록에 포함해 명시하지만, 구성이 결정하는 그 밖의 모든 요청은 이 조건으로 거부되며 해당 링크를 명시합니다. 이 메시지가 제시하는 해결책은 구성 고유의 것입니다. 전역 구성 파일은 어디에 보관되어 있든 읽히는 유일한 구성이며, --config 또는 AGGREGA_CONFIG로 지정합니다.

Release의 lockfile도 같은 방식으로 묶이며, 쓰일 때와 마찬가지로 읽힐 때도 그렇습니다. Release 옆의 lockfile은 빌드, pull, 검증, 린트, 검사, aggrega cache prune, 그리고 편집기와 어시스턴트의 요청이 기준으로 삼는 고정 버전을 위해 읽히며, 그 쓰기가 묶이는 디렉터리, 즉 워크스페이스 또는 워크스페이스 밖에서 지정된 Release의 경우 그 Release 자체의 디렉터리에 묶입니다. 밖으로 이어지는 링크인 lockfile은 읽히지 않으며, 위의 각 작업은 머신의 다른 곳에 보관된 고정 버전을 기준으로 하거나 고정 버전 없이 해석하지 않고 멈춘 뒤 해당 링크를 명시합니다. 이 메시지가 제시하는 해결책은 lockfile 고유의 것입니다. lockfile의 위치는 pull이 쓰는 곳, 즉 Release 옆 한 곳뿐입니다.

엔티티 옆에서 읽는 파일도 같은 방식으로 제한됩니다. 두 작업은 참조가 지정하는 파일이 아니라 엔티티 자체 문서 옆에 있는 파일을 읽습니다. 엔티티를 고정하거나 게시할 때는 다른 엔티티가 그 디렉터리를 함께 쓰는지 확인하기 위해 엔티티 디렉터리의 다른 모든 YAML 문서를 읽습니다. 카탈로그 디렉터리에서 작성된 Plugin 엔티티를 로드할 때는 그 옆에 놓인 빌드된 .wasm을 읽습니다. 각각은 엔티티 자체 문서를 읽은 디렉터리, 즉 워크스페이스, 워크스페이스 밖에서 지정한 카탈로그 디렉터리, 또는 워크스페이스 밖의 문서를 지정해 고정하거나 게시하는 엔티티의 경우 그 문서 자체의 디렉터리로 제한되며, 그 밖으로 이어지는 링크인 파일은 읽지 않습니다. aggrega pin, --dry-run 유무와 관계없는 aggrega push, 고정을 수행하는 pull, 그리고 에디터와 어시스턴트의 고정 및 게시는 링크를 지정하며 중단됩니다. 읽지 않은 문서가 걸림돌이 되는 엔티티일 수 있기 때문입니다. 플러그인을 로드하는 빌드나 pull도 머신의 다른 곳에 있는 바이트를 실행하거나 다른 곳에서 플러그인을 찾는 대신 링크를 지정하며 중단됩니다. 이 메시지가 제시하는 해결책은 엔티티 옆 파일에 대한 것입니다. 파일 자체를 그곳에 두십시오.

워크스페이스의 아티팩트 캐시도 쓰는 곳과 마찬가지로 읽는 곳에서 같은 방식으로 제한됩니다. artifact_cache_dir 아래의 캐시에서 읽는 모든 것, 즉 캐시된 엔티티, 플러그인 또는 라이브러리와 그 옆의 manifest, 소스 아카이브와 그 메타데이터, 고정된 외부 입력, 서명 번들, 레지스트리의 로컬 검색 인덱스, 그리고 aggrega cache status, aggrega cache prune, aggrega cache clear가 나열하는 모든 워크스페이스 항목은 캐시에 대한 쓰기가 제한되는 디렉터리, 즉 캐시 디렉터리 자체로 제한됩니다. 기본값인 .aggrega/cache든, 구성이 지정해 워크스페이스 루트 밖으로 올라가는 디렉터리든 마찬가지입니다. 그 안에서 캐시 디렉터리 밖으로 이어지는 링크인 것은 워크스페이스 내 다른 곳이든 그 밖의 어디든 읽지 않으며, 워크스페이스 루트 안에 작성된 캐시 디렉터리가 그 자체로 워크스페이스 밖으로 이어지는 링크라면 그 뒤의 어떤 것도 읽지 않습니다. 빌드, pull, 검증, 검색, 세 가지 캐시 명령, 그리고 캐시를 읽는 에디터와 어시스턴트의 요청은 링크를 지정하며 중단됩니다. 캐시가 기록된 다이제스트 아래 보관하는 콘텐츠도 포함되는데, 다이제스트는 바이트가 무엇인지를 말할 뿐 어디에서 읽어도 되는지는 말하지 않기 때문입니다. 워크스페이스 루트 안에 작성된 캐시 디렉터리가 워크스페이스 내 다른 곳으로의 링크라면 그것이 가리키는 곳에서 읽습니다. 아무것도 결정하지 않는 aggrega inspect가 출력하는 지원 중단 알림은 제외됩니다. prune이나 clear가 캐시 디렉터리 밖으로 이어지는 링크인 캐시 자체 디렉터리, 또는 그 자체로 워크스페이스 밖으로 이어지는 링크인 캐시 디렉터리를 만나면, 무엇이든 나열하기 전에 그것을 해당 삭제 작업으로 보고 “A path the operation writes leads through a link out of the directory it must stay inside (작업이 쓰는 경로가 링크를 통해 머물러야 하는 디렉터리 밖으로 이어집니다)” 아래에서 처리합니다. 이 메시지가 제시하는 해결책은 캐시에 대한 것입니다. 링크를 제거하면 pull이 캐시를 다시 채우며, 다른 곳에 보관하는 캐시는 링크를 통해 접근하는 대신 워크스페이스 루트에 대한 상대 경로로 artifact_cache_dir에 지정합니다.

소스가 가져오는 리포지토리는 자체 체크아웃으로 제한됩니다. pull, 즉 aggrega pull 또는 Release의 의존성을 해석하는 빌드나 에디터 또는 어시스턴트의 요청이 git-repository 소스를 가져올 때, 리포지토리를 체크아웃하고 소스가 지정한 디렉터리를 아카이브합니다. 체크아웃은 그 자체로 독립된 디렉터리이며, module_subdir 자체를 포함해 리포지토리가 담고 있는 모든 링크는 그 안으로 제한됩니다. 리포지토리 안의 파일이나 디렉터리로의 링크는 링크의 이름으로 그것이 가리키는 대상으로 아카이브됩니다. 리포지토리 밖으로 이어지는 링크는 pull을 실행하는 머신의 어떤 파일이든 가리킬 수 있으므로 읽지 않습니다. pull은 링크와 그것이 이어지는 곳을 지정하며 중단되고 아무것도 캐시되지 않습니다. 체크아웃은 pull이 멈추면 제거되는 임시 디렉터리이므로, 메시지는 링크를 리포지토리 안의 위치로 지정하고(명령줄 첫 줄과 문장 안에서 chart/secret.txt처럼), 머물러야 하는 디렉터리를 소스가 지정한 리포지토리와 리비전으로 지정합니다. which must stay inside the repository <url> at <ref> (commit <commit>)이며, 소스가 ref를 지정하지 않거나 커밋 자체를 지정하면 at commit <commit>입니다. 링크가 이어지는 곳은 사용자 머신에서의 실제 위치로 지정됩니다. 이 메시지가 제시하는 해결책은 리포지토리에 대한 것입니다. 링크는 그곳에 커밋되어 있으므로 그곳에서 변경합니다. 리포지토리 안을 가리키게 하거나 파일 자체로 교체한 다음, 소스가 그 변경을 담은 리비전을 지정하게 합니다. 아카이브가 이미 해당 링크를 통해 읽고 있는 디렉터리로 되돌아가는 디렉터리 링크도 pull을 중단시킵니다. 그것이 나타내는 트리에 끝이 없기 때문입니다. 이 거부는 이 조건이 아닌 일반 오류입니다.

카탈로그 생성이 읽는 오버레이도 같은 방식으로 제한됩니다. aggrega plugin gen-catalog --from-embedded는 주어진 오버레이 디렉터리(--overlay로 입력하거나, 에디터에서 선택하거나, 어시스턴트가 지정한 디렉터리) 아래의 모든 오버레이를 읽고, 각각을 그 오버레이 디렉터리를 읽는 기준 디렉터리로 제한합니다. 워크스페이스 안의 오버레이 디렉터리라면 워크스페이스이고, 워크스페이스 밖에서 지정한 디렉터리라면 오버레이 디렉터리 자체입니다. 오버레이 디렉터리는 지정한 그대로 사용되며, 링크인 디렉터리는 그것이 가리키는 곳에서 읽습니다. 그 아래의 오버레이 중 제한되는 디렉터리 밖으로 이어지는 링크인 것은 읽지 않으며, 자체 오버레이를 담을 수 있는 디렉터리 링크로서 그 밖으로 이어지는 것도 읽지 않습니다. 생성은 오버레이 없이 생성하는 대신 링크를 지정하며 아무것도 쓰지 않고 중단됩니다. 제한되는 디렉터리 안의 다른 곳으로 이어지는 링크인 오버레이는 그것이 가리키는 곳에서 읽고, 그 안으로 이어지는 디렉터리 링크에는 들어가지 않습니다. 이 메시지가 제시하는 해결책은 오버레이에 대한 것입니다. 오버레이 자체를 오버레이 디렉터리 아래에 두거나, 모든 오버레이를 담은 디렉터리를 오버레이 디렉터리로 지정하십시오.

가져오는 디렉터리는 그 자체로 제한됩니다. 디렉터리가 주어진 aggrega import, 어시스턴트의 가져오기 도구, 세션의 aggrega/import 메서드는 파일 패턴이 선택한 디렉터리의 파일을 각각 디렉터리 안의 위치로 임포터에 전달하므로, 그 디렉터리는 위치가 워크스페이스 안이든 밖이든 해당 읽기가 머무는 디렉터리입니다. 판단 대상은 가져오기가 무언가를 가져올 모든 항목입니다. 관련 패턴 중 하나가 선택하는 파일로의 링크(지정된 형식을 처리하는 임프터의 패턴, 또는 형식이 인식되는 경우 컴파일러의 핵심 임포터를 포함해 가져오기가 선택 대상으로 삼는 모든 임포터의 패턴)와, 결코 들어가지 않는 디렉터리로의 링크입니다. 디렉터리 밖으로, 즉 워크스페이스 내 다른 곳이나 그 밖의 어디로든 이어지는 링크는 읽지 않습니다. 가져오기는 디렉터리의 어떤 파일도 열기 전에 링크를 지정하며 아무것도 쓰지 않고 중단됩니다. 디렉터리 안의 다른 파일로의 선택된 링크는 링크 자체의 이름으로 그것이 가리키는 곳에서 읽으며, 어떤 패턴도 선택하지 않는 파일로의 링크는 판단하지도 읽지도 않습니다. 디렉터리 자체는 지정한 그대로 사용되며, 링크인 디렉터리는 그것이 가리키는 곳에서 읽습니다. 리스너를 통해 접근한 경우 어시스턴트의 도구는 링크를 워크스페이스 안의 위치로 지정하고 그것이 어디로 이어지는지는 말하지 않습니다. 이 메시지가 제시하는 해결책은 가져오는 디렉터리에 대한 것입니다. 링크 대신 파일 자체를 디렉터리에 두거나, 링크가 이어지는 디렉터리를 가져오십시오.

출력되는 메시지입니다. 조건 자체의 문장으로 시작하고, 이어서 읽기가 도달한 경로, 머물러야 하는 디렉터리, 도중에 만난 링크와 그 링크가 이어지는 곳, 그리고 해결책이 나옵니다:

a file this operation reads leads through a link out of the directory it must stay inside (reading <workspace>/catalog-local/component/app/1.0.0/component.yaml, which must stay inside <workspace>, the link <workspace>/catalog-local/component/app/1.0.0/component.yaml leads to <elsewhere>/component.yaml). nothing was read through that link. Remove the link, or make it lead to a place inside <workspace>. To read what is kept outside, list the directory holding it as a catalog directory in the workspace configuration, rather than reaching it through a link beneath one: a listed directory is read where it leads, even when it is itself a link (이 작업이 읽는 파일이 링크를 통해 머물러야 하는 디렉터리 밖으로 이어집니다(위에 적힌 파일을 읽는 중이며, 이 파일은 워크스페이스 안에 머물러야 하는데 해당 링크가 워크스페이스 밖의 위치로 이어집니다). 그 링크를 통해서는 아무것도 읽지 않았습니다. 링크를 제거하거나, 워크스페이스 안의 위치로 이어지게 하십시오. 밖에 보관된 것을 읽으려면 카탈로그 디렉터리 아래의 링크로 접근하는 대신, 그것을 담은 디렉터리를 워크스페이스 구성에 카탈로그 디렉터리로 나열하십시오. 나열된 디렉터리는 그 자체가 링크인 경우에도 링크가 이어지는 곳에서 읽힙니다)

이 진단에는 범주가 없습니다. 잘못된 것은 작성한 문서가 아니라 디스크상의 배치이기 때문입니다.

해결 방법: 링크를 그것이 가리키는 대상의 복사본으로 바꾸거나 링크를 제거합니다. 또는 엔터티를 워크스페이스 밖에 두려는 경우, 그것을 담은 디렉터리를 워크스페이스 구성의 catalog_dirs 아래에 나열하거나 --catalog로 전달하여 해당 디렉터리가 독립된 카탈로그 디렉터리로 읽히게 합니다. 링크가 있는 디렉터리가 아니라 링크가 가리키는 디렉터리를 나열하십시오. 디렉터리 아래에서 만난 링크는 그 디렉터리가 어떤 방식으로 읽히게 되었든 똑같이 판정되므로, 그 디렉터리를 나열해도 달라지는 것이 없습니다. 링크가 워크스페이스의 관례적인 catalog 디렉터리 자체인 경우에는 catalog 또는 그것이 가리키는 디렉터리를 catalog_dirs 아래에 나열하거나 둘 중 하나를 --catalog로 전달하는 것으로 충분합니다. 직접 지정한 디렉터리는 가리키는 위치에서 읽히기 때문입니다. 링크가 Release의 lockfile인 경우에는 링크를 제거하고 Release를 다시 pull하십시오. 그러면 그 옆에 새 lockfile이 작성됩니다. Manifest에는 카탈로그 계층이 없으므로 Release가 읽는 Manifest는 Release 자체 옆에 보관합니다. 링크가 구성 파일인 경우에는 워크스페이스 안에 보관한 복사본으로 바꾸십시오. 여러 워크스페이스에서 공유하려는 구성은 --config 또는 AGGREGA_CONFIG로 전역 구성 파일로 지정하면 각 워크스페이스 자체 파일보다 아래 순위로 읽힙니다. 링크가 pin하거나 게시하는 엔터티 옆에 있는 경우에는 파일 자체로 바꾸거나, 엔터티인 문서를 별도의 디렉터리로 옮기십시오. Plugin 엔터티 옆의 .wasm인 경우에는 빌드된 .wasm 자체를 그 위치에 두십시오. 링크가 아티팩트 캐시 디렉터리이거나 그 안의 항목인 경우에는 링크를 제거하거나(pull하면 캐시가 다시 채워집니다), 캐시를 다른 곳에 두려면 artifact_cache_dir를 워크스페이스 루트 기준 상대 경로(../shared-cache)로 그 디렉터리로 설정하십시오. 링크가 git-repository 소스가 가져오는 저장소에 커밋되어 있는 경우에는 그 저장소에서 링크를 변경하고(저장소 안을 가리키게 하거나 파일 자체를 커밋), 변경 사항이 포함된 리비전을 지정하십시오. 링크가 카탈로그 생성의 오버레이 디렉터리 아래에 있는 오버레이인 경우에는 오버레이 자체로 바꾸거나, 모든 오버레이를 담은 디렉터리를 오버레이 디렉터리로 지정하십시오. 링크가 가져오는(import) 디렉터리에 있는 경우에는 링크 대신 파일 자체를 디렉터리에 두거나, 링크가 가리키는 디렉터리를 가져오십시오.

A reference to another file leads out of the directory it must stay inside (다른 파일에 대한 참조가 머물러야 하는 디렉터리 밖으로 이어짐)

Release와 Manifest는 경로로 다른 파일을 지정할 수 있습니다. ./… 또는 ../…로 작성된 Release의 aggregate:와 manifest:, Release의 extends:, 경로로 작성된 Manifest의 extends:, 그리고 Release의 parameters: { $import: … }가 그렇습니다. 워크스페이스 안의 문서는 이 방식으로 워크스페이스 안의 파일에만 도달합니다. 워크스페이스 밖에 있는 Release(명령줄에서 지정한 것 또는 워크스페이스 구성이 지정한 것)와, 워크스페이스 밖에서 명령줄로 단독 지정한 Manifest는 자신의 디렉터리 안의 파일에만 도달합니다. 워크스페이스 밖에서 지정한 디렉터리와 마찬가지로 그 디렉터리는 독자적인 루트이며, extends: 체인이 이어지는 모든 Release도 같은 디렉터리에 묶입니다. 작성된 그대로 그 디렉터리 밖으로 올라가는 경로와, 작성된 그대로는 안에 머물지만 도중에 밖으로 이어지는 심볼릭 링크를 만나는 경로는 모두 거부되며, 그 경로가 지정하는 파일에서는 아무것도 읽지 않습니다. 디렉터리 아래에서 아직 존재하지 않는 파일로 이어지는 경로는 여기서 거부되지 않으며, 읽을 수 없는 파일로 보고됩니다. 워크스페이스 경계에서 지정한 경로뿐 아니라 참조도 제한되는 이유를 설명합니다.

경로가 어디를 기준으로 해석되는지는 언어 레퍼런스가 각 키에 대해 설명하는 규칙과 같습니다. Release의 aggregate:와 manifest:, 그리고 Manifest의 extends:는 명령이나 요청이 지정한 Release 옆을 기준으로 하며, 단독으로 지정한 Manifest의 경우 그 Manifest 옆을 기준으로 합니다. Release의 extends:와 parameters의 $import:는 그것을 작성한 Release 옆을 기준으로 하므로, extends: 체인의 각 고리는 자기 옆에 있는 부모를 지정합니다. 진단은 해석 기준이 된 디렉터리를 표시합니다.

경로가 아닌 이름은 여기서 판정하지 않습니다(aggregate: payments, extends: base-manifest). 이름은 Release 옆의 문서들에서, 그리고 Aggregate의 경우 카탈로그 디렉터리에서 조회되며, 카탈로그 디렉터리는 위의 “A file the operation reads leads through a link out of the directory it must stay inside (작업이 읽는 파일이 링크를 통해 머물러야 하는 디렉터리 밖으로 이어짐)”의 규칙을 따릅니다.

Release가 지정하는 대상을 해석하는 모든 경로는 파일을 읽기 전에 여기서 중단됩니다. aggrega pull, aggrega build, aggrega validate, Release 또는 Manifest에 대한 aggrega inspect, 단일 Release의 lint, 그리고 Release를 빌드, 미리 보기, 그래프화, 검증 또는 설명하는 에디터와 어시스턴트의 요청이 해당됩니다. 에디터에서는 해당 파일로 이어진 Release의 키에 진단이 표시됩니다.

출력되는 메시지. 조건 자체의 문장으로 시작하고, 이어서 작성된 그대로의 참조, extends:와 parameters의 $import:의 경우 그것이 작성된 문서, 해석 기준 디렉터리, 이어지는 위치, 머물러야 하는 디렉터리, 그리고 링크가 밖으로 이어지는 경우 그 링크가 나오며, 마지막으로 해결 방법이 나옵니다. 워크스페이스 안의 문서의 경우:

문서가 다른 파일을 가리키는 참조가 머물러야 하는 디렉터리 밖으로 이어집니다(.spec.aggregate: ../shared/app.yaml, <workspace>에서 해석됨, <elsewhere>/shared/app.yaml로 이어지며, 이는 워크스페이스 <workspace> 밖입니다). 그 파일에서는 아무것도 읽지 않았습니다. 워크스페이스 안의 문서는 <workspace> 안의 파일에만 도달합니다. 파일을 그곳으로 옮기거나, 링크가 참조를 밖으로 이끄는 경우 링크가 그곳을 가리키도록 하거나, 두 문서를 모두 담은 디렉터리에서 워크스페이스를 여십시오. 그 디렉터리 밖에 둔 Aggregate는 경로가 아니라 이름으로, 워크스페이스 구성이 나열하는 카탈로그 디렉터리에서 도달합니다

그리고 워크스페이스 밖에서 지정되어 자신의 디렉터리가 머물러야 하는 디렉터리인 Release 또는 Manifest의 경우:

문서가 다른 파일을 가리키는 참조가 머물러야 하는 디렉터리 밖으로 이어집니다(.spec.aggregate: ../aggregates/app.yaml, <directory>에서 해석되어 <parent>/aggregates/app.yaml로 이어지며, 이는 workspace <workspace> 밖에서 지정된 문서의 디렉터리인 <directory> 밖입니다). 해당 파일에서는 아무것도 읽지 않았습니다. workspace 밖에서 명령줄로 또는 workspace 구성으로 지정된 Release나 Manifest는 자신의 디렉터리 <directory> 안의 파일에만 접근합니다. 파일을 그곳으로 옮기거나, 링크가 참조를 밖으로 이끄는 경우 링크가 그곳으로 이어지도록 하거나, 두 문서를 모두 담은 workspace에서 문서를 지정하십시오. 그 디렉터리 밖에 보관된 Aggregate는 경로가 아니라 이름으로, workspace 구성이 나열하는 catalog 디렉터리에서 접근합니다

extends: 또는 parameters의 $import:의 경우 참조 뒤에 written in <document>가 붙고, 링크가 경로를 밖으로 내보내는 경우 끝에 the link <link> leads to <place>가 붙습니다. aggregate: 또는 manifest: 참조는 문서를 표시하지 않습니다. 다른 Release를 확장하는 Release는 체인의 더 위에 있는 Release에서 그것을 상속했을 수 있으며, 어느 경우든 명령이 지정한 Release 옆을 기준으로 해석됩니다.

진단의 범주는 [OPS_ERROR]입니다. 참조가 Release 또는 Manifest에 작성되어 있기 때문입니다.

해결 방법: 워크스페이스 밖에 있는 Aggregate의 경우 경로 대신 metadata.name을 작성하고, 그것을 담은 디렉터리를 워크스페이스 구성의 catalog_dirs 아래에 나열하거나 --catalog로 전달하십시오. 카탈로그 디렉터리는 워크스페이스가 그 밖에 있는 엔터티에 도달하는 방법입니다. Manifest, extends:가 지정하는 Release, parameters 파일은 Release 옆에서 읽히며 이름으로 조회되지 않으므로, 워크스페이스 안에 두거나 Release와 파일을 모두 담은 디렉터리에서 워크스페이스를 여십시오. 워크스페이스 밖에서 지정한 Release 또는 Manifest의 경우, 그것이 지정하는 대상을 자신의 디렉터리에 두거나, 그것과 그것이 지정하는 대상을 모두 담은 워크스페이스에서 빌드하십시오. 링크가 경로를 밖으로 내보내는 경우, 링크를 그것이 가리키는 대상의 복사본으로 바꾸거나 디렉터리 안을 가리키게 하십시오.

No catalog version satisfies a version constraint (버전 제약을 만족하는 카탈로그 버전이 없음)

참조가 카탈로그에 있는 엔터티를 지정하지만, 카탈로그에 없는 버전을 고정합니다. 존재하지 않는 정확한 버전이거나, 사용 가능한 어떤 버전과도 일치하지 않는 캐럿 범위입니다. 이름 자체를 알 수 없는 단순한 미발견과는 구별됩니다. 여기서는 엔터티가 존재하고 버전만 만족할 수 없으므로, 메시지는 엔터티가 없다고 보고하여 이름의 오타를 찾게 하는 대신 그 사실을 알려 줍니다.

모든 종류가 하나의 선택 과정을 통해 이 조건에 도달하므로, 만족할 수 없는 고정은 어디에 작성되든 똑같이 동작합니다. Manifest의 Recipe 매핑에 있는 버전 오타는 component type에 있는 같은 오타와 정확히 같은 방식으로 거부됩니다.

이 조건은 복구 가능하므로, 에디터는 문서를 포기하지 않고 입력을 계속하는 동안 이를 진단으로 표시할 수 있습니다. 명령줄에서는 중단으로 합쳐집니다.

출력되는 메시지이며, Release의 의존성이 도달하는 참조(컴포넌트 타입, Manifest 매핑 값)에 대해 그것이 수집된 위치를 지목합니다.

no catalog version satisfies the referenced version constraint: entity "<reference>" (referenced from <referring paths>) (참조된 버전 제약을 만족하는 카탈로그 버전이 없음: 표시된 엔티티와 그것을 참조하는 위치)

extends: 포인터에 대한 고정의 경우 출력되는 메시지:

no catalog version satisfies the referenced version constraint (Component <name>, at .extends, no catalog version satisfies extends parent "<reference>") (참조된 버전 제약을 만족하는 카탈로그 버전이 없습니다)

Feature의 체인이 고정을 가진 경우 Component 대신 Feature가 표시됩니다.

해결 방법: 고정을 카탈로그에 있는 버전으로 바꾸거나, 해당 버전을 카탈로그에 추가하십시오. aggrega inspect는 엔터티를 사용할 수 있는 버전을 나열합니다. 아무것과도 일치하지 않는 캐럿 범위는 대개 사용 가능한 버전이 모두 그 범위가 지정한 하한보다 낮다는 뜻입니다. 범위를 넓히거나, 참조가 기다리는 버전을 게시하십시오.

고정이 취하는 어떤 형식에도 해당하지 않는 고정은 다른 조건이며, 아래의 “A version pin is none of the forms a pin takes (버전 고정이 고정이 취하는 어떤 형식에도 해당하지 않음)”에서 설명합니다.

A version pin is none of the forms a pin takes (버전 고정이 고정이 취하는 어떤 형태에도 해당하지 않음)

참조는 다른 엔터티를 지정하며, 원하는 버전을 콜론 뒤에 두 가지 형태 중 하나로 고정할 수 있습니다. 하나는 정확한 고정으로, 1.0.0과 같은 시맨틱 버전이며 모든 엔터티의 metadata.version이 취하는 형태입니다. 다른 하나는 캐럿 고정으로, ^ 뒤에 ^1.0.0과 같이 버전이 오며 그 버전과 호환되는 가장 높은 버전을 선택합니다. 둘 다 아닌 고정, 즉 ^garbage처럼 텍스트가 버전 범위로 읽히지 않는 캐럿이나 1.x, 1.0, v1.0.0처럼 시맨틱 버전이 아닌 정확한 고정은 어떤 버전도 지정하지 않으므로, 어떤 카탈로그도 그것이 요구하는 것을 보유할 수 없습니다.

이러한 고정은 카탈로그가 보유하지 않은 엔터티나 버전이 아니라 형식이 잘못된 것으로 보고되므로, 진단은 존재하지 않는 것을 찾게 하는 대신 입력한 텍스트로 안내합니다. 고정이 어디에 작성되든 같은 조건입니다. component 또는 feature의 type, Component 또는 Feature의 extends:, Manifest 매핑의 키 또는 값, Release의 spec.aggregate, Recipe 또는 FeatureRecipe의 implements:, Recipe의 capability:를 제공하는 플러그인이 선택될 때 그것이 고정하는 버전, 그리고 파이프라인 단계의 plugin:이 해당됩니다.

이 조건은 해석에 실패한 참조가 보고되는 곳에서 보고되므로, 형식이 잘못된 고정이 어떤 참조가 해석되는지를 바꾸지는 않으며 실패 시 표시되는 내용을 바꿉니다. 형식은 올바르지만 사용 가능한 어떤 버전도 만족하지 않는 고정은 해당 경로가 보고하는 조건을 그대로 유지합니다. 위의 “No catalog version satisfies a version constraint (버전 제약을 만족하는 카탈로그 버전이 없음)” 또는 그것이 작성된 경로의 찾을 수 없음 조건입니다.

마지막 콜론 뒤의 텍스트만 고정이며, 그것도 /를 포함하지 않을 때만 해당합니다. 따라서 localhost:5000/core/api-server처럼 포트가 있는 레지스트리 호스트에 대한 참조는 고정을 포함하지 않으며(포트의 콜론 뒤 텍스트는 참조의 연속입니다), 형식이 잘못된 고정으로 보고되지 않습니다.

component type에 대한 캐럿 고정의 경우 출력되는 메시지:

reference carries a malformed version pin (reference "<reference>", pin "<pin>", the text after ^ is not a version range, referenced from <authored location>). write the reference as , as : with a semantic version such as 1.0.0, or as :^ for the highest version compatible with it (참조에 잘못된 형식의 버전 핀이 있습니다(참조, 핀, ^ 뒤의 텍스트가 버전 범위가 아님, 작성된 위치에서 참조됨). 참조를 이름만으로, 1.0.0 같은 시맨틱 버전을 붙인 이름:버전으로, 또는 그와 호환되는 가장 높은 버전을 위해 이름:^버전으로 작성하십시오)

정확한 고정의 경우 캐럿 절 대신 an exact pin must be a semantic version이 표시됩니다. 그 뒤의 값은 참조가 작성된 위치를 보고하는 경로의 표현으로 나타냅니다. referenced from과 작성 위치, in the Release's spec.aggregate, 또는 in the recipe's spec.implements입니다. Manifest 매핑이 해당 Recipe의 implements:에 대해 판정되는 경우에는 매핑 항목과 그 중 어느 쪽이 고정을 포함하는지(in the mapping key 또는 in the recipe's spec.implements)가 대신 참조 앞에 오며, Component 또는 Feature의 extends:는 확장하는 엔터티와 필드를 그 앞에 명시합니다.

해결 방법: 고정을 두 형태 중 하나로 다시 작성하거나, 제거하여 사용 가능한 가장 높은 버전을 선택하십시오. 1.x와 같은 와일드카드는 캐럿 고정 ^1.0.0으로 작성합니다. 앞에 v가 붙거나 숫자가 세 개보다 적은 버전은 1.0.0처럼 전체를 작성합니다.

Every version a reference could select has been withdrawn (참조가 선택할 수 있는 모든 버전이 철회됨)

참조가 레지스트리가 보유한 저장소로 해석되지만, 탐색이 그 저장소에서 선택할 수 있었던 모든 버전이 철회된 것으로 표시되어 있습니다. 선택할 수 있는 버전이 남아 있지 않습니다.

이는 의도적으로 누락된 엔터티로 보고되지 않습니다. 저장소는 존재하며 그 버전들을 여전히 보유하고 있습니다. 이를 없다고 하면 잘못된 문제를 지목하고, 오타를 찾게 만들며, 실제로는 거부인데 조용한 대체처럼 읽힐 것입니다. 메시지는 철회된 각 버전을 그에 대해 기록된 사유와 함께 명시하므로, 전달되는 내용은 게시자가 기록한 내용 그대로입니다.

철회된 버전을 직접 지정하는 것은 이 중단에 해당하지 않습니다. 정확한 버전은 탐색을 완전히 우회하므로, 그것을 고정하는 것이 의도적으로 계속 사용하는 방법입니다. 빌드는 철회를 보고하고 계속 진행합니다.

출력되는 메시지:

every published version this reference could select has been withdrawn: <reference>: withdrawn: <version> (<recorded reason>), <version> (<recorded reason>) (이 참조가 선택할 수 있는 게시된 모든 버전이 철회됨)

해결 방법: 기록된 사유를 읽으십시오. 대개 무엇으로 옮겨야 하는지가 적혀 있습니다. 철회된 엔터티를 대체하는 것으로 마이그레이션하십시오. 그것이 철회가 요구하는 결과입니다. 당분간 이전 것을 유지해야 하는 경우에는 참조에 정확한 버전을 고정하십시오. 버전을 지정하는 것이 그 버전을 수용한다는 의사 표시이며, 그러면 빌드는 거부하는 대신 매번 철회를 보고합니다.

A plugins.providers binding names a plugin that does not serve the capability (바인딩이 해당 capability를 제공하지 않는 플러그인을 지정함)

워크스페이스의 plugins.providers 블록이 어떤 기능에 대해 플러그인 식별자를 선택했지만, 그 기능을 제공하는 provider 렌더링 Plugin 중 해당 식별자를 가진 것이 없습니다. 바인딩은 카탈로그가 따를 수 없는 명시적 선택이므로, 다른 플러그인으로 조용히 대체하지 않고 중단합니다. 대체하면 사용하지 말라고 한 플러그인으로 출력을 렌더링하면서 아무 말도 하지 않게 됩니다.

바인딩은 플러그인의 좌표 식별자, 즉 플러그인 유형과 플러그인 이름(lockfile이 고정하는 것이기도 합니다)으로 선택하며, 그 뒤에 버전을 붙일 수 있습니다.

Recipe가 해당 기능을 요청하는지와 관계없이 판정됩니다. 그렇지 않으면 바인딩은 Recipe의 capability:가 그것을 지정할 때만 읽히므로, 기능 이름의 철자가 틀린 바인딩은 아무것도 참조하지 않고 아무것도 보고하지 않을 것입니다. 따라서 모든 빌드와 모든 aggrega validate --release는 플러그인을 지정하는 각 바인딩을 검사합니다. pull은 Recipe가 사용하는지와 관계없이 그러한 바인딩을 해석하므로, 빌드는 플러그인을 보유하고 그것이 무엇을 제공하는지 알며, 그 플러그인이 제공하지 않는 기능은 확실히 잘못된 것입니다. 이 검사는 lockfile이 아니라 워크스페이스 구성의 바인딩을 읽으며, 어떤 플러그인이 Recipe를 렌더링하는지는 바꾸지 않습니다. 그것은 여전히 lockfile이 결정합니다. 빌드가 보유하지 않은 플러그인(아직 어떤 pull도 가져오지 않은 레지스트리 플러그인)을 지정하는 바인딩은 pull이 그것을 가져올 때까지 판정되지 않습니다. 플러그인을 지정하지 않는 바인딩은 권고로서 다르게 판정됩니다. 아래 “Conditions that do not halt a build (빌드를 중단하지 않는 조건)”의 “A provider binding names a capability no plugin the build reads serves (provider 바인딩이 빌드가 읽는 어떤 플러그인도 제공하지 않는 기능을 지정함)”를 참조하십시오.

출력되는 메시지. 지정된 플러그인이 실제로 제공하는 것과, 바인딩의 기능이 한 글자 편집 거리에 있는 경우 그 철자를 덧붙입니다:

plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches: capability "<capability>" is bound to plugin "<plugin-identity>", but no provider-rendering plugin serving "<capability>" matches that identity; "<plugin-identity>" serves "<served capability>", and "<capability>" is one edit from "<served capability>" (plugins.providers 항목이 해당 기능을 제공하는 어떤 provider 렌더링 플러그인과도 일치하지 않는 플러그인을 지정함)

바인딩이 지정한 플러그인이 빌드가 읽는 카탈로그에 없는 경우, 그것이 무엇을 제공하는지에 대해 말할 것이 없으므로 메시지는 “matches that identity” 뒤에서 끝납니다.

해결 방법: 먼저 바인딩의 철자를 플러그인 자체의 좌표와 비교하십시오. 플러그인을 지정해야 할 곳에 기능을 지정하는 것이 흔한 실수입니다. 메시지가 작성한 것과 한 글자 편집 거리에 있는 기능을 명시하면, 바인딩의 capability:가 오타입니다. 그다음 플러그인이 빌드가 읽는 카탈로그에 있고 spec.provider.capabilities 아래에 이 기능을 나열하는지 확인하십시오. 한때 기능을 제공했지만 더 이상 선언하지 않는 플러그인은 정확히 이 메시지를 생성합니다. 기능을 제공하는 플러그인이 하나뿐인 경우에는 바인딩이 구별할 대상이 없으므로 바인딩을 제거하는 것이 올바른 해결책입니다.

No provider plugin version satisfies a Recipe’s provider pin (Recipe의 provider 고정을 만족하는 provider 플러그인 버전이 없음)

Recipe가 버전이 고정된 provider(helm:1.0.0 또는 helm:^1.0.0)를 바인딩하는데, 그 고정을 만족하는 provider 렌더링 Plugin 버전이 없습니다. 고정은 명시적인 요청이므로, 빌드는 이를 무시하고 마침 그 provider를 제공하는 아무 버전으로 렌더링하지 않고 중단합니다. 고정을 조용히 무시하면 작성자 자신의 선언이 존재해서는 안 된다고 하는 출력이 만들어지기 때문입니다.

이 상황에 이르는 경우는 두 가지이며, 메시지가 이를 구분합니다. 그 capability를 제공하는 것이 전혀 없는 경우와, 제공하는 것은 있지만 그 버전 중 어느 것도 제약을 만족하지 않는 경우입니다.

이는 위에서 설명한 만족할 수 없는 엔터티 버전과 다릅니다. 그것은 카탈로그가 보유하지 않은 버전으로 지정된 카탈로그 엔터티에 관한 것이고, 이것은 capability를 렌더링하는 플러그인을 선택하는 일에 관한 것입니다.

출력되는 메시지:

no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it (Recipe의 provider 버전 고정을 만족하는 provider 렌더링 플러그인 버전이 없음: capability가 버전을 고정하지만 이를 제공하는 provider 렌더링 플러그인이 없음) no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it (Recipe의 provider 버전 고정을 만족하는 provider 렌더링 플러그인 버전이 없음: capability가 버전을 고정하지만 이를 만족하는 제공 플러그인 버전이 없음)

해결 방법: Recipe의 capability: 필드에 있는 고정을 넓히거나 바로잡거나, 고정이 요구하는 플러그인 버전을 카탈로그에 추가합니다. 캐럿 고정은 같은 메이저 안에서 하한 이상인 버전과 일치하므로, ^2.0.0 고정은 아무리 최신이라도 1.x 플러그인으로는 만족되지 않습니다. 메시지가 capability를 제공하는 것이 없다고 하는 경우, 문제는 고정이 아닙니다. 플러그인 자체가 없는 것이며, 고정을 제거해도 도움이 되지 않습니다.

No plugin advertises a requested parse or import format (요청된 parse 또는 import 형식을 알리는 플러그인이 없음)

형식이 요청되었지만 이를 알리는 플러그인이 없습니다. 형식으로 라우팅하는 두 소켓은 각각 고유한 조건을 가지며, 요청된 작업만 다릅니다. parser 플러그인은 외부 소스 형식을 읽고, importer 플러그인은 외부 콘텐츠를 Aggrega 엔터티로 가져옵니다.

형식 공간은 열려 있으며 전적으로 플러그인에 속합니다. 어느 소켓도 컴파일러가 아는 형식 목록을 갖고 있지 않습니다. 플러그인은 자신이 처리하는 형식을 capability로 선언하고, 새 형식은 컴파일러를 변경하지 않고 새 플러그인으로 제공됩니다. 따라서 이 중단은 고정된 열거가 아니라 현재 알려진 집합을 그대로 보고하며, 모든 불일치는 명시적으로 드러납니다. 요청에 알리는 플러그인이 있거나, 아니면 요청을 이행할 수 없습니다. 아래에서 설명하는, 컴파일러가 내장한 parser라는 단 하나의 예외를 제외하면, 없는 플러그인을 대신하는 것은 없습니다.

출력되는 메시지:

no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" (요청된 형식을 알리는 parser 플러그인이 없음: 해당 parse 형식을 알리는 parser 플러그인이 없음) no importer plugin advertises the requested format: no importer plugin advertises "import:<format>" (요청된 형식을 알리는 importer 플러그인이 없음: 해당 import 형식을 알리는 importer 플러그인이 없음)

형식을 알리지만 해석할 수 없는 버전 형태를 가진 단일 parser 플러그인은 조용히 통과시키지 않고 알리는 플러그인이 없는 것으로 취급되며, 그렇게 표시됩니다:

no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>" (요청된 형식을 알리는 parser 플러그인이 없음: 해당 parse 형식에 대해 해석되는 parser 플러그인 버전이 없음)

파싱은 컴파일러가 내장한 parser로 대체합니다. 빌드는 render-verdict 정책에 넘기는 각 파일 중 정책이 기본적으로 읽지 못하는 형식의 파일을 파싱하고, importer는 자신이 지정하는 구문의 parser를 통해 소스를 읽으며, 형식을 지정하지 않은 import는 적용 가능한 각 시그니처가 지정하는 구문으로 소스를 파싱합니다. 각 구문에 대해 워크스페이스의 카탈로그가 제공하는 parser가 사용되고, 카탈로그가 제공하지 않는 경우에는 컴파일러 자체가 내장한 parser가 사용됩니다. 빌드가 Terraform 출력을 읽는 데 사용하는 HCL parser와 컴파일러의 core importer가 사용하는 JSON parser도 그중 하나이므로, Terraform 출력에 대한 정책이든 core importer를 통한 import든 카탈로그에 parser가 필요하지 않습니다. 카탈로그가 어떤 구문의 parser를 제공하는 경우 컴파일러 자체의 parser는 관여하지 않으며, 카탈로그에 이름이 다른 두 parser가 있으면 A parse or import format is advertised by more than one plugin (parse 또는 import 형식을 둘 이상의 플러그인이 알림)에서 설명하는 대로 거부됩니다. 따라서 이 중단은 카탈로그와 컴파일러 어느 쪽도 parser를 제공하지 않는 구문을 지정합니다.

해결 방법: 형식의 철자가 플러그인이 알리는 것과 같은지 확인합니다. capability는 소켓의 접두사와 형식 이름이므로, parse:hcl을 알리는 플러그인은 hcl 형식만 제공합니다. 그런 다음 빌드가 읽는 카탈로그에 플러그인이 있는지 확인합니다. 해당 형식의 플러그인이 존재하지 않는다면 그 플러그인이 빠진 부분입니다. 컴파일러는 아무것도 알리지 않는 형식을 읽을 수 없습니다.

A parse or import format is advertised by more than one plugin (parse 또는 import 형식을 둘 이상의 플러그인이 알림)

서로 다른 둘 이상의 플러그인이 같은 형식을 알리며, 어느 것을 사용할지 추측하지 않고는 요청을 라우팅할 수 없습니다.

둘 다 보유한 카탈로그는 유효하며 문제없이 로드됩니다. 두 게시자가 각각 한 형식의 parser나 importer를 제공할 수 있으며, 두 카탈로그를 연합하는 것은 지원되는 작업입니다. 모호성은 사용 시점의 조건입니다. 경합하는 형식이 실제로 요청될 때 중단되므로, 빌드의 범위 밖에 있는 경합 쌍은 빌드를 막지 않습니다.

모든 후보가 정렬된 상태로 나열되므로, 메시지는 실행할 때마다 같습니다.

출력되는 메시지:

format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] (둘 이상의 parser 플러그인이 형식을 알림: 해당 형식을 여러 parser 플러그인이 알림) format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>] (둘 이상의 importer 플러그인이 형식을 알림: 해당 형식을 여러 importer 플러그인이 알림)

importer의 경우 이 중단은 한 가지 형태로 더 발생합니다. 워크스페이스의 plugins.importer 항목이 그 형식을 알리는 importer를 둘 이상 연결하는 경우이며, 이때 메시지가 나열하는 importer는 연결된 것들입니다.

import가 선택하는 importer는 워크스페이스 카탈로그에 있는 것과, 모든 워크스페이스에서 자신의 형식을 알리는 컴파일러의 core importer입니다. 따라서 core importer가 제공하는 형식(import:langflow 또는 import:flowise)에 대해 다른 이름의 자체 importer를 보유한 카탈로그는, 둘 중 어느 것도 연결하지 않는 import에서 이 중단을 만나며, 메시지는 카탈로그의 importer와 함께 core importer를 나열합니다. 카탈로그가 core importer와 같은 이름으로 보유한 importer는 두 번째로 알리는 플러그인이 아닙니다. 한 이름 안에서는 가장 높은 버전이 선택되며, core importer와 같은 버전이면서 옆에 모듈이 있는 것은 core importer 대신 실행됩니다. 옆에 모듈이 없는 것은 실행할 수 있는 같은 이름의 importer가 그 형식을 알리는 경우 후보가 아닙니다. 이는 직접 작성한 importer와 함께 있을 때 어느 것이 실행되는가에서 설명합니다.

해결 방법: importer의 경우 둘 다 카탈로그에 두거나 자신의 것을 core importer와 함께 두고, 원하는 것을 연결합니다. aggrega plugin add importer가 작성하는 것처럼, uri가 식별자와 버전으로 그것을 지정하는 plugins.importer 항목(uri: importer/<name>:<version>)을 사용합니다. 연결된 importer는 그 형식을 알리는 것들 중에서 선택되며, 이는 아래의 “A capability is served by more than one provider plugin (capability를 둘 이상의 provider 플러그인이 제공함)“에서 설명하는 것처럼 plugins.providers 항목이 provider 소켓에서 capability를 제공하는 플러그인 중 하나를 선택하는 방식과 같습니다. 나열된 importer가 사용자의 항목이 연결한 것들이라면, 원하는 것의 항목은 남기고 다른 것은 제거합니다. parse 소켓에는 이러한 선택 기능이 없으므로, parser의 경우 해결책은 빌드가 읽는 카탈로그를 좁혀 원하는 플러그인만 남기는 것입니다. 선택한 플러그인이 있는 디렉터리를 --catalog로 가리키는 것이 직접적인 방법입니다.

A plugins.importer entry pins a version of its importer the catalog does not hold (이 항목이 카탈로그에 없는 임포터 버전을 고정합니다)

plugins.importer 항목이 임포터를 그 식별자와 버전(정확한 버전 uri: importer/<name>:1.2.0 또는 범위 uri: importer/<name>:^1.2.0)으로 연결하고 그 임포터가 임포트가 요청한 형식을 광고하지만, 임포트가 선택 대상으로 삼는 버전, 즉 워크스페이스의 카탈로그가 보유한 버전과 코어 임포터의 경우 컴파일러 자체 버전까지 포함한 버전 중 어느 것도 고정을 만족하지 않습니다. 정확한 버전이 없거나, 범위에 속하는 버전이 하나도 없는 경우입니다. 버전은 명시적인 선택이므로, 임포터의 다른 버전을 대신 실행하지 않고 어떤 임포터도 실행되기 전에 임포트가 거부됩니다.

이는 위에서 설명한, 형식을 광고하는 임포터가 없는 경우와 다릅니다. 여기서는 임포터가 임포트의 선택 대상이고 형식도 광고하며, 항목이 지정한 버전만 없습니다. :latest처럼 버전 고정이 취하는 어떤 형태에도 해당하지 않는 고정은 “A version pin is none of the forms a pin takes (버전 고정이 고정의 어떤 형태에도 해당하지 않음)”에서 설명하듯 형식이 잘못된 것으로 대신 보고됩니다.

형식의 capability와 항목이 고정한 버전을 명시하는, 출력되는 메시지:

no importer plugin version satisfies the plugins.importer entry’s version pin: capability "import:<format>" pins "<version>" but no serving plugin version satisfies it (plugins.importer 항목의 버전 고정을 충족하는 임포터 플러그인 버전이 없음: 해당 capability가 버전을 고정하지만 이를 충족하는 제공 플러그인 버전이 없음)

해결 방법: 항목의 uri에 있는 버전을 카탈로그가 보유한 버전(코어 임포터의 경우 컴파일러 자체 버전도 해당)으로 변경하거나, 범위를 넓히거나, 항목이 지정한 버전을 카탈로그에 추가합니다. 캐럿 범위는 같은 메이저 버전 안에서 하한 이상의 버전과 일치하므로, ^2.0.0은 아무리 최신이라도 1.x 임포터로는 만족되지 않습니다.

A plugin reference carries a registry host or an artifact path (플러그인 참조에 레지스트리 호스트나 아티팩트 경로가 포함됨)

Plugin 참조가 레지스트리 호스트 형태의 세그먼트(DNS 이름이나 호스트와 포트처럼 점이나 콜론을 포함한 세그먼트) 또는 아티팩트 경로로 시작합니다. Plugin은 좌표 식별자, 즉 플러그인 유형, 슬래시, 이름, 그리고 선택적으로 버전으로 지정됩니다. pull은 구성된 레지스트리와 플러그인 경로를 직접 앞에 붙여 그 식별자를 물리적 위치에 바인딩하므로, 이미 이를 포함한 참조는 두 번 접두사가 붙어 가져올 수 없는 위치에 바인딩됩니다.

가져오는 시점이 아니라 위치가 구성되는 시점에 거부되므로, 나중에 읽기 어려운 태그 오류로 드러나는 대신 메시지가 작성한 내용을 그대로 명시합니다.

위치를 구성하던 pull로 감싸고 그 아래 줄에 해결책을 담은, 출력되는 메시지:

catalog: tier-3 pull <uri>: wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path: "<identity>" (wasm 플러그인 참조는 레지스트리 한정 경로나 아티팩트 경로가 아니라 플러그인 좌표 식별자여야 함) remediation: remove the registry host and the artifact path, leaving the coordinate alone — <pluginType>/<name>:<version>, for example provider/helm:1.0.0; the pull prefixes the configured registry itself, so a reference that already carries one is prefixed twice (레지스트리 호스트와 아티팩트 경로를 제거하고 좌표만 남김. pull이 구성된 레지스트리를 직접 앞에 붙이므로, 이미 이를 포함한 참조는 두 번 접두사가 붙음)

해결 방법: 플러그인 유형 앞의 모든 것을 제거하고 좌표만 남깁니다. hub.example.com/plugin/provider/helm:1.0.0이 아니라 provider/helm:1.0.0입니다. 빌드가 가져오는 레지스트리는 식별자의 일부가 아니라 워크스페이스 구성이며, 덕분에 하나의 카탈로그를 그 안의 엔티티를 수정하지 않고 여러 레지스트리에서 제공할 수 있습니다.

A plugin or recipe reference carries no scope (플러그인 또는 레시피 참조에 범위가 없음)

Plugin 또는 Recipe 참조에 선행 범위 세그먼트가 없습니다. 슬래시가 아예 없거나, /name처럼 슬래시 앞이 비어 있는 경우입니다. 두 종류 모두 두 부분으로 식별되며, 첫 번째 부분이 같은 이름의 두 엔티티를 구분합니다. Plugin은 플러그인 유형과 이름으로, Recipe는 provider와 이름으로 식별됩니다. 두 소켓이 각각 redact라는 플러그인을 가질 수 있고, 두 provider가 각각 postgres라는 레시피를 제공할 수 있으므로, 범위는 장식이 아니라 식별자의 일부입니다.

빈 범위로 만든 위치에는 빈 경로 세그먼트(이중 슬래시)가 포함되어 해석될 수 없으므로, 나중에 읽기 어려운 가져오기 실패로 남기지 않고 위치가 구성되는 시점에 참조를 거부합니다.

두 해결책은 위의 한정된 플러그인 경우와도, 서로 간에도 반대이므로 각각 따로 기술합니다. 여기서는 참조에 세그먼트가 부족하여 하나를 추가하고, 한정된 참조는 세그먼트가 하나 더 있어 이를 제거합니다.

각각 pull로 감싸고 그 아래에 자체 해결책을 담은, 출력되는 메시지:

catalog: tier-3 pull <uri>: wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location: "<identity>" (wasm 플러그인 참조에는 pluginType 스코프가 있어야 하며, 빈 스코프는 OCI 위치에 바인딩할 수 없음) remediation: add the missing pluginType segment — write the reference as <pluginType>/<name>, for example provider/helm or governance/redact, using the pluginType the plugin entity declares under metadata.pluginType (조치: 누락된 pluginType 세그먼트를 추가하고, 플러그인 엔터티가 선언한 pluginType을 사용해 참조를 작성함)

catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" (레시피 참조에는 provider 스코프가 있어야 하며, 빈 provider는 OCI 위치에 바인딩할 수 없음) remediation: no local catalog directory held this reference, so it was looked for in the registry, where a provider segment is required; re-run as aggrega pull --release <release> --catalog <dir> so the directory that holds it is searched first (--catalog is repeatable) (조치: 이 참조를 가진 로컬 카탈로그 디렉터리가 없어 provider 세그먼트가 필요한 레지스트리에서 찾았음; 참조를 가진 디렉터리가 먼저 검색되도록 카탈로그 디렉터리를 지정해 다시 실행하며, 이 플래그는 반복해 지정할 수 있음)

해결 방법: 플러그인의 경우 Plugin 엔티티가 metadata.pluginType에 선언한 플러그인 유형을 앞에 붙입니다. 레시피의 경우 Recipe가 spec.capability에 선언한 provider를 앞에 붙입니다. 레시피 해결책은 읽어 볼 만한 두 번째 가능성을 제시합니다. 레지스트리에 도달했다는 것은 로컬 카탈로그 디렉터리를 먼저 검색했지만 어느 곳에도 참조가 없었다는 뜻이므로, 레시피가 로컬 디렉터리에서 와야 한다면 범위를 추가하지 말고 빌드가 그 디렉터리를 가리키도록 합니다.

The build consumes an artifact its publisher has deprecated (빌드가 게시자가 사용 중단한 아티팩트를 사용함)

이 빌드가 확인하는 참조에 게시자가 기록한 사용 중단 표시가 있으며, 그 표시의 심각도가 워크스페이스가 중단 임계값으로 구성한 심각도 이상입니다. 표시는 게시된 아티팩트에 사후에 첨부되므로, 어제 문제없이 빌드된 아티팩트라도 자신의 파일이 전혀 바뀌지 않은 채 오늘 표시를 가질 수 있습니다.

보고와 중단은 별개이며, 중단만 구성할 수 있습니다. 기록된 모든 표시는 모든 심각도에서 보고되며, 어떤 구성으로도 이를 끌 수 없습니다. 표시가 빌드를 중지시키는지 여부는 halt_on_deprecated_severity가 결정하며, 기록된 심각도를 구성된 임계값과 warning < error < retracted 순서로 비교합니다. 임계값이 구성되지 않으면 아무것도 중단되지 않고 모든 표시는 권고가 됩니다. 이 세 가지 밖의 심각도나 임계값은 결코 충족되지 않습니다. 잘못된 값은 중단을 일으킬 수도, 억제할 수도 없습니다.

빌드가 중지되기 전에 중단을 일으킨 것만이 아니라 모든 알림이 출력되므로, 임계값을 높여도 발견 사항을 놓치지 않습니다. 중단 자체는 중지된 단일 참조를 명시합니다. 발견 사항은 참조 순으로 정렬되므로, 같은 lockfile은 실행할 때마다 같은 순서를 보고하고 중단을 일으키는 항목도 항상 같습니다.

두 저장소를 검사하며 둘 다 같은 방식으로 보고합니다. lockfile이 고정하는 참조와, 수락 또는 거부 판정을 위해 신뢰된 것으로 기록된 플러그인입니다. 어느 검사도 레지스트리에 접근하지 않고 이미 기록된 내용만 읽으므로, 빌드는 AOT(ahead-of-time)로 유지됩니다.

출력되는 메시지입니다. 각 발견 사항은 순회되는 대로 출력되고, 이어서 중단이 임계값을 충족한 항목을 반복하며 빌드를 중지시킨 설정을 명시합니다:

deprecation: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run `aggrega pull` to refresh it)

deprecation: build consumes a deprecated entity: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run aggrega pull to refresh it): halt_on_deprecated_severity is "error"

두 권고 심각도 중 하나의 표시는 retracted 대신 deprecated (warning) 또는 deprecated (error)로 표시됩니다. 둘은 의미가 다르기 때문에 구분이 유지됩니다. 하나는 권장되지 않지만 여전히 선택 가능함을, 다른 하나는 선택에서 제외됨을 뜻하며, 더 강한 것을 약한 것으로 보고하면 실제로 일어난 일을 축소하게 됩니다.

해결 방법: 기록된 메시지를 읽고 마이그레이션합니다. 이 메시지는 무엇으로 옮겨야 하는지에 대한 게시자 자신의 설명입니다. 아직 마이그레이션할 수 없다면 halt_on_deprecated_severity를 높이거나 설정을 해제하면 중단이 계속 보이는 권고로 되돌아갑니다. 이는 우회책이 아니라 의도적인 수용이며, 알림은 계속 출력됩니다. 더 이상 사용하지 않는 버전에 기록된 표시는 aggrega pull로 lockfile을 새로 고치면 사라집니다.

A trusted plugin’s recorded digest disagrees with the cached artifact (신뢰된 플러그인의 기록된 다이제스트가 캐시된 아티팩트와 일치하지 않음)

빌드를 수락하거나 거부하는 역할로 첨부된 플러그인에 신뢰된 것으로 기록된 다이제스트가 있는데, 플러그인의 캐시된 manifest는 다른 다이제스트를 보고합니다. 둘은 플러그인의 실행 파일을 읽기 전에 비교되며, 불일치하면 그 자리에서 확인이 중지됩니다.

이 비교가 있기에 기록된 다이제스트는 단순한 재진술이 아니라 권위를 가집니다. 비교가 없으면 플러그인의 바이트는 바로 그 manifest에서 파생된 고정값과만 대조되고, 그 manifest의 바이트를 다시 검증하게 됩니다. 이는 구조상 자기 일관적일 뿐이며, 아티팩트 전체가 교체되었는지 알아챌 수 없습니다. 기록된 것과 manifest가 현재 보고하는 것을 비교함으로써 그 검사에 외부의 관점이 생깁니다.

이는 확인된 바이트가 그에 대해 주장된 다이제스트와 일치하지 않음을 보고하는 콘텐츠 다이제스트 불일치와는 다릅니다. 여기서는 아무것도 읽지 않았으며, 바이트는 manifest와 일치할 수도 있습니다. 불일치하는 것은 애초에 어떤 아티팩트가 확인되고 있는가입니다. 해결 방법이 정반대이므로 둘을 구분하는 것이 중요합니다. 하나는 손상되거나 변조된 아티팩트이고, 다른 하나는 새 아이덴티티가 아직 검토되지 않은, 정당하게 변경된 플러그인입니다.

출력되는 메시지:

resolve cached plugin "<plugin-identity>": the digest recorded as trusted for it is <recorded-digest>, but the plugin manifest in the content cache reports <cached-digest>; review what changed and re-record the trusted digest, or restore the recorded artifact: the digest recorded as trusted for this plugin does not match the digest its cached manifest reports

해결 방법: 무엇이든 다시 기록하기 전에 무엇이 바뀌었는지 확인합니다. 이 플러그인은 빌드를 거부할 수 있으며, 기록된 다이제스트는 누군가 이를 검토했다는 진술입니다. 플러그인을 의도적으로 업그레이드하여 변경이 예상된 경우라면 새 아티팩트를 검토하고 그에 대한 신뢰된 다이제스트를 다시 기록합니다. 예상되지 않은 경우라면 기록이 명시하는 아티팩트를 복원합니다. 이 불일치는 누구도 결정하지 않았는데 아이덴티티가 바뀌었음을 알려 주는 것입니다.

An extends: chain cannot be assembled (extends 체인을 구성할 수 없음)

Component, Feature, Manifest 또는 Release의 extends: 체인이 해석할 수 없는 부모를 지정하고 있어, 체인을 하나의 해석된 엔티티로 만들 수 없습니다.

이는 순환과 구별됩니다. 순환에는 별도의 조건과 해결 방법이 있으므로 위의 “Cyclic extends chain (순환 extends 체인)”을 참조하십시오. 또한 깊이 한도를 넘는 체인과도 구별되며, 이에 대해서는 아래에 별도의 조건이 있습니다. 그리고 부모는 존재하지만 버전만 존재하지 않는, 충족할 수 없는 버전 고정과도 구별됩니다.

출력되는 메시지이며, 해석할 수 없는 extends:를 가진 엔티티와 그 엔티티가 선언한 참조를 표시합니다:

inheritance merge failed (Component <name>, at .spec.extends, <entity> extends <reference>, which no catalog entity provides). Verify the extends reference names an entity present in the catalog (상속 병합 실패: 지정된 엔터티가 extends로 참조하는 대상을 제공하는 카탈로그 엔터티가 없습니다. extends 참조가 카탈로그에 있는 엔터티를 가리키는지 확인하십시오)

이를 보고하는 검사가 lockfile의 핀에 따라 아티팩트 캐시에서 부모를 읽는 경우, 즉 빌드와 aggrega validate --release의 extends 검사, 전체 카탈로그에 대한 aggrega validate, aggrega inspect, 그리고 편집기와 어시스턴트의 validate 도구에서 실행되는 같은 검사의 경우, 조언은 이어서 pull을 안내합니다: “a base published to a registry is fetched by aggrega pull --release <release>”(레지스트리에 게시된 베이스는 표시된 명령으로 가져옵니다). 단일 엔티티 파일을 검증할 때는 lockfile을 읽지 않으므로 pull을 실행해도 읽는 내용이 달라지지 않으며, 그 메시지는 카탈로그에서 끝납니다.

실패한 체인이 Feature의 체인인 경우 Component 대신 Feature가 표시됩니다. 루프와 마찬가지로, 먼저 표시되는 엔티티는 해석이 시작된 엔티티이고, 간선에 표시되는 엔티티는 열어 보아야 할 extends: 줄을 가진 엔티티입니다. 여러 단계로 이루어진 체인에서는 두 엔티티가 서로 다릅니다.

Manifest의 extends:는 다른 위치를 기준으로 해석되므로 다른 조언이 제시됩니다. Manifest는 카탈로그 콘텐츠가 아니라 Release 옆에 작성되는 운영자 구성이며, 그 extends:는 상대 경로 파일이나 Release 자체 디렉터리에 있는 Manifest의 metadata.name을 지정합니다. 카탈로그 엔티티를 지정하는 일은 없습니다. 따라서 메시지 끝에는 참조가 무엇으로 해석되지 못했는지와 대신 어디를 확인해야 하는지가 표시됩니다:

inheritance merge failed (Manifest <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path or the name of a Manifest in the Release’s directory (상속 병합 실패: extends 참조를 해석할 수 없습니다. extends 참조가 상대 경로이거나 Release 디렉터리에 있는 Manifest의 이름인지 확인하십시오)

끝에 붙는 세부 정보는 조회 자체가 보고한 실패, 즉 읽을 수 없었던 파일이나 해당 이름의 Manifest를 하나도 색인하지 못한 스캔이므로, 대개 두 형식 중 어느 것을 시도했고 왜 결과가 비었는지를 알려 줍니다.

Release의 extends:는 디렉터리를 기준으로 해석되며, 한 가지 형식만 허용합니다. Release는 부모를 ./base-release.yaml 또는 ../shared/base-release.yaml과 같은 상대 경로로 지정합니다. 기준이 되는 디렉터리는 참조를 작성한 Release가 있는 디렉터리이며, 체인의 각 링크는 자신의 디렉터리를 기준으로 해석됩니다. 따라서 하위 디렉터리에 둔 체인 중간의 Release는 명령이 지정한 Release가 어디에 있든 자기 옆에 있는 부모를 지정합니다. 단순 토큰은 경로가 아니며 컴파일러가 찾을 Release를 지정하지 않으므로, 찾을 수 없는 곳에서 검색하지 않고 여기에서 보고됩니다:

inheritance merge failed (Release <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path to a Release file, such as ./base-release.yaml, resolved from the directory holding this Release (상속 병합 실패: extends 참조를 해석할 수 없습니다. extends 참조가 이 Release를 담은 디렉터리를 기준으로 해석되는, ./base-release.yaml 같은 Release 파일의 상대 경로인지 확인하십시오)

해결 방법: Component 또는 Feature의 경우, extends: 값이 카탈로그에 있는 엔티티를 그 엔티티의 metadata.name 그대로, 대소문자까지 일치하게 지정하는지 확인하십시오. 레지스트리에 게시된 베이스는 Release의 lockfile이 그에 대해 기록한 핀에 따라 아티팩트 캐시에서 읽히므로, 베이스가 레지스트리에 있는 경우 aggrega pull --release <release>를 실행하십시오. pull은 체인을 따라가 베이스를 가져오고 핀으로 고정합니다. Manifest의 경우, 상대 경로가 가리키는 위치에 파일이 있는지, 또는 해당 metadata.name을 가진 Manifest가 Release 디렉터리에 있고 파싱되는지 확인하십시오. Release의 경우, 값이 ./ 또는 ../로 시작하는지, 그리고 가리키는 파일이 존재하며 Release로 파싱되는지 확인하십시오.

An extends: chain runs past the depth bound (extends 체인이 깊이 한도를 넘음)

Component, Feature, Manifest 또는 Release의 extends: 체인이 정상적으로 끝나지만, 한도인 10개보다 많은 엔티티를 거칩니다.

이 오류는 위의 조건을 공유하지 않고 별도의 조건을 가집니다. 두 해결 방법에 공통점이 없기 때문입니다. 부모가 없는 경우는 바로잡아야 할 참조이고, 지나치게 깊은 체인은 평탄화해야 할 구조입니다. 이 한도는 구조적 제한이 아니라 작성 실수를 막기 위한 안전장치입니다. 아키텍트는 보통 기준선을 한두 단계 확장하며, 깊이가 10인 체인은 대개 의도한 설계가 아니라 점점 커진 기반 트리입니다.

끝나는 체인만 이 조건에 도달합니다. 자기 자신으로 되돌아가는 체인은 길이와 관계없이 루프로 보고되므로, 이 조건이 순환을 대신하는 일은 없으며 체인을 줄이라는 조언이 순환에 대해 제시되는 일도 없습니다.

출력되는 메시지이며, 한도와 체인이 도달한 길이를 표시합니다:

extends chain exceeds maximum depth (Component <name>, rule extends). the bound is 10 and this chain reaches <length>; shorten the chain, or extend a base that sits closer to its root (extends 체인이 최대 깊이를 초과합니다. 한도는 10입니다. 체인을 줄이거나 루트에 더 가까운 베이스를 확장하십시오)

실패한 체인이 그중 하나인 경우 Component 대신 Feature, Manifest 또는 Release가 표시됩니다. 한도는 extends를 선언하는 모든 종류에서 동일하게 10이며, 엔티티 사이의 링크가 아니라 체인에 있는 엔티티 수를 셉니다. 정확히 10개의 엔티티로 이루어진 체인은 빌드되며, 이 오류가 보고하는 것은 11번째 엔티티입니다. 따라서 기반을 확장하고 그 기반이 다시 기반을 확장하는 엔티티, 즉 엔티티 3개와 링크 2개인 경우 3에 도달한 것입니다.

해결 방법: 체인의 중간 부분을 합치십시오. 그렇게 깊은 체인은 대개 각 단계가 조금씩만 추가한다는 뜻이며, 여러 단계를 하나의 기반 엔티티로 합치는 것이 해결책이자 더 명확한 구조입니다. 단계들이 실제로 서로 다른 경우, 체인 아래쪽의 엔티티가 중간의 모든 단계를 거쳐 상속하는 대신 루트에 더 가까운 기반을 직접 확장할 수 있습니다. 그렇게 깊은 Manifest 체인은 대개 환경별 오버레이 스택이므로, 아무도 변경하지 않는 단계를 그것이 덮어쓰는 기반에 합치십시오.

An assertion name is declared twice along an extends: chain (extends 체인에서 assertion 이름이 두 번 선언됨)

엔티티와 그 엔티티가 확장하는 대상이 같은 이름으로 어서션을 선언하며, 두 어서션이 서로 다른 규칙을 선언합니다. 확장하는 엔티티의 어서션은 기반의 어서션에 추가될 뿐 대체하지 않습니다. 따라서 같은 이름이 서로 다른 두 규칙으로 두 번 선언되면 기반의 불변 조건이 조용히 폐기되며, 이는 엔티티를 확장하는 목적과 정반대입니다.

같은 이름을 동일한 규칙으로 선언하는 것은 충돌이 아니며 빌드됩니다. 이 덕분에 체인에서 검사가 멱등성을 유지합니다. 그렇지 않으면 깊이가 3인 체인은 매번 자신의 중간 단계와 충돌하게 됩니다.

순서는 부수적인 것이 아니라 계약의 일부입니다. 어서션은 병합된 순서로 평가되고 처음 실패한 어서션에서 중단되므로, 기반의 불변 조건이 하위 엔티티의 것보다 먼저 검사되며, 체인에서는 루트부터 아래로 집합이 누적됩니다.

출력되는 메시지:

assertion name declared twice across the extends chain (Component <name>:<version>, rule assertions, at .spec.assertions.<key>). assertion "<key>" is already declared by the base Component "<base>", carrying a different rule; rename the extending entity’s assertion; an extending entity’s assertions add to the base’s and never replace one (extends 체인에서 assertion 이름이 두 번 선언되었습니다. 해당 assertion은 베이스 Component에서 다른 규칙으로 이미 선언되어 있습니다. 확장하는 엔터티의 assertion 이름을 바꾸십시오. 확장하는 엔터티의 assertion은 베이스의 assertion에 추가될 뿐 대체하지 않습니다)

해결 방법: 확장하는 엔티티의 어서션 이름을 변경하십시오. 메시지에 해당 어서션과 이를 이미 선언한 기반이 표시됩니다. 기반의 규칙을 대체하려던 것이라면, 이는 확장이 지원하지 않는 기능입니다. 기반의 어서션을 이를 확장하는 모든 엔티티에 대해 성립하도록 좁히거나, 규칙을 실제로 필요한 엔티티로 옮기십시오. 두 규칙이 같아야 하는 경우라면 텍스트를 완전히 동일하게 만들면 충돌이 사라집니다.

Release는 Aggregate의 컴포넌트를 두 방식 중 하나로 라우팅합니다. boundaries: 아래의 이름 있는 경계 또는 components: 아래의 최상위 컴포넌트입니다. 두 방식은 상호 배타적이며, 둘 다 선언하는 단일 문서는 읽을 때 거부됩니다. 이 조건은 extends: 체인 전체에 걸친 같은 규칙입니다. 이름 있는 경계를 선언하는 베이스와 최상위 컴포넌트를 선언하는 자식은 각각 그 자체로는 올바른 형식이며, 둘을 합칠 때에야 두 선택이 하나의 해석된 Release에 함께 들어갑니다.

어느 문서도 그 자체로는 잘못되지 않았으며, 그래서 메시지는 두 문서와 두 키를 모두 지정합니다. 빌드가 가리킨 Release만 지정하는 진단은 아무 문제가 없는 파일로 안내하게 됩니다.

링크가 일치하는 체인은 영향을 받지 않습니다. 모든 링크가 이름 있는 경계를 선언하면 정상적으로 구성되며, 모든 링크가 최상위 컴포넌트를 선언하는 경우도 마찬가지입니다. 멈추는 것은 혼합된 경우입니다.

두 파일과 각 파일이 선언하는 키를 지정하는 출력 메시지입니다:

release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both (Release <release-file>, boundaries declared by "<file>", components declared by "<file>") (release extends 체인이 이름 있는 경계와 최상위 컴포넌트를 모두 구성합니다. 체인 전체에 하나의 라우팅 형태만 선언하고 둘 다 선언하지 마십시오. Release 파일, 경계를 선언한 파일, 컴포넌트를 선언한 파일이 표시됩니다)

해결 방법: 체인이 사용할 라우팅 형태를 선택하고 끝까지 그 형태로 작성합니다. 베이스가 이름 있는 경계를 선언하는 경우, 컴포넌트를 구성하려는 자식은 Release 루트가 아니라 해당 컴포넌트를 담은 경계 안에서 지정합니다. 이렇게 하면 토폴로지를 다시 기술하지 않고도 한 컴포넌트의 크기를 바꿀 수 있습니다. 베이스가 최상위 컴포넌트를 선언하는 경우, 이름 있는 경계가 필요한 자식은 베이스와 다른 라우팅 형태를 기술하는 것이므로 그 Release의 자식보다는 별도의 Release로 작성하는 것이 좋습니다.

An external input’s URL uses a scheme that is not allowed (외부 입력의 URL이 허용되지 않는 스킴을 사용합니다)

엔터티가 가리키는 URL이 허용된 집합 밖의 스킴을 사용합니다. 허용되는 스킴은 세 가지입니다. https, 루프백 호스트에 한해서만 허용되어 평문 통신이 로컬 머신에만 도달할 수 있는 http, 그리고 레지스트리에서 가져오는 콘텐츠를 위한 oci입니다.

루프백이 아닌 http URL과 그 밖의 스킴에 대해 출력되는 메시지:

externalinputs: "<url>": plain http is allowed for loopback hosts only (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (일반 http는 루프백 호스트에만 허용됩니다(허용 스킴: https, 루프백 호스트로의 http, oci): URL 스킴이 허용되지 않습니다) externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (스킴이 허용되지 않습니다(허용 스킴: https, 루프백 호스트로의 http, oci): URL 스킴이 허용되지 않습니다)

해결 방법: URL을 https로, 또는 콘텐츠가 레지스트리에 게시되어 있다면 oci로 바꿉니다. 원격 호스트로의 일반 http URL은 다운그레이드되지 않고 거부되므로, 보안 스킴을 가리키게 하는 것이 해결책입니다. 루프백 호스트는 허용되므로 로컬 개발 서버는 http로 계속 동작합니다.

A render requests an external input the lockfile does not pin (렌더링이 lockfile에 고정되지 않은 외부 입력을 요청합니다)

빌드에 필요한 무언가를 lockfile이 고정하지 않은 URL에서 가져오려 합니다. 빌드는 lockfile이 기록한 클로저를 렌더링하며 아무것도 가져오지 않으므로, 이번 실행이 대신 그 URL을 획득하도록 허용하는 설정은 없습니다. 고정된 클로저가 빌드를 재현 가능하게 만드는 것이며, 입력 집합을 조용히 넓히는 것은 빌드가 결코 해서는 안 되는 일입니다.

따라서 이 중단에 도달하는 것은 구성 실수라기보다 정보를 주는 신호입니다. Release를 해석할 때 고정은 완전했으므로, 이제 고정되지 않은 URL이 있다는 것은 그 이후 무언가가 바뀌었다는 뜻입니다. 렌더링이 요청하는 참조를 좌우하는 값, 새로운 곳을 가리키기 시작한 차트, 또는 다른 Release를 기준으로 해석된 lockfile 등이 그 예입니다.

출력되는 메시지:

"<url>" is not pinned in the lockfile; run aggrega pull --release <release> to pin every external input this Release’s render consumes, then build again: externalinputs: acquisition is disabled for unpinned inputs (해당 URL이 lockfile에 고정되어 있지 않습니다. 위 명령을 실행하여 이 Release의 렌더링이 사용하는 모든 외부 입력을 고정한 다음 다시 빌드하십시오: externalinputs: 고정되지 않은 입력은 획득이 비활성화되어 있습니다)

해결 방법: 입력을 고정합니다. aggrega pull --release <path>는 Release를 렌더링하여 어떤 외부 입력을 사용하는지 파악하고, 각각을 가져와 그 다이제스트를 의존성 고정과 함께 lockfile에 기록합니다. 그 후의 모든 빌드는 고정된 기록에서 입력을 제공하며 네트워크가 전혀 필요하지 않습니다. 직접 작성한 무언가가 그 URL을 가리키기 시작해서 URL이 새로 생긴 경우라면, 건너뛴 단계는 Release를 다시 해석하는 것입니다. 예상치 못한 URL이라면 고정하기 전에 그것을 끌어들인 참조를 찾아볼 가치가 있습니다.

Fetched bytes do not match a pinned digest (가져온 바이트가 고정된 다이제스트와 일치하지 않습니다)

저장된 사본이 없어서 고정된 URL을 다시 가져왔는데, 돌아온 내용이 lockfile에 고정된 것과 다릅니다. 기록된 다이제스트가 항상 우선합니다. 저장소에는 아무것도 기록되지 않으며, 어떤 바이트도 반환되지 않습니다.

재충전은 URL의 태그가 아니라 기록된 다이제스트로 가져오므로, 다른 콘텐츠를 가리키도록 옮겨진 태그가 고정된 항목이 제공하는 내용을 바꿀 수 없습니다. 따라서 이 중단에 도달했다는 것은 다이제스트 뒤의 콘텐츠 자체가 온전히 돌아오지 못했다는 뜻입니다.

레지스트리에서 가져온 콘텐츠와 HTTPS로 가져온 콘텐츠에 대해 출력되는 메시지:

externalinputs: "<url>": refilled manifest digest is <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (재충전된 manifest 다이제스트와 고정된 다이제스트가 다릅니다: 가져온 바이트가 고정된 다이제스트와 일치하지 않습니다) externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (다시 가져온 바이트의 해시와 고정된 다이제스트가 다릅니다: 가져온 바이트가 고정된 다이제스트와 일치하지 않습니다)

해결 방법: 갱신할 lockfile로 보기 전에 먼저 공급망 문제로 다룹니다. 고정은 바로 이 바이트를 기준으로 빌드했다는 진술이며, 거부는 그 진술이 유지되고 있다는 것입니다. 소스가 여전히 다이제스트가 가리키는 콘텐츠를 게시하는지 확인하고, 중간에서 응답을 다시 쓰는 것이 있는지 점검합니다. 대체 콘텐츠를 제공하는 프록시나 미러가 흔한 원인입니다. 무엇이 바뀌었는지 알고 이를 받아들인 뒤에만 새 다이제스트를 기록하는 aggrega pull로 다시 고정해야 합니다.

A stored external input no longer matches its record (저장된 외부 입력이 더 이상 기록과 일치하지 않습니다)

고정된 입력을 로컬 저장소에서 다시 읽었는데 그에 대해 고정된 기록과 일치하지 않습니다. 이 검사는 바이트를 제공하기 전 매번 읽을 때마다 실행되므로, 손상되거나 변조된 저장소는 조용히 빌드에 사용되지 않고 사용 시점에 드러납니다.

무엇을 비교하는지는 입력이 어떻게 고정되었는지에 따라 다릅니다. HTTPS로 가져온 콘텐츠는 페이로드를 해싱하여 고정되므로, 읽을 때마다 다시 해싱하고 두 다이제스트를 모두 보고합니다. 레지스트리에서 가져온 콘텐츠는 manifest 다이제스트로 고정되는데, 이 다이제스트는 페이로드를 직접 해싱하는 대신 레지스트리 자체의 manifest를 통해 페이로드를 확정합니다. 따라서 저장된 사본은 기록된 크기와 비교되며, 전체 다이제스트 검증은 획득 시점과 다이제스트로 주소를 지정하는 모든 재충전 시점에 이루어집니다.

출력되는 메시지:

externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record (저장소 blob의 sha256과 고정된 다이제스트가 다릅니다: 저장소 blob이 고정된 기록과 일치하지 않습니다) externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record (저장소 blob의 크기가 고정된 기록의 크기와 다릅니다: 저장소 blob이 고정된 기록과 일치하지 않습니다)

해결 방법: 문제가 된 blob을 저장소에서 삭제하고 다음 실행이 소스에서 다시 채우도록 합니다. 재충전된 내용은 기록되기 전에 기록된 다이제스트와 대조하여 검증됩니다. 그 재충전에서도 다이제스트 불일치가 보고되면, 불일치는 로컬이 아니라 업스트림에 있으므로 위 항목을 참고합니다. 여러 머신이 공유하는 저장소나 쓰기 도중에 만든 백업에서 복원한 저장소가 흔한 로컬 원인입니다.

A guard needs a catalog entity the build resolved and cannot see (가드가 빌드가 해석했지만 볼 수 없는 카탈로그 엔터티를 필요로 합니다)

의미 가드가 컴포넌트 타입 뒤의 카탈로그 엔터티에 접근했는데, 해석 단계에서 그 타입을 카탈로그 참조로 해석했음에도 가드에 주어진 뷰에 해당 엔터티가 없습니다. 실제로 해석할 수 없는 참조는 더 이른 해석 단계에서 중단되므로, 엔터티가 없는 상태로 가드에 도달했다는 것은 빌드의 해석된 집합과 가드의 뷰가 어긋났다는 뜻입니다.

빌드는 가드를 건너뛰지 않고 중단됩니다. 건너뛰면 검사가 사라졌다는 아무런 표시 없이 검사가 폐기되고, 가드가 다루던 컴포넌트는 검사받지 않은 채 통과하며 빌드는 성공을 보고하게 됩니다.

./ 또는 ../로 시작하는 상대 경로로 작성된 타입은 여기서 판정되지 않습니다. 타입은 절대 파일로 읽히지 않으므로 그러한 값은 어떤 카탈로그 엔터티도 지정하지 않으며, 더 이른 단계인 Release의 의존성이 해석될 때 카탈로그에 없는 참조로 거부됩니다. 이 중단에 도달하는 것은 단순 토큰 형태의 카탈로그 참조뿐입니다.

이 조건은 어디에서 충족되든 같은 문구로 보고되므로, 메시지는 이를 발생시킨 검사가 아니라 타입과 결함을 명시합니다.

또한 문서나 그 안의 키를 명시하지 않는데, 이는 의도된 것이며 이 중단이 다른 모든 중단과 다르게 읽히는 유일한 지점입니다. 다른 모든 중단은 해결하기 위해 편집할 파일과 필드를 위치로 제시합니다. 여기에는 그런 파일이 없으므로 위치를 제시하면 결함이 없는 키로 안내하게 됩니다. 대신 두 뷰가 일치하지 않는 타입을 보고하는데, 그것이 조사하는 사람에게 이 불일치를 재현 가능하게 해 주기 때문입니다.

출력되는 메시지:

the compiler’s own views of the catalog disagree (internal error: this build resolved a component type that the catalog it reads then held no entry for. This is a fault in the compiler rather than in an authored document, so there is nothing to correct in the Aggregate, the Release or the catalog. Please report it, naming the command that produced this build and the type the views disagree on: "<type>") (카탈로그에 대한 컴파일러 자체의 뷰가 일치하지 않습니다(내부 오류: 이 빌드가 해석한 컴포넌트 타입에 대해, 이후 읽은 카탈로그에 항목이 없었습니다. 이는 작성된 문서가 아니라 컴파일러의 결함이므로 Aggregate, Release 또는 카탈로그에서 수정할 것은 없습니다. 이 빌드를 생성한 명령과 뷰가 일치하지 않는 타입을 명시하여 보고해 주십시오))

해결 방법: 직접 작성한 파일에서는 고칠 것이 없습니다. 이는 작성한 내용의 결함이 아니라 컴파일러 내부의 불일치를 보고하는 것이며, 메시지가 명시하는 타입과 함께 결함으로 보고할 가치가 있습니다. 컴포넌트의 타입은 거의 확실히 문제가 없습니다.

A reference names no entity the catalog holds (참조가 카탈로그에 없는 엔터티를 가리킴)

빌드가 무엇이든 렌더링하기 전에, Release가 의존하는 엔터티 전체 집합을 순회하며 각각을 고정하므로 lockfile에는 빌드가 읽을 내용이 정확히 기록됩니다. 카탈로그가 응답할 수 없는 참조는 이 순회를 중단시킵니다. 그 참조에 대해서는 아무것도 고정할 수 없으며, 계속 진행하면 빌드가 나중에 필요로 하는 항목이 빠진 lockfile이 아무 알림 없이 기록됩니다.

거부 메시지는 참조와 그 참조가 수집된 위치를 명시합니다. 하나의 엔터티는 여러 곳에서 도달되며, 그 엔터티를 지정한 곳이 바로 수정할 곳이기 때문입니다. 라이브러리 참조는 수집 경로 없이 단독으로 보고됩니다. 라이브러리는 그것을 $ref 또는 $import하는 엔터티에서 도달되며, 실패한 이름 자체가 결함의 전부입니다.

카탈로그 엔터티에 대해 출력되는 메시지입니다. 뒷부분에는 해당 엔터티를 참조하는 위치가 나열됩니다:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>)

라이브러리의 경우:

resolve: no entity in the catalog matches this URI: library "<reference>"

그리고 provider 소켓에 바인딩된 플러그인의 경우입니다. 이 플러그인은 카탈로그 문서가 아니라 해당 플러그인을 담고 있던 워크스페이스 구성 키로 표시됩니다:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers)

카탈로그 디렉터리 아래의 파일이 어떤 카탈로그에도 없는 종류(예: 철자가 틀린 kind)로 참조가 요구하는 이름을 선언하는 경우, 이 실패 아래의 메모는 그 파일, 그 파일이 선언하는 종류, 카탈로그가 담는 종류를 명시하고 로컬 엔터티를 어디에서 읽는지에 대한 조언은 생략합니다. 이는 잠금 파일을 채우는 빌드에서도, 잠금 파일을 읽는 빌드에서도, 이 실패를 보고하는 다른 모든 표면에서도 마찬가지입니다. 거부된 카탈로그 파일과 그것이 설명하는 실패를 참조하십시오.

해결 방법: 메시지가 인용한 그대로 참조를 읽으십시오. 존재하지 않는 이름, 게시된 적 없는 버전, 워크스페이스가 가리키지 않는 레지스트리의 단순 이름은 모두 똑같이 여기에 도달하므로 다음 순서로 세 가지를 확인합니다. 철자를 바로잡고, 버전이 존재하는지 확인하고, 해당 엔터티를 보유한 레지스트리가 구성되어 있으며 접근 가능한지 확인합니다. 로컬에서 작성하는 엔터티라면 파일이 빌드가 순회하는 카탈로그 안에 있는지 확인하십시오.

aggrega pull 또는 aggrega build --auto-pull이 라이브러리 참조에서 멈추고, 아티팩트 캐시에 어떤 잠금 파일 항목도 고정하지 않고 어떤 카탈로그 디렉터리도 제공하지 않는 SchemaLibrary가 있는 경우, 메시지 뒤에 remediation: 줄이 이어지며 그러한 라이브러리를 각각 지목합니다. 캐시된 라이브러리는 잠금 파일 항목이 그 다이제스트를 보증하는 경우에만 카탈로그 콘텐츠로 간주되며, pull은 그 항목을 라이브러리를 제공하는 레지스트리에서 기록합니다. 오프라인 상태에서는 pull이 라이브러리를 가져올 수도, 그에 대한 항목을 기록할 수도 없으므로, 이 줄은 레지스트리에 연결할 수 있는 곳에서 aggrega pull --release <release>를 실행하거나 카탈로그 디렉터리 아래에 라이브러리를 작성하라고 안내합니다. 연결된 상태에서는 pull이 읽는 어떤 카탈로그 디렉터리나 레지스트리도 그 라이브러리를 제공하지 않으므로 기록할 항목이 없으며, 이 줄은 카탈로그 디렉터리 아래에 라이브러리를 작성하도록 안내합니다.

A library reference is not written in the identity form (라이브러리 참조가 식별자 형식으로 작성되지 않음)

라이브러리 간 $ref: 또는 $import:는 라이브러리를 식별자로 지정한 다음 그 안의 항목을 지정합니다. 즉 라이브러리의 단순 이름, 선택적으로 :와 버전 하한, 그다음 #와 해당 필드가 읽는 표면상의 항목 경로입니다. 이 형식에는 레지스트리 호스트가 없습니다. 이름이 어느 레지스트리를 통해 해석되는지는 워크스페이스 구성이 정하고, 빌드가 어느 버전을 사용하는지는 lockfile이 답하므로, 둘 중 하나를 담은 참조는 빌드가 결정해야 할 것을 문서에 고정하게 됩니다.

여기서 거부되는 경우는 다음과 같습니다: 레지스트리 호스트를 포함한 값, 라이브러리 간 참조가 와야 할 자리에 작성된 문서 내 앵커, 빈 라이브러리 이름, 그리고 버전 구분자로 @를 쓴 경우입니다. 마지막 경우는 이 형식에서 가장 자주 발생하는 실수이므로, 일반적인 형태 오류가 아니라 수정된 표기와 함께 보고됩니다.

출력되는 메시지:

resolve: invalid library reference URI: "<the value as written>"

그리고 @가 구분자로 사용된 경우, 값이 대신 어떻게 되어야 하는지를 인용합니다:

resolve: invalid library reference URI: version separator is ’:’, not ’@’ — use "<the corrected value>"

해결 방법: 값을 <Library>#<entry-path> 형태로 다시 작성하고, 선택 가능한 버전에 하한이 필요한 경우에만 라이브러리 이름 뒤에 :<version>을 추가하십시오. 레지스트리 호스트는 모두 제거합니다. 참조가 같은 문서 내부를 가리키려던 것이라면, 문서 내 앵커는 라이브러리 참조와 다른 것이며 그것을 작성한 필드는 라이브러리 형식을 요구합니다.

Two consumers of one library require incompatible versions (한 라이브러리의 두 소비자가 호환되지 않는 버전을 요구함)

여러 엔터티가 하나의 라이브러리를 참조할 수 있으며, 각각 버전 하한을 지정하거나 전혀 지정하지 않습니다. 빌드가 선택하는 버전은 그중 가장 높은 하한입니다. 이 덕분에 더 낮은 버전을 요구하는 소비자도 자신을 만족하는 버전을 받으며, 더 높은 하한을 가진 소비자를 추가하면 빌드가 두 사본으로 나뉘는 대신 모두가 함께 올라갑니다.

이 규칙은 하한들의 선두 버전 번호가 일치할 때만 성립합니다. 서로 다른 메이저를 지정한 두 소비자는 우연히 이름이 같은 두 라이브러리를 요구하는 것이며, 둘 다 만족하는 단일 선택은 없습니다. 따라서 하나를 골라 다른 소비자가 자신이 대상으로 작성되지 않은 형태를 읽게 하는 대신, 빌드가 중단되고 불일치를 명시합니다. 하한을 지정하지 않은 소비자는 여기에 관여하지 않으며, 선택은 고정한 소비자들이 결정합니다.

출력되는 메시지입니다. 소비자는 정렬된 순서로 비교됩니다. 하한을 처음 지정한 소비자가 메이저를 정하고, 메시지는 다른 메이저를 지정한 첫 소비자까지(포함) 비교된 각 소비자를 그것이 요구한 버전과 함께 나열합니다. 따라서 같은 문서에서는 항상 같은 소비자가 표시됩니다:

resolve: minimal version selection conflict — incompatible library version requirements: library "<library>" has consumers requiring incompatible majors: <consumer> wants <version>; <consumer> wants <version>

해결 방법: 낮은 쪽 소비자의 하한을 같은 메이저로 올리십시오. 모두가 새 형태를 원하게 되었다면 이것이 일반적인 해법입니다. 두 메이저가 동시에 정말 필요하다면 그것은 두 개의 라이브러리입니다. 이전 형태를 별도의 이름으로 게시하고 그것이 필요한 소비자가 그쪽을 가리키게 하여, 각 참조가 자신이 대상으로 작성된 것을 지정하도록 하십시오.

The chain of module imports is deeper than the pin walk descends (모듈 import 체인이 고정 순회가 내려가는 깊이보다 깊음)

고정 과정은 Aggregate가 import하는 모든 모듈을 순회한 뒤, 그 모듈들이 import하는 모든 모듈을 순회하므로 첫 단계만이 아니라 전체 집합이 lockfile에 도달합니다. 이미 기록된 모듈은 다시 순회하지 않으며, 이것이 일반적인 순환을 끝냅니다. 자신을 다시 import하는 모듈을 import하는 Aggregate는 각각을 한 번씩 기록한 뒤 오류 없이 종료됩니다.

깊이 한계 10은 반복 감지가 볼 수 없는 체인을 막아 줍니다. 각 단계마다 새 버전으로 다시 게시되는 모듈처럼, 모든 단계에서 새로운 식별자를 내보이는 체인입니다. 이 한계는 그래프 빌더가 적용하는 것과 같으므로, 고정되는 구성은 빌드도 되는 구성입니다.

출력되는 메시지:

resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth>

해결 방법: 체인을 줄이십시오. 이렇게 깊은 체인은 대개 배포 구조가 아니라 조직 구조를 반영하므로, 자체 component를 제공하지 않는 단계를 찾아 상위 단계로 합치십시오. 각 단계가 하위 단계를 새 버전으로 다시 게시하기 위해서만 존재한다면 버전 자체가 체인입니다. 실제로 원하는 모듈을 원하는 버전으로 직접 import하십시오.

이것은 고정 순회의 한계입니다. 그래프 빌더는 자체 한계를 적용하며 이는 아래 “Sub-aggregate nesting depth exceeded”에서 보고됩니다. 두 가지는 같은 한계에 두 지점에서 도달한 별개의 보고로, 첫 번째는 lockfile을 채우는 동안, 두 번째는 그래프를 빌드하는 동안 발생합니다.

The catalog view a build was given cannot load the bodies pinning needs (빌드에 주어진 카탈로그 뷰가 고정에 필요한 본문을 불러올 수 없음)

고정 과정이 순회하는 축 중 두 가지는 카탈로그로부터 버전 응답 이상을 필요로 합니다. 문서 자체가 필요합니다. Aggregate가 import하는 모듈은 그 모듈들이 다시 import하는 것을 찾기 위해 읽어야 합니다. 빌드가 바인딩하는 Recipes, FeatureRecipes, Plugins는 그것들이 지정하는 아티팩트와 라이브러리를 찾기 위해 읽어야 합니다. 버전은 해석할 수 있지만 이러한 본문을 돌려줄 수 없는 카탈로그 뷰에서는 두 축 모두 읽을 것이 없게 됩니다.

두 경우 모두 건너뛰지 않고 처음부터 거부되며, 그 이유는 건너뛰었을 때의 결과 때문입니다. 한 부류의 항목 전체가 빠진 lockfile이 아무 알림 없이 기록되고, 이후 빌드가 이를 충실히 재구성한 뒤 불완전함을 발견하게 됩니다. 어느 메시지도 자체 값을 담지 않습니다. 어느 쪽도 작성한 문서에 관한 것이 아니기 때문이며, 각 메시지는 어떤 축을 계산할 수 없는지를 밝힙니다:

resolve: catalog lookup cannot load resolved sub-aggregate bodies resolve: catalog lookup cannot load resolved recipe and plugin bodies

해결 방법: 사용자의 파일 중 어느 것도 이 오류를 일으키지 않으며, 이를 해소하는 작성상의 변경도 없습니다. 결함은 빌드에 요청된 내용이 아니라 빌드가 연결된 방식에 있습니다. 실행한 명령과 그 명령이 사용한 워크스페이스 구성을 함께 보고하십시오.

An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (annotation-transform 플러그인이 전달받지 않은 컴포넌트를 지정하거나, 어떤 어노테이션도 받지 않는 값을 주입함)

운영자는 어노테이션을 추가하는 역할로 거버넌스 플러그인을 연결할 수 있으며, 그 연결은 하나의 선언입니다. 운영자가 변환을 요청한 것이므로 플러그인이 추가하는 내용은 누군가 모르게 주입되는 것이 아니라 명시적입니다. 이 역할은 그에 맞게 제한됩니다. 플러그인은 문서가 선언한 컴포넌트 좌표를 전달받고, 그 좌표에 어노테이션을 추가할 수 있으며, 각 어노테이션은 그 어노테이션에 직접 작성할 수도 있었던 값, 즉 문자열 또는 하위 키의 객체를 담습니다. 플러그인이 반환하는 형태는 다른 필드를 허용하지 않으므로, 출력이 적용될 때 남은 확인 사항은 모든 주입이 전달받은 좌표를 지정했는지, 그리고 모든 값이 어노테이션이 받는 값인지입니다.

그 집합 밖의 경계-컴포넌트 쌍을 지정하는 주입은 빌드를 중단합니다. 문서가 노출한 적 없는 컴포넌트에 플러그인이 접근한다면 아무도 선언하지 않은 인프라를 구성하는 것이 되며, 플러그인이 추가한 어노테이션은 작성된 어노테이션과 똑같이 Feature 연결로 확장되므로, 결과적으로 운영자가 플러그인에 내놓지 않은 컴포넌트에서 리소스가 나타나게 됩니다.

값이 null, 목록, 숫자, 불리언 또는 하위 키가 없는 객체인 주입도 빌드를 멈춥니다. null과 빈 객체는 컴포넌트가 상속받을 어노테이션에서 빠지기 위해 작성하는 값으로 읽히는데, 이 역할은 어노테이션을 추가할 뿐 제거하지 않습니다. 그 밖의 형태는 어노테이션이 받는 값이 아닙니다. 출력 전체가 그 일부라도 적용되기 전에 검사되므로, 거부된 출력은 아무것도 바꾸지 않습니다.

수락된 각 주입에는 이를 수행한 플러그인을 지정하는 동반 어노테이션 aggrega.ai/injected-by도 함께 붙습니다. 이 어노테이션은 호스트가 작성하며 플러그인은 이를 제공할 수 없으므로, 주입된 어노테이션의 출처에 대해 이 어노테이션이 말하는 내용은 플러그인이 좌우할 수 없습니다.

출력되는 메시지이며, 플러그인이 전달받지 않은 좌표의 경우와 어떤 어노테이션도 받지 않는 값의 경우입니다.

annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection targets boundary "<boundary>" component "<component>" (annotation "<key>") (annotation-transform 플러그인 출력이 거부됨: 주입이 호스트가 제공하지 않은 컴포넌트 좌표를 대상으로 하거나, 문자열도 하위 키의 객체도 아닌 값을 담고 있음: 주입 대상은 표시된 경계의 표시된 컴포넌트(표시된 어노테이션)) annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection for boundary "<boundary>" component "<component>" (annotation "<key>") carries a list; an injected annotation value is a string or an object of subkeys (annotation-transform 플러그인 출력이 거부됨: 주입이 호스트가 제공하지 않은 컴포넌트 좌표를 대상으로 하거나, 문자열도 하위 키의 객체도 아닌 값을 담고 있음: 표시된 경계의 표시된 컴포넌트(표시된 어노테이션)에 대한 주입이 목록을 담고 있음. 주입되는 어노테이션 값은 문자열 또는 하위 키의 객체임)

해결 방법: 결함은 문서가 아니라 플러그인에 있습니다. 플러그인이 전달받은 좌표에만 주입하고, 값으로는 문자열 또는 하위 키의 객체만 사용하도록 수정하십시오. 각 좌표는 플러그인의 입력에 들어 있습니다. 메시지의 컴포넌트가 플러그인이 볼 것으로 예상한 컴포넌트라면, Release가 그 컴포넌트를 경계 안에 선언하는지 확인하십시오. 선언된 컴포넌트 좌표만 전달됩니다. 플러그인을 수정하는 동안 빌드를 진행하려면 plugins.governance에서 연결을 제거하는 것이 즉각적인 방법입니다.

A plugin reference is not a Plugin entity (플러그인 참조가 Plugin 엔터티가 아님)

플러그인은 해당 Plugin 엔터티로 참조되며, 항상 플러그인 자체의 소켓 유형으로 범위가 지정됩니다. 즉 <pluginType>/<name> 형식이며, parser/yaml 또는 parser/yaml:1.0.0처럼 버전을 붙일 수도 있습니다. 범위는 여러 형식 중 하나가 아니라 필수입니다. 범위가 없는 name:version은 거부되는데, 두 소켓이 같은 이름의 플러그인을 가질 수 있으며 범위가 있어야 엔터티를 해석할 수 있기 때문입니다. 엔터티가 가리키는 바이너리는 엔터티를 통해서만 도달하며 직접 지정되지 않으므로, 기능 주장, 런타임 제한, 그리고 로드 시 바이너리와 대조하는 기록된 명령 집합을 담는 것은 엔터티입니다. 따라서 Plugin 엔터티를 지정하지 않는 참조는 바이너리를 대조할 대상이 없으며, 빌드는 확인되지 않은 참조로 바이트를 로드하는 대신 중단됩니다.

여기서는 두 가지 형태가 보고되며, 서로 다른 시점에 검사됩니다. 형식상 엔터티일 수 없는 참조(파일 시스템 경로, 또는 oci:// URL, 단독 .wasm, @sha256: 다이제스트 같은 아티팩트 참조)는 엔터티 참조만 받는 표면에서 처음부터 거부됩니다. 어디에도 보관된 엔터티를 지정하지 않는 참조는 조회 후에 거부되며, 메시지 내용은 참조가 작성된 방식에 따라 달라집니다. Plugin 엔터티 URI(<pluginType>/<name>, 버전은 선택 사항)는 어떤 카탈로그 디렉터리에도 없고, 바이너리에도 포함되어 있지 않으며, 어떤 pull도 가져오지 않은 엔터티로 보고되고, 그 밖의 참조는 그 형식을 사용하라는 안내를 받습니다. 두 형태 모두 같은 조건을 보고하므로, 어느 쪽이든 빌드의 대응은 같습니다.

pull은 빌드가 두 번째 형태를 만나기 전에 이를 거부합니다. Recipe 또는 FeatureRecipe의 pipeline이 지정하는 모든 Plugin은 Release의 나머지 종속성과 함께 카탈로그 디렉터리, 컴파일러 바이너리 내부의 사본, 콘텐츠 캐시 또는 레지스트리에서 해석되며, 그 어디에도 없는 것은 aggrega pull이 lockfile을 쓰기 전에 이 조건과 같은 메시지로 중단시키고, 해당 파이프라인이 그것을 지정한 Recipe 또는 FeatureRecipe를 명시합니다.

모든 표면이 엔터티가 아닌 형식을 거부하지는 않습니다. 파이프라인 플러그인 표면은 엔터티 참조만 받습니다. 운영자가 플러그인을 직접 연결하는 표면은 어떤 형식이든 받아들이며, 엔터티가 아닌 참조는 아티팩트로 해석되도록 넘깁니다. 따라서 같은 참조가 한 연결 지점에서는 수락되고 다른 지점에서는 거부될 수 있으며, 그 차이는 참조가 아니라 표면에서 비롯됩니다.

출력되는 메시지. 파일 시스템 경로:

plugin reference is not a Plugin entity: "<reference>" is a filesystem path, but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (플러그인 참조가 Plugin 엔터티가 아닙니다: 참조가 파일 시스템 경로이지만, 파이프라인 플러그인은 플러그인 유형으로 범위가 지정된 Plugin 엔터티 URI여야 합니다)

아티팩트 참조:

plugin reference is not a Plugin entity: "<reference>" is an artifact reference (an oci:// scheme, a bare .wasm, or an @sha256: digest), but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (플러그인 참조가 Plugin 엔터티가 아닙니다: 참조가 아티팩트 참조이지만, 파이프라인 플러그인은 플러그인 유형으로 범위가 지정된 Plugin 엔터티 URI여야 합니다)

아무것도 보관하지 않은 Plugin 엔터티 URI:

plugin reference is not a Plugin entity: "<reference>" is a Plugin entity URI, but no catalog directory holds the entity it names, the binary does not carry it, and no pull has fetched it into the content cache; place the Plugin entity in a catalog directory, or publish it to a registry and run aggrega pull (플러그인 참조가 Plugin 엔터티가 아닙니다: 참조는 Plugin 엔터티 URI이지만, 해당 엔터티를 보유한 카탈로그 디렉터리가 없고, 바이너리에 포함되어 있지 않으며, 어떤 pull도 이를 콘텐츠 캐시로 가져오지 않았습니다. Plugin 엔터티를 카탈로그 디렉터리에 두거나, 레지스트리에 게시한 뒤 pull을 실행하십시오)

그리고 엔터티를 지정하지 않는 그 밖의 참조(플러그인 유형 범위가 없거나, 버전 앞에 /가 두 개 이상 있거나, 레지스트리 호스트를 포함한 참조):

plugin reference is not a Plugin entity: "<reference>" must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0); a bare .wasm reference or an artifact reference names no Plugin entity (플러그인 참조가 Plugin 엔터티가 아닙니다: 참조는 플러그인 유형으로 범위가 지정된 Plugin 엔터티 URI여야 합니다. 단독 wasm 참조나 아티팩트 참조는 Plugin 엔터티를 가리키지 않습니다)

해결 방법: 참조를 Plugin 엔터티의 소켓 유형 범위 식별자로 작성하고, 필요하면 버전을 붙이십시오. 즉 <pluginType>/<name> 또는 <pluginType>/<name>:<version>입니다. 파일이나 아티팩트를 직접 가리키고 있었다면, 그에 대한 Plugin 엔터티를 게시하거나 작성하고 대신 그것을 참조하십시오. 로드 시 검사하는 주장이 있는 곳이 엔터티이므로, 엔터티를 건너뛰는 동등한 형식은 없습니다. 메시지가 참조를 Plugin 엔터티 URI라고 말한다면 형식은 올바르고 엔터티가 없는 것입니다. 워크스페이스가 나열하는 카탈로그 디렉터리에 빌드된 .wasm과 함께 Plugin 엔터티를 두거나, 워크스페이스가 읽는 레지스트리에 플러그인을 게시하고 aggrega pull을 실행하여 콘텐츠 캐시로 가져오십시오. 그리고 지정한 버전이 실제로 존재하는지 확인하십시오.

A cached signature bundle does not match the digest recorded for it (캐시된 서명 번들이 해당 번들에 기록된 다이제스트와 일치하지 않음)

가져올 때 서명이 검증된 아티팩트는 그 사실을 lockfile 항목에, 또는 verdict 역할로 연결된 플러그인의 경우 plugins-trust.yaml의 항목에 서명 자료의 다이제스트로 기록하여 이어 가며, 서명 자료는 아티팩트와 함께 캐시됩니다. 빌드는 무엇이든 렌더링하기 전에, 읽는 항목 중 이를 기록한 모든 항목(모든 종류의 카탈로그 엔터티, 라이브러리, 플러그인)에 대해 캐시된 자료를 다시 읽고 다시 해시하며, 그 해시는 기록된 해시와 같아야 합니다. lockfile이 고정한 플러그인과 verdict 역할로 연결된 플러그인은 바이트가 로드될 때 자료가 다시 검사되며, 이것이 빌드 밖에서 플러그인을 로드하는 명령(aggrega lint --release와 aggrega validate --release 등)에까지 미칩니다. 번들이 없거나, 읽을 수 없거나, 다른 값으로 해시되면 검토된 자료가 현재 디스크에 있는 것과 다르다는 뜻이며, 실행은 기록 아래에서 서명 증거가 바뀐 아티팩트를 사용하지 않고 중단됩니다.

재검사는 해시 비교일 뿐 그 이상이 아닙니다. 서명을 다시 검증하지 않고, 네트워크에 접속하지 않으며, 신뢰 자료를 참조하지 않으므로 네트워크 접근이 전혀 없는 빌드에서도 유효합니다. 이 덕분에 한 번 검증된 아티팩트는 이후의 오프라인 빌드에서도 검증된 상태로 유지됩니다.

다음 pull이 이를 복구합니다. pull은 콘텐츠 캐시가 제공한 모든 항목에 같은 검사를 적용하며, 검사가 항목을 거부하면 서명 요구 사항이 무엇이든 아티팩트의 레지스트리에 서명을 다시 묻고(가져오는 아티팩트가 받는 것과 같은 검증을 거칩니다), 그 검증 결과를 항목에 기록하고, 그것이 가리키는 번들을 캐시하여 더 이상 다이제스트와 일치하지 않는 캐시 사본을 다시 씁니다. verdict 역할로 연결된 플러그인은 항목에 무엇이 기록되어 있든 모든 pull에서 다시 검증되며, 그 번들도 같은 방식으로 캐시됩니다. 따라서 콘텐츠 캐시가 제공한 항목에 대한 메시지는 그 pull을 지목합니다. 카탈로그 디렉터리, 컴파일러 바이너리 내부의 사본, 또는 Release 옆에서 읽은 항목은 레지스트리에 조회되지 않으므로, pull은 그 항목에 기록된 서명을 그대로 두며, 그 메시지는 pull을 지목하지 않습니다.

출력되는 메시지는 아티팩트, 캐시된 파일, 그리고 콘텐츠 캐시가 제공한 항목의 경우 이를 복구하는 pull, 서명을 기록하는 파일, pull하는 Release를 지목합니다. 빌드의 검사에서, 읽을 수 없거나 없는 경우:

artifact "<reference>": cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (아티팩트: 캐시된 서명 번들을 읽을 수 없습니다: 캐시된 서명 번들이 기록된 다이제스트와 일치하지 않습니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 레지스트리에서 아티팩트의 서명을 다시 검증하고, 이를 해당 파일에 기록한 뒤 서명이 가리키는 번들을 캐시합니다)

그리고 달라진 경우:

artifact "<reference>": cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (아티팩트: 캐시된 서명 번들의 다이제스트가 기록된 다이제스트와 다릅니다: 캐시된 서명 번들이 기록된 다이제스트와 일치하지 않습니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 레지스트리에서 아티팩트의 서명을 다시 검증하고, 이를 해당 파일에 기록한 뒤 서명이 가리키는 번들을 캐시합니다)

그리고 플러그인의 바이트가 콘텐츠 캐시에서 로드되는 경우, 그 출처도 함께 지목합니다:

plugin "<reference>" resolved from <source>: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (해당 출처에서 해석된 플러그인: 캐시된 서명 번들을 읽을 수 없습니다: 캐시된 서명 번들이 기록된 다이제스트와 일치하지 않습니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 레지스트리에서 아티팩트의 서명을 다시 검증하고, 이를 해당 파일에 기록한 뒤 서명이 가리키는 번들을 캐시합니다)

plugin "<reference>" resolved from <source>: cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (해당 출처에서 해석된 플러그인: 캐시된 서명 번들의 다이제스트가 기록된 다이제스트와 다릅니다: 캐시된 서명 번들이 기록된 다이제스트와 일치하지 않습니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 레지스트리에서 아티팩트의 서명을 다시 검증하고, 이를 해당 파일에 기록한 뒤 서명이 가리키는 번들을 캐시합니다)

<file>은 Release의 lockfile이거나 Release 디렉터리의 plugins-trust.yaml입니다. pull이 조회하지 않는 항목의 경우 메시지는 remediation: 앞에서 끝납니다.

조회할 레지스트리가 없는 pull은 대신 중단됩니다. 카탈로그 엔터티나 라이브러리는 레지스트리 없이 이름이 지정되며 워크스페이스의 default_registry를 통해 레지스트리에 바인딩됩니다. 워크스페이스가 레지스트리를 지정하지 않는 경우(서명이 기록될 때는 지정했지만 더 이상 지정하지 않는 경우), 항목을 다시 조회할 레지스트리가 구성되어 있지 않으므로 pull은 다음 빌드가 거부할 lockfile을 쓰지 않고 이 조건으로 중단하며, lockfile을 그대로 둡니다. 그 메시지에는 pull이 수행하던 단계 뒤에 다음이 포함됩니다:

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest (검증: 해당 항목에 빌드가 받아들이지 않는 서명이 기록되어 있으며, 이를 다시 확인할 레지스트리가 구성되어 있지 않습니다: 캐시된 서명 번들을 읽을 수 없습니다: 캐시된 서명 번들이 기록된 다이제스트와 일치하지 않습니다)

해결 방법: 엔터티 파일의 어떤 내용도 이 문제의 원인이 아닙니다. 캐시는 사용자가 아니라 빌드의 것입니다. 메시지가 지목하는 명령인 aggrega pull --release <release>를 실행하십시오. 이 명령은 아티팩트의 서명을 다시 검증하고 서명과 번들을 함께 기록하므로, 이를 캐시한 pull 이후 제거되거나 변경된 번들이 복구됩니다. 오프라인 상태에서는 그 pull이 중단됩니다. 복구하려면 레지스트리에 조회해야 하므로 오프라인 거부로 중단되거나, verdict 역할로 연결된 플러그인의 경우 pull이 플러그인의 레지스트리에서 .wasm을 해석하므로 그보다 먼저 플러그인의 .wasm을 해석할 수 없는 것으로 지목하며 중단됩니다. 그 한 번의 실행에 네트워크를 허용하면 복구됩니다. 항목을 조회할 레지스트리가 구성되어 있지 않다며 pull이 중단되면, default_registry를 아티팩트를 가져온 레지스트리로 설정하고 다시 pull하십시오. 워크스페이스가 해당 아티팩트의 서명 검증을 건너뛰는 경우, pull은 대신 항목에 서명을 기록하지 않으며, 빌드는 같은 설정에서 이를 허용합니다. 레지스트리가 제공하는 서명이 검증되지 않으면 pull은 그 검증 자체의 거부로 중단됩니다. 이는 기록된 서명과 게시자가 제공하는 자료가 실제로 일치하지 않는 것이며, 아티팩트를 게시하는 측에 문의할 문제입니다. 메시지가 pull을 지목하지 않는 항목(카탈로그 디렉터리, 컴파일러 바이너리 내부의 사본, 또는 Release 옆에서 읽은 항목)의 경우, 해당 항목에서 signature를 제거하십시오. 이러한 항목은 서명 요구 사항의 적용을 받지 않으므로 빌드가 진행됩니다.

A recorded signature was made for a different artifact (기록된 서명이 다른 아티팩트에 대해 만들어졌습니다)

서명은 자신이 어떤 아티팩트에 대해 만들어졌는지를 나타냅니다. pull이 아티팩트의 서명을 검증하면 그 사실을 아티팩트의 lockfile 항목에 — 또는 verdict 역할로 연결된 플러그인의 경우 plugins-trust.yaml의 해당 항목에 — 기록하고, 검증한 서명을 캐시합니다. 무엇이든 렌더링되기 전에 빌드는 콘텐츠 캐시가 제공한 모든 항목의 캐시된 서명에서 그 서명이 어떤 아티팩트에 대해 만들어졌는지를 읽으며, 이는 빌드 자체가 그 항목에 대해 읽은 아티팩트, 즉 콘텐츠 캐시에서 바이트 옆에 manifest가 보관된 아티팩트여야 하고, 항목이 기록하는 어떤 것도 기준이 되지 않습니다. 다른 아티팩트에 대해 만들어진 서명은 빌드를 중단시킵니다. 한 항목의 signature를 다른 항목에 복사하면 바로 이런 모습이 됩니다. 그 서명이 가리키는 캐시된 서명은 손상되지 않았고 — 여전히 그에 대해 기록된 digest와 일치하며 — 다른 항목의 아티팩트에 대해 만들어진 것입니다.

서명 요구 사항과 무관합니다. 기록된 서명은 서명이 요구되는지 여부와 관계없이 자신이 주장하는 바에 맞는지 확인되며, 이는 캐시된 서명이 기록된 digest와 일치하는지 확인하는 검사와 마찬가지입니다.

플러그인은 어디에서 로드되든 같은 방식으로 확인됩니다. lockfile이 고정하는 플러그인과 verdict 역할로 연결된 플러그인은 그 바이트가 콘텐츠 캐시에서 로드될 때 기록된 서명이 그 바이트를 읽어 들인 아티팩트에 맞는지 확인되며, 이 확인은 빌드 밖에서 플러그인을 로드하는 명령에도 적용됩니다. 여기에는 aggrega lint --release와 aggrega validate --release, 그리고 aggrega serve와 aggrega mcp를 통해 수행되는 같은 작업이 포함됩니다.

검사가 읽는 것과 구별할 수 없는 것. 검사는 캐시된 서명과 아티팩트 옆의 manifest를 읽고 해시를 비교합니다. 서명을 검증하지 않고, 네트워크에 접속하지 않으며, 신뢰 자료를 참조하지 않으므로 네트워크에 전혀 접근할 수 없는 빌드에서도 유효합니다. 검사는 pull이 받아들이는 두 형식 모두에서 서명이 어떤 아티팩트에 대해 만들어졌는지를 읽습니다. 하나는 아티팩트 자체에 대해 만들어진 서명으로, 툴체인의 자체 서명자가 만드는 형식이고, 다른 하나는 아티팩트를 명시하는 서명된 statement입니다. 따라서 한 항목에서 다른 항목으로 복사된 서명은 어느 형식이든 거부됩니다. 이는 pull이 받아들이는 모든 서명에 적용하는 것과 같은 읽기 방식입니다. pull은 검증은 되지만 이 읽기 방식으로 해당 아티팩트에 대해 만들어진 것을 찾을 수 없거나 아티팩트를 전혀 읽어 낼 수 없는 서명을 거부하므로, pull이 기록하는 서명 중 검사가 읽을 수 없는 것은 없습니다. 카탈로그 디렉터리, 컴파일러 바이너리 안의 사본 또는 Release 옆에서 읽은 항목에는 manifest가 없으므로, 기록된 서명은 기록된 digest에 대해서만 확인됩니다. 이 두 형식 어느 것도 아닌 형식으로 수동으로 캐시에 넣은 서명도 마찬가지입니다. 또한 어떤 서명도 검증되지 않으므로, 항목 자체의 아티팩트에 대해 작성되어 수동으로 캐시에 기록된 서명은 pull이 검증한 서명과 구별되지 않습니다.

다음 pull이 이를 복구합니다. pull은 콘텐츠 캐시가 제공한 모든 항목에 같은 검사를 적용하며, 검사가 항목을 거부하면 서명 요구 사항이 무엇이든 아티팩트의 레지스트리에 서명을 다시 요청하고, 그렇게 검증된 내용을 복사된 서명 대신 항목에 기록합니다. verdict 역할로 연결된 플러그인은 항목에 무엇이 기록되어 있든 pull할 때마다 다시 검증됩니다. 서명이 어떤 아티팩트에 대해 만들어졌는지 확인되는 것은 콘텐츠 캐시가 제공한 항목뿐이므로, 빌드나 플러그인 로드에서 이 조건으로 거부될 때는 언제나 그 pull이 명시됩니다.

출력되는 메시지는 항목, 서명을 기록하는 파일, 캐시된 서명, 빌드가 그 항목에 대해 읽은 manifest, 그리고 이를 복구하는 pull을 명시합니다. 빌드의 검사에서는 다음과 같습니다.

artifact "<reference>": signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names

그리고 플러그인의 바이트가 로드되는 경우에는 그 출처도 함께 명시합니다.

plugin "<reference>" resolved from <source>: signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names

<file>은 Release의 lockfile이거나 Release 디렉터리의 plugins-trust.yaml입니다.

요청할 레지스트리가 없는 pull은 대신 중단됩니다. 이는 캐시된 서명 번들이 더 이상 digest와 일치하지 않을 때와 같습니다. 카탈로그 엔티티나 라이브러리에 복사된 서명이 있고 워크스페이스가 이를 연결할 default_registry를 더 이상 지정하지 않으면, pull은 이 조건으로 중단되고 lockfile을 그대로 둡니다. 그 메시지에는 pull이 수행하던 단계 다음에 다음 내용이 포함됩니다.

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: signing: the recorded signature was made for a different artifact (cached signature bundle <path>, the artifact read has manifest <manifest-digest>)

해결 방법: 엔티티 파일의 어떤 내용도 이 문제의 원인이 아닙니다. 항목이 기록하는 서명이 다른 아티팩트의 것입니다. 메시지가 명시하는 명령인 aggrega pull --release <release>를 실행합니다. 이 명령은 레지스트리에서 항목 자체의 서명을 검증하고 복사된 서명 대신 이를 기록하며, lockfile 항목과 verdict 역할로 연결된 플러그인 모두에 동일하게 적용됩니다. 파일이 커밋되어 있다면 버전 관리에서 항목 자체의 기록된 서명을 복원하는 방법도 있습니다. 오프라인 상태에서는 pull이 중단됩니다. 복구하려면 레지스트리에 요청해야 하므로 오프라인 거부로 중단되거나, verdict 역할로 연결된 플러그인의 경우 그보다 먼저, pull은 플러그인의 레지스트리에서 해당 .wasm을 확인하므로 플러그인의 .wasm을 확인할 수 없는 것으로 명시하며 중단됩니다. 그 한 번의 실행에 네트워크를 허용하면 복구됩니다. 항목에 대해 요청할 레지스트리가 구성되어 있지 않다며 pull이 중단되면, default_registry를 아티팩트를 pull했던 레지스트리로 설정하고 다시 pull합니다. 워크스페이스가 해당 아티팩트의 서명 검증을 건너뛰는 경우 pull은 대신 항목에 서명을 기록하지 않으며, 빌드는 같은 설정 아래에서 이를 허용합니다.

No verified signature is recorded for an artifact that requires one (서명이 필요한 아티팩트에 검증된 서명이 기록되어 있지 않음)

레지스트리에서 아티팩트를 가져오는 pull은 해당 레지스트리의 신뢰 정책에 따라 아티팩트의 서명을 검증하고, 검증된 사실을 아티팩트의 lockfile 항목에 기록합니다. 빌드는 레지스트리에 접근하지 않으므로 다시 검증하는 대신 기록된 사실을 읽으며, 렌더링이 시작되기 전에 읽는 모든 항목을 pull이 아티팩트를 가져올 때 적용한 요구 사항에 비추어 확인합니다. 콘텐츠 캐시가 제공한 항목 중 서명이 필요한 아티팩트에 대한 항목이 검증된 서명을 기록하고 있지 않으면 빌드가 중단됩니다. 빌드가 렌더링에 사용하려는 아티팩트가 한 번이라도 검증되었다는 근거가 빌드가 가진 정보 어디에도 없기 때문입니다.

요구 사항은 설정 하나하나까지 pull의 것과 같습니다. 작업 공간 전체의 서명 정책이 아티팩트의 종류를 포함하는 경우, 또는 .aggrega-config.yaml에 있는 레지스트리 자체 항목이 서명을 요구하는 경우(자체 항목이 없는 hub.aggrega.ai의 경우에는 공식 허브의 내장 정책이 요구하는 경우) 서명이 필요합니다. 종류를 판별할 수 없는 아티팩트는 정책이 활성화되어 있으면 서명이 필요한 것으로 간주됩니다. pull이 서명 없는 아티팩트를 허용하게 하는 설정은 빌드도 그 항목을 허용하게 합니다. 최상위의 skip_signature_verification, 작업 공간 전체 정책이 요구하는 종류를 제외한 레지스트리 자체 항목의 같은 스위치, 그리고 advisory로 표시된 레지스트리가 그것입니다.

항목의 출처는 lockfile이 아니라 빌드에서 읽습니다. 콘텐츠 캐시가 제공한 모든 항목은 그 항목이 무엇을 기록하든 확인 대상이므로, 항목의 매니페스트 다이제스트를 서명과 함께 제거해도 면제되지 않습니다. 카탈로그 디렉터리, 컴파일러 바이너리 내부의 사본, 또는 Release 옆에서 읽은 항목은 확인 대상이 되지 않습니다. 레지스트리에서 오지 않은 바이트에는 레지스트리 서명이 존재하지 않기 때문입니다. 카탈로그 엔터티, 라이브러리, 플러그인 아티팩트 등 모든 섹션의 항목이 동일하게 검사되며, 검사에서 거부된 모든 항목은 같은 실행에서 함께 나열됩니다.

verdict 역할로 연결된 플러그인은 plugins-trust.yaml을 통해 같은 검사를 받습니다. ir-verdict 또는 render-verdict 역할의 plugins.governance 연결과 모든 plugins.linter 연결은 렌더링되는 바이트에 영향을 주지 않으므로 lockfile 항목이 없으며, 대신 lockfile 옆의 기록이 검증된 서명을 담습니다. 빌드가 콘텐츠 캐시에서 읽는 이러한 플러그인은 각각 같은 설정을 통해 같은 요구 사항을 적용받습니다. 해당 기록의 항목이 서명을 기록하고 있지 않으면 빌드가 중단되며, 플러그인에 대한 항목이 아예 없어도 마찬가지입니다. 기록을 삭제해도 면제되지 않습니다. 카탈로그 디렉터리나 컴파일러 바이너리 내부의 사본에서 제공된 플러그인은 확인 대상이 아닙니다. 이 요구 사항은 빌드뿐 아니라 Release에 대해 이러한 플러그인을 로드하는 모든 곳에 적용됩니다. aggrega lint --release와 aggrega validate --release, 그리고 aggrega serve와 aggrega mcp를 통해 접근하는 같은 작업은 플러그인을 로드할 때 이 조건으로 실패합니다.

출력되는 메시지는 항목, 해당 항목에 대한 서명을 기록하지 않은 파일, 서명을 요구하는 설정, 그리고 그 파일에 서명을 기록하는 명령을 나열합니다. lockfile 항목의 경우 lockfile을 나열합니다.

signing: no verified signature is recorded for an artifact that requires one ("<reference>", <lockfile-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry and record it in <lockfile-path> (서명: 서명이 필요한 아티팩트에 검증된 서명이 기록되어 있지 않습니다. 해당 항목에 대해 lockfile에 서명이 기록되어 있지 않으며, 명시된 설정이 서명을 요구합니다. 조치: 위 명령을 실행해 레지스트리에서 아티팩트의 서명을 검증하고 lockfile에 기록하십시오)

verdict 역할로 연결된 플러그인의 경우 해당 기록을 나열합니다.

signing: no verified signature is recorded for an artifact that requires one ("<plugin>", <record-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the plugin’s signature at its registry and record it in <record-path> (서명: 서명이 필요한 아티팩트에 검증된 서명이 기록되어 있지 않습니다. 해당 플러그인에 대해 기록 파일에 서명이 기록되어 있지 않으며, 명시된 설정이 서명을 요구합니다. 조치: 위 명령을 실행해 레지스트리에서 플러그인의 서명을 검증하고 기록 파일에 기록하십시오)

두 파일 모두 명령에 지정된 Release 옆의 경로로 표시됩니다. <lockfile-path>는 Release의 lockfile이고, <record-path>는 Release 디렉터리의 plugins-trust.yaml입니다.

설정은 구성 파일 자체의 표현으로 표시됩니다. `signing.required` at the top level of the workspace configuration, `signing.required` on the `registries` entry for "<host>", 또는 the official hub's built-in signature requirement for "hub.aggrega.ai"이며, 둘 이상이 적용되면 함께 연결되어 표시됩니다.

해결 방법: 메시지가 지정하는 pull을 실행합니다. 콘텐츠 캐시가 제공하는 항목 중 서명이 필요한데 서명을 기록하지 않은 항목에 대해, pull은 가져오는 아티팩트에 대해서와 똑같이 항목에 기록된 매니페스트 다이제스트로 아티팩트의 레지스트리에 서명을 요청하고, 검증된 서명을 항목에 기록합니다. 그러면 다음 빌드가 이를 읽습니다. verdict 역할로 연결된 플러그인은 어떤 경우든 매 pull마다 확인되며, pull은 검증한 내용을 plugins-trust.yaml의 플러그인 항목에 기록하고 항목이 없으면 새로 만듭니다. 레지스트리가 서명을 첨부하지 않거나 신뢰 구성이 허용하지 않는 서명을 첨부하면 대신 해당 pull이 아티팩트를 나열하며 중단되며, 이는 그 아티팩트를 게시하는 쪽에 문의할 문제입니다. 오프라인 상태에서는 pull이 레지스트리에 요청할 수 없습니다. lockfile 항목에 대해서는 한 번의 실행에 네트워크를 허용하는 방법을 안내하며 거부하고, verdict 역할로 연결된 플러그인에 대해서는 요청하기 전에 중단하며 플러그인의 .wasm을 해석할 수 없는 것으로 표시합니다. pull은 그 .wasm을 플러그인의 레지스트리에서 해석하기 때문입니다. 캐시에 해당 기록이 가리키는 서명 자료가 아직 남아 있다면, 버전 관리에서 항목의 기록된 서명을 복원하여 네트워크 없이 해결할 수도 있습니다. 아티팩트가 서명될 대상이 아니라면 바꿔야 할 것은 요구 사항이며, 메시지가 어떤 설정인지 알려 줍니다. 다만 이를 완화하면 해당 레지스트리의 아티팩트가 pull에서도 더 이상 검사되지 않으므로, 요구 사항을 끄기보다 작업 공간 전체 정책의 종류를 좁히는 편이 좋습니다.

A recorded signature is not the one a pull would record (기록된 서명이 pull이 기록할 서명과 다름)

aggrega pull --verify는 지금 aggrega pull을 실행하면 pull이 커밋하는 파일이 바뀌는지 여부를 보고하며, pull이 아티팩트에 대해 검증한 서명은 pull이 기록하는 내용의 일부입니다. 즉 lockfile 항목의 signature와, verdict 역할에 연결된 플러그인의 경우 plugins-trust.yaml 항목의 서명입니다. 이 조건은 일반 pull이 다르게 기록할 각 기록된 서명에 대해 verify가 보고하는 것입니다. 기록된 서명이 없는 곳에 새로 기록할 서명, 교체할 서명, 또는 지울 서명이 이에 해당합니다. verify는 두 파일 모두 쓰지 않으며, 어느 파일에 있든 그러한 모든 항목을 같은 실행에서 명시합니다.

두 가지 lockfile 항목은 레지스트리에 묻지 않고 보고됩니다. 레지스트리가 어떻게 응답하든 pull이 이 항목들을 다시 쓰기 때문이며, 따라서 오프라인 상태에서도 보고됩니다. 하나는 신뢰 구성이 서명을 요구하는데도 서명을 기록하지 않은, 콘텐츠 캐시가 제공한 항목으로, pull은 아티팩트의 서명을 기록하거나 서명을 확보할 수 없으면 중단합니다. 다른 하나는 기록된 서명이 다른 아티팩트에 대해 만들어진 항목으로, pull은 이를 해당 아티팩트 자체의 서명으로 교체합니다.

pull이 다시 조회할 다른 모든 항목은 레지스트리에 묻습니다. pull이 그 항목을 바꿀지는 레지스트리의 응답만이 알려 주기 때문입니다. 콘텐츠 캐시에 바이트가 없어 verify가 가져온 항목, 그리고 캐시된 서명 번들이 제거되었거나 읽을 수 없거나 변경된 항목이 이에 해당합니다. verify는 pull과 같은 방식으로 레지스트리에 묻고, 응답에 따라 서명을 기록, 교체 또는 지우게 되는 항목을 보고하며, 검증한 번들을 pull과 같은 방식으로 캐시합니다. 오프라인 상태에서는 이러한 항목을 묻지 않고 보고하지도 않습니다. verify는 해당 항목을 명시하고 그 서명을 확인하지 않았다는 줄을 출력합니다.

플러그인 신뢰 기록의 경우, 모든 pull은 verdict 역할에 연결된 각 플러그인의 서명을 해당 레지스트리에서 검증하며 verify도 마찬가지입니다. 그 검증으로 서명이 기록, 교체 또는 지워질 항목이 보고되고, 기록에 항목이 없으며 서명이 기록되지 않았다는 이유로 빌드가 거부하는 플러그인도 보고됩니다. pull은 서명을 담은 항목을 쓰고, 그때까지 빌드는 해당 플러그인을 거부하기 때문입니다. 기록에 아직 없는 그 밖의 플러그인은 처음 발견된 것이므로 보고되지 않습니다. 오프라인 상태에서 verify는 이러한 플러그인에 대해 어떤 레지스트리에도 묻지 않습니다. 빌드가 읽는 것처럼 각 플러그인을 콘텐츠 캐시에서 읽고, 연결된 verify와 마찬가지로 그 식별자와 호스트 함수를 확인합니다. 서명이 기록되지 않았다는 이유로 빌드가 거부하는 플러그인(항목에 서명이 없거나 기록에 항목 자체가 없는 경우)과, 항목에 기록된 서명이 다른 아티팩트에 대해 만들어졌다는 이유로 빌드가 거부하는 플러그인은 묻지 않고 보고합니다. 레지스트리가 어떻게 응답하든 pull이 그 항목을 다시 쓰기 때문입니다. 그 밖의 모든 항목에 대해서는 해당 항목을 명시하고 그 서명을 확인하지 않았다는 줄을 출력합니다.

지원 중단 표시는 비교하지 않습니다. pull 이후 아티팩트에 붙은 표시는 레지스트리의 상태이며 작업 공간에서 아무것도 바뀌지 않아도 변하므로, 이 표시로 verify가 실패한다면 아무도 건드리지 않은 파일에 대한 검사가 실패하게 됩니다. 기록된 표시가 빌드를 중단시키지 않고 경고만 하는 이유도 이것입니다.

출력되는 메시지는 항목마다 하나씩이며, 항목, 파일과 그 파일이 기록한 내용, pull이 대신 기록할 내용, 그리고 파일을 최신 상태로 만드는 pull을 명시합니다. 레지스트리의 응답 또는 기록 자체의 검증이 pull이 기록할 서명을 알려 주는 경우:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: 기록된 서명이 pull이 기록할 서명과 다릅니다. 파일에 기록된 서명과 pull이 기록할 서명이 서로 다릅니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 파일을 최신 상태로 만드십시오)

서명이 요구되는데 서명을 기록하지 않은 항목(lockfile 항목, 또는 오프라인 상태에서 플러그인 신뢰 기록의 항목)의 경우:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records no signature, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: 기록된 서명이 pull이 기록할 서명과 다릅니다. 파일에 서명이 기록되어 있지 않으며, pull은 요구 사항이 요구하는 서명을 레지스트리에 요청하여 기록합니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 파일을 최신 상태로 만드십시오)

기록된 서명이 다른 아티팩트에 대해 만들어진 항목(lockfile 항목, 또는 오프라인 상태에서 플러그인 신뢰 기록의 항목)의 경우:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, made for another artifact, a pull would ask its registry for this artifact’s own signature and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: 기록된 서명이 pull이 기록할 서명과 다릅니다. 파일에 기록된 서명은 다른 아티팩트에 대해 만들어진 것이며, pull은 이 아티팩트 자체의 서명을 레지스트리에 요청하여 기록합니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 파일을 최신 상태로 만드십시오)

그리고 기록에 항목이 없으며 서명이 기록되지 않았다는 이유로 빌드가 거부하는 플러그인의 경우(두 번째 형식은 verify가 어떤 레지스트리에도 묻지 않는 오프라인 상태의 경우):

signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: 기록된 서명이 pull이 기록할 서명과 다릅니다. 기록 파일에 해당 플러그인의 항목이 없고 서명이 필요하며, pull은 서명을 기록합니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 기록 파일을 최신 상태로 만드십시오)

signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: 기록된 서명이 pull이 기록할 서명과 다릅니다. 기록 파일에 해당 플러그인의 항목이 없고 서명이 필요하며, pull은 요구 사항이 요구하는 서명을 레지스트리에 요청하여 기록합니다. 해결 방법: 해당 Release에 대해 pull을 실행하여 기록 파일을 최신 상태로 만드십시오)

<signature>는 서명을 그 방식, 서명자, 번들의 다이제스트로 나타내며(a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>, keyless 서명의 경우 서명자 뒤에 issued by <issuer>가 붙음), 또는 no signature입니다. <file>은 Release의 lockfile인 <lockfile-path>이거나, Release 디렉터리의 plugins-trust.yaml인 <record-path>입니다.

해결 방법: 메시지가 명시하는 pull을 실행합니다. pull은 메시지가 말한 서명을 명시된 파일에 쓰고 그 번들을 캐시하므로 다음 verify가 통과합니다. 메시지가 pull이 레지스트리에 묻는다고 하는 경우, pull은 레지스트리가 검증하는 내용을 기록합니다. 다만 레지스트리가 신뢰 구성이 허용하지 않는 서명을 붙이거나, 서명이 요구되는데 서명을 붙이지 않으면 아티팩트를 명시하며 대신 중단하며, 이는 그 아티팩트를 게시하는 측에 문의할 사안입니다. 오프라인 상태에서는 그 pull이 중단됩니다. lockfile 항목에 대해서는 레지스트리에 물어야 하므로 오프라인 거부로 중단하고, verdict 역할에 연결된 플러그인에 대해서는 그보다 먼저, 플러그인의 .wasm을 확인할 수 없는 것으로 명시하며 중단합니다. pull은 그 .wasm을 플러그인의 레지스트리에서 확인하기 때문입니다. 그 한 번의 실행에 네트워크를 허용하면 파일이 최신 상태가 됩니다. 메시지가 pull이 서명을 기록하지 않는다고 하는 경우, 레지스트리가 더 이상 서명을 붙이지 않고 아무것도 서명을 요구하지 않는 것입니다. pull은 항목의 서명을 지우며, 빌드는 같은 설정에서 이를 허용합니다. 레지스트리가 아티팩트 서명을 중단할 것을 예상하지 못했다면, 그 역시 게시자에게 문의할 사안입니다.

A plugin’s .wasm is not on this machine (플러그인의 모듈 파일이 이 머신에 없음)

플러그인의 .wasm은 다음 네 곳 중 하나에서 이 순서대로 읽습니다. 컴파일러 바이너리에 내장된 플러그인, 카탈로그 디렉터리에서 플러그인의 Plugin 엔터티 옆에 있는 파일, 참조가 명시하는 명시적 파일 시스템 경로, 그리고 aggrega pull이 채우는 작업 공간 콘텐츠 캐시입니다. 플러그인 확인은 이미 머신에 있는 것만 읽고 아무것도 가져오지 않으므로, 이 조건은 네 곳 중 어디에도 바이트가 없다는 것을 보고하며 다운로드가 실패했다는 뜻이 아닙니다. 한 가지 플러그인은 예외입니다. import에 필요한 core importer입니다. 그 모듈은 바이너리나 콘텐츠 캐시에서만 읽고 카탈로그 엔터티 옆에서는 절대 읽지 않으며, 둘 다 모듈을 갖고 있지 않으면 import가 작업 공간의 기본 레지스트리에서 한 번 가져옵니다. 이 경우 조건은 가져오기도 불가능했다는 것을 함께 보고합니다. 작업 공간이 오프라인이거나, 레지스트리에 연결할 수 없거나 레지스트리에 모듈이 없거나, 작업 공간이 기본 레지스트리를 명시하지 않은 경우입니다. 가져왔지만 검증되지 않는 모듈은 대신 그 자체의 조건(다이제스트 불일치 또는 서명 거부)으로 거부되며, 아무것도 보관되지 않습니다.

엔터티 옆의 파일 이름은 엔터티의 플러그인 유형과 이름으로 정해지며, 아래의 pull 거부 메시지가 그 이름을 알려 줍니다. pipeline-step/patch의 경우 엔터티 문서가 있는 디렉터리의 pipeline-step--patch.wasm입니다.

카탈로그 디렉터리 중 하나에서 작성한 Plugin 엔터티는 pull이 이를 해석할 때 거부됩니다. pull은 이러한 엔터티의 .wasm을 가져오지 않습니다. 위의 네 위치, 즉 빌드가 찾는 곳과 정확히 같은 곳을 찾아봅니다. 파이프라인 단계, 공급자 또는 판정 역할에 연결된 플러그인은 전혀 고정되지 않으며, 빌드는 매번 카탈로그 디렉터리에서 그 엔터티를 읽습니다. 변환 역할에 연결된 플러그인은 그 바이트가 렌더링 출력을 좌우하므로 고정됩니다. pull은 그 엔터티와 거기서 찾은 .wasm의 콘텐츠 다이제스트를 기록하고, 빌드는 더 이상 일치하지 않는 .wasm을 거부합니다. 따라서 네 위치 어디에서도 아티팩트를 찾지 못한 pull은 빌드가 나중에 플러그인을 로드하는 단계에서 실패하도록 두지 않고, lockfile이나 어떤 entity.lock도 쓰기 전에 그 자리에서 중단합니다. 바이너리에 포함된 .wasm이나 이미 콘텐츠 캐시에 있는 것은 빌드를 충족하는 것과 똑같이 pull을 충족하므로, 컴파일러에 내장되어 제공되는 플러그인의 엔터티는 옆에 파일이 필요하지 않습니다.

출력되는 메시지. 파일이 있을 것으로 예상한 디렉터리를 가리키고 그 아래에 해결 방법을 제시하는 pull의 거부 메시지:

plugin artifact not found on this machine (Plugin entity "<reference>" is authored in a catalog directory, expected <file> in <directory>). Place the built .wasm beside the entity under that name, or publish the plugin and reference the published Plugin entity instead of the one in the catalog directory (이 머신에서 플러그인 아티팩트를 찾을 수 없음(Plugin 엔터티가 카탈로그 디렉터리에서 작성되었으며, 해당 디렉터리에 해당 파일이 있어야 함). 빌드한 .wasm을 그 이름으로 엔터티 옆에 두거나, 플러그인을 게시하고 카탈로그 디렉터리의 엔터티 대신 게시된 Plugin 엔터티를 참조하십시오)

빌드나 import가 로드하는 플러그인의 바이트를 가진 소스가 없는 경우, 그리고 오프라인 상태의 aggrega pull --verify가 빌드처럼 콘텐츠 캐시에서 읽는 verdict 역할에 연결된 플러그인의 경우입니다. 플러그인의 Plugin 엔티티가 카탈로그 폴더에 있으면, 그 버전과 모듈을 둘 위치를 지목합니다.

plugin "<reference>" at version <version> is not on this machine; place its module, named <file>, beside its Plugin entity in <directory>: plugin artifact not found on this machine (해당 버전의 플러그인이 이 머신에 없습니다. 표시된 파일 이름으로 모듈을 표시된 디렉터리의 Plugin 엔티티 옆에 두십시오: 이 머신에서 플러그인 아티팩트를 찾을 수 없음)

그 밖의 경우에는 모듈을 찾아본 각 위치를 지목합니다.

plugin "<reference>" is not on this machine: the binary does not carry its module, no catalog folder holds its Plugin entity and the content cache a pull fetches into does not hold it: plugin artifact not found on this machine (플러그인이 이 머신에 없습니다: 바이너리에 모듈이 없고, 어떤 카탈로그 폴더에도 Plugin 엔티티가 없으며, pull이 가져오는 콘텐츠 캐시에도 없음: 이 머신에서 플러그인 아티팩트를 찾을 수 없음)

바이너리 안만 살펴보는 lint는 그 위치 중 첫 번째만 지목합니다.

레지스트리 위치로 작성된 참조의 경우도 마찬가지입니다:

plugin "<reference>" not resolvable: an OCI plugin URI requires a prior aggrega pull --release <release> (so its bytes are cached) or an explicit local path; plugin resolution does not fetch from a registry: plugin artifact not found on this machine (해당 플러그인을 해석할 수 없음: OCI 플러그인 URI에는 바이트가 캐시되도록 사전 pull을 실행하거나 명시적인 로컬 경로가 필요함. 플러그인 해석은 레지스트리에서 가져오지 않음: 이 머신에서 플러그인 아티팩트를 찾을 수 없음)

import가 읽지도 가져오지도 못한 core importer의 경우, importer와 그 버전, 이유(여기서는 작업 공간이 오프라인인 경우)를 명시하고, 이어서 그 모듈을 머신에 두는 방법을 명시합니다:

core importer "<importer>" at version <version> is not on this machine, and the workspace is offline, so its registry <host> is not asked for it; run the import once with the network available, which fetches it from the workspace’s default registry, verifies it and keeps it in the content cache for every later import, or place its module, named <file>, beside a Plugin entity of <importer> at <version> in a catalog folder: plugin artifact not found on this machine (해당 버전의 코어 임포터가 이 머신에 없고 워크스페이스가 오프라인이므로 레지스트리에 요청하지 않음. 네트워크를 사용할 수 있는 상태에서 import를 한 번 실행하면 워크스페이스의 기본 레지스트리에서 가져와 검증하고 이후 모든 import를 위해 콘텐츠 캐시에 보관함. 또는 해당 이름의 모듈을 카탈로그 폴더에 있는 해당 임포터·버전의 Plugin 엔터티 옆에 두십시오: 이 머신에서 플러그인 아티팩트를 찾을 수 없음)

다른 이유는 its registry <host> could not be reached (<cause>), its registry <host> holds no <location>:<version>, the workspace names no default registry to fetch it from으로 표시됩니다. 마지막 두 경우는 네트워크를 사용할 수 있는 상태에서 실행해도 바뀌지 않으므로 두 번째 해결 방법만 명시합니다.

해결 방법: 엔터티를 직접 작성한 경우, 플러그인을 빌드하고 그 .wasm을 메시지가 알려 주는 이름으로 엔터티 옆에 둡니다. 또는 aggrega push로 플러그인을 게시하고 카탈로그 사본 대신 게시된 엔터티를 참조합니다. pull도 빌드도 카탈로그에 있는 엔터티의 .wasm을 가져오지 않기 때문입니다. 레지스트리에서 사용하는 플러그인인 경우, 해당 release에 대해 aggrega pull을 실행하면 플러그인이 캐시됩니다. 컴파일러가 플러그인을 직접 포함하고 있을 것으로 예상한 경우, 실행하는 바이너리가 실제로 포함하는지 확인합니다. aggrega plugin list가 내장된 플러그인을 명시합니다. core importer인 경우, 작업 공간이 기본 레지스트리에 연결할 수 있는 곳에서 import를 한 번 실행합니다. 그 실행이 모듈을 가져와 검증하고 캐시하며, 이후의 모든 import는 오프라인으로 동작합니다. 또는 그 레지스트리에 모듈이 없는 경우, 카탈로그 폴더에서 해당 버전의 그 importer Plugin 엔터티 옆에 메시지가 알려 주는 이름으로 모듈을 둡니다. 그러면 그 엔터티가 core importer 대신 실행됩니다.

A plugin recorded as a trusted gate is no longer attached (신뢰된 게이트로 기록된 플러그인이 더 이상 연결되어 있지 않음)

빌드에 대해 승인 또는 거부 판정을 반환하는 플러그인은 해석되는 즉시 기록되므로, 워크스페이스에는 어떤 게이트가 검토되었는지에 대한 기록이 남습니다. 이 조건은 기록된 게이트를 더 이상 아무것도 연결하지 않을 때 보고됩니다. 이 조건이 조용히 통과하지 않고 빌드를 중단하는 이유는, 그렇지 않으면 그 출력이 게이트가 승인한 출력과 구별되지 않기 때문입니다. 게이트가 소리 없이 빠진 빌드와 게이트가 통과시킨 빌드는 같은 파일을 만들어 내며, 결과를 검토하는 누구도 자신이 어느 쪽을 들고 있는지 알 수 없습니다.

이는 바이트가 달라진 플러그인과는 다른 문제입니다. 그쪽은 검토된 플러그인이 아닌 플러그인의 실행을 거부하며, 이는 동일성의 문제입니다. 이쪽은 검토된 게이트가 아예 빠진 상태로 빌드하는 것을 거부하며, 이는 존재의 문제입니다. 따라서 해결 방법도 다릅니다. 한쪽은 아티팩트를 복원하고, 다른 쪽은 연결을 복원합니다.

이 검사가 보장하는 것과 보장하지 않는 것. 구성을 기록과 대조하면 기록된 모든 게이트가 여전히 연결되어 있고 각 게이트의 아티팩트가 기록된 것과 같다는 점이 보장됩니다. 그러나 연결된 게이트가 실제로 판정을 반환하는지에 대해서는 아무것도 보장하지 않습니다. 진입 함수가 판정을 반환하지 않는 선언된 export를 가리키는 연결은 실행되고, 아무것도 보고하지 않으며, 빌드를 통과시킵니다. 기록과의 어떤 비교도 이를 알아차리지 못합니다. 실행된 플러그인은 기록된 것과 정확히 같고, 단지 아무것도 실행하지 않았을 뿐이기 때문입니다. 인접한 두 경우는 빌드를 중단하며, 이 한계가 실제보다 넓게 읽히지 않도록 여기에 밝혀 둡니다. 플러그인이 선언하지 않은 export를 가리키는 진입 함수는 플러그인이 로드될 때 거부되고, 판정 형태가 선언하지 않은 키를 담은 출력은 빈 판정 목록으로 읽히지 않고 거부됩니다.

기록, 빠진 게이트, 두 가지 해결 방법을 명시하는 출력 메시지:

a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role: <record-path> records <plugin> as trusted, but no verdict attachment in the workspace configuration names it; a gate that was reviewed and is now absent leaves output indistinguishable from output that gate approved. Attach the plugin again under plugins.governance at an ir-verdict or render-verdict role, or under plugins.linter; or, if it was meant to go, run aggrega pull --upgrade --release <release> <plugin> to drop it from the record — an ordinary aggrega pull leaves the record as it is, so only an explicit upgrade removes an entry (승인 또는 거부 판정에 대해 신뢰할 수 있는 것으로 기록된 플러그인이 더 이상 어떤 판정 역할에도 연결되어 있지 않습니다. 기록 파일은 해당 플러그인을 신뢰할 수 있는 것으로 기록하고 있지만, 워크스페이스 구성의 어떤 판정 연결도 이를 지정하지 않습니다. 검토를 거쳤으나 지금은 없는 게이트는 그 게이트가 승인한 출력과 구별할 수 없는 출력을 남깁니다. 플러그인을 plugins.governance 아래 ir-verdict 또는 render-verdict 역할에, 또는 plugins.linter 아래에 다시 연결하십시오. 의도적으로 제거한 것이라면 대상 지정 업그레이드 명령을 실행하여 기록에서 제거하십시오. 일반적인 pull은 기록을 그대로 두므로, 명시적인 업그레이드만 항목을 제거합니다)

둘 이상의 게이트가 빠진 경우, 게이트마다 명령을 하나씩 두지 않고 하나의 업그레이드 명령에 함께 명시합니다. 대상 지정 업그레이드는 여러 대상을 받으며 명시하지 않은 고정은 모두 그대로 두므로, 함께 명시하는 편이 다른 방법에 필요한 전체 갱신보다 짧고 범위도 좁습니다.

해결 방법: 어느 쪽이 해당하는지는 사용자만 알 수 있으므로 메시지는 두 가지 해결 방법을 제시합니다. 게이트가 실수로 제거되었다면 플러그인을 plugins.governance 아래 판정 역할로, 또는 plugins.linter 아래에 다시 연결합니다. 의도적으로 제거한 것이라면 메시지가 제시하는 대상 지정 업그레이드로 이를 명시적으로 밝히십시오. 그것이 항목을 삭제하는 방법입니다. 이 조건을 해소하려고 기록을 편집하거나 삭제하지 마십시오. 기록은 무엇이 검토되었는지를 커밋한 기록이며, 일반 pull은 의도적으로 이를 그대로 둡니다. 제거를 소리 없이 받아들이는 것이야말로 이 거부가 막기 위해 존재하는 일이기 때문입니다.

A gate recorded as trusted resolves to a different identity (신뢰된 것으로 기록된 게이트가 다른 동일성으로 해석됨)

빌드에 대해 승인 또는 거부 판정을 반환하는 플러그인은 해석되는 즉시, 해석된 버전 및 아티팩트 다이제스트와 함께 기록됩니다. 이 조건은 이후의 해석이 기록에 이미 있는 게이트에 대해 다른 버전이나 다른 바이트에 도달했으나, 실행이 그 동일성을 받아들이도록 요청하지 않았을 때 보고됩니다.

버전이 바뀐 경우와 바이트가 바뀐 경우를 하나의 조건이 모두 다룹니다. 기록은 플러그인의 동일성으로 식별되며 버전과 다이제스트를 한 항목의 필드로 담기 때문에, 해석을 기록과 비교하는 것은 결과가 하나인 단일 비교입니다. 바이트를 바꾸지 않은 재게시와 같은 버전으로의 재푸시는 검토자 입장에서 같은 사건입니다. 동일성이 더 이상 검토된 것이 아닙니다.

이는 기록된 게이트를 더 이상 아무것도 연결하지 않는 경우와는 다른 문제이며, 그쪽은 동일성이 아닌 존재의 문제입니다. 또한 캐시된 바이트가 기록된 다이제스트와 일치하지 않는 플러그인과도 다릅니다. 그쪽은 검토된 플러그인이 아닌 플러그인의 실행을 거부하며 해결 방법은 아티팩트를 복원하거나 다시 기록하는 것이지만, 이쪽은 요청 없이 새 동일성을 채택하는 것을 거부하며 해결 방법은 업그레이드에서 플러그인을 명시하는 것입니다. 해결 방법이 둘이니 조건도 둘입니다.

새 동일성을 요청하는 방법은 pull이 이미 제공하며, 요청하는 방법은 두 가지입니다. 전체 갱신은 모든 것을 다시 해석하고, 대상 지정 업그레이드는 명시한 플러그인을 다시 해석합니다. 어느 쪽이든 새 동일성을 요청한 것으로 읽히며 기록이 최신 상태로 갱신됩니다. 그 밖의 pull은 기록된 동일성을 유지하고 중단하며, 이것이 동일성을 기록하는 이유입니다. 다음에 해석된 것을 무엇이든 받아들이는 기록은 해석을 통제하지 못하고 해석을 따라가게 됩니다. 처음 발견된 것은 불일치가 아닙니다. 기록에 아직 없는 동일성은 그냥 채워집니다.

이 비교는 검증만 하는 pull에서도 실행됩니다. 이 pull은 기록도 lockfile도 쓰지 않습니다. 옆의 lockfile을 검사하면서 기록을 건너뛰는 검증은 확인하지도 않은 일치를 보고하게 됩니다.

플러그인, 두 동일성, 두 가지 해결 방법을 명시하는 출력 메시지:

plugin "<plugin-identity>": <record-path> records version <recorded-version> with digest <recorded-digest> as trusted for it, but this resolution reports version <resolved-version> with digest <resolved-digest>; review what changed and adopt it with aggrega pull --upgrade --release <release> <plugin>, or restore the recorded identity: the plugin identity recorded as trusted no longer matches what this resolution reports (플러그인: 기록 파일은 이 플러그인에 대해 기록된 버전과 다이제스트를 신뢰할 수 있는 것으로 기록하고 있지만, 이번 해석은 다른 버전과 다이제스트를 보고합니다. 변경된 내용을 검토한 후 대상 지정 업그레이드 명령으로 채택하거나, 기록된 아이덴티티를 복원하십시오: 신뢰할 수 있는 것으로 기록된 플러그인 아이덴티티가 이번 해석이 보고하는 내용과 더 이상 일치하지 않습니다)

해결 방법: 두 동일성 중 어느 쪽이 의도한 것인지 결정하십시오. 이는 사용자만 결정할 수 있습니다. 의도한 변경이라면, 즉 게이트가 재게시되었고 변경 사항을 검토했다면, 메시지가 제시하는 대상 지정 업그레이드로 채택하십시오. 이 업그레이드는 해당 플러그인을 다시 해석하고 그 항목을 다시 씁니다. 예상하지 못한 변경이라면 기록된 동일성이 검토된 것입니다. 기록이 명시하는 버전이나 아티팩트를 복원하고, 참조가 왜 이제 다른 곳으로 해석되는지 조사하십시오. 이 조건을 해소하려고 기록을 편집하지 마십시오. 기록은 무엇이 검토되었는지를 커밋한 진술이며, 일반 pull은 의도적으로 이를 그대로 둡니다. 변경된 게이트를 소리 없이 받아들이는 것이야말로 이 거부가 막기 위해 존재하는 일이기 때문입니다.

A Plugin entity’s claims disagree with the plugin’s own self-report (Plugin 엔터티의 주장이 플러그인 자체 보고와 일치하지 않음)

Plugin 엔터티는 자신이 가리키는 플러그인이 무엇을 제공하는지 기술합니다. 즉 어떤 export가 있는지, 각 export가 무엇을 어떤 범위에서 대상으로 하는지, 그리고 provider를 지원하는 플러그인의 경우 렌더링 시 어떻게 동작하는지를 기술합니다. 플러그인도 로드될 때 자신에 대해 같은 내용을 보고합니다. 이 조건은 둘 사이의 불일치를 보고합니다.

비교는 export별로 이름을 키로 하여 이루어지며, 한 방향으로만 진행됩니다. 엔터티가 주장하는 모든 것은 일치해야 하며, 플러그인은 그보다 더 많이 제공할 수 있습니다. 플러그인 표면의 일부를 기술하는 엔터티가 나머지를 모두 열거할 필요는 없으므로, 플러그인이 선언하고 엔터티가 생략한 export는 불일치가 아닙니다. 불일치에 해당하는 것은 플러그인이 선언하지 않은 export를 주장하는 경우, 또는 주장한 export의 operates나 scope가 플러그인이 보고하는 것과 다른 경우입니다. 자유 형식 selector는 비교하지 않습니다.

엔터티가 render-behaviour 블록도 작성한 경우, 그 필드를 하나씩 비교합니다. 입력 종류, assembly 모드, artifact-template 구분자 쌍, assembly-name 어노테이션, 재사용 가능 인스턴스 주장, 경계 간 링크 주장, omit-entries 주장, 중첩 디렉터리가 대상이며, 처음으로 불일치하는 필드가 명시됩니다. 그런 블록을 작성하지 않은 엔터티는 이 비교를 완전히 건너뜁니다.

같은 검사가 publish 시에도 실행되므로, 불일치는 보통 빌드가 엔터티를 로드할 때가 아니라 엔터티가 게시되기 전에 드러납니다.

출력되는 메시지. 플러그인에 없는 export를 주장한 경우:

entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe() (엔터티가 플러그인의 describe()가 선언하지 않는 export를 주장합니다: wasm: 엔터티 계약 주장이 플러그인 describe()와 일치하지 않습니다)

주장한 export의 필드:

entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (엔터티의 export가 선언한 operates 값이 플러그인의 describe()가 보고하는 값과 다릅니다: wasm: 엔터티 계약 주장이 플러그인 describe()와 일치하지 않습니다)

그리고 render-behaviour 필드는 같은 형태로, 불일치한 필드를 명시하여 보고합니다:

entity "<entity>" declares boundary_assembly "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (엔터티가 선언한 boundary_assembly 값이 플러그인의 describe()가 보고하는 값과 다릅니다: wasm: 엔터티 계약 주장이 플러그인 describe()와 일치하지 않습니다)

해결 방법: 수정할 대상은 Aggregate나 Release가 아니라 Plugin 엔터티의 주장입니다. 주장을 플러그인이 보고하는 내용에 맞추십시오. 메시지에 두 값이 모두 명시되므로 어느 쪽으로 맞춰야 하는지는 메시지 자체에서 확인할 수 있습니다. 직접 게시하는 엔터티라면 바이너리에서 다시 생성하는 것이 둘을 일치시키는 확실한 방법입니다. 게시된 엔터티를 사용하는 경우에는 주장이 가리키는 바이너리와 일치하는 버전을 선택하고, 게시자에게 불일치를 보고하십시오.

A Plugin entity’s recorded command set does not match the plugin (Plugin 엔터티에 기록된 명령 집합이 플러그인과 일치하지 않음)

터미널 명령을 제공하는 플러그인은 그 명령들이 Plugin 엔터티에 기록됩니다. 이 기록은 작성하는 것이 아니라 기계가 작성합니다. 플러그인에서 읽어 내어 기록하므로 바이너리를 정확히 반영합니다. 이 조건은 더 이상 바이너리를 반영하지 않게 된 기록을 보고합니다. 명령 이름, 짧은 도움말 텍스트, 또는 명령이 선언된 순서의 차이가 해당합니다.

비교는 완전 일치이며, 이는 의도된 것입니다. 엔터티의 다른 곳에 있는 capability 및 export 주장은 선별된 것입니다. 작성자는 표면의 일부만 기술하고 나머지를 생략할 수 있으므로 이들은 부분 집합으로 검사됩니다. 명령 기록은 선별된 것이 아니므로 정확히 일치하지 않으면 기록이 플러그인이 실제로 제공하는 것에서 벗어났다는 뜻이며, 거의 맞지만 정확하지 않은 명령 목록은 호출을 잘못 라우팅하게 됩니다.

엔터티 없이 로드된 플러그인은 여기서 검사하지 않습니다. 기록은 엔터티에 있으므로 직접 로드한 바이트에는 기록이 없어 비교할 대상이 없습니다.

두 집합과 다시 기록하는 방법을 명시하는 출력 메시지:

wasm: plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>; re-run aggrega plugin sync and commit the result: wasm: recorded command mirror does not match plugin describe() (wasm: 플러그인의 기록된 명령 미러가 플러그인 describe() 명령과 일치하지 않습니다. 동기화 명령을 다시 실행하고 결과를 커밋하십시오: wasm: 기록된 명령 미러가 플러그인 describe()와 일치하지 않습니다)

publish 시의 같은 비교는 다시 기록하라는 안내 없이 집합만 보고합니다:

plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>: wasm: recorded command mirror does not match plugin describe() (플러그인의 기록된 명령 미러가 플러그인 describe() 명령과 일치하지 않습니다: wasm: 기록된 명령 미러가 플러그인 describe()와 일치하지 않습니다)

해결 방법: 바이너리에서 집합을 다시 기록하고 결과를 커밋하십시오. 이를 수행하는 명령은 메시지에 명시되어 있습니다. 기록을 일치시키려고 직접 편집하지 마십시오. 기록은 기계가 소유하며, 지금은 우연히 일치하는 직접 편집도 다음에 기록할 때 다시 도출되어 덮어쓰입니다. 게시하는 것이 아니라 게시된 엔터티를 사용하는 경우, 그 엔터티는 자신의 바이너리가 뒷받침하지 않는 기록으로 게시된 것이며 이는 게시자에게 문의할 문제입니다.

A Plugin entity’s recorded version does not match the plugin (Plugin 엔터티에 기록된 버전이 플러그인과 일치하지 않음)

플러그인은 빌드 시 기록된 버전을 보고하며, Plugin 엔터티에도 버전이 기록됩니다. 두 값은 같은 문자열이어야 합니다. Aggrega의 플러그인을 빌드하는 빌드 레시피는 플러그인을 릴리스하는 태그에서 그 버전을 가져옵니다. 컴파일러와 함께 배포되는 플러그인은 컴파일러 자체의 태그를, 컴파일러 외부에서 배포되는 플러그인은 플러그인 자체의 태그를 사용합니다. 따라서 태그가 가리키는 커밋을 빌드하면 릴리스 버전을 보고하고, 그 밖의 커밋을 빌드하면 1.0.0-3-g1a2b3c4 같은 개발 버전을 보고합니다. 이 조건은 어긋난 쌍을 보고하며, 어긋난 쌍이 카탈로그에 도달하지 않도록 바이트가 게시되기 전에 검사됩니다.

비교는 정확한 문자열 일치입니다. 빌드 버전이 기록되지 않은 채 빌드된 플러그인은 빈 버전을 보고하며, 그러면 엔터티의 버전도 그 빈 값과 같아야 합니다. 이 검사는 “보고된 버전 없음”을 “모든 버전 허용”으로 취급하지 않습니다. 게시된 엔터티의 버전이 항상 그 바이너리가 실제로 보고하는 것을 나타내도록 하는 것이 이 검사의 목적이기 때문입니다.

출력되는 메시지:

plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (플러그인의 기록된 metadata.version이 플러그인 describe() 버전과 일치하지 않습니다: wasm: 엔터티 metadata.version이 플러그인 describe()와 일치하지 않습니다)

publish 시의 거부는 엔터티 파일, .wasm, 복구 방법도 명시합니다:

Plugin <plugin>: metadata.version in <entity-path> does not match the .wasm describe() version at <path> — set metadata.version to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (Plugin: 엔터티 파일의 metadata.version이 .wasm의 describe() 버전과 일치하지 않습니다 — metadata.version을 게시하려는 릴리스로 설정하고, 해당 릴리스의 태그가 가리키는 커밋을 깨끗하게 체크아웃하여 플러그인을 빌드하면 플러그인이 그 버전을 직접 보고합니다. 새 릴리스라면 엔터티를 그것이 릴리스하는 소스와 함께 커밋하고 그 커밋에 먼저 태그를 지정하십시오: 플러그인의 기록된 metadata.version이 플러그인 describe() 버전과 일치하지 않습니다: wasm: 엔터티 metadata.version이 플러그인 describe()와 일치하지 않습니다)

해결 방법: 엔터티의 metadata.version을 게시하려는 릴리스로 설정하고, 그 릴리스의 태그가 가리키는 커밋을 깨끗하게 체크아웃하여 플러그인을 빌드해 플러그인 스스로 그 버전을 보고하게 하십시오. 새 릴리스의 경우 먼저 엔터티를 릴리스할 소스와 함께 커밋하고 그 커밋에 태그를 지정하십시오. 태그는 이미 엔터티를 포함한 커밋을 가리켜야 합니다. 플러그인이 보고하는 버전을 엔터티에 복사하지 마십시오. 그 밖의 커밋을 빌드하면 개발 버전을 보고하며, 이를 복사하면 어떤 릴리스 태그도 가리키지 않는 버전으로 그 빌드를 게시하게 됩니다. 플러그인이 버전을 전혀 보고하지 않는다면 버전이 기록되지 않은 채 빌드된 것이므로, 버전을 기록하여 빌드하십시오.

A plugin was built from a working tree with uncommitted changes (커밋되지 않은 변경 사항이 있는 작업 트리에서 플러그인이 빌드됨)

플러그인의 빌드는 빌드된 커밋으로부터 버전을 기록하며, 커밋되지 않은 변경 사항이 있는 작업 트리에서 만든 빌드는 그 버전 끝에 -dirty 표시를 붙입니다. 태그에서는 1.0.0-dirty, 태그 이후에서는 1.0.0-3-g1a2b3c4-dirty가 됩니다. 이러한 버전은 유효한 시맨틱 버전이지만, 빌드된 바이트를 담고 있지 않은 커밋을 가리키므로 아무도 게시될 버전으로부터 게시될 내용을 다시 빌드할 수 없습니다. Plugin 게시는 자체 버전에 이 표시가 있는 플러그인을 바이트가 게시되기 전, 레지스트리에 연결하기 전에 거부하며, 드라이 런에서도 거부합니다.

거부되는 것은 이 표시뿐입니다. 1.0.0-3-g1a2b3c4처럼 커밋에서 빌드된 개발 버전은 빌드된 내용을 실제로 담은 커밋을 가리키므로 게시되며, 1.0.0-rc.1 같은 프리릴리스도 마찬가지입니다. 게시 외의 상황에서 플러그인을 엔터티에 대해 검증할 때는 이 조건이 발생하지 않습니다. 개발 중인 빌드는 흔히 편집된 트리에서 만들어지기 때문입니다.

이 검사는 플러그인이 자신의 빌드에 대해 보고하는 버전을 읽으며, 엔터티의 metadata.version과의 비교보다 먼저 실행됩니다. 따라서 깨끗한 버전을 기록한 엔터티 아래에서 커밋되지 않은 변경 사항으로 빌드된 플러그인은 플러그인과 일치하지 않는 기록된 버전이 아니라 여기에서 보고됩니다.

플러그인, 플러그인이 보고하는 버전, 해결 방법을 명시하는 출력 메시지:

Plugin <plugin>: the .wasm at <path> was built from a working tree with uncommitted changes — set metadata.version in <entity-path> to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports (plugin "<plugin>", describe() version "<version>", which ends with "-dirty") (해당 경로의 .wasm이 커밋되지 않은 변경 사항이 있는 작업 트리에서 빌드되었습니다. 엔티티 파일의 metadata.version을 게시하려는 릴리스로 설정하고, 그 릴리스의 태그가 가리키는 커밋을 깨끗하게 체크아웃하여 플러그인을 빌드하면 플러그인이 그 버전을 스스로 보고합니다. 새 릴리스라면 먼저 엔티티를 그것이 릴리스하는 소스와 함께 커밋하고 그 커밋에 태그를 지정하십시오. 플러그인이 커밋되지 않은 변경 사항이 있는 작업 트리에서 빌드되었으므로, 플러그인이 보고하는 버전을 재현하는 커밋이 없습니다. 보고된 describe() 버전은 -dirty로 끝납니다)

해결 방법: 릴리스 태그가 가리키는 커밋의 깨끗한 체크아웃에서 플러그인을 빌드하여, 엔터티가 기록한 릴리스 버전을 플러그인이 보고하도록 합니다. 변경 사항 자체를 릴리스하려면 엔터티의 metadata.version을 새 릴리스로 설정하고, 엔터티를 변경 사항과 함께 커밋한 뒤 그 커밋에 태그를 지정하고 그곳에서 빌드합니다. 변경 사항을 커밋하고 다시 빌드하는 것만으로는 릴리스할 수 없습니다. 다시 빌드된 플러그인은 개발 버전을 보고하며, 이를 엔터티에 복사하면 어떤 릴리스 태그도 가리키지 않는 버전으로 빌드를 게시하게 됩니다.

A Plugin entity’s recorded host functions do not match the binary (Plugin 엔터티에 기록된 호스트 함수가 바이너리와 일치하지 않음)

플러그인은 호스트 자체 호출 중 어떤 것을 사용하는지 선언하며, 그 집합은 플러그인이 게시될 때 Plugin 엔터티에 기록됩니다. 이 기록은 작성되는 것이 아니라 바이너리 자체에서 읽어 낸 것입니다. 플러그인을 가져올 때 방금 내용이 검증된 바이트로부터 집합을 다시 도출하여 기록과 비교합니다. 어느 방향이든 차이가 있으면 가져오기가 중단됩니다.

이 검사는 콘텐츠 고정을 반복하는 것이 아니라 그 위에 더해지는 것이며, 고정만으로는 잡아내지 못하는 두 가지를 잡아냅니다. 하나는 일반적인 게시 경로가 아닌 다른 방법으로 게시되어 기록이 없거나 자신의 바이트를 설명하지 않는 기록을 가진 바이너리이고, 다른 하나는 기록 단계 자체의 결함입니다. 고정은 바이트가 고정된 바로 그 바이트임을 확인하고, 이 검사는 그 바이트에 대해 기록된 내용이 실제로 사실임을 확인합니다.

기록이 없는 엔터티는 빈 집합과 비교되며, 이는 호스트 호출을 전혀 사용하지 않는 플러그인과 일치합니다. 어느 쪽이든 동일한 무해한 일치이므로, 기록이 없는 엔터티가 기록이 없다는 이유로 거부되지는 않습니다.

플러그인, 두 집합, 바이트를 가져온 아티팩트를 명시하는 출력 메시지:

plugin "<plugin>": stamped spec.runtime.hostFunctions <recorded set> does not match <derived set> derived from the verified .wasm <artifact>: wasm: stamped host-function record does not match .wasm imports (플러그인에 기록된 spec.runtime.hostFunctions가 검증된 .wasm 아티팩트에서 도출한 집합과 일치하지 않습니다: wasm: 기록된 호스트 함수 레코드가 .wasm 임포트와 일치하지 않습니다)

플러그인을 검증하는 동안 실행되는 같은 비교는 아티팩트 없이 두 집합을 보고합니다:

plugin "<plugin>": recorded host-function record <recorded set> does not match the .wasm imports <derived set>: wasm: stamped host-function record does not match .wasm imports (플러그인에 기록된 호스트 함수 레코드가 .wasm 임포트와 일치하지 않습니다: wasm: 기록된 호스트 함수 레코드가 .wasm 임포트와 일치하지 않습니다)

해결 방법: 엔터티 파일의 어떤 내용도 이 조건의 원인이 아니며, 작성 내용을 변경해도 해결되지 않습니다. 바이너리에서 기록을 도출하여 둘을 함께 기록하는 일반 게시 경로를 통해 플러그인을 다시 게시하십시오. 게시된 플러그인을 사용하는 경우, 엔터티와 엔터티가 가리키는 바이너리가 서로 맞지 않게 게시된 것이므로 메시지의 두 집합을 인용하여 게시자에게 불일치를 알리십시오. 기록을 일치시키려고 직접 편집하지 마십시오. 기록은 작성되는 것이 아니라 도출되는 것이므로 다음 도출 때 편집 내용이 버려집니다.

The lockfile no longer matches what the release resolves to (lockfile이 더 이상 릴리스가 해석되는 결과와 일치하지 않음)

릴리스의 lockfile은 릴리스가 도달하는 모든 엔티티, 라이브러리, 플러그인을 각각 선택된 버전 및 다이제스트와 함께 고정하며, 릴리스 파일 자체, 즉 해당 릴리스와 그것이 확장하는 각 릴리스를 내용의 다이제스트로 기록합니다. 엔티티의 다이제스트는 그 엔티티의 게시본이 담는 것, 즉 해당 문서와 그 옆에 명시된 모든 파일을 각각의 경로와 바이트로 포괄합니다. 라이브러리와 플러그인의 다이제스트는 해당 바이트를 포괄합니다. 릴리스를 다시 해석하면 같은 집합이 생성되고, 둘을 비교합니다. 이 조건은 불일치가 있을 때 보고되는 것입니다.

모든 불일치는 어느 하나가 보고되기 전에 수집되며, lockfile이 고정하는 모든 항목에 걸쳐 이루어지므로 한 번의 실행으로 항목을 하나씩이 아니라 전체 상황을 파악할 수 있습니다.

다음과 같은 형태의 불일치가 보고되며, 해결 방법이 다르므로 구별할 가치가 있습니다.

  • lockfile이 고정하지 않는 참조. 릴리스가 이제 lockfile에 항목이 없는 무언가에 도달합니다. 이는 lockfile을 작성한 pull 이후에 추가된 의존성입니다. 항목은 릴리스가 그것을 요청하는 위치를 명시하므로, Manifest가 바인딩하는 Recipe 또는 FeatureRecipe는 그것을 바인딩하는 매핑 항목과 함께 보고되고, name 계층이 바인딩하는 것은 그것이 선택된 인스턴스 또는 어태치먼트를 명시합니다.
  • 쌍이 바뀐 고정된 참조. lockfile은 하나의 버전-다이제스트 쌍을 고정하는데 해석 결과는 다른 쌍을 생성했습니다. 이는 바이트가 변경된 벤더링된 콘텐츠이거나, 워크스페이스에서 변경된 무언가입니다. 엔티티나 라이브러리의 문서가 편집되었거나, 엔티티가 명시하는 파일(소스 아래의 차트, 가져오는 파일, 옆에 있는 entity.lock)이 편집, 추가 또는 제거되었거나, 플러그인 엔티티 옆의 .wasm이 교체된 경우입니다. 항목은 파일이 아니라 엔티티를 명시합니다. 일반 aggrega pull --release <release>는 An entity reads an input the lock beside it records no pin for (엔티티가 옆의 lock에 고정이 기록되지 않은 입력을 읽음)에서 설명하듯이 Recipe나 FeatureRecipe의 lock 아래에서 바뀐 파일을 명시합니다. 고정된 버전으로 다른 바이트를 제공하는 레지스트리는 여기서 보고되지 않습니다. 그 바이트를 가져오는 pull이 Fetched or cached bytes do not match the digest committed for them (가져오거나 캐시된 바이트가 해당 바이트에 대해 커밋된 다이제스트와 일치하지 않음)에서 설명하듯이 거부합니다.
  • 릴리스가 더 이상 도달하지 않는 고정된 참조. lockfile이 릴리스의 어떤 것도 더 이상 의존하지 않는 무언가를 여전히 고정하고 있습니다.
  • pull 이후 편집된 릴리스 파일. 릴리스 또는 그것이 확장하는 릴리스가 lockfile이 기록한 바이트를 더 이상 담고 있지 않습니다. 릴리스가 요청하는 모든 것, 즉 어떤 소스 버전을 가져올지, 어떤 컴포넌트를 어디에 배치할지는 파일 내용으로부터 해석되므로, 기록된 고정이 이제 요청하는 내용을 더 이상 설명하지 못할 수 있습니다. 이는 렌더링이 실패했을 지점으로서가 아니라 어떤 렌더링보다도 먼저 여기서 보고됩니다. 그렇지 않으면 편집된 소스 버전은 나중에 고정을 찾지 못하는 가져오기로 드러납니다. 릴리스 파일을 전혀 기록하지 않은 lockfile은 릴리스를 기록되지 않음으로 보고하고, 릴리스가 더 이상 확장하지 않는 릴리스 파일은 더 이상 읽히지 않음으로 보고됩니다.
  • 원격에서 바뀐 소스 참조. git ref:로 작성된 소스는 그 ref가 해석된 커밋으로 기록됩니다. 업그레이드가 아닌 각 pull은 원격에 ref가 현재 가리키는 곳을 묻고, 네트워크에 연결할 수 있는 경우 aggrega pull --verify도 마찬가지입니다. 다른 커밋으로 해석되는 ref는 채택되지 않고 여기서 보고됩니다. 이 둘만 이를 보고합니다. 빌드는 기록된 커밋을 읽으며 묻지 않습니다.

비교는 내용을 기준으로 하므로, 다른 경로로 도달한 동일한 내용은 드리프트되지 않습니다. 이 조건이 발생하려면 바이트가 달라야 합니다. 릴리스 파일의 경우, 릴리스가 명시하는 Aggregate 및 Manifest와 똑같이 주석이나 공백 변경도 포함됩니다. 엔티티의 경우 그것이 담는 것의 내용이므로, 카탈로그 디렉터리에서 읽은 엔티티와 레지스트리에서 가져온 같은 엔티티는 드리프트되지 않으며, 파일이 실행 비트를 포함한 권한 비트만 다른 체크아웃이나 아카이브가 다르게 압축된 게시본도 마찬가지입니다.

출력되는 메시지입니다. 조건 자체의 문장으로 시작하고, 수집된 모든 불일치가 뒤따르며, 각각은 해당 축을 명시하고 엔티티의 경우 그 종류도 명시합니다. 엔티티는 종류와 URI를 함께 사용해 식별되므로, Aggregate와 Manifest가 같은 이름을 공유하는 Release에는 항목이 두 개 있으며, 둘 중 하나를 편집하면 편집된 쪽에 대해 보고됩니다:

lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>) <axis> "<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) <axis> "<uri>" no longer used by the release release document "<file>" was edited after the lockfile was written: its content no longer matches the recorded digest (lockfile=<digest> current=<digest>), so the pins may no longer describe what it asks for; re-resolving the Release records the files it reads as they now stand (lockfile: 최신 상태가 아닙니다. 해당 Release가 해석되는 결과와 더 이상 일치하지 않습니다. 엔터티(종류 표시)가 lockfile에 없습니다(참조 위치 표시). 항목이 변경되었습니다. 엔터티(종류 표시)가 변경되었습니다. 항목을 release가 더 이상 사용하지 않습니다. release 문서가 lockfile 작성 후 편집되어 내용이 기록된 digest와 더 이상 일치하지 않으므로, 고정된 핀이 문서가 요청하는 내용을 더 이상 설명하지 못할 수 있습니다. Release를 다시 해석하면 읽는 파일이 현재 상태대로 기록됩니다)

<site>는 릴리스가 참조를 요청하는 위치로, 그것을 명시하는 항목까지의 경로로 작성됩니다(예: manifest.spec.mappings.components.name.db-primary). 이러한 위치가 정렬된 순서로 최대 세 개까지 나열되며, 더 있으면 그 뒤에 ...가 붙습니다. 해석 시 이러한 위치가 기록되지 않은 참조는 괄호 없이 보고됩니다.

바뀐 소스 참조를 보고하는 pull은 작성자가 작성한 대로 아티팩트를 명시하며, 소스가 명시하는 경우 chart=와 module_subdir=를 포함합니다.

source-artifact kind=<kind> url=<url>: reference "<ref>" moved — the lockfile pins <commit>, and it now resolves to <commit>; adopt where it now points with aggrega pull --upgrade --release <release> (source-artifact: 참조가 이동했습니다. lockfile이 고정한 커밋과 현재 해석되는 커밋이 다릅니다. 현재 가리키는 위치를 채택하려면 업그레이드 pull을 실행하십시오)

빌드는 항목 뒤에 해결 방법을 출력합니다.

run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile (Release를 다시 해석하고 lockfile을 다시 작성하려면 이 명령을 실행하십시오)

어떤 명령이 릴리스를 그 lockfile에 맞추는가. aggrega build는 렌더링하기 전에 비교하고 중단합니다. aggrega validate --release와, 릴리스를 해석하는 모든 aggrega inspect 선택(기본 보기, --resolved, --ir-graph, --closure)은 릴리스의 의존성이 해석되는 즉시 같은 비교를 실행하고, 같은 메시지와 해결 방법으로 중단하며, 표준 출력에는 아무것도 쓰지 않습니다. 따라서 둘 다 빌드가 어긋났다고 거부하는 lockfile을 그냥 넘기지 않습니다. 어시스턴트 도구의 build, release를 지정한 validate, release를 지정한 describe도 같은 조건으로 거부합니다. aggrega pull은 곧 쓸 lockfile에 대해, aggrega pull --verify는 디스크에 있는 lockfile에 대해 이 비교를 실행합니다. 릴리스를 해석하지 않는 명령, 즉 인수 없이(이 경우 extends 부모를 찾기 위해서만 lockfile 핀을 읽습니다) 또는 엔터티 경로와 함께 실행한 aggrega validate, 그리고 --ir-graph 없이 실행한 aggrega inspect --raw 또는 --output yaml은 lockfile에 묶이지 않으며, 옆에 lockfile이 없는 릴리스도 마찬가지입니다. 편집기의 언어 서버는 이 때문에 빌드를 중단하며, 그래프 요청에서는 그래프를 그리면서도 이를 lockfile에 대한 경고로 보고합니다.

해결 방법: 릴리스를 다시 해석하고 다시 작성된 lockfile을 커밋합니다. 빌드가 보고하는 모든 것에 대해, 일반 aggrega pull --release <release>(빌드가 출력하는 명령)가 해결의 전부입니다. 이 명령은 릴리스를 현재 상태대로 해석하고, 바뀐 고정은 다시 작성하며 나머지는 모두 유지하므로, 손대지 않은 것은 아무것도 변동되지 않습니다. 바뀐 것이 Recipe나 FeatureRecipe의 로컬 소스 아래 파일인 경우, 해당 pull은 먼저 엔티티에 대해 aggrega pin을 명시하며 중단됩니다. 새 고정을 그 옆에 기록하는 것은 작성자의 단계이기 때문입니다. 이를 실행하거나 pull에 --pin-sources를 전달하면 pull이 드리프트를 해소합니다. 일반 pull이 해소하지 않는 유일한 항목은 원격에서 바뀐 소스 참조입니다. 이를 해소하려면 참조가 현재 가리키는 커밋을 채택해야 하기 때문입니다. aggrega pull --upgrade --release <release>가 이를 수행하며, 항목에도 그렇게 안내됩니다. Recipe의 entity.lock이 해당 소스를 기록하는 경우, 업그레이드는 새 커밋이 그 옆에 고정될 때까지 같은 방식으로 중단됩니다. 실행하기 전에 항목을 읽으십시오. 세 번째 형태가 멈추고 살펴볼 가치가 있는 것입니다. 릴리스가 더 이상 도달하지 않는 참조는 대개 의도적으로 제거한 의존성이지만, 제거하지 않은 경우에는 다른 무언가가 변경되어 도달할 수 없게 된 것입니다. 손대지 않은 참조에서 쌍이 바뀌었다면 해당 버전의 내용이 검토된 내용이 아니라는 뜻이며, 이는 살펴보지 않고 채택할 것이 아니라 그것을 제공하는 쪽에 확인할 문제입니다.

pull은 작성하려는 lockfile에 대해 이와 같은 비교를 실행하고 비교가 거부하는 lockfile은 작성하지 않으므로, pull이 방금 작성한 lockfile은 같은 입력이 주어진 빌드에서 이 비교를 통과합니다. 완료된 pull 직후에 이 조건이 다시 발생한다면, 두 실행에 서로 다른 입력이 주어진 것입니다. 예를 들어 카탈로그 디렉터리가 한쪽에만 전달되었거나, 그 사이에 워크스페이스 구성이 편집된 경우입니다. pull과 빌드를 같은 입력으로 실행하십시오.

An artifact is not at the source the build was told to find it (아티팩트가 빌드가 찾도록 지시받은 소스에 없음)

카탈로그 참조는 아티팩트와 버전을 지정합니다. 이 조건은 그 쌍에 해당하는 것이 없다는 것을 보고합니다. 참조가 해석되는 레지스트리에도, 빌드가 읽는 로컬 아티팩트 캐시에도 없습니다.

빌드는 캐시를 읽으며, 스스로 외부에 접속하지 않습니다. 획득은 별도의 단계입니다. release를 해석하는 pull이 release에 필요한 것을 가져와 캐시에 기록하고, 그다음 빌드가 거기 있는 것을 읽습니다. 따라서 이 조건은 빌드에서는 캐시 미스로, pull에서는 해당 아티팩트가 없는 레지스트리로 나타납니다. 빌드가 시작할 때 lockfile을 채우도록 구성된 경우, 빌드가 실행하는 획득은 바로 그 pull입니다.

출력되는 메시지. 해당 태그가 없는 레지스트리, 그리고 콘텐츠 blob이 없는 manifest를 해석한 fetch:

oci: "<reference>:<version>": oci: artifact not found at remote source (원격 소스에서 아티팩트를 찾을 수 없음)

oci: content for "<reference>:<version>": oci: artifact not found at remote source (원격 소스에서 아티팩트를 찾을 수 없음)

항목을 찾지 못한 캐시 읽기. 빌드가 마주치는 형태입니다:

oci: cache miss for <reference>@<version>: oci: artifact not found at remote source (원격 소스에서 아티팩트를 찾을 수 없음)

그리고 캐시된 아티팩트 옆에 manifest가 없는 경우도 마찬가지입니다:

oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source (원격 소스에서 아티팩트를 찾을 수 없음)

해결 방법: 먼저 참조와 버전을 확인합니다. 더 이상 존재하지 않는 버전과 오타가 있는 이름은 같은 응답을 내며, 메시지가 둘 다 인용하므로 카탈로그와 비교할 수 있습니다. 참조가 올바르다면 아티팩트가 획득되지 않은 것입니다. release에 대한 pull을 실행하면 release가 도달하는 것을 가져와 캐시를 채웁니다. 워크스페이스가 오프라인이라면 그 pull은 네트워크에 접근할 수 있는 곳에서 실행해야 합니다. 오프라인 빌드는 이미 캐시된 것만 읽으며, 캐시에 해당 항목이 없을 때 이 메시지를 출력합니다.

The registry will not serve an artifact without credentials it accepts (레지스트리가 수락하는 자격 증명 없이는 아티팩트를 제공하지 않음)

레지스트리가 응답했고, 거부했습니다. 자격 증명이 제시되지 않았거나, 제시된 자격 증명이 수락되지 않았습니다. 이는 아예 도달할 수 없었던 레지스트리와 구별됩니다. 여기서는 통신이 이루어졌고 답이 거부였습니다.

네 가지 시점에서 보고되며, 모두 아티팩트를 획득하거나 게시하는 중입니다. 참조를 해석할 때, 그 콘텐츠를 pull할 때, 저장소가 보유한 버전을 나열할 때, 그리고 자격 증명을 저장하는 시점에 확인할 때입니다.

출력되는 메시지. 각각 요청한 대상을 지정하고 레지스트리의 응답을 인용합니다:

oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed (인증이 필요하거나 실패함)

저장소의 버전 나열. 대신 상태 코드를 지정합니다:

oci: tags/list "<repository>": status <code>: oci: authentication required or failed (인증이 필요하거나 실패함)

그리고 저장 시 자격 증명 확인:

oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed (인증이 필요하거나 실패함)

해결책을 제공하는 단계에서 실패가 드러난 경우, 줄 끝에 도출한 호스트에 대해 실행할 로그인 명령이 붙습니다:

remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release> (해결 방법: aggrega pull —release를 다시 실행하기 전에 표시된 호스트에 aggrega login(또는 docker login)을 실행하십시오)

그리고 import가 컴파일러의 core importer 중 하나를 가져오고 있던 경우에는 import를 다시 실행하기 전에 할 같은 로그인으로 끝납니다:

remediation: aggrega login <host> (or docker login <host>) before re-running the import (해결 방법: import를 다시 실행하기 전에 aggrega login(또는 docker login)을 실행합니다)

http 또는 https로 가져오는 기존 Helm 차트 저장소나 차트 아카이브, compose 조각, Git 저장소도 서버가 요청을 권한 없음으로 거부하면 이 조건을 보고하며, 이들의 해결 방안은 로그인 대신 추가할 netrc 항목을 지정합니다. 이러한 가져오기는 그 파일에서 자격 증명을 읽기 때문입니다:

remediation: add an entry for <host> (machine <host> login <user> password <secret>) to the netrc file <path>, then run the command again (해결 방안: netrc 파일에 해당 호스트에 대한 항목(machine, login, password 포함)을 추가한 다음 명령을 다시 실행하십시오)

해결 방법: 이는 엔티티 작성자가 아닌 운영자의 몫입니다. Aggregate, Component, Recipe의 어떤 내용도 이를 일으키지 않습니다. 공식 허브인 hub.aggrega.ai는 게시하는 것을 누구에게나 제공하므로 여기서 읽을 때는 자격 증명이 필요 없지만, 여기에 게시할 때는 필요합니다. 다른 레지스트리는 읽기에도 자격 증명을 요구할 수 있습니다. 메시지가 지정한 호스트에 로그인하고(http 또는 https로 가져오는 소스의 경우 해결 방안이 지정한 netrc 항목을 추가하고) 획득을 다시 실행합니다. 이미 로그인되어 있다면 저장소의 자격 증명은 그 호스트가 해당 저장소에 대해 수락하는 것이 아닙니다. 다시 로그인하여 갱신하고, 계정이 참조가 해석되는 저장소에 읽기 권한이 있는지 확인합니다. 비공개 저장소는 볼 수 없는 계정에 정확히 이렇게 응답하기 때문입니다. 참조가 예상하지 않은 호스트로 해석된다면 .aggrega-config.yaml의 레지스트리 별칭이나 기본 레지스트리가 다른 곳을 가리키고 있는 것입니다.

The netrc file cannot be read (netrc 파일을 읽을 수 없음)

기존 방식의 Helm 차트 저장소나 차트 아카이브, compose 조각, http 또는 https로 가져오는 Git 저장소는 netrc 파일에서 자격 증명을 가져오며, 이 파일은 그러한 소스를 가져올 때, 즉 pull, pin, 또는 잠금 파일을 채우는 빌드가 읽습니다. 어떤 파일을 읽고 어떤 항목이 요청에 응답하는지는 Authentication에서 설명합니다. 이 조건은 존재하지만 사용할 수 없는 netrc 파일을 보고합니다. 예를 들어 디렉터리이거나 읽기 권한이 없어서 읽을 수 없거나, netrc 형식을 따르지 않는 경우입니다. 형식은 엄격하게 읽힙니다. 잘못된 위치에서 읽힌 단어는 그 뒤의 모든 단어를 밀어내기 때문입니다. 키워드 철자가 틀리면 그 뒤의 비밀번호가 다음 키워드로 바뀌어, 파일은 멀쩡해 보이는데 요청은 자격 증명 없이 또는 잘못된 자격 증명으로 전송됩니다.

존재하지 않는 파일은 이 조건에 해당하지 않습니다. 자격 증명을 담고 있지 않으며, 자격 증명이 필요한 요청에는 서버의 거부가 응답합니다. 머신의 다른 사용자가 읽을 수 있는 파일도 이 조건에 해당하지 않습니다. Linux와 macOS에서는 그 파일을 지목하는 경고가 한 번 나오지만 파일은 여전히 읽힙니다.

메시지는 파일을, 형식 결함의 경우 줄도 지목하며, 무엇이 잘못되었는지를 형식의 관점에서만 설명합니다. 위치가 잘못된 단어가 비밀번호일 수 있으므로 파일에 담긴 단어는 절대 보여 주지 않습니다. 이 진단에는 범주가 없습니다. netrc 파일은 빌드가 읽는 문서가 아니라 사용자 자신의 자격 증명 파일이기 때문입니다.

형식 결함에 대해 출력되는 메시지입니다. 형식 결함은 키워드가 와야 할 자리에 단어가 있는 경우, 키워드 뒤에 값이 없는 경우, login, password 또는 account가 어떤 machine이나 default 항목보다도 앞에 있는 경우, 따옴표로 묶은 단어가 시작된 줄에서 닫히지 않은 경우 중 하나입니다.

the netrc file could not be read (file <path>, line <line>, a word stands where a keyword is expected (machine, default, login, password, account or macdef)). Correct the file, or set NETRC to the path of another netrc file to read instead (netrc 파일을 읽을 수 없습니다(표시된 파일과 줄에서 키워드(machine, default, login, password, account 또는 macdef)가 와야 할 자리에 단어가 있음). 파일을 수정하거나, 대신 읽을 다른 netrc 파일의 경로를 NETRC에 설정하십시오)

그리고 읽을 수 없었던 파일의 경우, 그 이유를 인용합니다.

the netrc file could not be read (file <path>, <why it could not be read>). Correct the file, or set NETRC to the path of another netrc file to read instead (netrc 파일을 읽을 수 없습니다(표시된 파일과 읽을 수 없었던 이유). 파일을 수정하거나, 대신 읽을 다른 netrc 파일의 경로를 NETRC에 설정하십시오)

해결 방법: 메시지가 지목하는 파일을 엽니다. 형식 결함의 경우 지목된 줄로 이동합니다. 각 항목은 machine <host>(또는 default) 뒤에 login <user>와 password <secret>이 오는 형태이며, 키워드 철자 오류나 값이 빠진 키워드가 흔한 원인입니다. 읽을 수 없었던 파일의 경우, 본인이 읽을 수 있고 본인만 읽을 수 있는 파일로 만듭니다(chmod 600). 그 파일이 읽히기를 의도한 파일이 아니라면, 의도한 파일의 경로를 NETRC에 설정합니다.

The registry could not be reached (레지스트리에 도달할 수 없음)

레지스트리와의 통신이 이루어지지 않았습니다. 이름 해석, 연결, 또는 보안 핸드셰이크가 실패했습니다. 이는 응답한 뒤 거부한 레지스트리와 대응되는 경우입니다. 여기서는 어느 쪽으로도 확인된 것이 없으므로, 원격 측 아티팩트의 상태는 없는 것으로 알려진 것이 아니라 알 수 없는 상태입니다.

또한 Recipe의 소스를 획득하는 동안 더 구체적인 원인이 없는 전송 실패가 보고하는 것이기도 하므로, 그 경로에서는 어느 계층이 실패했는지에 대한 주장이 아니라 일반적인 “원격 측에 도달할 수 없음”이라는 응답입니다.

출력되는 메시지. 획득 중인 소스를 지정하고 기저의 전송 실패를 인용하며, 조건이 가진 해결책을 함께 표시합니다:

sourceresolver: kind=<kind> url=<url> version=<version>: oci: network unreachable (cause: <the transport failure>); remediation: check network connectivity to <host>; corporate proxies typically need HTTPS_PROXY exported

해결 방법: 해결은 운영자의 몫이며 카탈로그 바깥에 있습니다. 명령을 실행하는 곳에서 메시지의 호스트에 도달할 수 있는지 확인합니다. 환경이 프록시를 통해 네트워크에 접속한다면 해결책이 지정하는 대로 프록시를 환경에 export해야 합니다. 브라우저나 패키지 관리자에만 구성된 프록시는 인식되지 않습니다. 호스트에 수동으로는 도달할 수 있지만 여기서는 안 된다면, 차이는 대개 프록시의 자격 증명이나 핸드셰이크가 수락하지 않은 가로채기 인증서입니다. 아티팩트가 캐시되고 나면 이후 빌드는 캐시를 읽으며 네트워크가 전혀 필요하지 않습니다.

A server did not answer in time (서버가 제시간에 응답하지 않았습니다)

요청이 대상으로 한 서버(레지스트리, 또는 서명이 기록되는 투명성 로그처럼 명령이 접근하는 다른 서버)를 계속 기다리다가 철회되었습니다. 요청은 전체가 전송된 뒤 서버가 응답을 시작하기까지 최대 30초, 이미 도착하고 있는 응답의 다음 부분을 최대 30초 기다립니다. 둘 중 하나를 넘기면 이 조건으로 거부되며, 서버와 대기 시간이 명시됩니다. 연결을 수락하고 전혀 응답하지 않는 서버도, 연결을 전혀 수락하지 않는 주소도 이 결과를 내며, 명령이 끝없이 기다리지 않습니다. 레지스트리의 전체 리포지토리 목록 순회는 대신 각 페이지에서 순회가 실행될 수 있는 시간만큼 기다리며, 자체 조건인 E0377로 제한됩니다.

제한되는 것은 대기뿐입니다. 계속 진행되는 다운로드나 업로드는 필요한 만큼 시간이 걸리는데, 대기 시간은 아무것도 도착하지 않는 동안에만 측정되기 때문입니다. Recipe의 source:가 HTTPS로 가져오는 Helm 차트는 응답이 시작되기까지의 대기에만 제한을 받으며, 그 만료는 이 조건이 아니라 네트워크 라이브러리 자체의 문구로 보고됩니다. 명령이 시간 초과 시 이미 다시 보내는 요청(aggrega registry update 중의 읽기, 게시 중의 쓰기)은 먼저 다시 보내지므로, 거부는 마지막 시도 뒤에 남은 결과입니다.

레지스트리가 응답하지 않은 버전 목록에 대해 출력되는 메시지:

aggrega plugin add: 127.0.0.1:18471: list versions for plugin/cli/mo: oci: list tags: Get “http://127.0.0.1:18471/v2/plugin/cli/mo/tags/list”: 127.0.0.1:18471 did not answer within 30s: egress: the server did not answer in time (aggrega plugin add: 127.0.0.1:18471: plugin/cli/mo의 버전 나열: oci: 태그 나열: Get: 127.0.0.1:18471이(가) 30s 안에 응답하지 않았습니다: egress: 서버가 제시간에 응답하지 않았습니다)

그리고 응답이 도중에 멈춘 경우:

<host> stopped answering: nothing more of its answer arrived for 30s: egress: the server did not answer in time (응답을 멈췄습니다: 응답의 나머지가 30s 동안 전혀 도착하지 않았습니다: egress: 서버가 제시간에 응답하지 않았습니다)

해결 방법: 수정은 운영자의 몫이며 카탈로그 밖의 일입니다. 메시지가 지목한 서버가 실행 중이고 명령이 실행되는 곳에서 접근할 수 있는지 확인하십시오. 부하가 걸렸거나 유지 보수 중인 레지스트리는 나중에 다시 응답하므로 명령을 그대로 다시 실행하면 됩니다. 환경이 프록시를 통해 네트워크에 접근하는 경우, 프록시가 요청을 붙잡아 두지 않고 전달하는지 확인하십시오. 대기 시간은 고정되어 있으며, 이를 늘리는 설정은 없습니다.

A registry’s repository listing did not end in time (레지스트리의 리포지토리 목록이 제시간에 끝나지 않았습니다)

레지스트리의 전체 리포지토리 목록 순회가 목록의 끝에 도달하지 못한 채 5분 동안 실행되어 중단되었습니다. 목록을 순회하는 명령은 두 가지입니다. aggrega plugin add는 주어진 이름과 정확히 일치하는 플러그인이 없어 그 이름을 포함하는 이름의 플러그인을 찾을 때만 순회하며, aggrega registry update는 레지스트리의 각 리포지토리를 읽기 전에 리포지토리를 나열합니다. 새 리포지토리를 끝없이 계속 나열하는 목록과, 레지스트리가 너무 느리게 제공해 끝나지 않는 목록은 모두 명령을 붙잡아 두지 않고 여기서 끝납니다. 이때 순회는 리포지토리를 전혀 내놓지 않으므로, 중간에 잘린 목록에서 아무것도 선택되거나 색인되지 않습니다. 메시지는 중단 시점까지 목록이 나열한 리포지토리 수를 알려 줍니다.

쿼리가 이름의 일부인 플러그인 추가에 대해 출력되는 메시지:

aggrega plugin add: 127.0.0.1:18472: no cli plugin is named “mo”, and searching every repository for a name containing it did not finish; name the plugin exactly, as aggrega plugin add cli <name>: the walk was stopped after 5m0s, before the listing ended (repositories named so far: 146): registry: the repository listing did not end in time (aggrega plugin add: 127.0.0.1:18472: “mo”라는 이름의 cli 플러그인이 없으며, 이를 포함하는 이름을 모든 리포지토리에서 찾는 검색이 끝나지 않았습니다. aggrega plugin add cli 뒤에 이름을 붙이는 식으로 플러그인의 정확한 이름을 지정하십시오: 목록이 끝나기 전에 5m0s 후 순회가 중단되었습니다 (지금까지 나열된 리포지토리: 146): registry: 리포지토리 목록이 제시간에 끝나지 않았습니다)

해결 방법: aggrega plugin add의 경우 플러그인의 정확한 이름을 지정하십시오. aggrega plugin add cli mo 대신 aggrega plugin add cli moo를 사용하면, 요청 한 번으로 그 이름의 플러그인을 조회하고 목록을 전혀 순회하지 않습니다. aggrega registry update의 경우 원인은 레지스트리의 목록입니다. 레지스트리를 운영하는 사람에게 목록이 끝나는지 확인하고, 끝나게 되면 업데이트를 다시 실행하십시오. 5분 제한은 고정되어 있으며, 이를 늘리는 설정은 없습니다.

A registry kept asking to slow down (레지스트리가 계속 속도를 늦추라고 요청함)

너무 바쁜 레지스트리는 429 Too Many Requests로 응답하거나, 얼마나 기다려야 하는지 알려 주는 Retry-After 헤더와 함께 503 Service Unavailable로 응답합니다. 명령이 레지스트리에 보내는 모든 요청은 레지스트리가 요청하는 만큼(명시되지 않은 경우 10초) 기다린 뒤 다시 요청되며, 해당 레지스트리에 대한 모든 요청이 함께 기다리고, 레지스트리가 다시 응답할 때까지 동시에 보내는 요청 수가 줄어듭니다. 5분 동안 “속도를 늦추라”는 응답만 하는 레지스트리는 이 조건으로 거부되며, 해당 레지스트리, 마지막 응답, 그리고 다른 응답 없이 지난 시간이 표시됩니다. 기다리는 동안 자체 시간 제한이 끝난 요청도 마찬가지입니다. 그러면 aggrega registry update는 해당 레지스트리를 인덱싱되지 않은 것으로 보고하며, 그 레지스트리는 실행 전에 가지고 있던 인덱스를 유지합니다.

5분 동안 속도를 늦추라고 요청한 레지스트리에 대해 출력되는 메시지:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for 5m0s: oci: the registry kept asking to slow down (계속 속도를 늦추라고 요청함: 마지막 응답은 429 Too Many Requests였으며, 5m0s 동안 다른 응답은 없었음: oci: 레지스트리가 계속 속도를 늦추라고 요청함)

그리고 요청 자체의 시간 제한으로 대기가 끝난 경우:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for <how long> when the request’s own time ran out: oci: the registry kept asking to slow down (계속 속도를 늦추라고 요청함: 마지막 응답은 429 Too Many Requests였으며, 요청 자체의 시간이 다 될 때까지 다른 응답은 없었음: oci: 레지스트리가 계속 속도를 늦추라고 요청함)

해결 방법: 원인은 작성한 내용이 아니라 레지스트리의 요청 속도 제한입니다. 클라이언트의 요청 속도를 제한하는 레지스트리는 보통 같은 주소에서 오는 모든 요청을 제한하므로, 그 주소 뒤에 있는 다른 명령이나 머신이 동시에 요청하고 있지 않은지 확인하고, 그것들이 끝난 뒤 명령을 다시 실행하십시오. 직접 운영하는 레지스트리라면 그 요청 속도 제한을 확인하십시오. 5분 한도는 고정되어 있으며, 이를 늘리는 설정은 없습니다.

Fetched or cached bytes do not match the digest committed for them (가져오거나 캐시된 바이트가 해당 바이트에 대해 확정된 다이제스트와 일치하지 않음)

모든 아티팩트는 콘텐츠의 다이제스트를 확정하는 매니페스트를 가지며, lockfile은 이와 별도로 그 매니페스트의 다이제스트를 고정합니다. 두 확정은 모두 가지고 있는 바이트를 다시 해싱하여 비교하는 방식으로 검사됩니다. 이 조건은 비교가 실패했을 때 보고되며, 방금 가져온 바이트와 캐시에서 다시 읽은 바이트에 대해 똑같이 발생합니다.

두 가지 조건이 있으며, 어느 쪽이 발생하는지가 어느 계층이 불일치했는지를 알려 줍니다. 하나는 자신의 매니페스트가 확정한 다이제스트와 일치하지 않는 콘텐츠를 가리킵니다. 다른 하나는 lockfile이 고정한 다이제스트와 일치하지 않는 캐시된 매니페스트를 가리키며, 이는 변조된 매니페스트가 이후의 콘텐츠 검사가 신뢰하는 기준이 되지 않도록 막는 검사입니다. 이 두 번째 검사를 의미 있게 만드는 것은 고정값입니다. 고정값은 캐시된 바이트에서 매니페스트를 다시 도출하는 것이 아니라 lockfile에서 오므로, 두 검사는 실제로 서로 독립적입니다.

그다음 엔터티는 바이트가 담은 내용보다 자신의 행을 기준으로 검사됩니다. 캐시된 엔터티의 바이트가 매니페스트와 일치하면, 그 바이트는 lockfile이 해당 엔터티에 대해 기록한 다이제스트와 비교됩니다. 이 다이제스트는 압축된 바이트가 아니라 게시물이 담은 파일들을 각각의 경로와 바이트로 포괄합니다. 따라서 같은 파일을 다른 압축 방식으로 게시해도 여전히 일치하지만, 같은 버전 아래의 다른 파일은 일치하지 않으며, 불일치는 콘텐츠 조건으로 보고됩니다. 고정값을 따르는 pull도 레지스트리가 고정된 버전으로 제공하는 것에 대해 같은 비교를 수행합니다.

이 검사들은 모두 네트워크가 필요하지 않습니다. 각 검사는 이미 가지고 있는 바이트에 대한 해시 비교이므로, 완전히 오프라인인 빌드도 읽고 있는 것이 고정된 것과 같음을 확인할 수 있습니다.

출력되는 메시지. 매니페스트와 비교한 콘텐츠:

oci: content digest <computed> != manifest layer <committed>: oci: content digest mismatch

매니페스트가 다른 위치에서 확정하는 플러그인 엔터티:

oci: config digest <computed> != manifest config <committed>: oci: content digest mismatch

고정된 다이제스트와 비교한 캐시된 매니페스트:

oci: cached manifest digest <computed> != pinned <pinned>: oci: cached manifest digest mismatch

자신의 행과 비교한 캐시된 엔터티, 그리고 고정된 버전으로 다른 콘텐츠를 제공하는 레지스트리:

catalog: cached <uri> content digest <computed> does not match lockfile pin <pinned>: oci: content digest mismatch

oci: content digest mismatch: pinned entity "<uri>": registry now serves digest <computed> for the pinned version, not the pinned digest <pinned>; run aggrega pull --upgrade --release <release> to update the pin

두 조건 모두 읽고 있던 대상에 따라 메시지가 감싸집니다. 어떤 소스도 고정값의 바이트를 가지고 있지 않은 고정된 엔터티의 경우, 캐시 항목의 매니페스트가 불일치했으면 매니페스트 조건이, 그렇지 않으면 콘텐츠 조건이 보고됩니다:

pinned entity <uri>: no source holds the pinned bytes <pinned> (<what each source it read held>); with a registry reachable, aggrega pull --release <release> fetches the pinned version again: <the message above>

아카이브 밖으로 벗어나는 경로를 가리키는 아카이브 항목도 콘텐츠 조건으로 보고됩니다. 그런 시도를 하는 번들은 확정된 번들이 아니기 때문입니다:

path traversal entry "<name>": oci: content digest mismatch

메시지를 표시하는 단계가 해결 방법을 제공하는 경우, 두 조건 모두 같은 해결 방법을 담습니다:

remediation: run aggrega pull —upgrade —release <release> to refresh the lockfile and cache

해결 방법: 엔터티 파일의 어떤 내용도 이 문제의 원인이 아니며, 작성 내용을 변경해도 해결되지 않습니다. aggrega pull --upgrade --release <release>로 캐시와 lockfile을 함께 갱신합니다. 이 명령은 소스에서 다시 가져와 둘 다 다시 씁니다. 이것으로 해결된다면 캐시된 사본이 기록된 이후 변경되었거나 잘린 것입니다. 갱신 후에도 불일치가 남는다면 게시자가 제공하는 바이트가 실제로 고정된 것과 다른 것입니다. 이는 다시 게시된 버전이며, 게시자에게 문의할 사항이고, 새 다이제스트를 채택하기 전에 문의할 가치가 있습니다.

A manifest carries no layer of the expected kind, or more than one (매니페스트에 예상한 종류의 레이어가 없거나 둘 이상 있음)

아티팩트의 매니페스트는 레이어를 나열하며, 콘텐츠를 담은 레이어는 위치가 아니라 미디어 타입으로 선택됩니다. 이 덕분에 아티팩트는 둘 이상의 레이어를 묶으면서도(예를 들어 차트와 그 옆의 분리된 출처 증명 레이어) 콘텐츠를 안정적으로 골라낼 수 있습니다.

두 가지 형태에서는 선택할 것이 없습니다. 예상한 타입의 레이어가 없으면 매니페스트가 참조를 읽은 방식과 다른 무언가를 기술한다는 뜻입니다. 둘 이상이면 선택에 답이 없다는 뜻이며, 첫 번째를 고르면 때로는 맞고 때로는 아무 경고 없이 틀리게 됩니다.

출력되는 메시지는 각각 예상한 미디어 타입을 명시합니다. 없는 경우:

oci: manifest has no layer of media type "<media-type>": oci: manifest has no layer of the expected content media type

둘 이상인 경우에는 개수도 명시합니다:

oci: manifest has <count> layers of media type "<media-type>"; expected exactly one: oci: manifest has multiple layers of the expected content media type

해결 방법: 이 문제는 직접 해결할 것이 아니라 게시자가 해결할 문제입니다. 매니페스트는 카탈로그 작성자가 작성하는 것이 아니기 때문입니다. 먼저 참조가 의도한 곳을 가리키는지 확인합니다. 다른 종류의 아티팩트로 해석되는 참조는 첫 번째 형태를 일으킵니다. 그 매니페스트는 다른 무언가에 대한 실제 매니페스트이기 때문입니다. 참조가 올바르다면 아티팩트가 주장하는 종류로 기술하지 않는 매니페스트와 함께 게시된 것이므로, 메시지의 미디어 타입을 게시자에게 전달합니다. 일반적인 게시 경로로 게시하면 콘텐츠 레이어가 정확히 하나인 매니페스트가 생성되므로, 어느 형태든 해당 아티팩트는 다른 방식으로 조립된 것입니다.

A published bundle holds no entity, or holds two (게시된 번들에 엔터티가 없거나 두 개 있음)

문서 옆에 파일을 선언하는 엔터티(Recipe의 로컬 차트나 그 잠금 파일, Component의 가져온 스키마)는 엔터티와 그 파일들을 함께 묶은 .tar.gz로 게시됩니다. 이를 다시 읽으려면 그 파일들 가운데서 엔터티를 다시 찾아야 하는데, 엔터티가 작성된 파일의 이름은 무엇이든 될 수 있으므로 엔터티를 식별하는 것은 이름이 아니라 엔터티가 지닌 엔터티 프리앰블입니다. 번들 최상위에 있는 문서 중 kind:가 게시 가능한 엔터티 종류인 문서가 엔터티입니다. 그 옆의 compose 조각, 차트 템플릿, Kubernetes 매니페스트는 엔터티가 아니며, source/ 트리 안 더 깊은 곳의 엔터티 문서도 엔터티가 아닙니다. 그것은 엔터티 자체가 아니라 엔터티가 함께 배포하는 콘텐츠입니다.

두 가지 형태에서는 선택할 것이 남지 않으며, 둘 다 아티팩트가 게시된 방식에서 비롯된 속성입니다.

번들 최상위에 엔터티 문서가 없음. 번들이 최상위에 엔터티 없이 패킹되었습니다. 문서가 빠졌거나, 함께 담는 파일들 옆이 아니라 하위 디렉터리에 놓인 경우입니다. 메시지에는 번들 최상위에 실제로 있는 항목이 나열되며, 대개 이것으로 어느 쪽인지 알 수 있습니다.

번들 최상위에 엔터티 문서가 두 개 있음. 두 엔터티가 작성된 디렉터리 전체로부터 번들이 패킹되었습니다. 각 엔터티는 자신이 선언한 파일만 담으므로 aggrega push는 결코 이렇게 하지 않지만, 다른 클라이언트는 그럴 수 있습니다. 그렇게 패킹되면 두 엔터티의 게시 좌표가 각각 같은 바이트를 담게 되므로, 어느 쪽으로 응답하든 요청된 이름 아래 다른 엔터티를 돌려줄 수 있고 이후 단계에서는 이를 알아챌 수 없습니다. 안전한 선택이 없으므로 어떤 선택도 하지 않습니다.

출력되는 메시지에는 발견된 항목이 나열됩니다. 번들에 다른 파일은 있지만 엔터티가 없는 경우:

bundle root carries no entity document among <file>, <file>: oci: published bundle carries no entity document (번들 루트의 파일 중에 엔터티 문서가 없음: oci: 게시된 번들에 엔터티 문서가 없음)

번들에 아무것도 없는 경우:

bundle root carries no files at all: oci: published bundle carries no entity document (번들 루트에 파일이 전혀 없음: oci: 게시된 번들에 엔터티 문서가 없음)

그리고 둘 이상인 경우로, 개수와 충돌하는 문서를 모두 밝힙니다:

bundle root carries <count> entity documents (<file>, <file>): oci: published bundle carries more than one entity document (번들 루트에 엔터티 문서가 여러 개 있음: oci: 게시된 번들에 엔터티 문서가 두 개 이상 있음)

해결 방법: 두 경우 모두 사용자가 아니라 게시자가 해결할 문제이며, 수정할 곳은 엔터티가 게시된 버전 디렉터리입니다. 각 엔터티에 고유한 버전 디렉터리를 주어 그 디렉터리에 엔터티 하나와 그에 속한 파일만 두십시오. 이는 게시된 모든 엔터티가 이미 따르는 레이아웃으로, 디렉터리 이름은 엔터티의 metadata.version이고 엔터티 자체 이름 아래에 위치합니다. 그런 다음 새 버전으로 다시 게시하십시오. 게시된 바이트는 고정되므로 기존 버전 위에 다시 게시하면 수정되지 않고 거부됩니다. 게시가 아니라 사용하는 쪽이라면 메시지를 아티팩트 게시자에게 전달하십시오. 메시지의 파일 이름으로 분리할 디렉터리를 알 수 있습니다.

A published artifact cannot be read as an entity (게시된 아티팩트를 엔터티로 읽을 수 없음)

게시된 좌표에서 엔터티를 읽는 일은 레지스트리가 그곳에서 제공하는 바이트에서 시작합니다. aggrega inspect oci://…는 사용자가 볼 수 있도록 그 바이트를 읽고, 의존성 pull도 고정하는 버전을 찾기 위해 같은 방식으로 아카이브의 바이트를 읽습니다. 그 바이트의 두 가지 형태에는 읽을 엔터티가 없습니다.

압축이 풀리지 않는 아카이브. 선언한 파일과 함께 게시된 엔터티는 .tar.gz로 게시되며 바이트도 그렇게 시작하지만, 압축 스트림이나 그 안의 아카이브가 올바른 형식이 아닙니다. 대부분 중간에 잘렸기 때문입니다. 바이트는 여전히 아티팩트 자신의 매니페스트가 기록한 다이제스트와 일치하므로 게시된 그대로입니다. 즉 손상은 전달 도중이 아니라 게시 전이나 게시 중에 일어났습니다.

엔터티가 아닌 문서. 좌표에 문서 하나가 있는데, 파싱되지 않거나, kind:를 선언하지 않거나, Release나 Manifest처럼 게시되지 않는 종류를 선언합니다. 이 경우 참조는 엔터티가 아니라 카탈로그 옆에 게시된 무언가를 가리킵니다. 예를 들어 aggrega push-artifact로 게시된 데이터 아티팩트입니다.

출력되는 메시지. 압축 스트림이 올바른 형식이 아닌 아카이브로, 중단시킨 오류와 함께 표시됩니다:

oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked (oci: gzip 번들 해제 실패: oci: 게시된 번들의 압축을 풀 수 없음)

파일 중간에서 멈추는 아카이브:

read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked (게시된 번들에서 파일 읽기 실패: oci: 게시된 번들의 압축을 풀 수 없음)

게시되지 않는 종류를 선언하는 문서:

the published document declares kind <kind>, which a registry does not publish: oci: published artifact is not an entity document (게시된 문서가 레지스트리가 게시하지 않는 kind를 선언함: oci: 게시된 아티팩트가 엔터티 문서가 아님)

그리고 문서가 전혀 아닌 바이트:

the published bytes do not parse as a document (<parse error>): oci: published artifact is not an entity document (게시된 바이트를 문서로 파싱할 수 없음: oci: 게시된 아티팩트가 엔터티 문서가 아님)

해결 방법: 압축이 풀리지 않는 아카이브는 게시자가 교체해야 합니다. 게시된 바이트는 고정되므로 해결책은 엔터티를 새 버전으로 다시 게시하는 것입니다. 사용하는 쪽이라면 메시지를 게시자에게 전달하십시오. 엔터티가 아닌 문서는 거의 항상 참조가 의도한 것이 아님을 뜻합니다. 참조가 엔터티가 게시된 좌표를 가리키는지 확인하십시오. 이는 aggrega push가 엔터티를 게시할 때 출력하는 참조입니다.

The registry could not answer what is attached to an artifact (레지스트리가 아티팩트에 무엇이 첨부되어 있는지 응답하지 못함)

서명과 기타 첨부물은 아티팩트 안에 있는 것이 아니라 아티팩트에 연결되어 있으며, 이를 찾는 일은 레지스트리에 묻는 질문입니다. 이 조건은 그 질문이 응답되지 않았음을 뜻합니다. 레지스트리가 해당 조회를 지원하지 않거나, 첨부물이 연결된 아티팩트를 찾을 수 없거나, 요청 자체가 실패한 경우입니다.

이는 “첨부된 것이 없음”이라는 응답과 같지 않으며, 둘을 혼동하지 않도록 하는 것이 바로 이 조건의 목적입니다. 실제로 서명이 없는 아티팩트는 정상적으로 해석되어 빈 목록을 반환합니다. 이 조건은 목록을 아예 얻지 못했으므로 무엇이 첨부되어 있는지 전혀 알 수 없음을 뜻합니다.

중단 여부는 서명이 필요한지에 따라 달라지며, 두 방향 모두 의도된 것입니다:

  • 서명이 필요한 경우. 빌드가 중단됩니다. 실행할 수 없었던 필수 검사는 통과한 것이 아니며, 아티팩트를 받아들이면 아무도 제기하지 못한 질문에 기대게 됩니다.
  • 서명이 필요하지 않은 경우. 빌드는 계속되며, 조용히 넘어가지 않고 이를 명시적으로 알립니다. 조회 결과 어느 쪽으로도 검증할 것이 없으므로, 거부하면 응답되지 않은 질문을 근거로 아티팩트를 거절하게 됩니다. 하지만 침묵하면 서명 없는 정상적인 pull로 읽히는데, 실제로는 그렇지 않습니다.

출력되는 메시지. 조회를 지원하지 않는 레지스트리:

oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed (oci: 대상이 referrer 검색을 지원하지 않음: oci: referrer 검색을 완료할 수 없음)

아티팩트 자체를 찾을 수 없는 경우:

oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: subject 확인 실패: oci: referrer 검색을 완료할 수 없음)

그리고 조회가 실패한 경우:

oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: referrer 목록 조회 실패: oci: referrer 검색을 완료할 수 없음)

서명이 필요하지 않은 경우에는 같은 텍스트가 알림으로 표시됩니다:

signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above> (서명 검증을 실행할 수 없음. 레지스트리가 서명 조회에 응답하지 못했으며 서명이 필수가 아니므로 계속 진행함)

해결 방법: 운영자가 해결할 문제이며, 원인은 카탈로그가 아니라 레지스트리에 있습니다. 레지스트리가 첨부물 조회를 전혀 지원하지 않으면 서명을 담을 수 없으므로, 아티팩트를 지원하는 레지스트리로 미러링하거나 .aggrega-config.yaml에서 해당 호스트에 대한 서명 요구를 해제하십시오. 이때 어느 쪽을 선택하는지 기록해 두십시오. 후자는 해당 호스트의 서명을 더 이상 검사하지 않는다는 뜻이기 때문입니다. 조회를 지원하는 레지스트리에서 조회가 실패했다면, 이는 특히 첨부물 엔드포인트의 전송 또는 권한 문제이며, 레지스트리에 연결할 수 있게 되면 다시 실행하는 것만으로 해결됩니다.

An artifact that must be signed carries no signature (서명되어야 하는 아티팩트에 서명이 없음)

워크스페이스 자체의 서명 정책이 아티팩트의 kind를 포함하거나, 아티팩트를 가져온 레지스트리가 서명을 요구하도록 구성되어 있으면 해당 아티팩트에는 서명이 필요합니다. 이 조건은 레지스트리가 첨부물 조회에 응답했고, 첨부된 것이 없었으며, 서명이 필요했음을 보고합니다.

두 요구 사항은 하나의 입장을 두 범위에서 읽은 것입니다. 워크스페이스 전체 정책은 자체 항목이 서명을 요구하지 않는 호스트에서 온 것이라도 범위 내 kind에 서명을 강제하므로, 아무것도 요구하지 않는 호스트라고 해서 워크스페이스 전체 정책이 포함하는 아티팩트가 면제되지는 않습니다.

서명이 필요하지 않은 경우 이는 전혀 실패가 아닙니다. 서명이 있으면 아티팩트를 검증하고 없으면 조용히 통과하며, 덕분에 입장이 구성되지 않은 호스트도 번거로운 절차 없이 사용할 수 있습니다.

워크스페이스 전체 정책이 활성화된 상태에서 kind를 판별할 수 없는 아티팩트는 면제가 아니라 서명이 필요한 것으로 취급되므로, 분류할 수 없는 아티팩트가 켜져 있는 정책을 빠져나갈 수 없습니다.

출력되는 메시지이며, 검사 중이던 참조로 둘러싸입니다.

verifying the signature of <uri>: signing: no signature found for an artifact that requires one (URI의 서명 검증 중: 서명: 서명이 필요한 아티팩트에서 서명을 찾을 수 없음)

해결 방법: 해결은 엔티티 작성자가 아니라 운영자나 게시자의 몫입니다. 아티팩트가 서명되어 있을 것으로 예상했다면 서명 없이 게시된 것이므로, 서명을 첨부할 수 있는 것은 게시자뿐이니 게시자에게 참조를 전달하십시오. 아티팩트가 서명될 의도가 없는 것이라면 바꿔야 할 것은 요구 사항입니다. 요구 사항은 .aggrega-config.yaml의 레지스트리 항목이나 워크스페이스 전체 서명 정책에서 오며, 메시지의 참조를 보면 어느 호스트를 확인해야 하는지 알 수 있습니다. 요구 사항을 끄면 해당 호스트의 아티팩트가 더 이상 검사되지 않으므로, 완전히 끄기보다는 정책의 범위를 특정 kind로 좁히는 편이 좋습니다.

A signature does not verify (서명이 검증되지 않음)

서명을 찾아 검사했으나 검사가 실패했습니다. 이는 해당 검사의 일반적인 부정 결과로, 신뢰 자료에 뿌리를 두지 않는 인증서 체인, 투명성 로그 기록이 필요한데 없는 서명, 현재 가진 것과 다른 아티팩트에 대한 서명, 변조된 번들, 고정된 키로 검사했으나 검증되지 않는 번들을 포함합니다.

이는 서명자를 신뢰할 수 없는 서명과 의도적으로 구분됩니다. 그쪽은 구조적으로는 올바르지만 잘못된 서명자가 만든 것이고, 이쪽은 아예 검사를 통과하지 못한 것입니다. 둘을 분리해 두기 때문에 “아티팩트가 서명된 것과 다르다”와 “아티팩트가 승인하지 않은 누군가에 의해 서명되었다”를 구별할 수 있습니다.

서명이 어떤 아티팩트를 위해 만들어졌는지는 두 번 검사됩니다. 서명의 암호학적 검사가 통과하면 툴체인은 서명 자체에서 그것이 어떤 아티팩트를 위해 만들어졌는지 읽어 냅니다. 이는 이후의 모든 빌드가 기록된 서명에 적용하는 것과 같은 판독이며, 덕분에 빌드는 아무것도 검증하지 않고도 한 아티팩트에서 다른 아티팩트로 복사된 서명을 거부할 수 있습니다. 그리고 그 판독이 현재 가진 아티팩트를 가리키지 않거나, 서명이 판독으로 아티팩트를 알아낼 수 없는 형태이면 서명을 거부합니다. pull이 받아들이는 두 형태 모두 판독됩니다. 아티팩트 자체에 대해 만든 서명과, 아티팩트를 명시하는 서명된 진술입니다. 판독은 암호학적 검사 자체의 규칙을 따르므로 그 검사가 받아들이는 서명에 대해서는 둘이 일치합니다. 이런 종류의 거부는 둘이 일치하지 않았다는 뜻이며, 구성으로 우회하기보다는 참조와 메시지를 함께 보고할 가치가 있습니다.

레지스트리 항목이 검증을 권고(advisory)로 지정한 경우, 같은 텍스트가 알림으로 보고되고 실행은 계속됩니다.

출력되는 메시지. 검사 자체에서 나오며, 검증기가 보고한 내용을 인용합니다.

signing: signature bundle does not verify: <what the verifier reported> (서명: 서명 번들이 검증되지 않음: 검증기가 보고한 내용)

그리고 암호학적 검사는 통과했으나 서명이 어떤 아티팩트를 위해 만들어졌는지에 대한 판독이 일치하지 않는 경우:

signing: signature bundle does not verify: its cryptographic check holds, but it does not name <manifest-digest> as the artifact it was made for (서명: 서명 번들이 검증되지 않음: 암호학적 검사는 통과하지만, 표시된 매니페스트 다이제스트를 서명 대상 아티팩트로 지정하지 않음)

signing: signature bundle does not verify: its cryptographic check holds, but it is in a form from which the artifact it was made for cannot be read (서명: 서명 번들이 검증되지 않음: 암호학적 검사는 통과하지만 서명 대상 아티팩트를 읽어 낼 수 없는 형태임)

각각 검증 중인 참조로 둘러싸입니다.

verifying the signature of <uri>: <the message above> (URI의 서명 검증 중: 위의 메시지)

그리고 레지스트리 항목이 검증을 권고로 지정한 경우, 중단 대신 알림으로:

signature verification failed for <uri> (advisory; continuing): <the message above> (URI의 서명 검증 실패(권고 모드, 계속 진행): 위의 메시지)

해결 방법: 엔티티 파일의 어떤 것도 이 문제의 원인이 아니며, 어떤 작성 변경으로도 해결되지 않습니다. 이를 구성이 아니라 아티팩트에 관한 진술로 받아들이십시오. 현재 가진 바이트가 서명된 바이트가 아니거나, 서명이 구성된 신뢰 자료로 검사할 수 있는 것이 아닙니다. 잘리거나 변조된 캐시 사본이 정확히 이렇게 실패하고 새로 가져오면 해결되므로, 먼저 아티팩트를 다시 받으십시오. 새로 가져와도 계속된다면 참조와 검증기의 원래 문구를 아티팩트 게시자에게 전달하십시오. 이를 넘기기 위해 권고 설정에 손대지 마십시오. 그 설정은 검사를 계속 실행하되 중단하지 않게 할 뿐이며, 이는 문제를 고치는 방법이 아니라 해당 호스트의 검증되지 않은 아티팩트를 받아들이겠다는 의도적인 선택입니다.

A signature verifies but its signer is not one the registry trusts (서명은 검증되지만 서명자가 레지스트리가 신뢰하는 대상이 아님)

서명은 검사를 통과했습니다. 인증서 체인이 신뢰 자료에 뿌리를 두고 투명성 기록도 있습니다. 그러나 그 인증서의 신원이 해당 레지스트리에 허용 대상으로 구성된 신원 중 어느 것과도 일치하지 않습니다. 아티팩트는 승인되지 않은 실제 서명자에 의해 서명되었습니다.

신원의 두 부분이 모두 비교됩니다. 주체(subject)와 그것을 보증한 발급자(issuer)이며, 둘 중 어느 쪽이든 일치하지 않은 쪽일 수 있습니다. 메시지는 인증서에서 읽을 수 있는 경우 둘 다 표시합니다. 아무도 승인하지 않은 발급자 아래에서 예상된 주체를 제시하는 서명자는 둘 다 표시하지 않으면 잘못된 주체와 똑같아 보이기 때문입니다.

출력되는 메시지. 두 부분을 모두 읽을 수 있는 경우:

signing: signature identity is not trusted for this registry: <what the verifier reported>; signer presented issuer "<issuer>" with identity "<subject>", but no trusted identity permits that issuer (서명: 서명 ID를 이 레지스트리에서 신뢰하지 않음: 검증기가 보고한 내용; 서명자가 표시된 발급자와 ID를 제시했으나, 해당 발급자를 허용하는 신뢰 ID가 없음)

그리고 읽을 수 없는 경우, 검증기 자체의 보고로 대체됩니다:

signing: signature identity is not trusted for this registry: <what the verifier reported> (서명: 서명 ID를 이 레지스트리에서 신뢰하지 않음: 검증기가 보고한 내용)

해결 방법: 이는 운영자의 결정이며, 형식적 절차가 아니라 실질적인 결정입니다. 메시지의 발급자와 신원을 .aggrega-config.yaml에서 해당 레지스트리에 구성된 신뢰 신원과 비교하십시오. 서명자가 승인하려는 대상이라면 추가하십시오. 항목은 신원 또는 신원과 일치하는 패턴을 발급자와 함께 지정하며, 둘 다 정확해야 합니다. 그렇지 않다면 아티팩트는 승인하지 않은 누군가에 의해 서명된 것이며, 빌드를 통과시키려고 그 신원을 추가하는 것이야말로 피해야 할 대응입니다. 자체 신뢰 정책을 공개하는 레지스트리는 레지스트리를 추가할 때 그 정책을 고정할 수 있으며, 이것이 신원을 옮겨 적지 않고 의도한 신원을 들여오는 방법입니다.

A keyless trust policy names no acceptable signer (키리스 신뢰 정책이 허용 가능한 서명자를 지정하지 않음)

키리스 검증은 서명 인증서의 ID를 허용 가능한 것으로 구성된 ID 집합과 대조하여 아티팩트를 수락할지 결정합니다. 빈 집합은 정책으로 취급되지 않고 거부됩니다. 아무것도 없는 집합과 대조하면 모든 서명자를 수락하거나 모든 서명자를 거부하게 되며, 어느 쪽도 검증을 구성한 운영자가 의도한 바가 아니기 때문입니다.

출력되는 메시지이며, 이 조건 자체의 문장입니다.

signing: keyless verification requires at least one trusted identity (signing: 키리스 검증에는 신뢰할 수 있는 ID가 하나 이상 필요합니다)

해결 방법: .aggrega-config.yaml에서 해당 레지스트리에 신뢰할 수 있는 ID를 하나 이상 구성합니다. 항목은 ID(정확한 subject 또는 이와 일치하는 패턴)와 이를 보증하는 발급자를 함께 지정하며, 둘 다 필수입니다. 레지스트리가 자체 신뢰 정책을 공개하는 경우, 레지스트리를 추가할 때 그 정책을 고정하면 레지스트리가 게시하는 내용으로 집합이 채워집니다. 이 레지스트리의 서명을 전혀 검증할 의도가 없다면, 그것은 빈 ID 집합과는 다른 설정이며 이를 명시적으로 설정해야 그 의도가 표현됩니다.

The pinned trust root cannot be read (고정된 신뢰 루트를 읽을 수 없음)

워크스페이스에 고정된 신뢰 루트는 키리스 검사가 어디에서 실행되든 네트워크 접근 없이 검증할 수 있게 해 줍니다. 이는 모든 서명을 검사하는 기준이 되는 자료를 내용으로 담은 파일입니다. 이 조건은 구성된 경로의 파일을 사용 가능한 신뢰 자료로 변환할 수 없었음을 보고합니다. 파일이 없거나, 읽을 수 없거나, 내용이 신뢰 루트가 아닌 경우입니다.

대체 동작으로 넘어가지 않고 중단합니다. 고정된 루트는 직접 관리하는 자료로 서명을 검사하겠다는 의도적인 선택이므로, 대신 조용히 루트를 가져오면 그 선택이 다른 선택으로 바뀌고 아무도 요청하지 않은 검증 결과가 만들어집니다.

출력되는 메시지이며, 경로를 지정하고 읽기 작업이 보고한 내용을 인용합니다.

signing: cannot load pinned trust root: <path>: <what the read reported> (signing: 고정된 신뢰 루트를 로드할 수 없습니다)

해결 방법: 이는 운영자가 해결할 문제입니다. 신뢰 루트로 구성된 경로가 존재하는지, 그리고 명령을 실행하는 사용자가 읽을 수 있는지 확인합니다. 다른 작업 디렉터리를 기준으로 한 상대 경로나, 파일은 있지만 읽을 수 없는 경우 모두 여기에서 보고됩니다. 파일이 존재하고 읽을 수 있다면 내용이 신뢰 루트가 아닌 것이므로, 파일을 편집하지 말고 원래 입수한 출처에서 받은 최신 번들로 교체합니다. 루트를 고정할 의도가 없었다면 구성을 변경해야 합니다. 고정을 해제하면 검증은 그렇지 않을 때 제공받을 자료를 사용합니다.

A pinned verification key is not the key profile the verifier accepts (고정된 검증 키가 검증기가 허용하는 키 프로필이 아님)

보유 키를 사용한 서명과 검증에는 하나의 키 프로필이 사용되며, 다른 종류의 키는 시도되지 않고 거부됩니다. 이는 키의 유형에 관한 진술이며, 키가 무언가를 검증하는지에 관한 것이 아닙니다.

보고되는 두 시점은 서로 다른 작업입니다. 하나는 서명에 사용할 키를 로드하는 것으로, 아티팩트를 게시하는 곳에서 일어납니다. 다른 하나는 레지스트리에 고정된 키로 서명을 검사하는 것으로, 아티팩트를 검증하는 곳에서 일어납니다. 거부는 두 경우 모두 동일합니다.

출력되는 메시지이며, 각각 실제로 제공된 키의 알고리즘인 an RSA key 또는 an Ed25519 key를 지정합니다. 고정된 검증 키의 경우:

signing: unsupported held-key type: pinned key is <the key's algorithm>, want ECDSA P-256 (서명: 지원되지 않는 보유 키 유형: 고정된 키가 표시된 알고리즘이며, ECDSA P-256이어야 합니다)

서명용으로 로드한 키의 경우:

signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256 (서명: 지원되지 않는 보유 키 유형: 보유 키가 표시된 알고리즘이며, ECDSA P-256이어야 합니다)

해결 방법: 메시지가 지정하는 프로필의 키를 제공합니다. 검증하는 경우, 키는 .aggrega-config.yaml에서 레지스트리에 고정된 키이며 게시자가 서명에 사용하는 키의 공개 키여야 합니다. 유형은 맞지만 다른 키인 경우에는 대신 검증되지 않는 서명으로 보고되므로, 여기서 불일치가 발생했다면 대개 잘못된 파일이 고정된 것입니다. 서명하는 경우, 지정된 프로필의 키를 생성하거나 보유 키가 전혀 필요 없는 키리스 경로를 사용합니다.

The workspace is offline and the step needs the network (워크스페이스가 오프라인인데 단계에 네트워크가 필요함)

워크스페이스는 오프라인으로 표시할 수 있으며, 이 설정은 선호가 아니라 거부입니다. 네트워크에 접근하려는 모든 단계는 생성되는 시점에, 어떤 연결도 시도되기 전에 거부됩니다. 일찍 거부하기 때문에 실패가 나중에 설명 없는 타임아웃으로 드러나지 않고 “이 워크스페이스는 오프라인입니다”라고 알려 줍니다.

하나의 결정을 한 곳에서 읽습니다. 네트워크에 접근할 수 있는지 미리 알아야 하는 단계는 가져오기 작업 자체가 묻는 것과 같은 질문을 하므로, 검사와 그 검사가 보호하는 작업이 서로 다른 결론에 이를 수 없습니다.

이 거부는 여러 종류의 작업에 적용되며, 모두 같은 거부입니다. 레지스트리에서 아티팩트 획득, 네트워크를 통한 Recipe의 소스 획득, 외부 입력 가져오기, 서명에 사용할 ID 획득, 신뢰 자료 가져오기가 해당됩니다. 채워진 캐시를 읽는 빌드는 이 중 어느 것에도 해당하지 않으며, 그것이 이 설정의 목적입니다.

명령 전체가 네트워크 왕복인 경우, 거부는 마지막이 아니라 처음에 옵니다. push, push-artifact, registry update는 레지스트리에 접근하기 위해 존재하므로, 엔티티를 읽거나 저장소를 탐색하기 전에 이를 알리고, 세 곳 중 어디에서 이 상태가 설정되었는지(입력한 플래그, 환경 변수, 또는 파일과 그 안의 키)를 지정합니다. --dry-run은 예외이며, 이름 때문이 아니라 하는 일 때문에 예외입니다. 게시할 내용을 보고할 뿐 아무것도 호출하지 않으므로 오프라인에서 안전한 게시 형태이며 계속 동작합니다.

출력되는 메시지이며, 자체 해결 방법을 담고 있고 이 조건 자체의 문장입니다.

egress: network access refused because the workspace is offline; remediation: pass --offline=false to allow the network for this one run, or clear the top-level offline key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run aggrega pull --release <release> from a connected environment first to populate the cache (egress: 워크스페이스가 오프라인이므로 네트워크 접근이 거부되었습니다. 해결 방법: 이번 한 번의 실행에 네트워크를 허용하려면 위의 플래그를 전달하고, 이후로 계속 허용하려면 구성 파일의 최상위 오프라인 키(또는 AGGREGA_OFFLINE)를 해제합니다. 머신에 없는 콘텐츠가 필요한 빌드라면 먼저 네트워크에 연결된 환경에서 위의 pull 명령을 실행하여 캐시를 채웁니다)

네트워크가 필요했던 작업(예: Recipe의 소스 획득)으로 감싸집니다.

sourceresolver: kind=<kind> url=<url> version=<version>: <the message above>

오프라인 워크스페이스에서 공식 허브를 추가하는 것은 거부되지 않습니다. 허브는 내장 기준선으로 추가되며, 워크스페이스가 오프라인이므로 허브에 신뢰 정책을 요청하지 않았다는 알림이 표시됩니다.

해결 방법: 메시지는 세 가지 방법을 제시하며, 어느 것이 적용되는지는 사용자가 결정합니다. 상태가 설정되어 있고 이번 명령에 한해 넘어가려면 --offline=false를 전달합니다. 이 플래그는 바로 그 용도이며, 구성 파일을 직접 작성하지 않은 사람이 사용할 수 있는 유일한 방법입니다. 워크스페이스가 오프라인이어야 하는 경우에는 누락된 콘텐츠를 해결해야 합니다. 네트워크에 접근할 수 있는 곳에서 pull을 실행하여 release가 참조하는 모든 것을 캐시에 담으면, 이후 오프라인 빌드에는 더 필요한 것이 없습니다. 오프라인일 필요가 전혀 없다면 설정을 그 출처에서 해제합니다. .aggrega-config.yaml의 최상위 offline 키 또는 메시지가 지정하는 환경 변수이며, 환경 변수는 어떤 파일에도 없기 때문에 놓치기 쉽습니다. 인증서 발급과 기록은 오프라인 형태가 없는 네트워크 작업이므로, 오프라인 워크스페이스에서는 키리스 경로로 서명할 수 없다는 점에 유의합니다.

토폴로지를 빌드할 때

모든 Component에 Recipe가 확정되면, 컴파일러는 각 Component의 uses: 블록을 읽고 대상과 기능 연결(attachment)을 상호 참조하여 Components를 IR 그래프로 엮습니다.

Dangling uses target (존재하지 않는 대상을 가리키는 엣지)

uses: 엣지가 확정된 토폴로지에 존재하지 않는 대상 컴포넌트를 지정합니다. 이 중단은 출처에 구애받지 않습니다. 개발자가 작성한 Aggregate 엣지와 Release가 연결한 엣지가 똑같이 검출됩니다. 존재하지 않는 대상은 조용히 버려지지 않고 치명적 중단이 됩니다. 그렇지 않으면 존재하지 않는 대상으로 향하는 엣지가 사라져, 배포 시점에 소비자의 주입된 값이 조용히 비어 있게 됩니다. 이는 아래의 선언되지 않은 소켓 중단의 구조적 짝입니다. 연결이 어느 소켓에 연결되든, 엣지의 타입을 검사하기 전에 그 대상이 기존 컴포넌트로 확정되어야 합니다.

출력되는 메시지입니다. 거부가 먼저 나오고, 이어서 아무것에도 대응하지 않는 대상과 연결이 연결된 소켓이 나오며, 마지막으로 해결 방법이 나옵니다:

uses edge target does not exist ("<target>", wired into socket "<socket>"). Point the target at a component the Aggregate declares, or declare a component under that name. (uses 엣지의 대상이 존재하지 않습니다. 대상을 Aggregate가 선언한 컴포넌트로 지정하거나, 그 이름으로 컴포넌트를 선언하십시오.)

검출 결과는 해당하는 작성 항목에, 그 항목이 작성된 문서 안에서 위치가 지정됩니다. 따라서 컴포넌트 자신의 uses: 블록이 그린 연결, 연결(attachment)이 투영한 연결, Release가 연결한 연결은 각각 자기 블록에서 보고됩니다. 문제가 있는 연결은 각각 별도의 검출 결과로 보고되므로, 한 번의 빌드가 첫 번째에서 멈추지 않고 모두를 알려 줍니다.

해결 방법: 누락된 대상 컴포넌트를 선언하거나, uses: 항목의 대상 이름을 기존 컴포넌트와 일치하도록 수정하십시오.

Two connections of one component under one alias (한 컴포넌트의 두 연결이 하나의 별칭을 사용함)

컴포넌트는 각 연결을 별칭으로 읽습니다. 별칭은 연결이 작성된 키이며, 목록 항목으로 작성된 연결의 경우 대상 자신의 이름입니다. Recipe 템플릿은 컴포넌트의 연결을 별칭만으로 키를 지정해 읽고, 어서션은 소켓 다음 별칭으로 키를 지정해 읽습니다. 따라서 한 컴포넌트의 두 연결이 하나의 별칭을 사용하면 적어도 한 쪽 보기에서 하나의 슬롯을 공유하게 됩니다. 나중 것이 슬롯을 차지하고, 다른 하나는 템플릿이나 어서션이 보는 내용에서 빠집니다. 그래서 하나의 별칭은 컴포넌트의 연결 하나를 가리킵니다. 각 연결이 어느 소켓에 연결되었든, 무엇이 그렸든(컴포넌트 자신의 uses: 블록, 어떤 범위에서든 연결(attachment)의 uses: 블록, 또는 Release의 엣지별 항목), 대상이 무엇이든 마찬가지입니다. 이런 쌍은 그래프가 확정된 후, 어떤 어서션이 실행되기 전, 그리고 무엇이든 렌더링되기 전에 빌드를 중단시킵니다.

이런 쌍은 각 작성 위치에서 단독으로는 합법인 작성에서 생깁니다. 하나의 소켓과 별칭에 대한 컴포넌트 자신의 항목과 연결(attachment)의 항목, 하나의 대상을 두 번 지정하는 목록(models: [llama, llama]), 두 소켓에 작성된 하나의 별칭(models: { local: … }과 databases: { local: … }), 하나의 별칭을 연결하는 두 연결(attachment), 또는 Aggregate가 바인딩하지 않은 소켓에 Aggregate가 이미 다른 소켓에서 사용한 별칭으로 연결을 그리는 Release 항목이 그렇습니다. 인접한 두 형태는 이 중단에 이르지 않습니다. 키 지정 항목의 한 블록에 하나의 키를 두 번 작성하면 문서 로드가 실패하고, 다른 블록이 이미 그린 소켓과 별칭에 대한 Release 항목은 두 번째 연결을 그리지 않고 그 연결을 구성합니다. 다른 대상을 지정하면 대상 변경으로 중단됩니다.

출력되는 메시지입니다. 거부가 먼저 나오고, 이어서 별칭과 컴포넌트, 이 연결의 소켓과 대상과 항목이 작성된 위치, 그리고 이미 그 별칭을 가진 연결에 대한 같은 정보가 나오며, 마지막으로 해결 방법이 나옵니다:

connection alias is already used by another connection of the same component ("<alias>", on component "<component>", this connection wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>", the connection already holding the alias wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>"). Give one of the two connections an alias of its own: a component reads each connection by its alias, whatever socket it is wired into. A list entry takes its target’s name as its alias, so a target listed twice is listed once, or written as two keyed entries under two aliases. (연결 별칭이 같은 컴포넌트의 다른 연결에서 이미 사용되고 있습니다. 두 연결 중 하나에 고유한 별칭을 지정하십시오. 컴포넌트는 어느 소켓에 연결되어 있든 각 연결을 별칭으로 읽습니다. 목록 항목은 대상의 이름을 별칭으로 사용하므로, 두 번 나열된 대상은 한 번만 나열하거나 서로 다른 두 별칭을 키로 하는 항목 두 개로 작성하십시오.)

두 연결이 하나의 키 경로에 작성된 경우(하나의 대상을 두 번 지정하는 목록), 각 연결은 그 목록에서의 위치로도 지정됩니다. list entry "2"와 list entry "1"처럼 표시되며, 이것이 두 항목을 구별하는 유일한 정보입니다.

검출 결과는 나중 연결 자신의 항목, 즉 두 번째로 그려져 그렇지 않았다면 별칭의 슬롯을 차지했을 항목에, 그 항목이 작성된 문서 안에서 위치가 지정됩니다. 따라서 Release 항목이나 Release가 작성한 연결(attachment)은 운영 측 결함으로, Aggregate의 항목은 개발자 측 결함으로 분류됩니다. 문제가 있는 연결은 각각 별도의 검출 결과로 보고되므로, 한 번의 빌드가 모두를 알려 줍니다.

일부 형태는 덜 정확하게 지정됩니다. 둘 이상의 범위에서 선언된 연결(attachment) 이름(예를 들어 컴포넌트와 그 컴포넌트를 보유한 서브시스템 양쪽)은 선언한 각 블록에서 연결을 그리며, 빌드는 둘 다 연결(attachment) 이름만으로 기록합니다. 그러면 두 연결은 선언한 블록 중 하나, 즉 그 이름이 선언된 경우 컴포넌트 자신의 연결(attachment) 블록에서 지정되며, 어느 쪽도 목록 위치를 갖지 않습니다. 가져온 Aggregate 안에서도 마찬가지이며, 선언한 블록들(컴포넌트의 블록과 모듈 자신의 서브시스템 중 하나의 블록)은 모듈 자체 문서에서 지정됩니다. 이 모든 형태에서도 쌍은 여전히 거부됩니다.

해결 방법: 두 연결 중 하나에 고유한 별칭을 지정하십시오. 하나의 대상을 두 번 지정하는 목록이라면 대상을 한 번만 나열하거나, 두 연결을 두 별칭 아래의 키 지정 항목으로 작성하십시오. 두 소켓에 하나의 별칭이 있다면 두 키 중 하나의 이름을 바꾸십시오. 컴포넌트가 이미 사용하는 별칭으로 소켓을 연결하는 연결(attachment)은 자신의 uses: 블록에서 다른 키를 사용해야 합니다.

uses: socket not declared in the owning entity’s usesSchema (소유 엔티티의 usesSchema에 선언되지 않은 uses: 소켓)

uses: 블록이 해당 표면을 소유한 엔터티가 자신의 usesSchema에 선언하지 않은 소켓을 지정합니다. 이는 선언된 소켓만 지정할 수 있는 두 표면 중 하나에서 발생합니다. 하나는 Feature 첨부의 uses:로, 소켓이 첨부된 Feature에 선언되어 있어야 하고, 다른 하나는 Release의 엣지별 uses:로, 소켓이 소비하는 Component에 선언되어 있어야 합니다. Release는 Component의 usesSchema가 이미 선언한 소켓 안에서만 엣지를 연결하거나 구성할 수 있습니다.

연결(attachment) 표면은 연결(attachment)이 작성되는 모든 범위에서 검사됩니다. 즉 컴포넌트, 서브시스템(Aggregate의 것이든 그것이 가져오는 모듈의 것이든), Release 경계, 그리고 모듈이 기여하는 컴포넌트의 항목을 포함한 Release 컴포넌트 항목에서 검사됩니다. 모듈 자체의 선언은 그 모듈을 가져오는 구성이 빌드된 뒤에 검사되며, 검출 결과는 모듈의 Aggregate와 그 문서 안의 키를 지정합니다.

컴포넌트 자신의 uses: 블록은 의도적으로 이 표면에 포함되지 않으므로, 이 중단은 해당 블록에서는 발생하지 않습니다. 개발자는 Aggregate가 선언하는 토폴로지를 소유하며 카탈로그가 선언하지 않은 소켓을 지정할 수 있습니다. 카탈로그가 어떤 소켓에 대해 아무것도 말하지 않는다는 것은 그 연결이 예상되지 않았다는 뜻이지 금지되었다는 뜻이 아닙니다. 그러한 소켓은 적법하며 그 엣지도 빌드됩니다. 대신 선언된 소켓이 갖는 셀렉터와 엣지별 계약을 잃게 됩니다. 따라서 그곳에서 소켓 이름의 철자를 틀리면 중단이 아니라 별도의 임시 연결이 되며, 두 철자를 모두 명시하는 경고로 보고됩니다. warnings.md의 “Uses-socket near-miss lint”를 참조하십시오.

출력되는 메시지:

unknown uses socket: name a socket the entity declares in its usesSchema — only a component’s own uses block may name one the catalog did not declare (Release <release-name>, at .spec.components.<component>, "<component-type>", "<socket-name>", "<declared-sockets>") (알 수 없는 uses 소켓: 엔터티가 usesSchema에 선언한 소켓을 지정하십시오. 카탈로그가 선언하지 않은 소켓은 컴포넌트 자체의 uses 블록에서만 지정할 수 있습니다. Release, 위치, 컴포넌트 유형, 소켓 이름, 선언된 소켓이 표시됩니다)

첨부 경로에서는 컴포넌트 유형 대신 피처 유형을 명시합니다. usesSchema를 전혀 선언하지 않은 첨부된 Feature의 경우에는 대신 해당 Feature에 uses: 선언이 허용되지 않는다고 보고합니다.

해결 방법: 첨부에서는 소켓 이름을 첨부된 Feature가 선언한 이름으로 수정하거나, 해당 소켓을 Feature의 usesSchema에 선언합니다. Release 엣지별 항목에서는 소켓 이름을 소비하는 Component가 선언한 이름으로 수정합니다. Release는 Component가 선언하지 않은 소켓을 도입할 수 없으며, 선언을 카탈로그 엔터티로 옮기는 것이 지원되는 방법입니다. 카탈로그 엔터티가 usesSchema를 전혀 선언하지 않았다면 그 표면에서 어떤 uses: 선언도 받아들이지 않으므로 해당 블록을 제거하십시오.

A connection carries an attachment under a name its socket declares no slot for (연결이 소켓에 슬롯이 선언되지 않은 이름으로 첨부를 가짐)

연결 항목의 features: 블록이 연결의 소켓에 선언된 어떤 슬롯에도 해당하지 않는 첨부를 지정합니다. 연결이 가지는 첨부는 닫힌 집합입니다. 연결이 거쳐 가는 소켓은 소비하는 Component의 usesSchema 항목에 있는 featuresSchema에서 해당 소켓의 연결이 채울 수 있는 모든 슬롯을 선언하며, 그 밖의 이름으로 된 첨부는 빌드가 로드될 때 거부됩니다. featuresSchema를 선언하지 않은 소켓은 그 연결에 어떤 첨부도 허용하지 않으며, Component가 선언하지 않았는데 Aggregate가 지정한 소켓도 마찬가지입니다. 그러한 소켓은 슬롯을 선언하지 않습니다.

이 규칙은 연결의 첨부를 작성하는 두 문서 모두에 적용됩니다. 즉 컴포넌트의 uses: 아래에 있는 Aggregate의 연결 항목과 Release의 엣지별 uses: 항목입니다. 하위 aggregate가 제공하는 컴포넌트의 경우, 개발자가 작성한 이름은 하위 aggregate 자체 문서를 읽은 후에 검사되며, 발견 사항은 그 문서의 파일과 그 안의 컴포넌트 항목을 명시합니다. Release의 이름은 구성이 평탄화된 후 Release가 대상으로 작성하는 모든 컴포넌트에 대해 검사되며, 발견 사항은 Release 자체 항목을 명시합니다. 이 항목은 그것이 속한 경계 안에 있거나, 하위 aggregate의 컴포넌트에 도달하는 라우팅 항목 아래에 있습니다. Component가 선언하지 않은 소켓에 대한 Release 항목은 이 중단이 아니라, 실제로 존재하는 소켓을 나열하는 위의 미선언 소켓 중단으로 보고됩니다.

출력되는 메시지. 거부 내용이 먼저 나오고, 이어서 문서와 항목, 첨부의 이름, 연결, 소켓, 컴포넌트, 소켓이 선언한 슬롯이 나온 다음 조치 방법이 나옵니다:

a connection carries an attachment under a name its socket declares no slot for (Aggregate <aggregate-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<attachment>", on the connection "<alias>", through socket "<socket>", of component "<component>", the socket declaring the slots "<slots>"). Write the attachment under one of the slots the socket declares, or declare this slot in the socket’s featuresSchema on the Component. (연결이 소켓에 슬롯이 선언되지 않은 이름으로 attachment를 가지고 있습니다. attachment를 소켓이 선언한 슬롯 중 하나로 작성하거나, Component의 해당 소켓 featuresSchema에 이 슬롯을 선언하십시오.)

이름이 소켓에 선언된 슬롯과 한 번의 편집 차이 이내인 경우, 즉 문자가 뒤바뀌거나 빠지거나 중복되거나 틀린 오타 형태인 경우, 그 슬롯이 바로 뒤에 명시되므로 의도했을 가능성이 높은 철자가 같은 문장에 나타납니다:

a connection carries an attachment under a name its socket declares no slot for (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, "credentail", near the declared slot "credential", on the connection "<alias>", …) (연결이 소켓에 슬롯이 선언되지 않은 이름으로 attachment를 가지고 있습니다. 선언된 슬롯과 가까운 이름이 함께 표시됩니다)

그러한 이름에 대해 별도의 권고는 발생하지 않습니다. 컴포넌트 자신의 features: 블록에서는 선언된 슬롯과 한 번의 편집 차이인 이름이 적법하며 아래의 “An attachment name is one edit from a declared slot (첨부 이름이 선언된 슬롯과 한 번의 편집 차이임)” 권고만 발생합니다. 연결에서는 그 이름이 거부되며, 거부 메시지 자체가 그 대응 관계를 담고 있습니다.

소켓이 슬롯을 선언하지 않은 경우 목록은 생략되고 안내 문구는 “The socket declares no slots, so no connection wired through it carries an attachment: remove the attachment, or declare the slot in the socket’s featuresSchema on the Component. (소켓이 슬롯을 선언하지 않으므로 이를 통해 연결된 어떤 연결도 첨부를 가질 수 없습니다. 첨부를 제거하거나, Component에서 소켓의 featuresSchema에 슬롯을 선언하십시오.)”가 됩니다. Component가 해당 소켓을 전혀 선언하지 않은 경우에는 “The component’s type does not declare this socket, so the socket declares no slots and no connection wired through it carries an attachment: remove the attachment, or declare the socket and its slot in the Component’s usesSchema. (컴포넌트 유형이 이 소켓을 선언하지 않으므로 소켓에 슬롯이 없고 이를 통해 연결된 어떤 연결도 첨부를 가질 수 없습니다. 첨부를 제거하거나, Component의 usesSchema에 소켓과 그 슬롯을 선언하십시오.)”가 됩니다.

문제가 되는 모든 첨부는 각각 별도의 발견 사항으로 보고되므로, 한 번의 빌드에서 모두 명시됩니다.

해결 방법: 소켓이 선언한 슬롯 아래에 첨부를 작성합니다. 또는 연결에 소켓에 없는 슬롯이 필요하다면 Component에서 소켓의 featuresSchema에 그 슬롯을 선언합니다. Component가 선언하지 않은 소켓이라면 Component의 usesSchema에 소켓과 그 슬롯을 선언하거나, 첨부를 제거하십시오.

Release retargets a developer-declared edge (Release가 개발자가 선언한 엣지의 대상을 변경함)

Release의 엣지별 uses: 항목이, 개발자가 같은 소켓과 별칭에 이미 연결한 대상과 다른 대상을 지정합니다. Release는 개발자가 선언한 엣지를 구성할 수 있고(엣지별 infra를 설정하며, 같은 대상을 지정하거나 대상을 생략함), 선언되었지만 바인딩되지 않은 소켓에 엣지를 연결할 수 있지만, 개발자가 선언한 엣지의 대상을 변경할 수는 없습니다. 개발자가 작성한 아키텍처는 개발자의 소유이기 때문입니다.

두 대상은 해석된 결과가 아니라 작성된 그대로 비교됩니다. target:은 컴포넌트 id 대신 하위 aggregate가 공개한 별칭을 지정할 수 있으며, 그 별칭은 모듈이 해당 별칭으로 공개하는 컴포넌트로 해석됩니다. 따라서 개발자가 작성한 바로 그 별칭을 반복하는 Release 항목은 구성으로 간주되어 허용되며, 일반 컴포넌트 id를 반복하는 경우와 똑같습니다.

이 중단이 발생하든 발생하지 않든 엣지는 개발자가 지정한 대상을 유지하며, Release 항목의 infra:는 그 엣지에 적용되지 않습니다. 거부된 대상 변경이 일부만 적용되는 일은 없습니다.

출력되는 메시지. 거부 내용이 먼저 나오고, 이어서 개발자가 선언한 대상, Release가 지정한 대상, 소켓이 나온 다음, 조치 방법이 나옵니다:

release edge retargets a developer-declared edge (declared target "<declared-target>", target the Release names "<release-target>", wired into socket "<socket>"). Drop the target from the Release entry to configure the connection as it was declared, or change the target where the connection is declared. (Release의 엣지가 개발자가 선언한 엣지의 대상을 변경합니다. 선언된 대상, Release가 지정한 대상, 연결된 소켓이 함께 표시됩니다. 선언된 대로 연결을 구성하려면 Release 항목에서 대상을 제거하고, 그렇지 않으면 연결이 선언된 곳에서 대상을 변경하십시오.)

이 결과는 연결을 선언한 문서에서, 연결이 선언된 작성 항목의 위치에 표시됩니다. 문제가 되는 각 항목은 개별 결과로 보고되므로, 실행할 때마다 하나씩이 아니라 한 번의 빌드에서 모두 표시됩니다.

해결 방법: 기존 엣지를 구성하려면(엣지별 infra만) Release uses: 항목에서 다른 target을 제거하거나, 연결이 실제로 다른 소켓에 속한다면 개발자가 바인딩하지 않고 남겨 둔 소켓을 통해 연결하십시오. 대상 자체를 변경하려면 토폴로지가 작성되는 Aggregate에서 변경하십시오.

Release per-edge configuration has no edge to apply to (Release 엣지별 구성을 적용할 엣지가 없음)

Release의 엣지별 uses: 항목이 infra:, features: 아래의 첨부, 또는 둘 다를 설정하지만, 빌드의 모든 엣지가 그려진 후에 그 항목이 지정하는 소비자, 소켓, 별칭에 엣지가 존재하지 않습니다.

Release 항목이 할 수 있는 두 가지는 엣지를 연결하는 것과 엣지를 구성하는 것이며, 어느 쪽을 하는지는 target:을 지정하는지에 따라 결정됩니다. 대상이 있는 항목은 자신이 구성하는 엣지를 생성합니다. 대상이 없는 항목은 이미 존재해야 하는 엣지를 구성합니다. 그 엣지는 개발자가 Aggregate에서 선언했거나 첨부된 Feature가 기여한 것입니다. 따라서 대상을 지정하지 않고 기존 엣지와도 일치하지 않는 항목은 아무것에도 적용되지 않습니다. infra: 블록과 그 아래의 첨부는 어떤 출력에도 도달하지 않습니다. 빌드는 아무 효과도 없는 작성 내용을 허용하지 않고 중단됩니다. 그렇지 않으면 빌드가 성공한 것이 인프라가 적용되었고 연결이 항목에 지정된 내용을 전달한다는 확인으로 읽히기 때문입니다.

별칭은 항목이 지정하는 내용의 일부이므로, 개발자가 선언한 적이 없는 별칭을 구성하는 항목은 소켓이 다른 별칭으로 바인딩되어 있더라도 어떤 엣지에도 도달하지 않습니다. Aggregate가 선언하지 않은 컴포넌트를 지정하는 항목도 마찬가지입니다.

인접한 두 가지 조건은 이 중단이 아니라 각자의 중단으로 보고됩니다. 각각 더 알려 줄 내용이 있기 때문입니다. 소비하는 Component의 usesSchema가 선언하지 않은 소켓은 선언되지 않은 소켓으로 보고되며, 실제로 존재하는 소켓을 나열할 수 있습니다. 어떤 컴포넌트도 지정하지 않는 target:은 댕글링 대상으로 보고됩니다. active: 토글로 꺼진 컴포넌트는 설계상 자신의 엣지도 함께 제거하므로, 그런 컴포넌트에 남겨진 항목은 중단되지 않고 허용됩니다.

문제가 되는 모든 항목이 보고됩니다. 엣지에 도달하지 않는 항목이 여러 개인 Release는 첫 번째 항목만 보고하고 나머지를 다음 빌드로 미루지 않고, 한 번의 빌드에서 문서가 선언한 순서대로 항목마다 하나씩 이 중단을 표시합니다.

항목이 존재하는 컴포넌트를 지정하는 경우 출력되는 메시지. 메시지에는 항목 자체의 경로가 포함되므로, 항목을 담고 있는 컴포넌트가 아니라 수정할 줄이 표시됩니다:

release per-edge configuration has no edge to apply to (Release <release-name>, at .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, "<consumer>", on socket "<socket>", under alias "<alias>"). Give the entry a target to wire the edge, or remove it: an entry with no target configures an edge that must already exist. (Release의 엣지별 구성을 적용할 엣지가 없습니다. Release, 항목의 경로, 소비자, 소켓, 별칭이 함께 표시됩니다. 엣지를 연결하려면 항목에 대상을 지정하고, 그렇지 않으면 항목을 제거하십시오. 대상이 없는 항목은 이미 존재해야 하는 엣지를 구성합니다.)

경계 아래가 아니라 최상위 수준에서 컴포넌트를 지정하는 Release는 작성자가 작성한 형태인 .spec.components.<consumer>.uses.<socket>.<alias>를 표시하며, aggregates: 라우팅 항목 안에서 지정된 컴포넌트는 그 항목을 통해, 그곳에서 사용하는 로컬 이름으로 표시됩니다.

항목이 Aggregate가 선언하지 않은 컴포넌트를 지정하는 경우, 중단은 빌드의 더 이른 단계에서 발생하며 항목이 설정하는 내용(infra, features 또는 infra and features)을 지정하여 다음과 같이 표시됩니다:

release per-edge configuration has no edge to apply to: release edge <consumer>/<socket>/<alias> sets <infra|features|infra and features> on <consumer>, which is not a component in the topology (Release의 엣지별 구성을 적용할 엣지가 없습니다. 해당 Release 엣지는 토폴로지에 있는 컴포넌트가 아닌 소비자에 대해 구성을 설정합니다.)

해결 방법: 항목에 target:을 추가하여 엣지를 연결하고 구성을 그 엣지에 적용하거나, 항목이 기존 엣지를 구성하도록 별칭을 Aggregate가 해당 연결에 선언한 별칭으로 수정하거나, 컴포넌트 이름을 Aggregate가 선언한 이름으로 수정하거나, 구성이 더 이상 필요하지 않다면 항목을 제거하십시오.

A Release attachment takes the name of a connection’s attachment (Release 첨부가 연결 첨부의 이름을 사용함)

Release가 컴포넌트의 연결 중 하나에 있는 첨부가 사용하는 이름으로 첨부를 작성합니다. 그 이름은 연결의 별칭, 점, 그리고 첨부가 채우는 슬롯으로 이루어집니다. 예를 들어 연결 gpt의 credential 슬롯을 채우는 첨부는 gpt.credential입니다. 연결의 첨부는 해당 연결 항목, 즉 컴포넌트의 uses: 아래에 있는 Aggregate의 연결이나 같은 연결에 대한 Release의 엣지별 uses: 항목에 작성되며, 이 조합된 이름으로 소비 컴포넌트의 첨부가 됩니다. Release는 키에 점을 포함할 수 있는 다른 두 범위에도 첨부를 작성하므로, 조합된 이름을 그곳에도 작성할 수 있습니다.

  • 컴포넌트 항목 자체의 features: 블록: 해당 컴포넌트에 첨부됩니다.
  • 경계 자체의 features: 블록: 해당 경계 또는 그 안에 중첩된 경계에 배치된 모든 컴포넌트에 첨부되며, 경계가 이름을 지정하지 않고 라우팅해 들이는 하위 Aggregate의 컴포넌트도 포함합니다. 그곳의 키가 도달하는 어떤 컴포넌트의 조합된 이름과 같으면, type:을 지정하는지와 관계없이 빌드가 중단됩니다.

빌드는 둘 중 어느 것도 연결의 첨부에 병합하지 않고 중단합니다. 병합하면 어느 문서도 빌드가 그 첨부로 하는 일 전체를 보여 주지 않기 때문입니다. 소켓의 슬롯은 연결마다 그 연결 자체의 항목으로 채워지며, 더 넓은 범위에서 내려오는 첨부로는 결코 채워지지 않습니다. 도달하는 컴포넌트의 어떤 연결 첨부도 사용하지 않는 점이 포함된 키는 일반 첨부 이름이며 거부되지 않습니다.

이 검사는 두 문서 중 어느 쪽이 연결에 둔 첨부든 모두 다루며, Aggregate가 선언한 컴포넌트뿐 아니라 하위 Aggregate가 제공하는 컴포넌트도 다룹니다.

컴포넌트 항목의 키에 대해 출력되는 메시지입니다. 거부가 먼저 나오고, 이어서 Release와 컴포넌트 항목, Release가 작성한 키, 컴포넌트, 연결, 소켓, 슬롯이 나온 다음, 그 첨부를 작성할 연결 항목이 나옵니다.

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.components.<component>, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on the connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this entry’s features: an attachment a connection carries is written on that connection and nowhere else. (Release 첨부가 컴포넌트의 연결 중 하나가 가진 첨부의 이름을 사용합니다. 해당 연결 항목의 features 아래에 작성하고, 이 항목의 features에서는 제거하십시오. 연결이 가진 첨부는 그 연결에만 작성합니다.)

경계의 키에 대해 출력되는 메시지입니다. 경계의 첨부 블록과, 연결이 그 첨부를 가진 컴포넌트를 명시합니다.

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.boundaries.<boundary>.features, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on component "<component>"’s connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this boundary’s features: an attachment a connection carries is written on that connection and nowhere else. (Release 첨부가 컴포넌트의 연결 중 하나가 가진 첨부의 이름을 사용합니다. 해당 컴포넌트의 연결 항목의 features 아래에 작성하고, 이 경계의 features에서는 제거하십시오. 연결이 가진 첨부는 그 연결에만 작성합니다.)

경계의 키가 조합된 이름을 가진 연결이 있는 여러 컴포넌트에 도달하면, 연결마다 별도로 수정해야 하므로 각 컴포넌트마다 한 번씩 보고됩니다.

이 결과는 키가 작성된 블록, 즉 컴포넌트 항목이나 경계의 features:에 위치가 지정됩니다. 키 자체에 점이 포함되어 위치로는 그런 키를 가리킬 수 없기 때문이며, 대신 키는 메시지에 명시됩니다. 경계를 지정하는 Release에서 컴포넌트 항목은 .spec.boundaries.<boundary>.components.<component>로 표시되고, aggregates: 라우팅 항목 안에서 지정된 컴포넌트는 그 항목을 거쳐 그곳에서 갖는 로컬 이름으로 표시되며, 중첩된 경계의 블록은 .spec.boundaries.<outer>.boundaries.<inner>.features로 표시됩니다.

해결 방법: 첨부를 해당 연결에 대한 Release의 항목, 즉 컴포넌트 아래의 uses.<socket>.<alias>.features.<slot>로 옮깁니다. Aggregate가 선언한 첨부의 크기를 지정하려면 그곳에 infra:만 작성하고, Release만 만드는 첨부라면 type:과 infra:를 작성합니다. 그런 다음 컴포넌트 또는 경계의 features:에서 점이 포함된 키를 제거합니다. 여러 컴포넌트의 연결을 대상으로 한 경계 전체 키는 해당 연결마다 한 번씩 작성합니다.

A Release connection attachment names no Feature type (Release 연결 첨부가 Feature 유형을 지정하지 않음)

Release의 엣지별 uses: 항목이 Aggregate가 해당 연결에 첨부를 선언하지 않은 슬롯 아래에 첨부를 두면서 type:을 지정하지 않았습니다. Release가 연결에 작성하는 첨부는 둘 중 하나입니다. Aggregate가 같은 연결에 이미 선언한 첨부의 크기를 지정하는 것으로, Aggregate의 선언이 유형을 지정하므로 유형을 지정하지 않습니다. 또는 Release만 만드는 첨부이며, 이 경우 Release 항목이 그 Feature 유형을 얻을 수 있는 유일한 곳입니다. 유형이 없으면 어떤 것도 그 첨부에 대한 FeatureRecipe를 선택할 수 없습니다.

이 검사는 Aggregate가 선언한 컴포넌트뿐 아니라 하위 Aggregate가 제공하는 컴포넌트도 다룹니다. active: 토글로 꺼진 컴포넌트는 연결도 함께 제거되므로, 그 컴포넌트에 남은 항목은 검사되지 않습니다.

출력되는 메시지입니다. 거부가 먼저 나오고, 이어서 Release와 연결 항목, 슬롯, 연결, 소켓, 컴포넌트가 나온 다음, 해결 방법이 나옵니다.

a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Name the Feature this attachment attaches under its type, or declare the attachment on the Aggregate’s connection entry and size it here. (Release 연결 첨부가 Feature 유형을 지정하지 않았으며, Release만 만드는 첨부에는 유형이 필요합니다. 이 첨부가 붙이는 Feature를 type으로 지정하거나, Aggregate의 연결 항목에 첨부를 선언하고 여기서 크기를 지정하십시오.)

문제가 되는 모든 첨부는 각각 별도의 발견 사항으로 보고되므로, 한 번의 빌드에서 모두 명시됩니다.

해결 방법: 첨부가 첨부하는 Feature를 지정하는 type:을 추가합니다. 또는 첨부를 개발자가 선언해야 하는 경우라면, Aggregate의 연결 항목에 values:와 함께 선언하고 Release 항목에는 infra:만 남깁니다.

Component identity cannot be stamped on what it emits (컴포넌트 식별자를 그 컴포넌트가 내보내는 리소스에 새길 수 없음)

컴포넌트의 식별자는 Aggregate 안의 키일 뿐만 아니라 클러스터 안의 이름이기도 합니다. 컴포넌트가 내보내는 모든 리소스에는 aggrega.ai/component-id와 app.kubernetes.io/name 아래에 이 식별자가 새겨지며, 워크로드 합성기는 내보내는 것의 이름을 이 식별자를 따라 짓습니다. 따라서 식별자는 대상이 받아들이는 이름이어야 하고, 말하는 그대로의 의미를 가지는 이름이어야 합니다.

작성한 이름은 작성한 그대로 출력에 도달하며, 덕분에 Aggregate에 있는 이름을 클러스터에서 그대로 찾을 수 있습니다. 이는 가치 있는 성질이며, 대상이 거부할 식별자를 작성하지 않은 무언가로 조용히 고치지 않고 여기서 보고하는 이유이기도 합니다.

한 문자가 예외이며, 이 문자는 직접 작성할 수 없습니다. 바로 모듈의 이름과 그 안의 컴포넌트 이름을 잇는 점입니다. 이 점은 그 연결이 모호하지 않도록 작성하는 모든 이름에서 예약되어 있으며, 식별자를 새기기 전에 식별자에서 변환되어 제거됩니다. data-layer.main-db는 data-layer-zdmain-db로 새겨집니다. 이로 인해 누군가 입력한 이름이 희생되지는 않으며, 이것이 가져온 Aggregate가 제공하는 컴포넌트를 새길 수 있게 해 줍니다. 점은 Service 이름이 허용하는 문자가 아니며, 클러스터 주소 안에서는 서비스와 네임스페이스를 구분하므로, 점이 들어간 이름을 호스트로 소비자에게 넘기면 실패하는 대신 다른 서비스로 해석됩니다.

두 가지 형태가 거부됩니다.

새김 문자 집합이 담을 수 없는 식별자. 식별자는 내보내는 모든 리소스가 가지는 레이블 값에 기록되며, 이 문자 집합은 문자, 숫자, -, _, .를 허용하고 값이 문자나 숫자로 시작하고 끝나야 합니다. 작성하는 이름의 규칙은 이와 비슷하지만 같지 않아 이름이 -나 _로 시작하거나 끝나는 것을 허용하므로, _api와 api-는 둘 다 작성할 수 있는 이름이지만 어느 것도 새길 수 없습니다.

이름의 길이는 여기서 검사하지 않습니다. 길이는 컴포넌트가 배포되는 대상이 정할 일이며, 대상마다 답이 다릅니다. 이 조건은 어떤 대상도 담을 수 없는 형태를 다룹니다. 길이 때문에 거부된 이름은 대신 대상 자체의 거부로 보고되며, 여기에는 그 대상의 이유와 대상이 받아들일 길이가 담깁니다.

합성된 식별자처럼 시작하는 식별자. Feature가 내보내는 리소스에는 작성한 컴포넌트 이름을 새길 수 없으므로, Aggrega는 작성한 부분들로 식별자를 합성하고 그 앞에 Feature가 어디에 붙었는지 나타내는 고정된 시작부를 둡니다. Feature가 단일 컴포넌트에 붙은 경우 식별자는 그 컴포넌트와 Feature가 붙은 키로 합성되며 cfr--로 시작합니다. 전체 경계에 붙은 경우에는 어느 한 컴포넌트의 이름도 적용되지 않으므로, 식별자는 경계의 경로와 Feature가 붙은 이름으로 합성되며 bfr--로 시작합니다. 시작부는 리소스가 컴포넌트가 아니라 이 둘 중 어디에서 왔는지 읽는 사람에게 알려 줍니다. 따라서 bfr--와 cfr--는 모두 컴포넌트 식별자의 시작 부분에서 예약되어 있습니다. bfr--api나 cfr--api라는 이름의 컴포넌트는 합성된 식별자와 똑같이 새겨지며, 내보낸 출력의 어떤 것으로도 둘을 구별할 수 없습니다. 전체 시작부만 예약되어 있습니다. bfr, cfr, bfr-api, bfrontend라는 이름의 컴포넌트는 평범한 이름이며 빌드됩니다.

이 검사는 컴포넌트가 실제로 가지는 식별자를 읽으며, 가져온 Aggregate가 제공하는 컴포넌트의 경우 이는 한정된 식별자, 즉 모듈 이름, 점, 그리고 컴포넌트 자체의 이름입니다. 따라서 각각으로는 허용되는 두 이름이 합쳐져 허용되지 않는 식별자가 될 수 있습니다. bfr--x라는 모듈과 그 안의 y라는 컴포넌트는 bfr--x.y로 합쳐지며, 이는 합성된 식별자처럼 시작합니다. 이 중단은 작성한 키를 가리키면서 합쳐진 식별자를 명시합니다.

대상이 거부할 식별자에 대해 출력되는 메시지:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must "<rule>") (컴포넌트 ID는 내보낸 리소스에 찍히는 이름이 될 수 없습니다: 컴포넌트 이름을 변경하십시오. ID는 위에 명시된 규칙을 따라야 합니다)

합성된 식별자처럼 시작하는 식별자에 대해서는 다음과 같으며, 여기서 <opening>은 이름이 일치한 예약된 시작부입니다.

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must not open with the reserved "<opening>") (컴포넌트 ID는 내보낸 리소스에 찍히는 이름이 될 수 없습니다: 컴포넌트 이름을 변경하십시오. ID는 예약된 시작 부분으로 시작해서는 안 됩니다)

해결 방법: 컴포넌트를 명시하는 모든 곳, 즉 컴포넌트를 선언하는 Aggregate와 컴포넌트를 배치하고 구성하는 Release에서 컴포넌트 이름을 바꿉니다. 문자나 숫자로 시작하고 끝나며 bfr--나 cfr--로 시작하지 않는 이름을 지정합니다. 컴포넌트 이름을 바꾸면 클러스터에서 그 리소스가 가지는 이름이 바뀌므로, 이미 배포된 애플리케이션에서는 다른 리소스 이름 변경과 마찬가지로 다루십시오.

The target will not accept a name derived from an authored identity (대상이 작성된 식별자에서 파생된 이름을 받아들이지 않음)

모든 대상은 component의 식별자에서 자체 이름을 파생합니다. 차트 설치 도구는 release 이름을, 컨테이너 오케스트레이터는 서비스 이름을 파생합니다. 이 중단은 해당 대상이 그중 하나를 사용할 수 없다고 알리는 것입니다.

Aggrega는 어떤 대상의 이름 규칙도 보유하지 않습니다. 이름의 최대 길이, 대상이 허용하는 문자, 대상의 문법이 이름의 시작 부분에 요구하는 것을 알지 못하며, 의도적으로 알지 않습니다. 이는 대상마다, 이름이 붙는 리소스의 종류마다, 때로는 한 provider 안의 한 서비스마다 다르기 때문입니다. 따라서 이름이 확정되기 전에 컴파일러는 해당 component를 렌더링할 provider에게 묻고, 이 중단은 provider의 답을 보고합니다. 그래서 메시지에는 컴파일러에 작성된 규칙이 아니라 거부한 대상에 대한 대상 자체의 용어(release name, Service name)와 대상 자체의 이유가 담깁니다.

이름을 줄이지 않고 거부하는 이유. 작성한 이름은 workload의 배포된 이름입니다. 이를 줄이면 기존의 모든 출력에 있는 모든 리소스의 이름이 바뀌며, 요청하지 않았는데도 대신 그렇게 하게 됩니다. 다른 이름을 고를 수 있는 사람은 이 이름을 작성한 사람이므로, 이 중단은 작성한 spec.components 키를 가리키고 이름은 그대로 둡니다. 반면 Aggrega가 직접 구성하는 이름(예: 전체 boundary에 연결된 Feature의 식별자)은 줄입니다. 이러한 이름은 여러 문서에 걸쳐 작성된 부분으로 조합되므로 어느 한 작성자도 그 길이를 볼 수 없기 때문입니다.

대상이 줄 수 있는 두 가지 답이 있으며, 각각 다른 곳으로 이어집니다. 더 짧은 이름이 허용되는 경우, 중단은 통하는 길이를 명시하므로 새 이름을 두 번이 아니라 한 번에 고를 수 있습니다. 어떤 길이로도 해결되지 않는 경우, 즉 대상의 문법이 해당 위치에서 거부하는 문자인 경우에는 줄여도 해결되지 않으므로 길이를 명시하지 않습니다. 두 번째 종류의 가장 흔한 사례는 다음과 같습니다. 이름이 소문자만 허용되는 대상은 허용하지 않는 각 문자를 이스케이프하며, 모든 이스케이프는 하이픈으로 시작하므로 첫 문자가 이스케이프된 이름은 하이픈으로 시작하는 이름이 됩니다. 그 위치에 소문자나 숫자를 요구하는 대상은 나머지가 아무리 짧아도 이를 거부합니다. 대상은 이름의 시작 부분에 그 이름을 따라 명명되는 리소스의 더 엄격한 규칙을 적용할 수도 있습니다. helm 대상은 숫자로 시작하는 이름을 Service name으로 보고하며 거부합니다. Helm은 그러한 release 이름을 허용하지만, 클러스터는 그 이름을 딴 Kubernetes Service를 거부하기 때문입니다.

세 번째 형태는 구성된 이름에서만 나타납니다. 구성된 식별자는 구분자를 위한 공간을 확보하므로, 대상이 컴파일러가 주어진 부분으로 구성할 수 있는 가장 짧은 식별자보다 더 짧은 길이를 명시할 수 있습니다. 이 경우 중단은 provider에 결함이 있다고 보고하는 대신 그 사실을 알리고 해결책, 즉 작성된 부분을 줄이라는 것을 제시합니다.

일부 이름은 컴포넌트가 렌더링하는 워크로드를 위해서만 존재합니다. 프로바이더에 대한 질의는 그 컴포넌트의 Workload가 해석된 뒤에 이루어지며, 질의에는 Workload의 form과 Service 키가 담기므로 대상은 이것들로 만드는 이름도 판단할 수 있습니다. helm 대상에서는 이로 인해 두 가지가 추가됩니다. 하나는 CronJob name으로, 최대 52자이며 scheduled Workload에 대해서만 판단합니다. 클러스터가 각 실행의 Job에 CronJob 이름 뒤에 접미사를 붙인 이름을 주기 때문입니다. 다른 하나는 각 Service name, 즉 <release name>-<service key>이며 최대 63자입니다. Service 이름은 두 작성자의 부분, 즉 컴포넌트 이름과 워크로드가 Recipe 또는 FeatureRecipe에서 선언하는 키로 만들어지므로, 그 이유에는 작성한 필드와 함께 그 키와 워크로드가 이를 선언한 위치 spec.workload.services.<key>가 표시됩니다. 어떤 컴포넌트 이름도 들어갈 자리가 남지 않을 만큼 긴 키라면 선택할 길이가 제시되지 않으며, 이유에는 짧아져야 하는 것이 키라고 표시됩니다. 경계 전체에 첨부된 Feature에 대해서는 이 이름들을 판단하지 않습니다. 그 식별자는 Workload가 해석되기 전에 확정되는데, 그 출력이 어디서 조립되는지가 식별자에 따라 달라질 수 있기 때문입니다.

작성된 식별자에 대해 출력되는 메시지:

the target will not accept a name derived from this component’s authored identity: rename the component (component "<identity>", written at <field-path>, which the target cannot use as a <name-kind>, <the target's reason>). choose a name of at most <n> characters that the target accepts (대상이 이 component의 작성된 식별자에서 파생된 이름을 받아들이지 않습니다: component의 이름을 바꾸십시오. 대상이 받아들이는 최대 길이 이내의 이름을 선택하십시오)

해결 방법: component 이름을 대상이 허용하는 이름으로 바꾸되, 이를 명명하는 모든 곳에서 바꾸십시오. 즉 이를 선언하는 Aggregate와 이를 배치하고 구성하는 Release입니다. 메시지에 길이가 명시되어 있으면 그 안에 맞추십시오. 명시되어 있지 않으면 대상의 이유를 읽으십시오. 대개 대상이 허용하지 않는 문자이며, 가장 흔하게는 이름 시작 부분의 대문자이고, helm 대상에서는 그 위치의 숫자입니다. 소문자와 숫자를 사용하고 단어 사이에 하이픈을 넣는 것이 좋습니다. 이름 지정 장에서 각 종류의 대상에서 이름이 치르는 비용을 설명합니다. 이유에 Service 키가 지목되어 있으면 워크로드가 그 키를 선언한 곳에서 키를 줄여서도 길이를 확보할 수 있으며, 이유에 그 키가 자리를 남기지 않는다고 되어 있으면 그 방법밖에 없습니다. component 이름을 바꾸면 그 리소스가 가지는 이름이 바뀌므로, 이미 배포된 애플리케이션에서는 다른 리소스 이름 변경과 마찬가지로 다루십시오.

식별자가 작성한 것이 아니라 컴파일러가 구성한 것인 경우, 같은 중단이 구성된 값을 보고하고 그것을 만든 부분, 즉 Feature를 연결한 이름과 Feature를 연결한 boundary 경로를 줄이도록 요청합니다.

A provider never accepted a name the compiler composed (provider가 컴파일러가 구성한 이름을 끝내 받아들이지 않음)

이 중단은 작성한 내용이 아니라 플러그인의 결함을 보고합니다.

구성된 이름을 확정하는 과정은 주고받기입니다. 컴파일러가 식별자를 제안하면 provider는 이를 받아들이거나 얼마나 짧아야 하는지 알리고, 컴파일러는 더 짧은 식별자를 구성하며, provider에게 다시 묻습니다. 두 번째 거부는 정상적이고 예상되는 일입니다. 특정 길이로 줄이면 대상의 문법이 허용하지 않는 위치에 문자가 올 수 있으며, provider가 그렇게 알리는 것이 어떤 대상의 문법도 모르는 컴파일러와 그것을 아는 provider가 합의에 이르는 방식입니다.

정상적이지 않은 것은 아무것도 받아들이지 않는 provider입니다. 즉 길이를 명시하고, 그 길이의 이름을 받은 뒤, 다시 거부하는 provider입니다. 주고받기에는 한도가 있으며, 한도에 도달하면 빌드는 provider가 동의한 적 없는 이름을 사용하는 대신 중단하고 해당 provider를 명시합니다. 포기하여 확정된 이름은 합의에 이르지 못했다는 기록이 출력 어디에도 없는 채로 실제 리소스에 찍히게 되고, 그 결과는 이를 만든 빌드가 아니라 적용 시점에 드러나게 됩니다.

출력되는 메시지:

provider guest never accepted a component identity the compiler composed for it (provider guest "<provider>", refused <n> proposals, the last of them "<identity>"). report the defect to whoever maintains that provider plugin (provider 게스트가 컴파일러가 구성한 component 식별자를 끝내 받아들이지 않았습니다. 해당 provider 플러그인의 관리자에게 결함을 보고하십시오)

해결 방법: 메시지의 마지막 제안을 인용하여 명시된 provider 플러그인의 유지 관리자에게 보고하십시오. 이를 우회하는 작성 변경은 없습니다. 컴파일러는 이미 provider가 요청한 모든 길이를 제시했습니다. 직접 유지 관리하는 provider라면, 명시한 한도로 잘린 이름을 이후에 받아들이는지 확인하십시오.

Required uses: socket not populated (필수 소켓이 채워지지 않음)

Component가 usesSchema에 required: true로 표시된 소켓을 선언했으나, 빌드 내 어디에서도 해당 Component의 인스턴스 중 하나에 대해 그 소켓에 연결을 배선하지 않았습니다.

세 가지 표면에서 배선할 수 있으며, 이 중단은 세 곳이 모두 비어 있을 때만 발생합니다. Aggregate 안의 인스턴스 자체 uses: 블록, 선언되었지만 바인딩되지 않은 소켓으로 연결을 생성하는, target:을 지정한 Release의 에지별 uses: 항목, 그리고 컴포지션이 생성한 연결 집합입니다. 세 번째는 가져온 Aggregate가 기여한 component를 담당합니다. 그러한 component의 uses: 블록은 해당 Aggregate 자체의 문서에 있으며, 컴포지션이 조립된 후에야 읽히기 때문입니다. 세 번째 표면이 가장 늦게 완성되므로, 이 검사는 작성된 두 문서를 읽는 도중이 아니라 전체 컴포지션이 존재한 뒤에 실행되며, 어느 문서가 선언했든 모든 component에 같은 질문을 합니다.

소켓을 채울 것처럼 보이지만 채우지 않는 형태가 두 가지 있습니다. target:을 지정하지 않은 Release 항목은 연결을 생성하는 것이 아니라 이미 존재해야 하는 연결을 구성하므로 아무것도 배선하지 않습니다(그리고 infra:를 포함하는 경우 위에 있는 별도의 중단으로 보고됩니다). 또한 Feature 첨부의 uses:는 첨부된 Feature에 선언된 소켓, 즉 별개의 엔터티에 있는 별개의 소켓 집합을 지정하므로, 첨부는 Component 자체의 소켓을 결코 채울 수 없습니다.

출력되는 메시지:

required uses socket not populated (Component, at .spec.components.<instance>.uses.<socket>, "<socket-name>", declared required by component type "<component-type>") (필수 uses 소켓이 채워지지 않음: 표시된 위치의 소켓은 표시된 컴포넌트 유형이 필수로 선언한 소켓임)

이 결과는 작성자가 작성해야 하는 소켓 항목 .spec.components.<instance>.uses.<socket>에 위치합니다. 여기의 인스턴스 이름은 component를 선언한 문서에서 그 component가 갖는 이름이므로, 가져온 Aggregate가 기여한 component의 경우 로케이터는 컴포지션이 부여한 접두사 붙은 이름이 아니라 해당 Aggregate 자체 파일에 있는 키를 가리킵니다.

채워지지 않은 필수 소켓은 모든 component에서 각각 보고됩니다. 한 번의 빌드로 첫 번째 것만이 아니라 전부를 알 수 있습니다.

해결 방법: 필수 소켓에 대한 uses: 항목을 추가하여 소켓의 selector:가 허용하는 대상에 배선하거나, target:을 지정한 항목으로 Release에서 배선합니다. 소켓이 더 이상 필수가 아니어야 한다면 Component의 usesSchema를 수정하여 required: false로 설정하거나 required 선언을 제거합니다.

Sub-aggregate nesting depth exceeded (하위 aggregate 중첩 깊이 초과)

하위 aggregate 가져오기 체인이 컴파일러의 최대 중첩 깊이를 초과합니다. 이 제한은 깊이 중첩된 토폴로지가 끝없이 평탄화되는 것을 막고, 임계값을 넘으면 아키텍처 분해를 강제합니다.

출력되는 메시지:

max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>. (하위 aggregate의 최대 중첩 깊이를 초과함: 평탄화된 접두사 위치의 깊이)

해결 방법: 중첩을 줄이도록 aggregate 토폴로지를 재구성합니다. 이 정도로 깊은 중첩은 대개 Aggregate 형태가 배포 토폴로지가 아니라 조직 계층을 반영하고 있음을 나타냅니다. 하위 aggregate 그룹을 하나의 상위 Aggregate 안의 동등한 서브시스템으로 평탄화하는 것을 고려하십시오.

Feature type mismatch between Aggregate and Release (Aggregate와 Release 간 Feature 타입 불일치)

Aggregate와 Release가 모두 같은 인스턴스 이름으로 feature를 연결하지만 각각 다른 type:을 선언하며, Release의 attachment는 경계의 features:에서 컴포넌트에 도달합니다. Release가 대신 그 컴포넌트에 대한 자신의 항목에 작성한 경우에는 같은 충돌이 더 일찍 거부되며, 위의 “A feature attached by both the Aggregate and the Release cannot be merged (Aggregate와 Release가 모두 연결한 feature를 병합할 수 없음)”에서 E0153으로 보고됩니다.

출력되는 메시지:

feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>) (Aggregate와 Release 사이의 feature 유형 불일치: Aggregate의 기존 유형이 Release의 유형과 충돌함)

해결 방법: Release에서 type:을 삭제하거나(Aggregate에서 상속됩니다), 양쪽이 같은 타입을 선언하도록 한쪽을 변경합니다. Release는 type:을 생략하거나 Aggregate의 타입을 반복할 수 있지만, 다른 타입으로 대체할 수는 없습니다.

Cyclic extends on Components or Features (Components 또는 Features의 순환 extends)

Component의 extends: 체인 또는 Feature의 extends: 체인이 자기 자신으로 되돌아갑니다.

출력되는 메시지입니다. 순환하는 것이 Feature 체인인 경우 Component 대신 Feature가 표시됩니다:

cyclic extends chain (Component <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (순환 extends 체인: 엔티티가 이미 체인에 있는 참조를 확장함. 해당 엔티티의 extends를 제거하거나 체인 밖의 엔티티를 가리키도록 하십시오)

해결 방법: 에지가 지정하는 엔터티를 열고(세 개 이상의 체인에서는 메시지 앞부분에 지정된 엔터티가 아닙니다) 그 extends:를 제거하거나 다른 곳을 가리키도록 합니다.

A component the composition holds is placed in no boundary (컴포지션이 보유한 component가 어떤 경계에도 배치되지 않음)

Release는 두 가지 방법으로 component를 경계에 배치하며, 어느 쪽이든 인정됩니다. 하나는 경계의 components 아래에 component를 지정하는 것으로, 전체 컴포지션이 평탄화된 후 component가 갖는 id로 지정합니다. 다른 하나는 component를 기여하는 모듈을 aggregates 아래에서 경계로 라우팅하는 것으로, 그 모듈이 포함한 모든 component를 한꺼번에 배치합니다.

어느 쪽에도 해당하지 않는 component는 Release가 선언한 모든 경계 밖에서 렌더링됩니다. 그러면 그 출력 디렉터리, sync wave, 어노테이션, component별 infra는 어디에서도 오지 않으며, 이 중단이 없다면 빌드는 성공하고 아티팩트를 출력하면서 운영자의 구성이 해당 component에 적용되지 않았다는 사실을 전혀 알리지 않을 것입니다. 또한 그 경계선으로 분리된 두 component는 서로 다른 출력으로 렌더링되어, 함께 배치되었을 때 갖는 순서를 잃습니다.

두 가지 형태는 의도적으로 이 중단에 해당하지 않습니다. 이름 있는 경계가 아니라 최상위 components를 선언한 Release는 지정한 모든 것을 배치합니다. 그러한 Release를 정규화하면 정확히 그 component들을 담는 자체 경계가 생깁니다. 또한 Release가 모듈 전체를 어디에도 배치하지 않은 component는, 자체 선언이 올바른 component마다 한 번씩 보고되는 대신 아래 항목에서 모듈에 대해 한 번 보고됩니다. 하나의 결함, 하나의 해결책, 수정할 하나의 키입니다.

출력되는 메시지입니다. 끝에 있는 값은 컴포지션이 평탄화된 후 component가 갖는 id이며, 모듈이 기여한 component의 경우 그 모듈의 이름, 점, component 자체의 이름으로 이루어집니다:

component placed in no boundary: name it under a boundary’s components, or place the sub-module that contributes it under aggregates (Release <name>, at <authored key>, "<component-id>") (어느 경계에도 배치되지 않은 컴포넌트: 경계의 components 아래에 이름을 지정하거나, 이 컴포넌트를 제공하는 하위 모듈을 aggregates 아래에 배치하십시오)

해결 방법: 메시지가 인용한 id를 정확히 사용하여 경계의 components 아래에 component를 지정합니다. 모듈이 기여한 component의 경우 이는 모듈 자체 파일 안에 작성된 이름이 아니라 접두사가 붙은 id입니다. 또는 모듈 전체가 하나의 경계에 속한다면 aggregates 아래에서 그 경계로 라우팅하여 모듈이 보유한 모든 component가 한꺼번에 배치되도록 합니다.

하위 모듈의 컴포넌트가 어떤 경계에도 배치되지 않음

위 규칙의 모듈 단위 형태입니다. 구성이 가져온 모듈이 컴포넌트를 제공했는데, 어떤 경계도 그중 하나도 담고 있지 않은 경우입니다. 이는 컴포넌트마다 한 번이 아니라 모듈에 대해 한 번 보고됩니다. 어디에도 배치되지 않은 모듈 하나는 하나의 키에서 하나의 해결책을 갖는 하나의 작성 오류이며, 컴포넌트별로 보고하면 자신의 선언이 완전히 올바른 컴포넌트들을 지목하게 되기 때문입니다.

이 규칙은 표기가 아니라 배치를 읽으므로, 컴포넌트 각각이 경계의 components 아래에 개별적으로 지정된 모듈은 배치된 것으로 보고 통과합니다. 라우팅 항목이 없다는 이유로 이를 거부하면 언어가 허용하는 작성 형태를 거부하게 됩니다. 일부만 배치된 모듈도 통과합니다. 어떤 컴포넌트가 자신의 항목을 가지는지는 컴포넌트 규칙이 다루는 문제이며, 누락된 컴포넌트는 그쪽에서 각자의 키에 보고됩니다.

컴포넌트를 제공하지 않은 모듈은 이 오류에 해당하지 않습니다. 배치할 것이 없기 때문입니다. false인 active: 토글로 제거된 모듈도 마찬가지이며, 이 모듈은 애초에 구성되지 않았습니다.

출력되는 메시지이며, 모듈을 선언한 aggregates 항목에, 가져오는 문서가 작성한 로컬 이름 아래에 위치합니다:

sub-module placed in no boundary: route it into a boundary under aggregates, or name its components there under components (Release <name>, at <authored key>, "<module-path>") (어떤 경계에도 배치되지 않은 하위 모듈: aggregates 아래에서 해당 모듈을 경계로 라우팅하거나, 그 경계의 components 아래에 해당 모듈의 구성 요소를 지정하십시오)

해결 방법: 모듈이 속하는 경계 아래에 해당 모듈의 aggregates 항목을 추가하면, 모듈이 제공하는 모든 컴포넌트가 배치됩니다. 또는 컴포넌트들이 서로 다른 경계에 속하는 경우, 평탄화 후 갖게 되는 접두사가 붙은 id를 사용하여 각 컴포넌트를 해당 경계 아래에 지정합니다.

경계가 구성에 없는 컴포넌트를 지정함

위 두 규칙의 과잉 지정 쪽 대응이며, 둘 중 하나의 분기가 아니라 별개의 질문입니다. 위 규칙들은 컴포넌트에 대해 무언가가 그것을 배치했는지를 묻고, 이 규칙은 Release가 작성한 항목에 대해 무언가가 그에 대응하는지를 묻습니다. 어느 쪽도 다른 쪽을 함축하지 않습니다. Release는 존재하는 모든 컴포넌트를 제대로 배치하면서도 존재하지 않는 컴포넌트를 지정할 수 있고, 작성한 모든 항목이 해석되면서도 실제 컴포넌트를 배치하지 않은 채로 둘 수 있습니다.

아무것도 지정하지 않는 항목은 아무것도 구성하지 않습니다. 그 항목의 directory, subDirectory, syncWave, 어노테이션, 컴포넌트별 infra는 존재하지 않는 컴포넌트를 위해 작성된 것이므로 그 아래에서 렌더링되는 것이 없으며, 그대로라면 빌드는 운영자의 구성이 조용히 무효화된 채로 성공하게 됩니다.

경계는 두 가지 방식으로 컴포넌트를 지정하며, 둘 다 검사됩니다. components 아래에서는 항목이 구성 전체가 평탄화된 후 컴포넌트가 갖는 id로 컴포넌트를 가리킵니다. 따라서 모듈이 제공한 컴포넌트는 자신의 이름 앞에 해당 모듈의 접두사를 붙여 작성합니다. aggregates 라우팅 항목 안에서는 항목이 해당 모듈 안에서 컴포넌트가 갖는 로컬 이름으로 컴포넌트를 가리키며, 이는 같은 id로 해석됩니다. 메시지는 항목이 가리킨 id를 인용하는데, 라우팅 축에서는 이것이 파일에 적힌 이름이 아닙니다. 파일에는 로컬 부분이 있고 나머지는 모듈이 제공합니다.

서브시스템은 컴포넌트의 id에 아무것도 더하지 않으므로, 서브시스템 안에 선언된 컴포넌트는 이름만으로 가리킵니다. 서브시스템이 id의 일부인 것처럼 작성한 항목은 아무것도 가리키지 않으며 이 오류에 해당합니다.

false인 active: 토글로 꺼진 컴포넌트는 이 오류에 해당하지 않습니다. 컴포넌트를 끄는 것은 작성 행위이며, 그 컴포넌트를 구성하는 Release가 같은 편집에서 다시 작성될 것으로 기대되지 않습니다. 그 항목을 거부하면 어떤 Release든 그 컴포넌트를 지정하는 동안에는 토글을 사용할 수 없게 됩니다.

출력되는 메시지:

boundary names a component the composition does not hold: correct the name, or remove the entry (Release <name>, at <authored key>, "<addressed id>") (경계가 구성에 없는 컴포넌트를 지정함: 이름을 수정하거나 항목을 제거하십시오)

해결 방법: 메시지가 인용한 id를 구성이 실제로 담고 있는 컴포넌트와 비교합니다. 흔한 원인은 모듈 접두사 누락과 id에 서브시스템 이름을 써 넣은 것 두 가지입니다. 서브시스템을 빼거나, 모듈 접두사를 추가하거나, 철자를 수정합니다. 이후 제거되었거나 이름이 바뀐 컴포넌트의 항목이 남아 있는 경우라면 삭제합니다.

uses 엣지가 active: 토글로 제거된 컴포넌트를 대상으로 함

위의 대상 누락(dangling target) 중단과 짝을 이루는 오류로, 작성자에게 대상이 왜 없는지 알리기 위해 따로 보고됩니다. 대상은 선언된 적이 없어서 없는 것이 아닙니다. 선언되어 있지만, active: 토글이 false로 해석되어 이 빌드에서 의도적으로 제거되었고 그 엣지들도 함께 제거되었습니다. 남아 있는 컴포넌트가 여전히 그것에 의존하고 있으며, 엣지가 사라지도록 두면 그 소비자의 주입 값이 배포 시점에 조용히 비어 있게 됩니다.

출력되는 메시지입니다. 거부 내용이 먼저 나오고, 이어서 토글이 제거한 대상과 연결이 연결된 소켓, 그다음 조치 방법이 나옵니다:

uses edge target was pruned because its active toggle resolved to false ("<target>", wired into socket "<socket>"). Keep the target’s active toggle true, or drop the dependency on it. (uses 엣지의 대상이 active 토글이 false로 확인되어 제거되었습니다. 대상의 active 토글을 true로 유지하거나 대상에 대한 의존성을 제거하십시오.)

이 결과는 해당 작성 항목에, 위의 대상 누락 중단이 지정하는 것과 같은 경로에 위치하며, 첫 번째만이 아니라 문제가 되는 모든 연결이 보고됩니다.

해결 방법: 둘 중 어느 것이 이 환경에 속하는지 결정합니다. 대상을 다시 켭니다. 토글이 파라미터를 읽는 경우, 이 Release에 해당 파라미터를 제공하는 것을 뜻합니다. 또는 소비자를 같은 토글 뒤에 두어 둘이 함께 빠지게 하고, 아무것도 가리키지 않는 엣지가 남지 않게 합니다. 또는 소비자가 정말로 더 이상 그것을 필요로 하지 않는 경우, 소비자의 uses: 블록에서 엣지를 제거합니다.

A uses target names a module’s component the module does not export (uses 대상이 모듈이 내보내지 않는 그 모듈의 컴포넌트를 지정함)

모듈은 exportedComponents: 아래에 인터페이스를 공개하며, 모듈을 가져오는 문서는 그 이름, 즉 모듈 이름, 점, 별칭 중 하나를 통해서만 모듈의 컴포넌트에 도달합니다. 그 밖의 방법, 즉 모듈 내부의 컴포넌트 이름이나 모듈을 거쳐 그 안에 중첩된 모듈로 들어가는 경로로 모듈 내부의 컴포넌트에 도달하는 uses: 대상은 빌드를 중단시킵니다. 그 연결은 모듈 작성자가 공개하지 않았고 자유롭게 이름을 바꾸거나 제거할 수 있는 것에 바인딩되기 때문입니다. 컴포넌트 자신의 uses: 블록, attachment의 블록, Release가 연결한 연결 모두 똑같이 적용됩니다. 연결이 어느 모듈로 들어가는지는 그 소비자가 위치한 곳에서 읽으므로, 한 모듈의 두 컴포넌트 사이의 연결은 Release가 둘을 서로 연결하는 경우를 포함해 어떤 인터페이스도 넘지 않으며 거부되지 않습니다. 어떤 컴포넌트에도 해당하지 않는 대상은 대신 존재하지 않는 대상 중단으로 보고되므로, 잘못 입력한 이름 하나는 한 번만 보고됩니다.

출력되는 메시지입니다. 거부가 먼저 나오고, 이어서 작성된 대상, 그것이 들어가는 모듈과 그 모듈이 내보내는 별칭, 소켓, 그리고 해결 방법이 나옵니다.

uses edge target names a component its module does not export ("<target>", module "<module>", which exports "<aliases>", wired into socket "<socket>"). Name the component through one of the module’s exported aliases, or list it under the module’s exportedComponents. (uses 엣지의 대상이 모듈이 내보내지 않는 컴포넌트를 지정함(대상, 모듈과 그 모듈이 내보내는 별칭, 연결된 소켓이 표시됨). 모듈이 내보내는 별칭 중 하나를 통해 컴포넌트를 지정하거나, 모듈의 exportedComponents 아래에 나열하십시오.)

아무것도 내보내지 않는 모듈은 "nothing"을 내보내는 것으로 표시됩니다. 결과는 연결을 그린 문서에 작성된 항목에 위치합니다.

해결 방법: 모듈이 내보내는 별칭을 통해 컴포넌트를 지정합니다. finance-db-subsystem.internal-pg-primary가 아니라 finance-db-subsystem.primary_db처럼 씁니다. 또는 모듈을 직접 작성하고 컴포넌트를 공개할 생각이라면 모듈의 exportedComponents 아래에 나열하고, 가져오는 쪽이 그 컴포넌트 자신의 이름을 써야 한다면 그 이름으로 나열합니다.

active: 토글이 true 또는 false로 해석되지 않음

active: 토글은 그래프 빌더에 도달할 때 이미 리터럴로 해석되어 있습니다. 직접 작성한 불리언이거나, 문서를 읽기 전에 Release의 값이 대입된 파라미터 참조입니다. 그다음 엄격하게 읽힙니다. 불리언이 아닌 리터럴은 어떤 값으로 기본 처리되지 않고 빌드를 중단합니다. 이 규칙은 컴포넌트의 토글과 모듈의 토글에 동일하게 적용됩니다.

짚어 둘 만한 경우는 빈 리터럴입니다. 충족되지 않은 파라미터가 만들어 내는 것이 바로 빈 리터럴이기 때문입니다. {{ .parameters.<key> }}를 읽는 토글은 그 파라미터에 값이 없는 동안 아무것도 아닌 값으로 해석되며, 이를 “존재함”으로 읽으면 작성자가 파라미터 뒤에 둔 바로 그 엔티티가 배포됩니다. 아무도 작성하지 않은 토글만 기본적으로 존재함으로 처리되며, 이는 토글의 값이 아니라 토글의 부재로부터 읽힙니다. 그래서 active:를 뒤에 아무것도 없이 작성하는 것은 키를 생략하는 것과 같지 않습니다.

출력되는 메시지:

active toggle did not resolve to a boolean (node "<node>", active resolved to "<value>") (active 토글이 불리언으로 해석되지 않음)

그리고 아무것도 아닌 값으로 해석된 경우에는, 흔한 원인을 알려 주는 조언과 함께 출력됩니다:

active toggle did not resolve to a boolean (node "<node>", active resolved to ""). a toggle reading a parameter resolves to nothing until that parameter is fulfilled (active 토글이 불리언으로 해석되지 않음. 파라미터를 읽는 토글은 그 파라미터가 충족될 때까지 아무것도 아닌 값으로 해석됩니다)

해결 방법: true 또는 false를 작성합니다. 토글이 파라미터를 읽는 경우, Release에서 그 파라미터를 제공하거나, Aggregate에서 선언된 곳에 default:를 지정하여 모든 환경이 값을 갖도록 합니다. 엔티티가 무조건 존재하게 하려면 active: 키를 비워 두지 말고 제거합니다.

컴포지션이 가져오는 모듈을 로드할 수 없거나 모듈이 자기 자신을 가져옴

Aggregate는 aggregates: 아래에 다른 Aggregates를 지정하여 구성하며, 각각은 차례로 로드되고 순회되어 그 컴포넌트가 그래프에 합류합니다. 여기서는 두 가지가 이 순회를 멈춥니다.

모듈을 아예 로드할 수 없는 경우입니다. 참조가 카탈로그가 돌려줄 수 있는 어떤 것으로도 해석되지 않거나, 그 뒤의 문서를 읽을 수 없습니다. 로더가 제시한 이유는 중단에 합쳐지지 않고 그 아래에 실리므로, 무엇이 실패했는지는 로더 자신의 말로 보고됩니다.

또는 모듈이 현재 순회 중인 체인에 이미 있는 타입을 지정하는 경우입니다. 이를 펼치면 그것을 포함한 체인이 끝없이 재현됩니다. 이는 참조가 루프를 닫는 지점에서 보고되며, 타입과 그것이 컴포지션 내 어디에 있는지를 함께 명시합니다.

순환 참조의 경우 출력되는 메시지:

sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>") (하위 aggregate 로드 실패: 순환 하위 aggregate 참조)

로드 실패의 경우에는 중단이 문장 하나로만 표시되고, 모듈의 경로에 위치하며, 그 아래에 로더 자신의 이유가 붙습니다:

sub-aggregate load failed (하위 Aggregate 로드 실패)

해결 방법: 로드 실패의 경우 중단 아래의 이유를 읽으십시오. 카탈로그가 응답할 수 없는 이름이나 버전이 흔한 경우이며, 수정은 그것을 지정하는 aggregates: 항목에서 합니다. 순환 참조의 경우 루프를 끊으십시오. 메시지의 경로는 체인이 닫히는 곳이며, 그 경로상의 모듈 중 하나가 자신을 가져오는 모듈을 가져오지 않아야 합니다. 두 모듈이 실제로 서로의 컴포넌트를 필요로 한다면, 공유 부분은 두 모듈이 모두 가져오는 세 번째 모듈에 두어야 합니다.

두 인스턴스가 하나의 식별자로 평탄화됨

Aggregate를 구성하면 모든 컴포넌트가 하나의 집합으로 평탄화되며, 모듈이 제공한 컴포넌트는 그 모듈의 이름, 점, 그리고 자신의 이름을 가집니다. 이 집합은 하나의 식별자 아래에 두 항목을 담기를 거부합니다. 두 번째 항목이 첫 번째를 대체하여 두 컴포넌트 중 하나가 아무 언급 없이 출력에서 사라지기 때문입니다.

이 중단은 모듈의 컴포넌트가 병합될 때 발생하는 것이며, 작성 표면은 이를 일으킬 이름을 제공하지 않습니다. 모듈이 제공하는 모든 컴포넌트는 자신의 이름 앞에 그 모듈의 이름을 가집니다. 인스턴스 이름은 문자, 숫자, -, _로 작성되므로 둘을 잇는 점을 포함할 수 없고, 서로 다른 모듈 이름으로 만들어진 두 식별자는 만날 수 없습니다. 하나의 이름으로 가져온 두 모듈은 하나의 중복 키이며, 문서는 로드될 때 거부됩니다. 따라서 이는 일반적인 작성 경로가 아닌 다른 무언가가 조립한 컴포지션을 위한 안전장치이며, 이를 만나면 우회하기보다 보고할 가치가 있습니다.

한 Aggregate의 두 컴포넌트가 하나의 식별자에 이르는 것은 다른 중단이며, 일반적인 작성으로도 발생합니다. 아래의 Two subsystems declare a component under one name (두 서브시스템이 하나의 이름으로 컴포넌트를 선언함)을 참조하십시오.

출력되는 메시지:

flattened node ID collision: rename one of the colliding instances so their flattened IDs differ (id "<identifier>", path "<path in the composition>", collides with existing entry from "<the other contributor>") (평탄화된 노드 ID 충돌: 평탄화된 ID가 서로 달라지도록 충돌하는 인스턴스 중 하나의 이름을 변경하십시오)

해결 방법: 메시지가 지정한 두 인스턴스 중 하나의 이름을, 그것을 선언하는 문서와 그것을 지정하는 모든 Release 항목에서 바꾸십시오.

두 서브시스템이 하나의 이름으로 컴포넌트를 선언함

서브시스템은 읽는 사람을 위해, 그리고 하위로 전파되는 설정을 위해 Aggregate의 컴포넌트를 묶을 뿐, 컴포넌트가 응답하는 이름을 한정하지 않습니다. subsystems.frontend 아래에 선언된 컴포넌트는 frontend.api가 아니라 api로 지정되며, 모듈이 제공한 컴포넌트는 서브시스템이 아니라 그 모듈의 이름을 가집니다. 따라서 한 Aggregate의 두 서브시스템이 각각 api라는 컴포넌트를 선언할 수 있으며, 그러면 둘은 같은 식별자에 응답하게 됩니다.

문서 자체는 올바른 형식입니다. 둘은 서로 다른 블록의 서로 다른 키이며, 바로 그 때문에 앞 단계에서 아무것도 이를 거부하지 않습니다. 그러나 하나의 식별자는 하나의 컴포넌트만 가질 수 있습니다. 빌드는 마지막으로 읽은 쪽을 유지하고 컴포넌트 하나만 선언된 것처럼 렌더링하는 대신 중단됩니다.

하나의 서브시스템 안에서 같은 이름이 두 번 나오는 것은 다른 오류입니다. 이는 하나의 키 아래 두 항목이며, 문서는 읽힐 때 거부됩니다.

출력되는 메시지:

components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component’s identity (Aggregate, at .spec.subsystems.<second>.components.<identifier>, "<identifier>", declared under subsystems "<first>, <second>") (서로 다른 서브시스템의 컴포넌트가 같은 식별자를 가집니다: 서브시스템은 컴포넌트의 식별자에 아무것도 더하지 않으므로 둘 중 하나의 이름을 변경하십시오)

해결 방법: 두 컴포넌트 중 하나의 이름을, 그것을 선언하는 문서와 그것을 지정하는 모든 Release 항목에서 바꾸십시오. 둘이 실제로 두 곳에서 필요한 같은 컴포넌트라면, 한 번만 선언하고 다른 서브시스템에서 그것에 의존하십시오. 서브시스템의 이름을 바꾸는 것은 도움이 되지 않습니다. 서브시스템은 이름의 일부가 아닙니다.

재게시된 컴포넌트 별칭이 자기 자신을 가리킴

모듈은 별칭으로 컴포넌트를 내보내어 자신의 일부를 게시하며, 이를 가져오는 Aggregate는 그 별칭 중 하나를 자신의 이름으로 재게시할 수 있습니다. 이러한 별칭을 해석할 때는 재게시의 체인을 따라 최종적으로 지정하는 컴포넌트까지 가므로, 공개 이름을 가리키는 에지가 실제 컴포넌트에 도달합니다.

컴포넌트에 도달하기 전에 별칭을 다시 방문하는 체인은 끝나지 않습니다. 순회는 이를 영원히 따라가는 대신 멈추고, 순회한 체인을 명시하여 루프를 닫는 연결이 드러나게 합니다.

작성할 수 있는 어떤 것도 이러한 체인을 만들지 않습니다. 가져오기 트리는 비순환이고, 각 연결은 이전 연결보다 더 깊이 중첩된 것을 지정하므로, 가져오기로 조립된 체인은 아래로 내려가다 끝납니다. 따라서 이는 Aggregate가 선언할 수 있는 형태가 아니라 일반적인 작성 경로가 아닌 다른 무언가가 조립한 별칭 테이블을 위한 안전장치입니다.

출력되는 메시지:

re-exported component alias forms a cycle (alias chain <first> -> <second> -> <first>) (재내보낸 컴포넌트 별칭이 순환을 이룹니다)

해결 방법: 파일의 어떤 내용도 이를 만들지 않으며, 이를 해소하는 작성 변경도 없습니다. 실행한 명령과 메시지가 명시한 별칭 체인을 함께 보고하십시오. 별칭 체인은 루프가 어디서 닫혔는지 알려 주는 정보입니다.

An Aggregate reached graph building without being normalised (Aggregate가 정규화되지 않은 채 그래프 빌드에 도달함)

최상위에 컴포넌트를 두고 작성한 Aggregate와 이름 있는 서브시스템으로 작성한 Aggregate는 읽힐 때 같은 형태가 됩니다. 최상위 컴포넌트는 컴파일러가 제공하는 서브시스템으로 접혀 들어가고 최상위는 비워집니다. 이 접기 덕분에 이후의 모든 단계가 하나의 형태에 하나의 질문만 던질 수 있습니다.

둘 다 채워진 채 그래프 빌드에 도달한 Aggregate는 그 읽기 과정에서 만들어진 것이 아닙니다. 두 형태는 작성 시점에 상호 배타적이며(둘 다 선언한 문서는 로드될 때 거부됨), 접기가 이후에 이를 하나의 형태로 만들므로, 작성자가 쓸 수 있는 어떤 것도 여기에 도달하지 않습니다. 이는 일반적인 로드 경로가 아닌 다른 무언가가 조립한 Aggregate를 위한 안전장치이며, 이를 만나면 우회하기보다 보고할 가치가 있습니다.

메시지는 다음으로 시작합니다:

aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) (Aggregate가 정규화되지 않은 채 토폴로지에 도달함 (합성된 기본 서브시스템과 함께 비어 있지 않은 루트 컴포넌트가 있음))

그리고 컴파일러가 기대하는 구성 경로로 이어지는데, 이는 작성 지침이 아니라 빌드를 디버깅하는 사람을 위한 참고 사항입니다.

해결 방법: 파일의 어떤 내용도 이를 만들지 않으며, 이를 해소하는 작성 변경도 없습니다. 실행한 명령과 함께 보고하십시오.

A label-transform plugin’s patch reaches outside node labels (레이블 변환 플러그인의 패치가 노드 레이블 밖에 도달함)

레이블 변환 역할로 연결된 거버넌스 플러그인은 그래프의 투영을 받습니다. 이 투영은 노드마다 하나의 항목으로 구성되며, 각 항목은 해당 노드의 레이블과 그 인스턴스가 선언한 값을 담고, 그 Component가 민감하다고 선언한 값은 제외됩니다. 플러그인은 노드 레이블에 대한 패치를 반환합니다. 호스트는 패치를 레이블에만 적용한 다음, 돌아온 결과가 여전히 그 레이블 뷰인지 확인합니다. 즉 노드가 같고, 각 노드가 레이블만 담고 있으며, 각 레이블 값이 문자열이어야 합니다.

그 밖의 결과는 거부되고 빌드가 중단됩니다. 노드를 추가하거나 제거하는 것, 또는 레이블 이외의 노드 필드를 변경하는 것은 바로 아무도 선언하지 않은 인프라가 조용히 나타나는 일입니다. 따라서 빌드는 해당 역할이 다루지 않는 변경을 받아들이는 대신, 패치가 어떤 제한 규칙을 어겼는지 알려 줍니다. 레이블이 이 역할이 다룰 수 있는 범위의 전부이며, 플러그인을 연결한 운영자는 딱 그만큼만 선언한 것입니다.

출력되는 메시지. 패치가 적용되기 전에 거부된 경우:

mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (뮤테이터 패치 거부됨: 패치가 JSON Patch 문서로 디코딩되지 않습니다) mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (뮤테이터 패치 거부됨: 패치를 노드 레이블 표면에 적용할 수 없습니다)

또는 패치를 적용한 결과가 호스트가 넘겨준 뷰가 아닌 경우:

mutator patch rejected: mutated node set changed size (a mutator may not add or remove nodes) (뮤테이터 패치 거부됨: 변경된 노드 집합의 크기가 바뀌었습니다(뮤테이터는 노드를 추가하거나 제거할 수 없습니다)) mutator patch rejected: mutated node set introduced node "<node>" (a mutator may not add nodes) (뮤테이터 패치 거부됨: 변경된 노드 집합에 새 노드가 추가되었습니다(뮤테이터는 노드를 추가할 수 없습니다)) mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (뮤테이터 패치 거부됨: 노드에 레이블 필드 밖의 필드가 추가되었습니다(뮤테이터는 레이블만 변경할 수 있습니다)) mutator patch rejected: node "<node>" lost its "labels" field (뮤테이터 패치 거부됨: 노드의 레이블 필드가 사라졌습니다) mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (뮤테이터 패치 거부됨: 패치 적용 후 노드에 문자열이 아닌 레이블 값이 있습니다)

해결 방법: 결함은 문서가 아니라 플러그인에 있습니다. 플러그인이 반환하는 모든 연산이 어떤 노드의 labels 아래 항목을 대상으로 하고 문자열 값만 설정하도록 수정하십시오. 이 표면은 문자열만 받으므로, 숫자나 불리언 레이블 값이 흔한 원인입니다. 플러그인을 수정하는 동안 빌드를 바로 진행하려면 plugins.governance에서 해당 연결을 제거하면 됩니다.

의도적인 생략: 토폴로지가 비순환일 필요는 없음

Aggrega는 토폴로지에 순환을 허용합니다. 의존성 그래프가 방향성 비순환 그래프(Directed Acyclic Graph)일 것을 요구하지 않습니다. 에이전트 간 아키텍처, 콜백 패턴, 상호 인증 쌍은 모두 순환 에지를 만들며, 컴파일러는 이를 받아들입니다. 배포 시점의 순서는 IR 그래프가 아니라 렌더러가 다룰 문제입니다(경계별 syncWave 또는 그에 상응하는 수단을 통해).

inject 계약을 검사할 때

컴파일러는 모든 inject: 블록, 즉 self-inject(Component가 자기 자신에 주입하는 것)와 uses-inject(Component 간 연결) 모두를 순회하며, 전달 계약을 대상 Component의 provides: 스키마, Feature의 레이블 파티션, 선언된 전달 키 집합에 대해 검증합니다. Aggregate 자신의 component가 작성한 블록의 from: 키는 카탈로그가 해석되는 즉시 검사되므로 작성한 그 줄에서 실패합니다. 모듈이 기여하는 컴포넌트의 블록에 있는 키는 그 모듈을 가져오는 구성이 빌드된 뒤에 검사되며, 모듈 자체 문서의 해당 줄에서 실패합니다. 연결된 Feature가 기여하는 연결의 from: 키는 연결을 만들 수 있는 모든 표면이 기여를 마친 뒤에 검사되며, 이는 그러한 연결이 검사할 수 있는 상태로 존재하게 되는 가장 이른 시점입니다.

Inject from key is not in the target’s provides (Inject 키가 대상이 제공하는 키에 없음)

inject: 항목이 읽어 오는 소스가 공개하지 않는 from: 키를 참조합니다. 컴포넌트 자체 블록이나 연결의 경우 그 소스는 대상 Component의 provides: 스키마이고, 첨부된 Feature 자체의 inject: 블록의 경우 첨부된 Feature의 FeatureRecipe입니다.

이 검사는 연결이 작성된 모든 위치에 적용됩니다. uses: 연결은 둘 이상의 작성 표면에서 빌드된 토폴로지에 도달합니다. Component 자신의 uses: 블록, 그리고 그 Component에 연결된 Feature의 uses: 블록이 있으며, 그 연결은 component, subsystem, Release 경계, 또는 Release 경계의 component 항목 중 어디에 작성되어도 됩니다. 같은 철자 오류 키는 이 모든 곳에서 거부됩니다. 진단은 그 키를 작성한 사람의 블록을 가리킵니다. 즉 연결 자체가 선언된 위치의 해당 연결 자신의 uses: 항목을 가리키며, 기여된 연결에 대해서는 아무것도 담고 있지 않은 소비 component의 uses: 블록을 가리키지 않습니다.

참조가 해석되는 위치는 참조가 있는 위치에 따라 달라집니다. Component 수준의 self-inject from:은 같은 Component 자신의 provides:에 대해 해석됩니다. uses: 연결의 from:은 그 연결이 가리키는 component의 provides:에 대해 해석되며, 두 표면이 하나의 소켓과 하나의 별칭을 작성한 경우 각 연결은 자신이 지정한 대상에 대해 해석되고, 같은 빌드에서 그 쌍은 별칭을 공유한다는 이유로 거부됩니다. provides:를 선언하지 않은 Component는 자신을 향한 모든 from: 참조를 거부합니다.

첨부된 Feature 자체의 inject: 블록. 여기서 from:은 Feature의 FeatureRecipe가 provides:에 공개하는 키에 대해, Feature가 첨부된 컴포넌트에 대해 평가된 대로 해석되며, 해당 컴포넌트가 렌더링될 때 검사됩니다. FeatureRecipe가 공개하지 않는 키는 컴포넌트의 환경, 파일 또는 인수에 아무것도 넣지 않으므로 대신 빌드가 중단됩니다. 단, FeatureRecipe가 첨부된 Feature의 항목을 .inject에서 직접 읽는 경우는 예외입니다. 이는 첨부된 Feature 자체의 렌더 컨텍스트, 즉 .inject를 담고 있는 컨텍스트에 대해 평가하는 템플릿에서 읽는 것으로, 해당하는 곳은 그 값 매핑, 워크로드, 아티팩트, 생략 항목, 또는 파이프라인 단계의 with:나 when:이며, 인라인으로 작성되었든 가져온 것이든 상관없습니다. 그 locals:, provides:, source:, assertions:는 .inject를 담지 않으며, 그 injectMapping:은 컴포넌트의 컨텍스트에 대해 평가되므로 이들 중 어디에서 읽더라도 인정되지 않습니다. 이러한 FeatureRecipe는 모든 항목을 작성된 그대로 받아 자체 방식으로 전달하므로 그 항목은 거부되지 않으며, 공개하지 않는 키는 컴포넌트 자체의 전달을 통해서는 아무것도 전달하지 않고 FeatureRecipe가 사용할 몫이 됩니다. FeatureRecipe가 .inject를 읽는지 여부는 그 템플릿이 지정하는 경로로 결정됩니다. 전체 컨텍스트를 넘겨주는 템플릿(toJson .)이나 index . "inject" 같은 함수를 통해 항목에 접근하는 템플릿은 항목을 읽는 것으로 간주되지 않으며, 공개되지 않은 키를 지정하는 그 항목은 거부됩니다. 경계에 첨부되고 그 FeatureRecipe가 해당 경계에 대해 한 번 렌더링되는 Feature는 그 한 번의 평가에 대해 검사됩니다. 컴포넌트를 포함하는 어떤 경계도 그러한 평가를 만들지 않은 경우에는 키를 검사할 대상이 없으므로 키가 거부되지 않습니다. 공개된 키를 지정하는 from:은 이전과 같이 전달됩니다. 이 발견 사항은 첨부된 Feature 자체의 항목, 즉 그것을 작성한 문서 내 위치(예: Aggregate의 .spec.components.<component>.features.<attachment>)에 표시되며, 전달 키를 다른 inject 소스도 이미 보유하고 있는 항목은 “An attachment delivers a key another inject source already claimed (첨부가 다른 inject 소스가 이미 차지한 키를 전달함)”에서도 보고됩니다. 각각 별도의 수정이 필요하기 때문입니다.

컴포넌트 자신의 inject: 블록에서 value: 항목은 리터럴을 담으며 어떤 것에 대해서도 해석되지 않으므로, 우연히 provides 키처럼 보이는 리터럴도 그곳에서는 거부되지 않습니다. 연결에서는 아래의 “An inject: entry on a connection carries a literal (연결의 inject 항목이 리터럴을 담고 있음)”에서 설명하는 대로 value: 항목이 거부됩니다. 키를 지정하는 것은 from:뿐입니다.

Release 자신의 간선별 uses: 표면은 target과 infra를 담고 inject:는 담지 않으므로, 그곳에서 연결된 연결은 전달을 지정하지 않으며 검사할 from: 키도 없습니다.

Component 자신의 inject: 블록에서 읽은 from:에 대해 출력되는 메시지입니다. 거부 내용이 먼저 나오고, 이어서 문제의 키, 해석 대상이 된 component 타입, 그리고 선택할 수 있는 대안인 해당 타입의 선언된 키가 정렬된 순서로 나옵니다:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<delivery-key>, "<from-key>", "<component-type>", "<key-1>", "<key-2>") (잘못된 inject 키: from 키는 해당 소스가 공개하는 provides 키를 지정해야 합니다)

uses: 연결에서 읽은 from:의 경우, 같은 거부 내용이 앞에 오고 항목이 작성된 메커니즘과 전달 키가 문제의 키보다 앞에 나옵니다:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>, "<mechanism>", "<delivery-key>", "<from-key>", "<component-type>", "<key-1>") (잘못된 inject 키: from 키는 해당 소스가 공개하는 provides 키를 지정해야 합니다)

첨부된 Feature 자체의 inject: 블록에서 읽는 from:의 경우, 문제가 된 키가 먼저 오고, 그다음 항목의 in:과 메커니즘, 해석 기준이 된 FeatureRecipe, 그리고 그 FeatureRecipe가 공개하는 각 키가 정렬된 순서로 옵니다:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<from-key>", in "<in>", mechanism "<mechanism>", FeatureRecipe "<feature-recipe>", publishes "<key-1>", publishes "<key-2>") (잘못된 inject 키: from 키는 해당 소스가 공개하는 provides 키를 지정해야 합니다)

대상이 provides: 키를 전혀 선언하지 않은 경우 나열할 대안이 없으므로 메시지는 component 타입 뒤에서 끝나며, 첨부된 Feature의 블록에서는 FeatureRecipe 뒤에서 끝납니다.

해결 방법: from: 키를 메시지에 나열된 선언된 키 중 하나와 일치하도록 변경하거나, 대상 Component의 provides: 스키마를 확장하여 필요한 키를 선언합니다. 첨부된 Feature의 블록에서는 from: 키를 FeatureRecipe가 공개하는 키로 변경하거나, FeatureRecipe를 직접 관리한다면 그 provides:에 키를 공개하거나, FeatureRecipe가 자체 방식으로 값을 전달한다면 .inject에서 항목을 직접 읽도록 합니다.

Required feature not attached (필수 feature가 연결되지 않음)

Component가 존재 의무, 즉 features.aggrega.ai/requiredType.<label> 어노테이션을 선언하여 Feature 타입을 지정했지만, 이 component 인스턴스가 최종적으로 갖게 되는 연결 중에 그 타입이 없습니다. 여기에는 모든 범위가 포함됩니다. Aggregate의 component 수준 및 subsystem 수준 블록, Release의 경계 수준 및 component 수준 블록, 그리고 어노테이션 기반 확장입니다.

출력되는 메시지:

missing required feature: attach a Feature of the required type to the component (<required-type>, required by component type <component-type>, under the requirement label <label>) (필수 feature 누락: 필요한 타입의 Feature를 component에 연결하십시오)

세 값은 의무가 요구하는 Feature 타입(위 문장이 이미 지정하므로 설명 없이 나옴), 의무를 선언한 component 타입, 의무가 담은 레이블 순이며, 뒤의 둘은 두 엔터티 참조를 구별할 수 있도록 각각 설명이 붙습니다. 서로 다른 두 타입을 요구하는 component는 서로 다른 두 메시지를 보고하며, 다른 타입에서 의무를 선언한 두 component에는 각 요구를 어느 타입이 했는지 알려 줍니다. 보고는 components: 아래 component 자신의 키에 위치하며, subsystem 안에 작성된 component는 먼저 그 subsystem의 키 아래에 위치합니다.

여기서는 연결이 작성된 이름이 중요하지 않습니다. 의무는 지정된 타입의 연결이 존재하는지만 묻습니다. 슬롯을 바인딩해도 충족되고, 다른 어떤 이름으로 연결해도 충족됩니다.

해결 방법: Aggregate나 Release에서, 또는 component가 상속하는 더 넓은 범위에서 필요한 타입의 Feature를 component에 연결합니다. Component가 더 이상 그것을 요구하지 않아야 한다면 카탈로그 선언에서 의무 어노테이션을 제거합니다.

Malformed attachment requirement (잘못된 형식의 연결 요구 사항)

존재 의무의 선언을 평가할 수 없습니다. 어노테이션 값은 불투명한 문자열이므로 컴파일러가 읽기 전에 그 형식을 검증하는 것이 없습니다. Feature 타입 URI가 아닌 값, 또는 접두사 뒤에 레이블 없이 의무 계열을 지정하는 키는 충족되지 않은 요구 사항이 아니라 손상된 선언으로 보고됩니다. 오타가 충족된 요구 사항으로 읽혀서는 절대 안 되기 때문입니다.

출력되는 메시지:

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the value must be a Feature type URI of the form <publisher>/<name> in lower-case kebab segments, as in core/prometheus-exporter). Correct that annotation on the component type’s catalog entity. (잘못된 형식의 연결 요구 사항: 값은 소문자 kebab 세그먼트로 된 Feature 타입 URI여야 하므로 평가할 수 없습니다. component 타입의 카탈로그 엔터티에서 해당 annotation을 수정하십시오.)

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the key needs a label naming the requirement, as in features.aggrega.ai/requiredType.database). Correct that annotation on the component type’s catalog entity. (잘못된 형식의 연결 요구 사항: 키에 요구 사항을 지정하는 레이블이 필요하므로 평가할 수 없습니다. component 타입의 카탈로그 엔터티에서 해당 annotation을 수정하십시오.)

메시지는 중단의 대상인 선언, 즉 어노테이션 키로 시작하고 그 뒤에 선언이 손상된 component 타입을 지정합니다. 따라서 보고가 그 타입을 사용하는 component 인스턴스에 위치하더라도 수정할 엔터티를 알려 줍니다. 인스턴스는 문제를 보게 되는 곳이고, 카탈로그 엔터티는 해결책이 있는 곳입니다.

이 중단은 구성이 조립되는 즉시 발생하며, 이는 완성된 그래프를 읽는 모든 검사보다 이릅니다. 따라서 손상된 의무를 포함한 빌드는 그것만 보고합니다. 이후에 실행될 검사들은 선언의 내용을 바탕으로 추론하는데 선언을 읽을 수 없으므로 실행되지 않습니다. 수정하고 다시 빌드하면 나머지를 확인할 수 있습니다.

해결 방법: Component 카탈로그 엔터티를 수정합니다. 해결책은 Aggregate가 아니라 카탈로그에 있으며, 이 때문에 이 중단은 자신의 문서를 변경해야 하는 “Required feature not attached(필수 feature가 연결되지 않음)”와 구별됩니다.

Required attachment slot not bound (필수 연결 슬롯이 바인딩되지 않음)

카탈로그 엔티티가 자신의 featuresSchema에 required: true로 연결 슬롯을 선언했지만, 해당 엔티티의 인스턴스에서 그 슬롯의 이름을 바인딩하는 것이 없습니다. 이 검사는 모든 범위가 합쳐진 뒤 인스턴스가 최종적으로 갖게 되는 연결을 대상으로 실행됩니다. 여기에는 Aggregate의 컴포넌트 수준 및 서브시스템 수준 features: 블록, Release의 경계 수준 및 컴포넌트 수준 블록, 그리고 어노테이션 기반 확장으로 생성된 연결이 포함됩니다. 따라서 인스턴스가 상속하는 범위에서 한 번 연결된 자격 증명은 인스턴스에 직접 작성한 채움과 똑같이 슬롯을 바인딩합니다.

출력되는 메시지:

required attachment slot unfilled (<slot>, declared required by component type <component-type>). Attach a Feature at that name, in the Aggregate or in the Release, on the component or at a scope above it. (필수 attachment 슬롯이 채워지지 않았습니다(위 슬롯, 위 component 유형이 필수로 선언함). 해당 이름으로 Feature를 Aggregate 또는 Release에서, component에 또는 그 상위 범위에 연결하십시오.)

두 값은 슬롯 자체의 이름과 그 슬롯을 선언한 컴포넌트 타입이므로, 하나의 인스턴스가 두 슬롯을 바인딩하지 않으면 서로 다른 두 메시지가 보고됩니다. 보고는 Aggregate에서 컴포넌트의 features: 블록 아래 슬롯 키 위치에 놓입니다. 그 키가 바로 누락된 것이므로, 편집기는 실제로 존재하는 가장 가까운 키에 보고를 표시합니다. 컴포넌트가 features: 블록을 작성했다면 그 블록에, 작성하지 않았다면 컴포넌트 자체에 표시합니다. 누락된 연결을 작성한 것은 없으므로 특정 문서의 작성자를 지목하지 않습니다. 보고는 컴포넌트에 머물고 개발자 오류로 분류되며, 해결 방법은 두 문서를 모두 언급합니다. 어느 쪽이든 슬롯을 채울 수 있기 때문입니다. Aggregate는 컴포넌트 또는 그것을 포함하는 서브시스템에서, Release는 해당 컴포넌트의 항목 또는 그것을 포함하는 경계에서 채울 수 있습니다.

소켓이 선언한 슬롯, 즉 usesSchema 항목의 featuresSchema에 선언된 슬롯은 컴포넌트가 아니라 해당 소켓을 통해 연결된 각 연결에 요구됩니다. 각 연결은 Aggregate 또는 Release의 자기 항목에서 슬롯을 직접 채우며, 상위 범위는 이 슬롯에 도달하지 않습니다. 따라서 연결이 두 개인 소켓에서 한 연결만 슬롯을 채웠다면, 나머지 연결만 이름을 들어 보고됩니다.

required attachment slot unfilled ("<slot>", declared required by socket "<socket>", of component type "<component-type>", left unfilled by the connection "<alias>"). Attach a Feature under that slot in this connection’s features, on its entry in the Aggregate or in the Release. (필수 attachment 슬롯이 채워지지 않았습니다(위 component 유형의 위 소켓이 필수로 선언한 슬롯을 위 연결이 채우지 않음). 이 연결의 features에서 해당 슬롯 아래에 Feature를 Aggregate 또는 Release의 해당 항목에 연결하십시오.)

이 보고는 연결을 작성한 문서의 연결 항목 위치에 놓입니다. 즉 Aggregate의 uses: 항목, 또는 Release가 연결한 연결의 경우 Release의 엣지별 항목입니다. 연결된 Feature가 만드는 연결은 컴포넌트의 소켓이 아니라 그 Feature가 선언한 소켓에 연결되므로, 컴포넌트의 소켓 슬롯은 그 연결이 채울 대상이 아닙니다.

해결 방법: Aggregate 또는 Release에서 슬롯 이름으로 Feature를 연결하십시오. 컴포넌트에 연결하거나, 슬롯의 모든 소비자가 공유하는 더 넓은 범위에 연결합니다. 소켓의 슬롯이라면 보고에 명시된 연결에 연결합니다. 다른 이름으로 작성한 연결은 슬롯을 바인딩하지 않습니다. 슬롯은 이름이 있는 바인딩 지점이므로 이름이 곧 바인딩입니다. 슬롯이 더 이상 필수가 아니어야 한다면, 카탈로그 엔티티의 featuresSchema(컴포넌트 자체의 것 또는 소켓의 것)를 수정해 required 선언을 제거하십시오.

Two Features declared to conflict reach one component (충돌하도록 선언된 두 Features가 하나의 컴포넌트에 도달함)

Feature의 interoperability.conflictsWith는 그 Feature와 함께 연결될 수 없는 Features를 나열하는데, 하나의 컴포넌트가 그 Feature와 그것이 나열한 Feature를 함께 갖게 된 경우입니다. 이 검사는 모든 범위가 합쳐진 뒤 컴포넌트가 최종적으로 갖게 되는 연결을 대상으로 실행됩니다. 여기에는 Aggregate의 컴포넌트 수준 및 서브시스템 수준 features: 블록, Release의 경계 수준 블록(중첩된 것을 포함해 컴포넌트가 속한 모든 경계)과 컴포넌트 수준 항목, 그리고 어노테이션 기반 확장으로 생성된 연결이 포함됩니다. 따라서 두 Feature가 모두 컴포넌트에 작성된 경우, 하나가 컴포넌트를 포함하는 경계나 서브시스템에 있는 경우, 하나는 바깥 경계에 있고 다른 하나는 그 안에 중첩된 경계에 있는 경우 모두 중단됩니다. 공유하는 컴포넌트가 없는 형제 경계에 연결된 두 Features는 만나지 않으며, 컴포넌트를 포함하지 않는 경계는 아무것에도 도달하지 않으므로 어느 경우에도 중단되지 않습니다.

선언은 하나로 충분합니다. 어느 한 Feature의 목록이 다른 쪽을 나열하면 중단이 발생합니다. 이름은 양쪽 모두 버전을 제거한 상태로 비교되므로, 한 항목은 그것이 나열한 Feature의 모든 버전과 일치합니다. 컴파일러는 Feature 작성자가 선언한 이름을 컴포넌트가 가진 Features와 비교할 뿐이며, 어느 쪽에도 그 이상의 의미를 부여하지 않습니다.

출력되는 메시지:

a Feature reaches a component alongside a Feature it declares a conflict with ("<feature>", attached in the Release on boundary "<boundary-path>", conflicts with "<other-feature>", attached in the Aggregate on component "<component>", on component "<component>"). Attach only one of the two where they meet: remove one attachment, or move it to a scope that does not hold this component. (Feature가 충돌을 선언한 다른 Feature와 함께 하나의 component에 도달합니다(Release의 boundary에 연결된 Feature가 Aggregate의 component에 연결된 다른 Feature와 충돌하며, 두 Feature는 위 component에서 만납니다). 둘이 만나는 곳에는 하나만 연결하십시오. attachment 하나를 제거하거나, 이 component를 포함하지 않는 범위로 옮기십시오.)

첫 번째 값은 목록에서 다른 쪽을 나열한 Feature, 즉 위 문장이 언급하는 Feature이며, 그 뒤에 그것이 연결된 모든 위치가 이어집니다. 다음은 그것과 충돌하는 Feature와 그 Feature가 연결된 모든 위치이고, 마지막은 둘이 만나는 컴포넌트입니다. 각 위치는 그것을 변경하기 위해 열어야 할 문서의 용어로 표기됩니다. attached in the Aggregate on component, attached in the Aggregate on subsystem, attached in the Release on boundary(중첩된 경계의 경로는 각 수준을 /로 연결합니다), attached in the Release on the entry for component 뒤에 in boundary, 또는 attached by annotation-driven expansion of 뒤에 어노테이션과 그것이 작성된 위치를 나타내는 declared at이 옵니다. 연결 위에 작성된 연결은 그 연결의 항목으로 표기됩니다. 컴포넌트 자체의 블록이 아니라 그 항목에서 편집하기 때문입니다. attached in the Aggregate on the connection 뒤에 through socket과 of component, 또는 attached in the Release on the connection 뒤에 through socket, of the entry for component, in boundary가 옵니다. 두 위치에 연결된 Feature는 두 위치를 모두 나열합니다. 보고는 components: 아래 컴포넌트 자체의 키 위치에 놓이며, 여러 컴포넌트에서 만나는 쌍은 Aggregate가 컴포넌트를 선언한 순서대로 각 컴포넌트마다 한 번씩 보고됩니다.

해결 방법: 둘이 만나는 곳에는 하나만 연결하십시오. 연결 중 하나를 제거하거나, 형제 경계처럼 이 컴포넌트를 포함하지 않는 범위로 하나를 옮깁니다. 연결이 어노테이션 기반 확장에서 온 경우, 변경할 대상은 확장된 블록이 아니라 어노테이션입니다. 두 Features가 실제로 함께 사용될 수 있다면 잘못된 것은 선언이므로, 선언한 Feature의 카탈로그 엔티티에 있는 conflictsWith 목록에서 다른 Feature를 제거하십시오.

Attachment does not conform to its declared slot shape (첨부가 선언된 슬롯 형태에 맞지 않음)

첨부가 선언된 슬롯에 바인딩되지만 그 슬롯이 선언하는 형태와 일치하지 않습니다. 흔한 경우는 전달입니다. 슬롯의 inject 허용 목록은 채움이 자료를 전달할 수 있는 메커니즘을 지정하며, 빈 허용 목록은 블랙박스입니다. 즉 Recipe가 자료를 내부적으로 전달하고, 채움은 어떤 전달도 지정할 수 없습니다. 빈 inject: {} 블록은 어떤 전달도 지정하지 않으므로 빈 허용 목록을 포함한 모든 슬롯의 형태에 맞으며, 첨부가 어디에 작성되든 같은 판정을 받습니다. Aggregate가 선언하는 컴포넌트, 가져온 모듈이 제공하는 컴포넌트, 더 넓은 범위 모두 마찬가지입니다. 어떤 슬롯도 선언하지 않은 이름으로 작성된 첨부는 자유 첨부이며 슬롯 제약을 받지 않습니다.

출력되는 메시지이며, attachment가 그 슬롯이 받지 않는 전달 방식을 지정하는 경우로, 슬롯, 이어서 메커니즘, 그다음 슬롯의 inject 허용 목록이 받아들이는 각 메커니즘이 슬롯이 선언한 순서대로 표시됩니다(허용 목록이 비어 있으면 아무것도 뒤따르지 않습니다):

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>") (attachment가 선언된 슬롯 형태를 따르지 않음)

가져온 모듈이 제공하는 컴포넌트는 그 모듈을 가져오는 컴포지션이 빌드된 후에 검사되며, 두 번째 형식으로 보고됩니다. 이 형식은 모듈의 Aggregate와, 모듈 문서 안에서 슬롯이 선언하지 않은 키, 즉 첨부의 inject: 블록 아래에 있는 메커니즘 또는 허용 목록이 비어 있는 슬롯에서 어떤 메커니즘이든 지정하는 inject: 블록 자체를 지목합니다:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>.<key>, attachment does not conform to the declared slot shape: this key is not part of the slot’s declaration — <remedy>) (첨부가 선언된 슬롯 형태에 맞지 않음: 이 키는 슬롯 선언에 포함되지 않습니다)

여기서 <remedy>는 키에 따라 다릅니다:

  • remove it: 허용 목록이 비어 있는 슬롯에서 메커니즘을 지정하는 inject: 블록인 경우;
  • remove it, or add it to the slot's inject allowlist in the entity's featuresSchema: 슬롯의 허용 목록이 지정할 수 있는 메커니즘, 즉 env, file 또는 arg인 경우;
  • remove it: a slot's inject allowlist in the entity's featuresSchema accepts only env, file and arg: 그 밖의 메커니즘인 경우이며, 이러한 메커니즘은 어떤 슬롯도 선언할 수 없습니다.

더 넓은 범위, 즉 하위 시스템 전체에 선언되어 그 아래의 모든 구성 요소로 전파되는 첨부도 같은 형태를 따라야 하며, 도달하는 각 구성 요소의 슬롯에 대해 검사됩니다. 따라서 같은 첨부가 한 구성 요소에는 형태가 맞고 다른 구성 요소에는 맞지 않을 수 있으므로, 이 형식은 구성 요소와 검사에 실패한 슬롯을 지정하고, 첨부의 위치를 전달 블록 안의 키가 아니라 첨부가 선언된 범위로 나타냅니다.

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.subsystems.<scope>.features.<attachment>, this attachment is declared at a scope that reaches component <component>, whose attachment slot <slot> does not accept the delivery it carries: move the attachment down to the components that may receive it) (첨부가 선언된 슬롯 형태에 맞지 않음: 이 첨부는 구성 요소에 도달하는 범위에 선언되었으나 해당 구성 요소의 첨부 슬롯이 첨부가 담은 전달을 받아들이지 않습니다. 첨부를 받을 수 있는 구성 요소로 내려 옮기십시오)

연결이 담는 첨부는 이 중단에 도달하지 않습니다. 그 형태는 작성되는 곳에서 닫혀 있습니다. Aggregate의 연결 항목에서는 type, description, values를, Release의 연결 항목에서는 type, description, infra를 받으므로 어떤 전달도 지정할 수 없습니다. 그곳에 작성된 inject:는 문서를 로드할 때 해당 키를 지정하며 거부됩니다. 대신 그 첨부를 전달하는 Workload 항목이 소켓 슬롯의 inject 허용 목록을 따릅니다. 또한 어떤 범위도 소켓의 슬롯에 도달하지 않으므로, 위의 범위 전체 형식은 연결에 대응하는 형식이 없습니다.

해결 방법: 이 형식들은 서로 다른 두 가지 수정이 필요하며, 필드 경로를 보면 어느 쪽인지 알 수 있습니다. 필드 경로가 구성 요소의 첨부, 또는 그 안의 키를 가리키면 전달이 원인입니다. 전달을 제거하거나, 그 항목을 슬롯의 inject 허용 목록이 지정하는 메커니즘 아래로 옮기십시오. 자료가 실제로 슬롯이 나열하지 않은 메커니즘을 통해 워크로드에 도달해야 하는 경우에는 카탈로그 엔터티의 featuresSchema에 있는 허용 목록을 넓힐 수 있습니다. 다만 슬롯이 선언할 수 있는 메커니즘인 env, file, arg로만 넓힐 수 있습니다. 그곳에 다른 메커니즘을 지정하는 Component는 로드될 때 검증에 실패하므로, 그 밖의 메커니즘은 제거하는 것이 유일한 해결 방법입니다. 필드 경로가 범위에 있는 첨부를 가리키면 첨부 자체는 올바르고 배치가 원인입니다. 슬롯이 해당 전달을 받아들이는 구성 요소로 첨부를 내려 옮기고, 전달을 자신의 Recipe에 맡기는 구성 요소는 첨부가 도달하지 않도록 두십시오.

Duplicate delivery key across inject sources (inject 소스 간 전달 키 중복)

하나의 component에 대해 개발자가 작성한 inject 소스들 사이에서 동일한 전달 키(예: 동일한 환경 변수 이름)가 두 번 선언되었습니다. Component 수준과 uses[] 항목 아래에서, 같은 component의 두 uses[] 항목에서, 또는 Component 자체 inject: 블록의 두 전달 메커니즘 아래에서 선언된 경우입니다. 전달은 동시에 두 곳에서 올 수 없으므로, 두 번 선언된 키는 어느 쪽이 우선하는지의 문제가 아니라 모순입니다.

빌드는 이를 네 곳에서 읽습니다. 각 위치는 작성된 소스와 의존성 연결의 서로 다른 집합을 보고 그에 대해 서로 다른 질문을 하며, 각각 고유한 형식으로 보고합니다.

첫 번째는 Aggregate에 작성한 연결을 읽으며, 파일이 해석될 때 보고합니다. 전달 메커니즘, 키, 그리고 작성 순서상 같은 키를 선언한 첫 번째 연결의 socket과 alias를 명시합니다:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>") (inject 소스 간 전달 키 중복)

두 번째는 같은 작성 블록을 읽되 다른 질문을 합니다. 연결이 전혀 관여하지 않은 상태에서 component가 자신의 두 전달 메커니즘 아래에 하나의 키를 선언하는지 여부입니다. 키를 선언한 메커니즘마다 한 번씩, 해당 메커니즘 자체 항목 위치에서 보고하며, 보고 대상 메커니즘, 키, 그리고 같은 키를 선언한 다른 모든 메커니즘을 작성 순서대로 명시합니다:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>") (inject 소스 간 전달 키 중복)

어느 메커니즘도 위반의 원인이 아니며 두 보고 모두 수정할 수 있습니다. 둘 중 하나의 키 이름을 바꾸거나, 두 전달 중 하나를 제거하십시오. component가 애초에 어떤 메커니즘을 사용할 수 있는지는 별개의 문제이며, spec.inject 허용 목록이 이를 결정합니다. 아래 “Self-inject mechanism not in the component’s allowlist (component의 허용 목록에 없는 self-inject 메커니즘)”을 참조하십시오.

모듈이 기여하는 컴포넌트도 이 처음 두 형태에 해당하며, 그 모듈을 가져오는 구성이 빌드된 뒤 모듈 자체 문서에서 읽힙니다. 이 경우 메시지는 모듈의 Aggregate와 그 문서 안의 키를 지정합니다.

세 번째는 완성된 토폴로지가 담고 있는 연결을 읽으며, 여기에는 Feature attachment가 대신 추가한 연결도 포함됩니다. 렌더링 전에 실행되며, 작성한 전달 키와 그 키를 함께 전달하는 의존성 socket을 명시합니다:

duplicate delivery key across self-inject and uses-inject ("<key>", socket "<socket>") (self-inject와 uses-inject 간 전달 키 중복)

작성된 하나의 키가 두 의존성 socket을 통해 전달되면 socket마다 한 번씩 보고되므로, 한 번의 빌드로 먼저 도달한 하나가 아니라 모든 socket을 알 수 있습니다.

네 번째는 같은 완성된 토폴로지를 읽되 다른 질문을 합니다. component 자체는 아무것도 선언하지 않은 상태에서 component의 두 의존성 연결이 하나의 키를 나누어 전달하는지 여부입니다. 각 연결에서 한 번씩, 해당 연결 자체의 전달 항목 위치에서 보고하며, 항목의 경로와 그 뒤에 키를 전달하는 모든 socket을 명시합니다:

duplicate delivery key across inject sources ("inject.<mechanism>.<key>", "<socket>", "<socket>") (inject 소스 간 전달 키 중복)

같은 socket이 두 번 명시되었다면 두 연결이 서로 다른 alias로 하나의 socket에 있다는 뜻입니다. 이 경우 둘을 구분하는 것은 위치뿐이므로, socket 이름이 아니라 두 보고 각각의 필드 경로를 확인하십시오.

어느 연결도 위반의 원인이 아니며 둘 다 수정할 수 있습니다. 키 중 하나의 이름을 바꾸거나, 두 전달 중 하나를 제거하십시오.

키가 경로인 경우 필드 경로는 대신 메커니즘의 블록을 명시합니다. 전달 키가 무엇을 표현하는지는 메커니즘 자체가 결정하며, file 메커니즘은 마운트 경로로 전달합니다. 따라서 그런 키에는 점이 포함되는데, 필드 경로는 점으로 자신의 단계를 구분합니다. 필드 경로는 문서에 없는 키를 따라가는 것처럼 읽히는 단계를 표기하지 않고 모호함 없이 명시할 수 있는 마지막 단계에서 멈추므로, /etc/app/config.yaml 같은 키의 경우 .spec.components.<component>.inject.<mechanism>에서 멈춥니다. 메시지는 어느 경우든 키를 명시하므로 보고는 똑같이 조치 가능합니다. 다만 메시지에서 키를 읽는 위치는 위 네 가지 형식마다 다르므로, 필드 경로로 블록을 확인한 뒤 해당 형식에서 키를 찾으십시오. 세부 내용이 전달 메커니즘으로 시작하면 키는 바로 뒤에 오는 따옴표 값이고, 키 자체로 시작하면 첫 번째 따옴표 값이며, 전달 항목 자체의 경로로 시작하면 키는 그 경로의 마지막 단계입니다.

해결 방법: 충돌하는 키 중 하나의 이름을 바꾸거나 중복 선언을 제거하십시오. component 자체의 inject: 블록이나 연결의 inject: 블록 중 하나가 전달한 키를 FeatureRecipe의 injectMapping이 다시 쓰는 것은 의도된 가로채기이며, 여기서도 다른 어디서도 지적되지 않습니다.

component에 attach된 Feature가 선언한 키는 세 가지 작성 표면 중 세 번째에서 같은 공유 공간을 만나며, 아래 “An attachment delivers a key another inject source already claimed (attachment가 다른 inject 소스가 이미 선언한 키를 전달함)”으로 보고됩니다. attach된 두 Features가 전달하는 키 중 나중 것이 자신의 FeatureRecipe의 injectMapping을 통해 전달하는 경우는 “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (attach된 두 Features가 하나의 키를 전달하며, 나중 것은 FeatureRecipe의 injectMapping을 통해 전달함)”으로 보고됩니다.

Self-inject on a component without an allowlist (허용 목록이 없는 component에서의 self-inject)

개발자가 component 수준 inject: 블록을 작성했지만, Component 카탈로그 엔터티가 spec.inject를 선언하지 않습니다. spec.inject 허용 목록이 없는 Components는 Black-Box 유형이며, 개발자가 작성한 주입을 받지 않습니다.

출력되는 메시지:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>") (spec.inject 허용 목록이 없는 컴포넌트에서의 self-inject)

보고는 제거해야 할 요소인 inject: 블록 자체에 위치합니다.

해결 방법: 이 Component 인스턴스에서 inject: 블록을 제거하거나, 카탈로그 선언에 spec.inject가 포함된 White-Box Component 유형으로 전환하십시오.

Self-inject mechanism not in the component’s allowlist (component의 허용 목록에 없는 self-inject 메커니즘)

개발자가 Component의 spec.inject 허용 목록에 없는 메커니즘(예: env 또는 특정 파일 마운트 형식)을 사용하는 component 수준 inject: 블록을 작성했습니다.

출력되는 메시지:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>, "<component-type>", "<mechanism>", "<allowlisted-mechanism-1>", "<allowlisted-mechanism-2>", …) (spec.inject 허용 목록이 없는 컴포넌트에서의 self-inject)

지정된 메커니즘 뒤에 해당 유형이 허용하는 메커니즘이 이어지므로, 메시지에는 작성된 내용과 유형이 허용하는 내용이 모두 담깁니다. 허용 목록을 전혀 선언하지 않은 유형은 지정된 메커니즘만 보고하고 그 뒤에는 아무것도 없습니다.

이 규칙과 위의 규칙은 모두, 모듈을 가져오는 구성이 빌드된 뒤 모듈이 기여하는 컴포넌트에도 적용됩니다. 이 경우 보고는 모듈의 Aggregate와 그 문서 안의 키를 지정합니다.

해결 방법: 허용 목록에 있는 메커니즘으로 전환하거나, Component가 필요한 메커니즘을 지원해야 한다면 카탈로그의 spec.inject 허용 목록을 확장하십시오.

uses edge dictates delivery on a socket that allowlists none (uses 에지가 허용 목록이 없는 소켓에 전달을 지정함)

uses: 엣지의 inject: 블록이 연결되는 소켓의 usesSchema 항목에 inject: 허용 목록이 선언되어 있지 않거나 빈 목록이 선언되어 있습니다. 이러한 소켓은 Black-Box 연결입니다. 소켓을 선언한 엔터티가 의존성의 값을 내부에서 처리하므로, 소비자는 생산자의 Recipe가 내보내는 것을 그대로 받으며 전달 형태를 선택하지 않습니다. inject: 키가 없는 것과 inject: []는 같은 선언입니다.

소켓은 그것을 선언한 엔터티에서 읽습니다. Feature 부착에 작성된 엣지는 부착된 Feature의 usesSchema를 기준으로 해석되고, 그 외의 모든 엣지는 소비하는 Component의 것을 기준으로 해석됩니다.

출력되는 메시지입니다. 거부 문구가 먼저 나오고, 이어서 엣지가 지정한 메커니즘, 소켓, 선언을 읽은 엔터티가 나온 뒤 해결 방법이 나옵니다:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", declared on the component type "<component-type>"). The socket declares no delivery allowlist, so it permits no dictation at all — the entity that declared it delivers the dependency’s values itself. Remove the inject block from this connection and read the values from the connection’s provides in the consuming Recipe, or declare the mechanisms the socket permits in its usesSchema entry. (uses 엣지의 inject가 소켓이 허용하지 않는 전달 메커니즘을 지정함. 소켓에 전달 허용 목록이 선언되어 있지 않으므로 어떤 지정도 허용되지 않습니다. 소켓을 선언한 엔터티가 의존성의 값을 직접 전달합니다. 이 연결에서 inject 블록을 제거하고 소비하는 Recipe에서 연결의 provides로부터 값을 읽거나, 소켓의 usesSchema 항목에 허용할 메커니즘을 선언하십시오.)

이 결과는 해당 작성 항목이 작성된 문서에서 그 항목의 위치에 표시됩니다. 컴포넌트 자체의 uses: 블록이 만든 엣지는 .spec.components.<consumer>.uses.<socket>.<alias>에, 부착이 만든 엣지는 .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias>에 표시되며, 후자는 부착을 선언한 블록을 기준으로 하므로 컴포넌트 자체가 아니라 서브시스템이나 경계의 블록일 수 있습니다. 소켓이 부착된 Feature에 선언된 경우 메시지는 컴포넌트 타입 대신 feature 타입을 표시합니다. 위반한 각 엣지가 별도의 결과로 보고되므로 한 번의 빌드에서 모두 확인할 수 있습니다.

해결 방법: 엣지에서 inject: 블록을 제거하고 소비하는 Recipe에서 대신 .context.uses.<alias>.provides.<name>로부터 의존성의 값을 읽습니다. 또는 연결이 투명해야 한다면 소켓의 usesSchema 항목에 있는 inject: 허용 목록에 허용할 전달 메커니즘을 선언합니다.

선언하는 엔터티가 전혀 선언하지 않은 소켓은 다른 경우이며 여기서 거부되지 않습니다. 임시 소켓에는 허용 목록이 없으므로 엣지가 벗어날 범위 자체가 없습니다.

uses edge dictates a delivery mechanism outside the socket’s allowlist (uses 에지가 소켓의 허용 목록에 없는 전달 메커니즘을 지정함)

uses: 엣지의 inject: 블록이 소켓의 inject: 허용 목록에 없는 전달 메커니즘을 지정합니다. 허용 목록은 선언하는 엔터티의 엔트리포인트가 실제로 의존성의 값을 읽을 수 있는 전달 형태를 밝힌 것이므로, 목록 밖의 메커니즘은 아무도 소비하지 않는 값을 전달하게 됩니다.

블록이 지정하는 모든 메커니즘을 검사하고 허용 목록 밖의 메커니즘을 각각 보고하므로, 실행할 때마다 하나씩이 아니라 한 번의 빌드에서 모두 확인할 수 있습니다.

출력되는 메시지입니다. 거부 문구가 먼저 나오고, 이어서 거부된 메커니즘, 소켓, 그 소켓이 허용하는 것, 선언을 읽은 엔터티가 나옵니다:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", which permits "<mechanism-1>, <mechanism-2>", declared on the component type "<component-type>"). Dictate one of the mechanisms the socket permits, or widen that socket’s inject allowlist in the declaring entity’s usesSchema entry. (uses 엣지의 inject가 소켓이 허용하지 않는 전달 메커니즘을 지정함. 소켓이 허용하는 메커니즘 중 하나를 지정하거나, 선언하는 엔터티의 usesSchema 항목에서 해당 소켓의 inject 허용 목록을 넓히십시오.)

이 결과는 해당 작성 항목의 위치, 즉 위의 거부에서 설명한 것과 같은 경로에 표시됩니다. 소켓이 부착된 Feature에 선언된 경우 메시지는 컴포넌트 타입 대신 feature 타입을 표시합니다.

해결 방법: 허용 목록에 있는 메커니즘 중 하나로 바꿉니다. 또는 엔터티가 필요한 메커니즘을 지원해야 한다면 카탈로그의 usesSchema 항목에서 해당 소켓의 inject: 허용 목록을 넓힙니다.

An inject: entry carries both a literal and a source key (inject: 항목에 리터럴과 소스 키가 모두 있음)

inject: 항목은 두 가지 중 하나를 전달합니다. value: 아래에 작성하는 리터럴(컴포넌트 자체 블록에서이며, 리터럴이 전달되는 유일한 곳입니다)이거나, from: 아래에 작성하는, 연결이 가리키는 컴포넌트에서 읽는 키입니다. 둘 다 있는 항목은 두 가지를 동시에 말하면서 둘 중 하나를 고를 규칙을 제공하지 않으므로, 둘 중 하나가 조용히 우선하게 두지 않고 거부됩니다.

작성 스키마는 둘 중 정확히 하나만 허용하므로, 파일에서 읽은 문서는 로드될 때 거부됩니다. 이 검사는 그 검사를 뒷받침하는 것입니다. 두 문서가 해석되는 동안 Aggregate와 Release가 지닌 모든 inject: 블록을 읽으므로, 파일이 아닌 다른 경로로 만들어진 문서도 한 필드가 조용히 선택되지 않고, 그로부터 무엇이든 빌드되기 전에 거부됩니다. 아래의 형태 검사와 같은 블록을 대상으로 합니다.

위반 항목을 지닌 각 전달 메커니즘은 별도의 결과로 보고되며, 그것을 작성한 문서에서 해당 메커니즘 위치(컴포넌트 자체 블록이라면 .spec.components.<component>.inject.env)에 놓입니다. 빌드의 모든 결과가 한 번에 보고됩니다. 결과는 메커니즘을 지정한 다음, 그 메커니즘 목록에 있는 각 위반 항목의 in:을 지정합니다.

출력되는 메시지:

inject entry carries both value: and from:; schema requires exactly one ("<mechanism>", "<in-1>", "<in-2>") (inject 항목에 리터럴과 소스 키가 모두 있습니다. 스키마는 정확히 하나를 요구합니다)

해결 방법: 메시지가 지정하는 각 항목을 열어 둘 중 필요하지 않은 쪽을 삭제합니다. 값이 연결이 가리키는 컴포넌트에서 와야 한다면 from:을 유지합니다. 이것은 그 컴포넌트의 provides:가 선언하는 키를 가리킵니다. 값이 컴포넌트 자체 블록에서 이쪽이 제공하는 리터럴이라면 value:를 유지합니다. 연결과 첨부된 Feature 자체 블록에서는 리터럴이 거부되므로 그곳에서는 from:을 유지합니다.

An inject: entry on a connection carries a literal (연결의 주입 항목에 리터럴이 있음)

연결은 그것이 가리키는 컴포넌트가 게시하는 것을 소비하는 컴포넌트로 전달합니다. 연결의 inject: 블록에 있는 각 항목은 from: 아래에서 그 컴포넌트의 provides: 키 중 하나를 지정합니다. value: 아래에 작성한 리터럴은 대상이 게시하는 어떤 것도 가리키지 않으므로 연결에 있을 자리가 없으며, 해당 항목은 버려지지 않고 거부됩니다. 컴포넌트가 자기 자신에게 전달하는 리터럴은 value:가 허용되는 컴포넌트 자체의 inject: 블록에 둡니다.

어느 문서가 그렸든 모든 연결이 검사됩니다. 컴포넌트 자체의 uses: 블록에 있는 연결, Aggregate에서 부착된 Feature가 그리는 연결, 그리고 Release에 작성된 attachment가 그리는 연결입니다. 무엇이든 렌더링되기 전에 거부되므로 aggrega build뿐 아니라 aggrega validate --release도 이를 보고합니다.

각 위반 항목은 별도의 결과로 보고되며, 그 연결을 그린 문서의 연결 항목 위치에 놓입니다. 컴포넌트 자체의 연결이라면 .spec.components.<component>.uses.<socket>.<alias>, attachment가 그리는 연결이라면 .spec.components.<component>.features.<attachment>.uses.<socket>.<alias>, Release에서는 attachment 항목 아래의 같은 경로(예: .spec.boundaries.<boundary>.components.<component>.features.<attachment>.uses.<socket>.<alias>)입니다. 빌드의 모든 결과가 한 번에 보고됩니다. Aggregate의 결과는 DEVELOPER_ERROR로, Release의 결과는 OPS_ERROR로 분류됩니다. 결과는 메커니즘과 항목의 in:을 지정합니다.

출력되는 메시지:

inject entry on a connection carries value:; a connection delivers the target’s published keys, each named with from: ("<mechanism>", "<in>") (연결의 inject 항목에 리터럴이 있습니다. 연결은 대상이 게시한 키를 전달하며, 각 키는 소스 키로 지정됩니다)

해결 방법: 값이 대상이 게시하는 것이라면 value:를 그 provides: 키를 지정하는 from:으로 바꿉니다. 소비하는 컴포넌트가 필요로 하는 리터럴이라면, 항목을 그 컴포넌트 자체의 inject: 블록으로 옮깁니다. 그 블록의 메커니즘은 해당 Component 유형의 spec.inject 허용 목록이 관장합니다.

An inject: entry on an attached Feature carries a literal (첨부된 Feature의 주입 항목에 리터럴이 있음)

첨부된 Feature에 작성된 inject: 블록은 해당 첨부의 FeatureRecipe가 공개하는 것을 컴포넌트에 전달합니다. 각 항목은 FeatureRecipe의 provides:가 공개하는 키 중 하나를 from: 아래에 지정합니다. value: 아래에 작성된 리터럴은 첨부가 공개하는 어떤 것도 지정하지 않으므로, 그 항목의 in: 아래로 컴포넌트에 도달하는 것은 없습니다. 이 항목은 빌드된 뒤 버려지는 대신 거부됩니다. 컴포넌트에 필요한 리터럴은 컴포넌트 자체의 inject: 블록에 속하며, 그곳에서는 value:가 허용되고 전달됩니다.

Aggregate가 inject: 블록을 작성하는 모든 첨부가 검사됩니다. 컴포넌트 자체의 features: 블록에 있는 첨부와, 하위 시스템이 포함하는 모든 컴포넌트에 적용되는 하위 시스템의 features: 블록에 있는 첨부가 대상이며, 이는 Release가 지정하는 Aggregate와 그 Aggregate가 aggregates: 아래에서 가져오는 모든 모듈에서 깊이와 관계없이 적용됩니다. 첨부가 그리는 연결은 자체 inject: 블록을 가지며, 그곳의 리터럴은 위에서 설명한 연결 거부에 해당합니다. Release의 첨부는 자체 inject: 블록을 작성하지 않습니다. 이 항목은 무엇이든 렌더링되기 전에 거부되므로, aggrega validate --release도 aggrega build와 마찬가지로 이를 보고합니다.

문제가 되는 각 항목은 별도의 발견 사항으로 보고되며, 블록을 작성한 문서의 Aggregate에 대해 DEVELOPER_ERROR로 분류되고(모듈에서 작성된 첨부의 경우 모듈 자체 문서), 해당 문서에서 첨부 블록 내부의 전달 메커니즘 위치에 표시됩니다: .spec.components.<component>.features.<attachment>.inject.<mechanism>, 또는 하위 시스템의 첨부의 경우 .spec.subsystems.<subsystem>.features.<attachment>.inject.<mechanism>입니다. 한 문서 안의 모든 항목은 한 번에 보고되며, 가져온 모듈 안의 항목은 가져오는 Aggregate가 통과하면 보고됩니다. 발견 사항은 메커니즘과 항목의 in:을 지정합니다. value:와 from:을 모두 가진 항목은 위의 “An inject: entry carries both a literal and a source key (주입 항목에 리터럴과 소스 키가 모두 있음)”에서 한 번만 보고됩니다.

출력되는 메시지:

inject entry on an attachment carries value:; an attachment delivers the keys its FeatureRecipe publishes, each named with from:, and a literal belongs in the component’s own inject block ("<mechanism>", "<in>") (첨부의 inject 항목에 리터럴이 있습니다. 첨부는 FeatureRecipe가 공개하는 키를 각각 소스 키로 지정하여 전달하며, 리터럴은 컴포넌트 자체의 inject 블록에 속합니다)

해결 방법: 값이 첨부의 FeatureRecipe가 공개하는 값이라면 value:를 해당 provides: 키를 지정하는 from:으로 바꿉니다. 컴포넌트에 필요한 리터럴이라면 항목을 컴포넌트 자체의 inject: 블록으로 옮깁니다. 그 블록의 메커니즘은 해당 Component 타입의 spec.inject 허용 목록이 관리합니다:

components:
api:
type: core/api
inject:
env:
- in: LITERAL_NAME
value: a-literal # the literal, delivered by the component's own block
features:
token:
type: core/token
inject:
env:
- in: TOKEN_NAME
from: name # a key the attachment's FeatureRecipe publishes

An inject: delivery is not a list of entries (주입 전달이 항목 목록이 아님)

inject: 블록의 각 전달 메커니즘(env, file, arg 또는 그 옆에 이름을 붙인 메커니즘)은 항목의 목록이며, 각 항목은 in:과 from: 또는 value: 중 정확히 하나를 지닙니다. 이름에서 키로의 매핑처럼 그 밖의 것을 지닌 메커니즘은 컴파일러가 읽을 수 있는 것을 아무것도 전달하지 않으므로, 버려지지 않고 거부됩니다. 값이 전혀 작성되지 않은 메커니즘은 아무것도 전달하지 않으며 거부되지 않습니다.

작성 스키마는 목록만 허용하므로, 파일에서 읽은 문서는 해당 종류의 스키마와 일치하지 않는 문서로서 로드될 때 거부됩니다. 이 검사는 그 검사를 뒷받침하는 것입니다. 두 문서가 해석되는 동안 Aggregate와 Release가 지닌 모든 inject: 블록을 읽으므로, 파일이 아닌 다른 경로로 만들어진 문서도 전달이 사라지게 두지 않고, 그로부터 무엇이든 빌드되기 전에 거부됩니다. 두 문서가 지닌 모든 블록을 대상으로 합니다. Aggregate에서는 컴포넌트 자체의 블록, attachment의 블록, 그리고 둘 중 하나가 그리는 연결의 블록이며, Release에서는 그 attachment가 그리는 연결의 블록입니다.

각 위반 메커니즘은 별도의 결과로 보고되며, 그것을 작성한 문서에서 해당 메커니즘 위치에 놓이고 메커니즘 이름을 지정합니다. 빌드의 모든 결과가 한 번에 보고됩니다. Aggregate의 결과는 Release의 결과보다 먼저 보고됩니다.

출력되는 메시지:

inject delivery: shape must be a list of entries, each in: with exactly one of from: or value: ("<mechanism>") (inject 전달: 형태는 항목의 목록이어야 하며, 각 항목은 전달 위치와 함께 소스 키 또는 리터럴 중 정확히 하나를 지녀야 합니다)

위치는 작성자가 쓴 키 경로입니다. Aggregate에서는 컴포넌트 자체 블록이 .spec.components.<component>.inject.<mechanism>, 그 연결 중 하나의 블록이 .spec.components.<component>.uses.<socket>.<alias>.inject.<mechanism>, attachment의 블록이 .spec.components.<component>.features.<attachment>…이며, 컴포넌트나 attachment가 선언된 각 하위 시스템마다 .subsystems.<name>이 붙습니다. Release에서는 attachment가 그리는 연결의 블록이 그 attachment를 통해 표시됩니다. 경계 전체에 부착된 것은 .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism>, 컴포넌트에 부착된 것은 .spec.boundaries.<boundary>.components.<component>.features.<attachment>…이며, 중첩된 각 경계마다 .boundaries.<name>, 컴포넌트가 거쳐 지정되는 각 라우팅 항목마다 .aggregates.<module>이 붙습니다.

해결 방법: 메시지가 지정하는 각 메커니즘을 목록으로 작성합니다. env: 아래의 항목 DB_URL: host는 - in: DB_URL이 되며, host가 provides: 키(연결에서는 연결된 컴포넌트의 키, 자체 블록에서는 컴포넌트 자신의 키)를 가리키면 from: host를, 컴포넌트 자체 블록에서 이쪽이 제공하는 리터럴이라면 value: host를 함께 씁니다.

The Feature filling an attachment slot does not satisfy the slot’s selector (attachment 슬롯을 채우는 Feature가 슬롯의 selector를 충족하지 않음)

Component는 자신이 기대하는 Features를 위한 이름 있는 바인딩 지점을 선언하며, 슬롯은 자신을 채우는 대상의 레이블을 제약하는 selector:를 선언할 수 있습니다. attachment는 슬롯의 이름을 지님으로써 슬롯을 바인딩합니다. 그렇게 할 때 attachment가 지정하는 Feature의 레이블이 그 제약과 대조되며, 제약을 충족하지 않는 채움은 빌드를 중단시킵니다. 제약을 선언하지 않은 슬롯은 어떤 채움이든 받아들입니다.

슬롯을 아예 바인딩하지 않은 채로 둘 수 있는지는 다른 해결책이 필요한 별개의 문제이며, 위의 별도 중단 항목에서 보고됩니다. 이 항목은 채움이 있다는 것을 전제로 그 채움이 허용되는지를 묻기 때문에, 바인딩되지 않은 슬롯은 이 항목의 소관이 아닙니다.

이 하나의 조건 아래에서 두 가지 결과가 보고되며, 메시지는 마지막 값이 무엇을 말하는지로 둘을 구분합니다. 제약을 충족하지 않은 채움은 레이블이 일치하지 않은 Feature를 지정합니다. 제약을 아예 읽을 수 없었던 경우에는 대신 그 이유, 즉 레이블 매처가 평가할 수 없었던 표현식을 지정하며, 이는 슬롯에 부착된 것이 아니라 슬롯 자체의 선언에 있는 결함입니다.

채움의 레이블이 제약을 충족하지 않은 경우 출력되는 메시지:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (attachment 슬롯 selector가 충족되지 않았습니다(슬롯에 선언된 selector를, 슬롯을 채우는 Feature의 레이블이 충족하지 않습니다). 슬롯의 selector가 요구하는 레이블을 Feature의 레이블에 추가하거나, 이미 해당 레이블을 가진 Feature로 슬롯을 채우십시오.)

제약 자체를 평가할 수 없었던 경우:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the component’s catalog entity. (attachment 슬롯 selector가 충족되지 않았습니다(슬롯에 선언된 selector를 평가할 수 없었습니다). component의 카탈로그 엔터티에 있는 슬롯 선언의 selector를 수정하십시오.)

이 결과는 채움을 작성한 문서에서 채움의 키 위치에 표시되며, 그 문서의 작성자에게 귀속됩니다. Aggregate에 있는 컴포넌트의 features: 블록은 개발자 결함이고, Release만이 만드는 채움(컴포넌트에 대한 항목이나 컴포넌트를 포함하는 경계에 있는 채움)은 운영자 결함으로 Release 자체의 경로에서 보고됩니다:

[OPS_ERROR E0008] release.yaml at .spec.boundaries.main.components.app.features.identity
attachment slot selector unsatisfied ("feature.aggrega.ai/kind!=secret", declared on slot "identity", not satisfied by the labels of the Feature filling it, "core/secret-value"). Add the labels the slot's selector requires to the Feature's labels, or fill the slot with a Feature that already carries them.

같은 채움을 Aggregate의 컴포넌트에 작성하면 [DEVELOPER_ERROR E0008] aggregate.yaml at .spec.components.app.features.identity로 보고됩니다.

소켓이 선언하는 슬롯(usesSchema 항목의 featuresSchema에 있는 슬롯)도 같은 방식으로 각 연결의 채움을 자신의 selector:에 맞춥니다. 연결이 슬롯에 지닌 attachment가 제약과 대조되며, 제약이 허용하지 않는 채움은 빌드를 중단시키고 슬롯과 함께 소켓과 연결도 지정합니다:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", filled on the connection "<alias>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (attachment 슬롯 selector가 충족되지 않았습니다(소켓의 슬롯에 선언되고 해당 연결에서 채워진 selector를, 슬롯을 채우는 Feature의 레이블이 충족하지 않습니다). 슬롯의 selector가 요구하는 레이블을 Feature의 레이블에 추가하거나, 이미 해당 레이블을 가진 Feature로 슬롯을 채우십시오.)

이 결과는 채움을 작성한 문서에서 해당 연결의 features: 아래 attachment 키 위치에 표시됩니다. 즉 Aggregate의 연결 항목이거나, Release만이 만드는 채움의 경우 Release의 엣지별 항목입니다.

문법이 읽을 수 없는 슬롯 셀렉터는 무언가가 슬롯을 채우기 전에도 거부됩니다. aggrega validate는 카탈로그 전체에 대해서든 하나의 Component 또는 Feature에 대해서든, 그 엔터티 자체 문서가 선언하는 모든 슬롯 셀렉터, 즉 Component 자체의 슬롯, 그 소켓이 선언하는 슬롯, Feature의 슬롯을 읽고, 무언가가 슬롯을 채우는지와 관계없이 문법이 읽을 수 없는 셀렉터를 이 같은 조건으로 거부합니다. 메시지는 위의 “평가할 수 없음” 형태이며, 소켓이 선언하는 슬롯에서는 소켓이 추가됩니다:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the socket’s featuresSchema on the component’s catalog entity. (첨부 슬롯 셀렉터가 충족되지 않음: 소켓의 슬롯에 선언된 셀렉터를 평가할 수 없습니다. 컴포넌트의 카탈로그 엔터티에 있는 소켓의 featuresSchema에서 슬롯 선언의 셀렉터를 수정하십시오.)

Feature의 슬롯에서는 해결 방법이 대신 그 Feature의 카탈로그 엔터티를 지목합니다. 아직 아무것도 슬롯을 채우지 않았으므로 결함은 카탈로그 엔터티에 있습니다. 이는 CATALOG_ERROR로 분류되며 엔터티의 파일을 지목합니다.

해결 방법: 제약을 충족하지 않은 채움이라면 레이블이 제약을 충족하는 Feature를 부착하거나(메시지의 selector가 어떤 레이블을 요구하는지 알려 줍니다), 슬롯을 선언하는 Component에서 슬롯의 selector:를 넓히십시오. 메시지가 제약을 평가할 수 없었다고 말하는 경우 selector 표현식이 결함이므로, Component의 슬롯 선언 또는 소켓의 슬롯 선언에서 수정하십시오.

An attachment written under another name fits a slot its component leaves empty (다른 이름으로 작성된 attachment가 컴포넌트가 비워 둔 슬롯에 맞음)

Component 자체의 attachment 표면은 열려 있습니다. 어떤 슬롯도 선언하지 않은 이름 아래의 attachment는 자유 attachment이며 허용됩니다. 그 표면에서 한 가지 형태만은 중단되는데, 슬롯을 위한 채움이 잘못된 이름으로 작성되었을 때 띠는 형태이기 때문입니다. 하나의 attachment에 대해 다음이 모두 성립하면 빌드가 중단됩니다:

  • 컴포넌트 자체에 작성되어 있습니다. 즉 Aggregate에 있는 컴포넌트 자체의 features: 블록이나, 그 컴포넌트 하나에 대한 Release의 항목에 있습니다.
  • 그 이름이 컴포넌트의 타입이 선언하는 슬롯이 아닙니다.
  • 그 Feature의 레이블이 타입이 선언하는 슬롯의 selector:를 충족합니다.
  • 모든 범위가 합쳐진 뒤에도 컴포넌트에서 그 슬롯을 바인딩하는 것이 없습니다.

그대로 두면 이러한 attachment는 자유 attachment가 되고 원래 의도한 슬롯은 비어 있게 되며, 비어 있는 선택적 슬롯은 빌드가 성공하면서도 아무것도 전달하지 않습니다. 이 규칙은 자격 증명뿐 아니라 모든 Feature에 적용됩니다.

표면의 나머지는 모두 자유롭게 유지됩니다. Feature가 선언된 어떤 슬롯에도 맞지 않는 attachment는 빌드되며, 이미 무언가가 바인딩한 슬롯 옆의 추가 attachment도 그것이 맞는 다른 슬롯이 비어 있지 않는 한 빌드됩니다. 컴포넌트가 하위 시스템이나 Release 경계에서 상속하는 attachment는 판정 대상이 아니므로, 공유 형태(여러 컴포넌트가 속한 범위에 자격 증명을 한 번 부착하고 어떤 컴포넌트도 슬롯을 채우지 않는 형태)는 빌드됩니다. selector:를 선언하지 않은 슬롯은 어떤 Feature를 위한 것인지 아무것도 말하지 않으므로, 어떤 attachment도 이런 방식으로 그 슬롯에 맞춰지지 않습니다. 연결이 지닌 attachment도 여기서는 판정되지 않습니다. 소켓의 슬롯은 닫힌 집합이며, 연결에 있는 다른 이름은 “A connection carries an attachment under a name its socket declares no slot for (연결이 소켓이 슬롯을 선언하지 않은 이름으로 attachment를 지님)” 아래에서 중단됩니다.

출력되는 메시지. 조건을 나타내는 문장이 먼저 오고, 이어서 attachment가 작성된 이름, 컴포넌트, 부착하는 Feature, 맞는 빈 슬롯이 오며, 그다음에 해결 방법이 옵니다:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>"). Attach it as "<slot>" to fill the slot. (어떤 슬롯도 선언하지 않은 이름으로 작성된 attachment가 component에서 비어 있는 슬롯에 맞습니다(component에 attachment가 연결하는 Feature가 비어 있는 슬롯에 맞습니다). 슬롯을 채우려면 해당 슬롯 이름으로 연결하십시오.)

Feature가 둘 이상의 빈 슬롯에 맞는 경우, 메시지는 컴포넌트의 타입이 선언한 순서대로 각 슬롯을 지정하고 선택은 사용자에게 맡깁니다:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>", and the empty slot "<another-slot>"). Attach it under the name of the slot it is meant to fill. (어떤 슬롯도 선언하지 않은 이름으로 작성된 attachment가 component에서 비어 있는 슬롯에 맞습니다(component에 attachment가 연결하는 Feature가 비어 있는 여러 슬롯에 맞습니다). 채우려는 슬롯의 이름으로 연결하십시오.)

이 결과는 attachment를 작성한 문서에서 attachment의 키 위치에 표시되며, 그 문서의 작성자에게 귀속됩니다. Aggregate에 있는 컴포넌트 자체의 features: 블록에 있는 attachment는 .spec.components.<component>.features.<attachment>에서 개발자 결함으로 보고되고, Release만이 컴포넌트에 대한 항목에 작성한 attachment는 그곳, 즉 컴포넌트를 지정하는 경계 아래의 .spec.boundaries.<boundary>.components.<component>.features.<attachment>에서 운영자 결함으로 보고됩니다:

[OPS_ERROR E0328] release.yaml at .spec.boundaries.main.components.app.features.metrics
attachment written under a name no slot declares fits a slot its component leaves empty ("metrics", on component "app", attaching the Feature "core/prometheus-exporter", which fits the empty slot "identity"). Attach it as "identity" to fill the slot.

빈 슬롯 자체는 필수인 경우 별도의 결과이며, Aggregate의 컴포넌트에서 “Required attachment slot not bound (필수 attachment 슬롯이 바인딩되지 않음)” 아래에 보고됩니다.

근접 오타 권고와의 차이. “An attachment name is one edit from a declared slot (attachment 이름이 선언된 슬롯과 한 글자 차이)” 아래의 권고는 이름의 철자에 관한 것입니다. 즉 attachment의 Feature가 selector:를 충족하지 않는 슬롯과 한 글자 차이인 이름으로, 빌드는 되고 경고를 보고합니다. 이 중단은 이름과 관계없이 Feature가 무엇에 맞는지에 관한 것입니다. 이름은 무엇이든 될 수 있으며, 맞는 슬롯이 비어 있어야 합니다. 이름이 슬롯과 한 글자 차이이고 그 Feature가 해당 슬롯에 맞는 경우에는 권고가 발생하지 않으며, 슬롯이 비어 있으면 이 중단이 보고되는 유일한 결과입니다.

해결 방법: 슬롯의 이름으로 부착하여 슬롯을 채우십시오. 메시지가 슬롯을 지정하며, 후보가 여러 개이면 모든 후보를 지정합니다. 정말로 별도의 attachment라면 슬롯도 채우십시오. 추가 attachment는 그것이 맞는 모든 슬롯이 바인딩되면 자유롭기 때문입니다. 또는 여러 컴포넌트에 도달해야 하는 경우 그 컴포넌트들이 속한 하위 시스템이나 Release 경계에 부착하십시오. Feature가 그 슬롯을 절대 채워서는 안 된다면 슬롯을 선언하는 Component에서 슬롯의 selector:를 좁히십시오.

An attachment delivers a key another inject source already claimed (attachment가 다른 inject 소스가 이미 점유한 키를 전달함)

세 가지 작성 표면이 inject: 블록을 통해 하나의 컴포넌트의 주입 파이프로 전달합니다. 컴포넌트 자체의 inject: 블록, 의존성 블록 항목에 있는 inject: 블록, 그리고 컴포넌트에 부착된 각 Feature의 블록입니다. 이들은 전달 메커니즘마다 하나의 키 공간을 공유하므로, 둘이 점유한 키는 어떤 값이 도착하는지 모호해지며, 빌드는 한 표면이 다른 표면을 조용히 대체하도록 두지 않고 중단됩니다. 부착된 Feature는 FeatureRecipe의 injectMapping을 통한 두 번째 방법으로도 전달할 수 있습니다. 이 경로는 모든 블록이 전달한 뒤에 같은 공간과 만나며, 아래의 “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (부착된 두 Features가 하나의 키를 전달하며, 나중 것이 FeatureRecipe의 injectMapping을 통해 전달함)” 아래에서 보고됩니다.

이 조건은 그 공간에서 attachment 블록 쪽에 해당합니다. attachment 자체의 inject: 블록이 이전의 어떤 전달이 이미 보유한 키를 점유할 때 보고됩니다. 위의 “Duplicate delivery key across inject sources (inject 소스 간 중복 전달 키)” 항목은 같은 규칙을 개발자가 작성한 쪽에서 읽은 것이며, 둘을 합하면 모든 블록의 점유가 다루어집니다.

충돌한 쪽은 순서가 결정합니다. 키 아래의 첫 번째 점유가 그 키를 보유하고, 나중의 점유가 보고됩니다. 따라서 키를 이미 빼앗긴 attachment는 그 사실을 통보받지만, 먼저 점유한 attachment는 아무것도 대체하지 않은 나중 점유에 대해 통보받지 않습니다. 아무것도 전달하지 않은 점유는 키를 비워 두며 이 과정에 전혀 참여하지 않습니다.

이 결과는 컴포넌트 블록 안의 attachment 자체 항목에 표시되며, 이곳이 수정할 위치입니다. 메시지는 키와 그 키가 속한 키 공간의 메커니즘을 지정합니다. 충돌하는 각 키는 개별적으로 보고되므로, 두 키를 중복하는 attachment는 두 키 모두에 대해 알려 줍니다.

출력되는 메시지:

duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>")

해결 방법: 어느 쪽도 잘못한 것이 아니며 양쪽 모두 변경할 수 있습니다. 직접 관리하는 쪽의 키 이름을 바꾸거나(Feature의 매핑은 카탈로그 문서에 작성되므로 대개 컴포넌트 자체의 inject: 항목입니다), 두 전달 중 하나를 제거하십시오. attachment가 실제로 값을 공급하도록 의도된 경우에는 attachment의 점유가 아니라 개발자가 작성한 점유를 제거하십시오. Feature의 FeatureRecipe injectMapping이 키를 작성하는 것은 다른 경로이며 여기서 보고되지 않습니다. 컴포넌트 자체의 inject: 블록이나 연결 중 하나가 전달한 키를 다시 작성하는 것은 가로채기이며 전혀 보고되지 않고, 다른 부착된 Feature가 전달한 키를 작성하는 것은 아래 항목에서 보고됩니다.

Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (부착된 두 Features가 하나의 키를 전달하며, 나중 것이 FeatureRecipe의 injectMapping을 통해 전달함)

부착된 Feature는 두 가지 경로로 컴포넌트의 주입 파이프에 전달합니다. attachment에 작성된 inject: 블록과, 출력이 전달 키를 지정하는 FeatureRecipe의 injectMapping입니다. 이 키는 흔히 자격 증명이 선택한 환경 변수처럼 attachment가 지닌 값에서 나옵니다. 부착된 두 Features가 하나의 전달 메커니즘 아래에서 하나의 키에 도달하고, 둘 중 나중 것이 매핑을 통해 도달하면 빌드가 중단됩니다. 그대로 실행되면 컴포넌트는 우연히 마지막에 작성된 값을 읽게 되므로, 출력에 아무런 표시 없이 한 자격 증명이 다른 자격 증명 대신 제시될 수 있습니다.

이 조건은 어디에 부착되었든 모든 부착된 Feature를 다룹니다. 컴포넌트 자체의 features: 블록, 하위 시스템, Release 경계나 컴포넌트 항목, 어노테이션의 확장, 연결의 features: 항목입니다. 두 전달 중 먼저 된 것은 다른 Feature의 매핑일 수도 있고 그 Feature 자체의 inject: 블록일 수도 있으며, 빌드는 두 조합 모두를 이 하나의 조건 아래에서 보고합니다.

충돌한 쪽은 순서가 결정합니다. 모든 inject: 블록은 어떤 매핑이 렌더링되기 전에 전달되고, 매핑은 하나의 고정된 순서, 즉 컴파일 파이프라인에서 설명하는 inject 매핑이 컴포넌트의 부착된 Features를 순회하는 순서로 렌더링됩니다. 따라서 키 아래의 첫 번째 전달이 그 키를 보유하고, 나중 Feature가 보고됩니다. 존재 여부만으로 결정됩니다. 값은 비교되지 않으므로, 하나의 키 아래 같은 값을 전달하는 두 Features도 보고됩니다. 매핑의 출력에 전혀 없는 키는 전달이 아니지만, 빈 값으로 포함된 키는 전달입니다. 빈 값이 그 자리에 있던 값을 대체하기 때문입니다. 서로 다른 두 전달 메커니즘 아래의 같은 키는 두 개의 키이며 충돌이 아닙니다.

보고되지 않는 경우. FeatureRecipe의 injectMapping이 컴포넌트 자체의 inject: 블록이나 연결의 inject: 블록 중 하나가 전달한 키를 다시 작성하는 것은 가로채기(호스트를 한정하는 라우팅 Feature, 업스트림을 리디렉션하는 가드)이며, 매핑의 값이 그 하나의 항목을 대체합니다. Feature의 매핑이 그 Feature 자체의 inject: 블록이 전달한 키를 다시 작성하는 것은 그 Feature가 자신의 전달을 변환하는 것이며, 이 역시 보고되지 않습니다.

이 결과는 나중 Feature 자체의 항목에 표시됩니다. 컴포넌트의 features: 블록 안이거나, 연결이 지닌 Feature의 경우 그것을 작성한 문서에서 해당 연결 아래의 항목, 예를 들어 Aggregate의 .spec.components.<component>.uses.<socket>.<alias>.features.<slot>입니다. 메시지는 키, 전달 메커니즘, 그리고 두 Features를 컴포넌트에서 지닌 이름으로 지정합니다. 연결이 지닌 Feature는 연결의 별칭과 채우는 슬롯을 점으로 연결한 이름으로 지정됩니다. 충돌하는 각 키는 개별적으로 보고됩니다.

출력되는 메시지:

duplicate delivery key across two attachments: an attachment’s FeatureRecipe writes a delivery key another attachment already delivered ("<key>", mechanism "<mechanism>", attachment "<attachment>", delivered first by attachment "<other-attachment>"). Give one of the two attachments a key of its own, or attach one fewer: the key this attachment delivers under is chosen by its FeatureRecipe, which can read the attachment’s own values and infra, and the other’s is chosen the same way or by its own inject block where it delivered through one. A Release sets an attachment’s infra and never its values, so where a key is chosen by a value, attach that attachment in the Aggregate with the value, and keep giving the rest from the Release. (두 첨부 간 전달 키 중복: 한 첨부의 FeatureRecipe가 다른 첨부가 이미 전달한 전달 키를 씁니다. 두 첨부 중 하나에 고유한 키를 부여하거나 첨부를 하나 줄이십시오. 이 첨부가 전달에 사용하는 키는 해당 FeatureRecipe가 선택하며, FeatureRecipe는 첨부 자체의 values와 infra를 읽을 수 있습니다. 다른 첨부의 키도 같은 방식으로 선택되거나, 자체 inject 블록을 통해 전달한 경우에는 그 블록이 선택합니다. Release는 첨부의 infra는 설정하지만 values는 절대 설정하지 않으므로, 키가 값으로 선택되는 경우에는 그 첨부를 값과 함께 Aggregate에서 첨부하고 나머지는 계속 Release에서 제공하십시오.)

해결 방법: 두 Features 중 하나에 고유한 키를 부여하거나(자격 증명 Feature의 경우 대개 그 값이 지정하는 키입니다), 두 attachment 중 하나를 제거하십시오. 둘 다 하나의 변수를 공급하도록 의도된 경우에는 컴포넌트가 어느 것을 읽어야 하는지 결정하고 그것만 부착하십시오. Release가 단독으로 부착하는 두 자격 증명은 모두 해당 Feature가 기본으로 지정하는 키로 도착합니다. Release는 attachment의 values를 쓸 수 없기 때문입니다. 그중 하나를 그 키를 지정하는 값과 함께 Aggregate에서 부착하고, 같은 항목에서 Release로 그 출처를 제공하십시오.

A component declares an inject mechanism the attached Feature maps nothing to (컴포넌트가 부착된 Feature가 아무것도 매핑하지 않는 inject 메커니즘을 선언함)

Component의 spec.inject 허용 목록은 표준 메커니즘 외의 전달 메커니즘을 지정할 수 있습니다. 이는 컴포넌트 자체의 배관이 이해하는 메커니즘으로, 여기에 전달하는 모든 것은 이에 대한 값을 만들어야 합니다. 이러한 컴포넌트에 Feature가 부착되면, FeatureRecipe의 injectMapping이 그것이 만드는 각 값이 어떤 메커니즘으로 전달되는지를 정합니다. 컴포넌트가 선언했지만 매핑이 키를 만들지 않는 메커니즘은 아무 표시 없이 결코 일어나지 않을 전달이므로, 대신 빌드가 중단됩니다.

메커니즘에 대해 아무것도 말하지 않는 매핑은 메커니즘이 없다고 말하는 매핑이 아닙니다. 매핑이 전달의 평면 딕셔너리로 렌더링되는 FeatureRecipe는 메커니즘에 대해 전혀 주장하지 않습니다. 이는 환경 변수 전달을 만드는 Feature의 일반적인 작성 방식입니다. 평가할 매핑이 없는 FeatureRecipe를 바인딩하는 부착도 마찬가지입니다. 둘 다 여기서 보고되지 않습니다. 이 조건은 메커니즘을 지정하면서 컴포넌트가 선언한 메커니즘 하나를 빠뜨린 매핑에만 해당합니다.

매핑되지 않은 각 메커니즘은 별개의 결과이므로, 부착이 둘 다 매핑하지 않는 두 메커니즘을 선언한 컴포넌트는 둘 모두에 대해 알려 줍니다. 이 결과는 사용자 자신의 파일에 있는 부착 항목에 위치하며, FeatureRecipe도 함께 지정합니다. 매핑이 작성된 문서가 바로 그것이며, 그 문서는 전혀 다른 곳에 있기 때문입니다.

출력되는 메시지:

custom inject mechanism has no matching key in injectMapping output; add the mechanism’s key to the Recipe injectMapping ("<mechanism>", recipe "<featurerecipe>") (사용자 정의 inject 메커니즘에 대응하는 키가 injectMapping 출력에 없음. 메커니즘의 키를 Recipe injectMapping에 추가하십시오)

해결 방법: 메시지가 양쪽을 모두 지정합니다. FeatureRecipe의 injectMapping에 메커니즘의 키를 추가하여 Feature가 그에 대한 값을 만들도록 하거나, 그 메커니즘으로 아무것도 전달될 것으로 예상되지 않는 경우 Component의 spec.inject 허용 목록에서 메커니즘을 제거합니다. FeatureRecipe가 다른 사람의 카탈로그에 속한 경우, 매핑이 해당 메커니즘을 다루는 Feature를 부착하는 것이 세 번째 방법입니다.

An attached Feature’s injectMapping output cannot be read (첨부된 Feature의 injectMapping 출력을 읽을 수 없음)

FeatureRecipe의 injectMapping은 템플릿이며, 그것이 생성하는 결과는 YAML로 읽힙니다. 즉 전달 메커니즘(env, file, arg 또는 컴포넌트 고유의 메커니즘)을 키로 하는 딕셔너리이거나, 환경 변수 전달로 이루어진 평면 딕셔너리입니다. 출력이 둘 중 어느 것으로도 읽히지 않으면 그 키를 하나도 전달할 수 없으므로, 빌드는 첨부된 Feature가 아무것도 전달하지 않은 것처럼 컴포넌트를 렌더링하는 대신 중단됩니다. 가장 중요한 경우는 자격 증명입니다. 그렇지 않으면 받은 적 없는 비밀번호를 기대하는 컴포넌트가 비밀번호 없이 실행될 수 있으며, 출력의 어떤 부분도 그 사실을 알려 주지 않습니다.

흔한 원인은 템플릿이 값을 그대로 따옴표 안에 쓴 경우입니다. 값 안의 큰따옴표는 따옴표로 묶인 스칼라를 일찍 끝내고, 백슬래시는 YAML이 모를 수 있는 이스케이프를 시작하므로, 대부분의 값에서는 올바르게 렌더링되는 매핑이 그런 문자를 포함한 값, 흔히 비밀번호에서 깨집니다. 비어 있는 출력이나, 아무것도 전달하지 않는 딕셔너리로 파싱되는 출력은 이 조건에 해당하지 않습니다. 그 출력은 아무것도 전달하지 않으며, 그것이 바로 그 출력이 말하는 바입니다.

메시지 위의 프레임은 렌더링 중인 컴포넌트를 지목하고, 이어서 첨부를 컴포넌트에서 갖는 이름과 매핑이 작성된 FeatureRecipe로 feature "<attachment>" (recipe "<featurerecipe>") injectMapping output 형태로 지목합니다. 메시지 아래에는 출력을 읽을 수 없었던 이유, 즉 줄과 YAML이 그곳에서 발견한 내용이 yaml: line 2: found unknown escape character처럼 표시됩니다. 템플릿이 작성자가 민감하다고 선언한 값을 읽고 그 이유가 그 값의 내용에 따라 달라지는 경우, 이유는 숨겨지고 그렇다는 문장이 대신 표시되므로, 이 중단은 출력을 깨뜨린 값을 결코 인용하지 않습니다. 매핑은 FeatureRecipe 작성자가 작성하므로, 빌드는 이 중단을 CATALOG_ERROR 태그로 보고합니다.

출력되는 메시지:

FeatureRecipe injectMapping output could not be read as a dictionary of deliveries (FeatureRecipe의 injectMapping 출력을 전달 딕셔너리로 읽을 수 없음)

해결 방법: FeatureRecipe의 injectMapping에서 각 값을 toJson을 거쳐 작성하십시오({{ .values.key }}: {{ .values.origin | toJson }}). 그러면 값이 JSON 문자열로 작성되어, 어떤 문자를 담고 있든 YAML이 정확히 그대로 다시 읽습니다. FeatureRecipe가 다른 사람의 카탈로그에 속한 경우에는, 매핑이 수정될 때까지 값에 큰따옴표나 백슬래시가 들어가지 않도록 값을 바꿀 수도 있습니다.

An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (첨부된 Feature의 injectMapping 출력이 아무것도 전달하지 않는 키 아래에 전달을 작성함)

FeatureRecipe의 injectMapping 출력은 최상위 키에 따라 컴포넌트의 주입 파이프에 병합됩니다. env, file, arg는 해당 메커니즘으로 전달되고, 그 밖의 키는 그 이름을 가진 고유한 메커니즘으로 전달되며, 컴포넌트의 Recipe는 이를 .context.inject.<name>에서 읽습니다. all 뷰는 다릅니다. 이 뷰는 병합 후의 메커니즘들로부터 만들어지며 출력에서 병합되는 일이 없으므로, 매핑이 all: 아래에 작성한 값은 어디에도 도달하지 않습니다. 출력은 여전히 문제없이 읽히므로, 이 중단이 없으면 그 값들을 선택적으로 읽는 빌드는 값이 빠진 채 성공합니다. 그곳에 작성된 자격 증명은 컴포넌트에 결코 도달하지 않으며, 빌드의 어떤 부분도 그것을 잃어버린 매핑을 지목하지 않습니다.

이 조건은 all:이 항목을 하나 이상 담고 있으면, 단독이든 다른 메커니즘과 함께든 적용됩니다. 같은 출력의 다른 메커니즘은 문제가 아니며, 비어 있게 작성된 all:은 아무것도 잃지 않으므로 보고되지 않습니다. 우연히 all이라는 이름의 키를 단일 값과 함께 담은 평면 딕셔너리는 all이라는 이름의 환경 변수 전달이며, 이 조건이 아닙니다.

이 결과는 사용자 자신의 파일에 있는 첨부 항목에 위치가 지정되며, 키와 매핑이 작성된 FeatureRecipe를 지목합니다. 변경해야 할 문서는 그것이며, 완전히 다른 곳에 있기 때문입니다. 이와 함께 출력이 담을 수 있는 키도 제시합니다. 그러한 키는 각각 별도의 결과가 됩니다. 빌드는 이를 CATALOG_ERROR 태그로 보고합니다.

출력되는 메시지:

FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads ("all", recipe "<featurerecipe>", an output may carry "env, file, arg, or a custom mechanism the host's Recipe reads under its own name") (FeatureRecipe의 injectMapping 출력이 호스트의 어떤 전달 메커니즘도 읽지 않는 키를 작성함: recipe와 출력이 담을 수 있는 키가 함께 표시됨)

해결 방법: FeatureRecipe의 injectMapping에서 all: 아래의 항목을 컴포넌트가 그것을 읽는 메커니즘으로 옮기십시오. 보통 env:이거나, 컴포넌트의 Recipe가 읽는 메커니즘의 이름입니다. FeatureRecipe가 다른 사람의 카탈로그에 속한 경우에는 대신 매핑이 그 값을 전달하는 Feature를 첨부하십시오.

출력을 렌더링할 때

모든 계약이 검증된 후 컴파일러는 Component 값, FeatureRecipe injectMapping 블록, Recipe 및 FeatureRecipe 소스의 Go 템플릿을 평가한 다음 그 결과를 렌더러에 넘깁니다.

provides: 템플릿이 자기 완결적이지 않은 루트를 참조함

Recipe의 provides: 템플릿이 자기 완결 집합 밖의 루트를 참조합니다. provides 블록은 provides 평가 단계에서, 즉 inject 파이프가 채워지기 전이자 노드 간 엣지를 순회하기 전에 평가되므로 자기 노드에 속한 데이터만 참조할 수 있습니다: .context.instance_id, 노드의 provider가 보고하는 경우의 .context.rendered_name, .values, .infra, 노드의 해석된 .locals, 그리고 정적 문자열입니다. 이 검사는 허용 목록 방식이므로 그 밖의 루트는 모두 중단됩니다. .context.inject와 .context.uses(노드 간 데이터), .context.annotations.*, .context.labels, .context.metadata, .metadata.*(provides 표면이 노출하지 않는 배치 또는 배포에 결합된 데이터), 그리고 .attachment_name(기본 Recipe의 provides 단계는 어떤 연결도 해석하지 않음)이 그렇습니다. 이들 중 하나를 참조하면 빈 값을 조용히 렌더링하는 대신 명시적으로 중단됩니다.

.locals는 표면에 포함됩니다. 노드의 locals는 같은 단계의 서두에서 provides보다 먼저 해석되므로, provides 템플릿은 이를 읽어 해석된 값을 받습니다.

출력되는 메시지:

provides block references a root outside the self-contained set ("<expression>") (provides 블록이 자기 완결 집합 밖의 루트를 참조함)

이 중단은 해당 항목을 선언한 Recipe와 그 안의 작성된 키 .spec.provides.<name>에 위치하므로, Recipe를 바인딩한 component가 아니라 수정할 블록을 가리킵니다. 표면 밖으로 벗어나는 모든 항목은 같은 빌드에서 보고되며, 둘 이상이면 결과는 provides entries that reach outside the data they are evaluated against 아래에 묶입니다.

해결 방법: Recipe 자체의 필러에서만 값을 가져오도록 템플릿을 고칩니다. 값이 다른 노드의 출력에 의존한다면 그 의존성은 대상의 provides가 아니라 호출자의 uses[].inject 블록에 있어야 합니다. 값이 계산된 것이라면 식을 locals: 항목에 두고 provides에서 읽습니다. 그러면 식이 한 곳에만 존재합니다. 네임스페이스 간 호스트를 만들려고 배포 네임스페이스(또는 다른 배치 데이터)를 참조하려 했다면, 여기서는 순수 호스트를 게시하고 소비자 측에서 라우팅 기능으로 한정합니다. 생산자의 provides는 배포된 위치에 의존해서는 안 됩니다.

FeatureRecipe의 provides:도 같은 locals 규칙을 따릅니다. 자체 locals:가 provides:보다 먼저 해석되므로 FeatureRecipe의 provides 항목도 .locals를 읽을 수 있습니다.

locals: 항목이 같은 블록에서 나중에 정의된 형제 항목을 참조함

locals: 블록은 항목이 작성된 순서대로 해석되며, 항목은 자신보다 위에 정의된 형제 항목만 읽습니다. 블록에서 나중에 정의되는 항목을 직접 .locals.<key>로 참조하면 중단됩니다. 컴파일러는 참조가 해석되도록 블록을 정렬하거나 재배열하지 않습니다. 그렇게 하면 출력이 작성된 내용이 아니라 추론을 따르게 되기 때문입니다. 중단이 없다면 참조는 누락 키 정책에 따라 빈 문자열로 해석되어, 파생된 호스트 이름이나 시크릿 이름이 원래 구성 요소였던 부분을 조용히 잃게 됩니다.

locals: 블록의 두 가지 해석 모두가 이 오류를 판정하며, 그중 하나는 고정(pinning)입니다. 블록은 두 가지 목적으로 해석됩니다. 아티팩트를 렌더링하는 동안 Recipe 자체 템플릿이 읽을 수 있도록, 그리고 구조화된 source: 좌표를 해석하여 그것이 가리키는 아티팩트를 고정할 수 있도록입니다. 이 오류는 선언된 키 순서와 작성된 텍스트만으로 판정되므로 두 해석 모두 이를 만나 같은 조건을 보고합니다. aggrega pull과 lockfile을 채우는 빌드도 렌더링과 똑같이 블록을 거부합니다. 작성할 때 알아 둘 두 가지 결과가 있습니다. 좌표를 해석하는 동안에는 블록 전체를 읽으므로, 모든 source: 필드가 리터럴이고 local을 읽지 않더라도 순서가 잘못된 항목은 중단됩니다. 그리고 source:가 일반 문자열이거나 source:를 전혀 선언하지 않은 Recipe는 좌표를 해석하지 않으므로, 그런 Recipe에서는 출력을 렌더링할 때 오류가 보고됩니다.

component Recipe 자체의 locals: 블록에 있는 항목에 대해 출력되는 메시지입니다. Recipe 안의 작성된 키에 위치하며, 문제가 있는 모든 항목이 한 빌드에서 보고됩니다. 둘 이상이면 결과는 locals entries that read a sibling they cannot 아래에 묶입니다:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<referenced>", resolved at this point "<the locals available here>", reached through the component "<component>"). define "<referenced>" above "<key>" in the locals block (locals 항목이 같은 블록에서 나중에 정의된 형제 항목을 참조합니다. 참조된 키를 locals 블록에서 해당 키보다 위에 정의하십시오)

자기 참조도 같은 조건입니다. 키는 선언되었지만 해석되지 않았고, 어떤 재배열로도 해결되지 않으므로 메시지는 이동 지시 대신 그 사실을 알려 줍니다:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<key>", resolved at this point "<the locals available here>", reached through the component "<component>"). a locals entry cannot read itself; compute the value from .values and .infra directly (locals 항목이 같은 블록에서 나중에 정의된 형제 항목을 참조함. locals 항목은 자기 자신을 읽을 수 없으므로 .values와 .infra에서 값을 직접 계산하십시오)

하나의 Recipe는 여러 component에 바인딩되므로, 공유 블록의 실수 하나는 그것을 바인딩한 component마다 한 번씩 보고되며, reached through the component가 그 결과들을 구분해 줍니다. 모두 같은 문서의 같은 작성 항목에 관한 것이므로 위치는 같습니다. 위치는 수정할 곳이고, component 이름은 각 결과가 어느 component에 해당하는지를 나타냅니다. 결과를 하나로 합치지 않는 이유는, 합치면 무언가 잘못되었다는 것만 말하고 어느 component에 영향을 주는지는 말하지 못하기 때문이며, 조치해야 할 부분이 바로 그것입니다.

Feature의 recipe가 선언한 locals: 블록의 같은 오류도 같은 방식으로 보고됩니다. 해당 recipe 안의 작성된 키에 위치하고, 연결이 붙은 component의 이름으로 표시되며, 같은 오류를 가진 형제 항목과 함께 묶입니다. recipe가 여러 곳에 연결되어 있으면 오류는 각 연결마다 한 번씩 보고됩니다. 각 연결이 그 블록을 독립적으로 바인딩하므로, 각각은 하나의 반복이 아니라 별개의 발생입니다.

이 형태가 자기 참조를 보고할 때 위치 절은 나중 항목이 아니라 참조하는 항목 자체를 가리킵니다. 키가 있는 곳이 바로 그곳이기 때문입니다.

해결 방법: 참조되는 항목을 그것을 읽는 항목 위로 옮깁니다. 한 항목이 다른 항목을 읽는 경우 locals: 블록의 재배열은 동작 변경이므로, 해결 방법은 정확히 메시지가 지시하는 재배열입니다. 자기 참조, 즉 자신의 키를 가리키는 항목은 재배열로 해결할 수 없습니다. 대신 .values와 .infra에서 값을 직접 계산하십시오. 메시지도 이동 지시 대신 이를 안내합니다.

locals: key does not exist (해당 키가 존재하지 않음)

템플릿이 locals: 블록에 전혀 선언되지 않은 키에 대해 .locals.<key>를 읽습니다. 철자 오류이거나 이름이 바뀌었거나 제거된 키입니다. 이 pillar를 읽는 모든 표면이 이 중단을 발생시킵니다. locals: 항목, provides: 템플릿, Recipe source: 템플릿, 그리고 구조화된 source: 좌표의 해석입니다. 좌표의 해석은 좌표가 가리키는 아티팩트를 고정하기 위해 블록 전체를 읽습니다. locals pillar는 열린 키 맵이므로 그 아래의 알 수 없는 키는 루트 검사를 통과하며, 그렇지 않으면 빈 문자열로 해석됩니다. 이 중단은 그 빈 값이 출력되는 아티팩트에 도달하지 않도록 막는 장치입니다.

문제의 참조가 provides: 템플릿에 있는 경우 출력되는 메시지:

template references a key the locals block does not declare (Recipe <recipe> provides[<key>] references <expression>, the locals block declares no <referenced>, it declares <the keys it does declare>). correct the key name (템플릿이 locals 블록에 선언되지 않은 키를 참조합니다. 키 이름을 수정하십시오)

참조가 locals: 항목 자체에 있는 경우 출력되는 메시지입니다. 이 메시지는 블록이 바인딩된 경로인 컴포넌트를 함께 담습니다. 그 이유는 위의 순서 중단에서 설명한 것과 같습니다. 공유된 블록 하나는 그것을 바인딩하는 컴포넌트마다 한 번씩 보고되며, 이것이 그 결과들을 구분해 줍니다:

template references a key the locals block does not declare ("<expression>", the missing key is "<referenced>", the block declares "<the keys it does declare>", reached through the component "<component>"). correct the key name (템플릿이 locals 블록에 선언되지 않은 키를 참조합니다. 키 이름을 수정하십시오)

해결 방법: 키 이름을 블록이 선언한 키 중 하나로 수정합니다. 메시지에 해당 키 목록이 나와 있습니다. 이 중단은 해결 방법이 다르기 때문에 위의 순서 중단과 구별됩니다. 존재하지 않는 키는 어떤 순서 변경으로도 해석되지 않습니다.

이 검사는 참조의 입력된 문자가 아니라 참조가 해석되는 경로를 읽으므로, 블록의 별칭도 추적됩니다. with .locals 본문이 다시 바인딩하는 점(dot)을 통해 도달한 키나 .locals에 바인딩된 변수를 통해 도달한 키는 직접 쓴 표기와 정확히 같은 조건으로 검사되며 같은 방식으로 중단되고, 괄호로 감싼 블록에서 읽은 키({{ (.locals).nope }} 또는 {{ ($.locals).nope }})도 마찬가지입니다. 괄호가 내놓는 것은 블록 자체일 뿐 그 이상이 아니기 때문입니다. 검사를 벗어나는 표기는 하나뿐입니다. 템플릿 텍스트가 결과를 지칭할 수 없는 호출을 통해 도달한 키입니다. {{ index .locals "nope" }} 또는 {{ (default dict .locals).nope }}처럼, 그런 호출이 내놓는 값은 작성된 내용이 아니라 템플릿이 실행될 때 결정되기 때문입니다. 그런 호출의 결과에서 필드로 읽은 없는 키, 즉 (default dict .locals).nope 형태는 중단되지 않으며, 템플릿 엔진의 자리 표시 텍스트인 <no value>를 렌더링합니다. index를 통해 도달한 없는 키는 중단되지만, 이 검사가 아니라 아래의 “A template indexes a map with a key the map does not hold (템플릿이 맵에 없는 키로 맵을 인덱싱함)”으로 보고됩니다. index는 맵에 없는 모든 맵 키에서 중단되기 때문입니다. 따라서 index는 이름 자체가 계산되는 키에 도달하는 방법으로 남으며, 블록이 선언하지 않은 계산된 이름도 여전히 그 키로 보고됩니다.

Template references a root the render context does not define (템플릿이 렌더 컨텍스트가 정의하지 않는 루트를 참조함)

템플릿이 렌더 컨텍스트가 정의하지 않는 최상위 루트(앞의 점 다음에 오는 첫 번째 경로 세그먼트)를 참조합니다. {{ .valeus.port }} 같은 오타이거나, 작성 중인 표면에 존재하지 않는 루트입니다. 이 검사는 루트 이름에 대한 긍정 허용 목록이며, 허용되는 집합은 별도의 목록으로 옆에 두는 것이 아니라 렌더 컨텍스트 자체의 형태에서 도출됩니다. 따라서 빌드가 거부하는 집합과 컨텍스트가 실제로 제공하는 집합이 서로 어긋날 수 없습니다. 진단은 문제가 되는 참조를 지목하고 해당 컨텍스트가 정의하는 루트를 나열합니다.

이 중단은 참조가 그대로 쓰였든 default, if, with, range 폴백으로 감싸였든 똑같이 발생하며, 가장 중요한 것은 감싼 형태입니다. 래퍼는 정의된 루트 아래의 없는 키에 대해서는 폴백을 제공할 수 있지만 없는 루트에 대해서는 결코 제공할 수 없으므로, 이 중단이 없다면 감싼 형태는 조용히 빈 값으로 해석되어 빌드가 성공적으로 끝나게 됩니다. 정의된 루트 아래의 없는 키는 영향을 받지 않으며, 아래 “Missing template key — asymmetric policy (누락된 템플릿 키 — 비대칭 정책)”에서 설명하는 값 템플릿용 missingkey=zero 정책을 그대로 따릅니다. 따라서 {{ .values.optional_field | default "fallback" }} 같은 선택적 키 관용구는 계속 동작합니다.

같은 중단은 형태가 선언된 필러 아래 한 단계의 잘못 입력한 키에도 적용됩니다. 일부 필러는 컴파일러가 정의하는 키 집합을 가집니다. Recipe 및 FeatureRecipe 렌더 컨텍스트의 .context, .metadata, .inject, .workload, .boundary와 경로 템플릿의 .manifest입니다. 이러한 필러가 정의하지 않는 키에 대한 참조({{ .context.nmae }}, {{ .metadata.typo }}, {{ .workload.containres }}, {{ .boundary.nmae }})는 잘못된 루트와 똑같이 중단되며, 진단은 해당 필러가 정의하는 키를 나열합니다. Feature 첨부 자체의 템플릿에서는 .inject가 env, file, arg, all 외에도 첨부 자체의 inject: 블록이 지정하는 전달 메커니즘마다 키를 하나씩 더 정의합니다. vault_ref: 메커니즘을 쓰는 첨부는 {{ .inject.vault_ref.VAULT_PATH }}에서 읽히며, 진단은 .inject가 정의하는 키 가운데 .inject.vault_ref를 나열합니다. 첨부가 지정하지 않은 메커니즘은 if나 with 안에서도 중단됩니다. 참조는 템플릿이 실행되기 전에 검사되기 때문입니다. 첨부가 지정하지 않을 수도 있는 메커니즘을 읽으려면 다음과 같이 보호하십시오: {{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}. 이렇게 보호된 쌍은 첨부가 그 메커니즘을 지정하든 그렇지 않든, 그리고 inject: 블록을 아예 쓰든 그렇지 않든 빌드에 성공합니다. 그 경우 .inject는 아무것도 담지 않으므로 with가 본문을 건너뛰는 반면, .inject에 바로 hasKey를 적용하면 맵이 아닌 값에서 중단됩니다. 보호 안에서도 index는 지정된 메커니즘이 담고 있지 않은 키에서 여전히 중단됩니다. 다른 필러는 열려 있습니다. 담는 내용이 컴파일러가 선언하는 집합이 아니라 키로 구분된 데이터이기 때문입니다. 렌더 컨텍스트의 .values, .infra, .locals, .provides, .features, .steps와 경로 템플릿의 .parameters, .parent_boundary가 여기에 해당합니다. 열린 필러는 어떤 키든 받아들입니다. 열린 필러 아래의 없는 키는 이 중단에 해당하지 않으며, 아래 “Missing template key — asymmetric policy (누락된 템플릿 키 — 비대칭 정책)”에서 설명하는 해당 표면의 누락 키 정책을 따릅니다. 따라서 {{ .values.optional_field | default "fallback" }}를 비롯한 모든 선택적 키 관용구는 계속 동작합니다.

어떤 필러가 선언되고 어떤 필러가 열려 있는지는 표면의 속성이며 템플릿이 영향을 줄 수 있는 것이 아닙니다. 컴파일러는 이를 곧 제공할 렌더 컨텍스트의 형태에서 읽습니다. 이 덕분에 같은 템플릿에서 오타는 중단되고 선택적 키는 렌더링될 수 있습니다.

표면은 필러가 원래 정의하는 키를 좁힐 수도 있으며, 이러한 보고는 오타가 아닙니다. 어떤 키가 특정 표면에서 무의미한 답을 담거나 다른 노드에 속하는 답을 담는 경우, 그 표면은 참조를 잘못된 값으로 해석하는 대신 거부하고, 진단은 실제로 정의하는 키를 나열합니다. 알아 두어야 할 두 가지 경우가 있으며, 둘 다 {{ .context.rendered_name }}입니다. Feature 첨부 자체의 템플릿에서 이 키는 호스트 컴포넌트의 이름을 호스트 자신의 프로바이더가 보고하는 대로 담습니다. 따라서 프로바이더가 이름을 보고하지 않는 호스트(아티팩트 집합만 배치하는 호스트나, 그러한 이름을 도출하지 않는 프로바이더를 통해 렌더링하는 호스트)의 첨부에서는 거부되고, 다른 모든 호스트에서는 허용됩니다. {{ .context.instance_id }}는 그 표면에서 허용되며 첨부가 해석되는 대상인 호스트 컴포넌트를 가리키는데, 그러한 호스트에서는 호스트 자신의 리소스가 이 이름을 따라 명명됩니다. Recipe의 locals: 항목에서는 노드의 프로바이더가 무엇을 보고하든 이 키가 거부됩니다. local은 Recipe의 source: 템플릿과 컨텍스트를 공유하며, 노드가 소스를 제공하는지가 이름이 의존하는 요소 중 하나이므로 그곳에서는 이름이 제공되지 않습니다. 진단은 그곳에서 .context가 정의하는 유일한 키로 .context.instance_id를 나열합니다. 렌더링된 이름은 대신 provides: 항목이나 인라인 템플릿에서 읽으십시오. 두 키가 각각 무엇을 가리키고 어디에서 읽을 수 있는지는 ../templates/rendered-resource-names.md를 참조하십시오.

루트 자체가 정의되지 않았을 때 출력되는 메시지:

template references a root the render context does not define (template <template-name> references <dotted-path>, the render context defines <the roots that context defines>) (템플릿이 렌더 컨텍스트가 정의하지 않는 루트를 참조합니다)

그리고 루트는 맞지만 선언된 필러 아래의 키가 틀렸을 때:

template references a root the render context does not define (template <template-name> references <dotted-path>, <pillar> defines <the keys that pillar defines>) (템플릿이 렌더 컨텍스트가 정의하지 않는 루트를 참조합니다)

해결 방법: 참조를 진단이 나열하는 것 중 하나로 고치십시오. 대부분의 보고는 .values, .infra, .context의 오타이거나 .context 또는 .metadata 아래 키의 오타입니다. 폴백 래퍼를 제거해도 중단은 해소되지 않으며, 래퍼를 추가해도 중단이 억제된 적은 없습니다. 래퍼는 어느 참조가 잘못되었는지를 숨겼을 뿐입니다. 데이터가 실제로 다른 노드에 속한다면, 그 데이터는 별도의 루트를 통해서가 아니라 inject 파이프를 통해 이 템플릿에 도달합니다. 소비자에 uses[].inject 항목으로 연결하고 .context.inject에서 읽으십시오.

이 검사는 렌더러가 평가하는 모든 템플릿 표면을 대상으로 하며, 각 표면은 자신이 정의하는 참조 집합에 대해 검사됩니다. Recipe 및 FeatureRecipe의 valuesMapping, injectMapping, workload, artifacts: 본문, provides: 및 locals: 항목, source:, pipeline 단계의 when: 및 with: 본문, assertions:, Aggregate의 컴포넌트 수준 self-inject value: 템플릿, 그리고 Release 경계 경로 템플릿(directory: / subDirectory:)입니다. 이 중 두 표면은 일부 거부를 자체 진단으로 지목합니다. 그 실수가 “이 참조는 존재하지 않는다”보다 더 구체적이기 때문입니다. 주어지지 않은 변수를 참조하는 경로 템플릿은 아래 “Path-template references a variable outside the allowlist (경로 템플릿이 허용 목록 밖의 변수를 참조함)”에서 다루고, 컴포넌트별 필러를 참조하는 경계 범위 FeatureRecipe는 “FeatureRecipe template references a field outside its scope’s allowlist (FeatureRecipe 템플릿이 범위의 허용 목록 밖의 필드를 참조함)”에서 다룹니다. 이 두 표면이 거부하는 그 밖의 모든 것(허용하는 필러 아래의 잘못 입력한 키 포함)은 이 중단을 보고하므로, 어떤 진단도 참조를 실제와 다른 것으로 알려 주지 않습니다.

artifacts: 템플릿이 Recipe가 선언하지 않은 필러를 읽음

artifacts: 항목의 템플릿이 workload:를 선언하지 않은 Recipe에서 .workload 또는 그 아래의 키를 읽거나, source:를 선언하지 않은 Recipe에서 .source 또는 그 아래의 키를 읽습니다. 두 필러는 artifacts 렌더 컨텍스트에 항상 존재하며 해당 표면이 정의하는 루트이므로, 참조 자체는 올바른 형식이고 이 중단은 참조가 잘못된 것이 아니라 선언이 없다는 것에 관한 것입니다. 합성된 워크로드에서 Deployment를 렌더링하는 Recipe와 소스에서 차트를 렌더링하는 Recipe는 서로 다른 형태이며, 그중 하나를 위해 작성된 artifacts: 본문은 다른 쪽이 결코 채우지 않는 필러를 찾게 됩니다.

이 검사는 항목이 평가되기 전에 실행되며, 이 순서 덕분에 보고가 유용해집니다. 없는 필러는 빈 값으로 템플릿에 전달되므로, 평가에 맡기면 빌드는 출력 파일에 아무것도 삽입하지 않거나, 아무것도 없는 값에서 키를 읽는 것에 대해 템플릿 엔진이 내놓는 오류로 실패합니다. 어느 쪽도 필러나 누락된 선언을 알려 주지 않습니다. 먼저 거부하면 이 중단은 필러를 찾은 정확한 표현식을 작성한 그대로 인용하여 알려 줄 수 있습니다.

선언되었지만 빈 문자열로 렌더링되는 source:는 소스가 전혀 없는 것으로 읽힙니다. 검사가 읽는 것은 소스 자체의 템플릿이 평가된 후의 소스이기 때문입니다. 이는 provider가 이어서 렌더링에 사용하는 값과 같으므로, source:가 아무것도 아닌 값으로 해석된 Recipe는 artifacts: 본문에 제공할 소스도 없습니다.

출력되는 메시지는 artifacts: 항목이 어디에 작성되었든 한 가지 형태입니다. 달라지는 것은 문장이 아니라 그 뒤의 캡션이며, 캡션은 어느 문서가 해당 항목을 담고 있는지 알려 줍니다.

템플릿 안의 위반 참조는 모두 보고되므로, 없는 필러 두 개를 찾는 본문은 먼저 나온 것만이 아니라 두 가지 모두를 알려 줍니다. 각 참조는 해당 항목을 선언한 문서에서, 작성한 그대로 인용되고 그 참조가 속한 출력을 캡션으로 달아 보고됩니다:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>) (artifact 템플릿이 Recipe가 선언하지 않은 필러를 참조함)

표현식은 첫 번째 세그먼트에서 필러를 나타내며, 이것으로 어떤 선언이 누락되었는지 알 수 있습니다. .source.chart는 source:를, .workload.containers는 workload:를 찾습니다.

컴포넌트 자체의 Recipe가 선언한 항목은 해당 Recipe의 artifacts: 블록에 대해 보고됩니다.

FeatureRecipe가 선언한 항목은 컴포넌트에 기능으로 연결되었든 경계에서 선언되었든, 호스트 컴포넌트의 필러가 아니라 그 FeatureRecipe가 선언한 필러를 기준으로 검사되고, FeatureRecipe의 artifacts: 블록에 대해 보고되며, 이를 바인딩하는 연결을 나타내는 캡션이 하나 더 붙습니다:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>) (artifact 템플릿이 Recipe가 선언하지 않은 필러를 참조함)

연결 캡션은 위치만으로는 알 수 없는 것을 알려 줍니다. 컴포넌트에는 여러 연결이 있을 수 있고, 경계에서 선언된 연결은 해당 경계에 속한 모든 컴포넌트에 적용됩니다. 문장 자체는 어느 경로에서든 Recipe를 언급하며, 어느 문서를 열어야 하는지는 위치와 연결 캡션을 함께 보아야 알 수 있습니다.

하나의 템플릿이 여러 참조를 포함하는 경우, 각 참조는 공유하는 항목을 나타내는 줄 아래에 각각 별도로 보고되며, 그 줄도 문서를 나타냅니다:

artifact <output-name> references pillars its Recipe does not declare (artifact가 해당 Recipe가 선언하지 않은 필러를 참조함)

artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare (artifact가 연결이 바인딩하는 FeatureRecipe가 선언하지 않은 필러를 참조함)

이 보고들은 어느 문서에 관한 것이든 모두 같은 중단 조건을 가지므로, 텍스트가 아니라 조건으로 매칭하는 도구에는 이들 사이에 차이가 없습니다.

해결 방법: 템플릿이 읽는 필러를 선언하거나, 읽지 않도록 합니다. artifacts: 본문이 해당 Recipe 형태에 맞는 경우에는 선언하는 것이 해결책입니다. 템플릿의 컨테이너, 포트 또는 볼륨 참조가 기대하는 workload:나, 템플릿이 보간하는 차트 또는 모듈 경로를 가진 source:를 추가합니다. 본문이 다른 Recipe를 기준으로 작성되어 여기에 적용되지 않는 조각을 재사용하는 경우에는 참조를 제거하는 것이 해결책입니다. 값이 실제로 다른 곳에서 오는 경우에는 이 Recipe가 채우지 않는 필러를 찾는 대신, 생성하는 노드의 provides:를 통해 게시하고 inject 파이프에서 읽습니다. 참조를 폴백 래퍼로 감싸도 중단은 해소되지 않으며(없는 것은 그 아래의 키가 아니라 필러입니다), 같은 Recipe의 다른 항목으로 참조를 옮겨도 해소되지 않습니다. 하나의 artifacts: 블록에 있는 모든 항목은 같은 필러를 기준으로 평가되기 때문입니다.

이 중단은 위의 “Template references a root the render context does not define (템플릿이 렌더 컨텍스트가 정의하지 않은 루트를 참조함)”과 구별되며, 해결 방법이 다르므로 둘을 구분할 필요가 있습니다. 그쪽은 표면이 전혀 정의하지 않는 루트나, 형태가 고정된 필러 아래의 잘못 입력된 키에서 발생합니다. 예를 들어 워크로드를 실제로 선언한 Recipe의 {{ .workload.containres }}입니다. 이쪽은 철자가 올바르지만 단순히 존재하지 않는 필러에 대한 참조에서 발생합니다.

템플릿이 노드의 provider가 보고하지 않는 렌더링된 이름을 읽음

템플릿이 {{ .context.rendered_name }}, 즉 바인딩된 provider가 작성자가 제공한 소스 또는 자신이 합성한 workload로부터 노드에 대해 렌더링하는 출력에 부여하는 이름을 읽는데, 해당 노드의 provider가 그러한 이름을 보고하지 않습니다. 참조는 올바른 형식이고 키도 렌더 컨텍스트가 정의하는 키입니다. 없는 것은 이 노드에 대한 값입니다.

이렇게 거부하는 이유는 다른 선택지가 중단보다 나쁘기 때문입니다. 이름은 템플릿에 일반 문자열로 전달되므로, 이름이 없는 노드는 참조를 빈 값으로 렌더링하여 세그먼트 하나가 빠진 주소(호스트 이름이 와야 할 자리에 .svc.cluster.local)를 종료 코드 0으로 출력하며, 빌드에는 읽을 만한 것이 아무것도 남지 않습니다. 그 아티팩트는 배포되지만 그것이 가리키는 대상은 존재하지 않습니다. 아무것도 평가하기 전에 거부하면 작성자가 쓴 템플릿에 대해 오류를 보고할 수 있습니다.

노드의 provider가 그러한 이름을 보고하는지는 모든 평가에 앞서 Recipe 바인딩으로 결정되므로, 여기에는 추측이 개입하지 않습니다.

보고는 두 가지이며, 어느 쪽이 나오는지는 참조를 작성한 위치가 아니라 노드에 따라 달라집니다. 자체 소스를 제공하지 않고 이름을 보고하지 않는 provider 아래에 있는 노드는 리소스가 노드의 ID를 따라 이름이 지어지므로 올바른 값이 있으며, 보고가 그 값을 알려 줍니다. 소스를 제공하고 이름을 도출하지 않는 provider 아래에 있는 노드는 대체할 값이 없습니다. 이 경우 ID를 제시하면 그 노드의 어떤 리소스도 가리키지 않는 값으로 안내하게 되므로, 보고는 대신 그 사실을 알려 줍니다.

노드가 자체 소스를 제공하지 않을 때 출력되는 메시지:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). read {{ .context.instance_id }} instead: this node supplies no source of its own, so its resources are named after the node’s identity (템플릿이 대상이 노드에 대해 렌더링하는 리소스에 부여하는 이름을 읽지만, 이 노드의 provider는 그러한 이름을 보고하지 않습니다. 규격에 맞는 템플릿은 노드 자신의 provider가 제공하는 값을 읽습니다. 대신 노드의 instance_id를 읽으십시오. 이 노드는 자체 소스를 제공하지 않으므로 그 리소스는 노드의 식별자를 따라 이름이 지정됩니다)

그리고 노드가 소스를 제공하고 provider가 그러한 이름을 도출하지 않을 때:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). write a value that does not depend on a name this target derives: it reports none for the output it renders from supplied source, so there is nothing of that kind to read here (템플릿이 대상이 노드에 대해 렌더링하는 리소스에 부여하는 이름을 읽지만, 이 노드의 provider는 그러한 이름을 보고하지 않습니다. 적합한 템플릿은 노드 자신의 provider가 제공하는 값을 읽습니다. 이 대상이 도출하는 이름에 의존하지 않는 값을 작성하십시오. 이 대상은 제공된 소스로부터 렌더링하는 출력에 대해 이름을 보고하지 않으므로 여기에서 읽을 그러한 값이 없습니다)

참조가 provides: 항목이 아닌 템플릿에 있을 때는 보고가 그 참조가 작성된 필드(field "valuesMapping", field "artifacts[probe.tf.json]")도 함께 알려 줍니다. artifacts: 항목의 키는 출력 파일 이름이며 위치가 자신의 세그먼트를 구분하는 데 쓰는 문자를 포함하므로, 위치는 항목을 담은 블록에서 멈추기 때문입니다.

검사 대상 템플릿: Recipe가 인라인으로 작성하는 모든 템플릿, 즉 provides: 항목, valuesMapping:, workload: 본문, 각 artifacts: 항목, 그리고 각 파이프라인 단계의 with:와 when:입니다. 한 가지 템플릿 영역은 제외됩니다. $import:를 통해 제공되는 valuesMapping:, workload: 또는 artifacts: 항목은 import가 로컬 파일을 가리키든 라이브러리 항목을 가리키든 렌더링이 이를 해석하기 전까지 Recipe에 텍스트가 없으므로, 그러한 본문 안의 참조는 중단되지 않고 빈 값으로 렌더링됩니다.

해결 방법: 보고가 알려 주는 키를 읽으십시오. 노드의 출력이 이름을 보고하지 않는 provider 아래에서 그 노드를 위해 만들어진 것(합성된 workload, 배치된 아티팩트 집합)이라면 {{ .context.instance_id }}가 그 리소스가 실제로 갖는 이름이며, 대체값이 아니라 올바른 값입니다. 노드가 자체 차트나 모듈을 제공하고 보고가 대체값을 제시하지 않는다면, 찾던 이름은 그 provider가 도출하는 이름이 아닙니다. 그 이름에 의존하지 않는 값을 게시하거나, 제공한 소스에서 리소스 이름을 지정하고 직접 설정한 값에서 그 이름을 다시 읽으십시오. ../templates/rendered-resource-names.md에서 어떤 provider가 이름을 보고하는지, 그리고 나머지 각 provider에 대해 보고할 이름이 없는 이유를 설명합니다.

템플릿이 선언 없이 호출자의 렌더 팩트를 읽음

컴포넌트에 연결된 FeatureRecipe의 템플릿이 .context.used_by 아래의 render_facts, 즉 attachment의 호스트에 연결하는 컴포넌트들이 자신의 렌더링에 대해 보고한 내용을 읽는데, FeatureRecipe가 readsCallerRenderFacts: true를 설정하지 않았습니다.

이 키는 attachment가 언제 렌더링되는지를 결정합니다. 키가 없으면 attachment는 연결된 컴포넌트 바로 다음에 렌더링되며, 빌드 순서상 나중에 오는 연결 컴포넌트는 그 시점에 아직 렌더링되지 않았으므로 그것이 출력한 내용을 읽을 수 없습니다. 아무것도 렌더링하기 전에 템플릿을 거부하면, 일부 호출자의 출력만 읽고 나머지는 읽지 못하는 빌드 대신 작성한 필드에 대해 누락된 선언을 보고할 수 있습니다.

출력되는 메시지:

template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>) (템플릿이 호출자의 렌더 팩트를 읽지만 FeatureRecipe가 readsCallerRenderFacts를 설정하지 않았습니다)

참조는 그것을 읽은 연결을 기준으로 상대적으로 인용됩니다(.render_facts 또는 .render_facts.<name>). 템플릿은 {{ range .context.used_by }} 안에서, 또는 선택한 한 연결에서 호출자를 한 번에 한 연결씩 읽기 때문입니다. 필드는 템플릿이 작성된 블록을 가리킵니다: valuesMapping, workload 또는 artifacts[<output-name>]. 파이프라인 단계의 with: 또는 when:이 같은 팩트를 읽는 경우는 FeatureRecipe의 설정과 관계없이 다음 항목에서 보고됩니다. 키를 설정해도 단계가 그 팩트를 읽을 수 있게 되지 않기 때문입니다. 여러 필드가 팩트를 읽으면 각 필드는 공통점을 나타내는 줄 아래에 별도의 보고를 받습니다:

attachment templates reading their callers’ render facts without declaring it (선언 없이 호출자의 렌더 팩트를 읽는 attachment 템플릿)

해결 방법: FeatureRecipe의 spec에 readsCallerRenderFacts: true를 설정하십시오. 그러면 attachment가 모든 컴포넌트가 렌더링된 후에 렌더링되며, 렌더링하는 내용은 그 밖에 아무것도 바뀌지 않습니다. FeatureRecipe 엔터티 페이지를 참조하십시오. 키가 계약이며, 이 중단은 키가 필요하다는 것이 드러나는 템플릿을 찾는 데 도움을 줄 뿐입니다. 검사는 작성된 그대로의 템플릿을 읽으므로, 템플릿 실행 중에 만들어지는 참조나 파일 또는 라이브러리에서 가져온 내용에 작성된 참조는 중단되지 않습니다. 그러한 FeatureRecipe에도 키를 설정하십시오. .context.used_by 옆의 다른 목록에서 render_facts라는 필드를 읽는 템플릿도 중단되며, 그 옆의 {{ with .context }} 안에서 호스트 자신의 팩트를 .render_facts로 읽는 템플릿도 마찬가지입니다. 호스트 자신의 팩트는 .context.render_facts로 전체를 써서 작성하십시오. 이는 호출자의 팩트로 간주되지 않습니다. 키를 설정하면 렌더링이 늦어지는 것 외에는 비용 없이 두 경우 모두 해결됩니다.

boundary에 대해 한 번 렌더링되는 FeatureRecipe(executionScope: boundary)는 여기에서 검사되지 않습니다. 그 리소스를 생성하는 템플릿에는 읽을 .context가 없으며, 이에 대한 참조는 대신 스코프의 허용 목록 밖에 있는 필드로 거부됩니다.

A pipeline step reads its callers’ render facts (파이프라인 단계가 호출자의 렌더 사실을 읽음)

컴포넌트에 연결된 FeatureRecipe에서 파이프라인 단계의 with: 또는 when:이 .context.used_by 아래의 render_facts, 즉 연결의 호스트에 접속하는 컴포넌트들이 자신의 렌더에 대해 보고한 내용을 읽습니다.

파이프라인 단계는 그러한 연결을 보지 못합니다. 단계는 호스트 컴포넌트 자신의 문서를 다시 쓸 수 있으며, 컴포넌트 자신의 출력은 누가 접속하든 동일하게 유지되므로, 단계의 템플릿은 .context.used_by 없이 평가됩니다. 이는 readsCallerRenderFacts: true를 설정했는지와 관계없이 모든 FeatureRecipe에 해당합니다. 이 키는 연결이 언제 렌더링되는지를 결정할 뿐, 단계가 무엇을 보는지는 결정하지 않습니다. 따라서 호출자의 사실을 읽는 단계는 아무것도 읽지 못하게 되며, 빌드는 그 읽기를 빈 값으로 렌더링하는 대신 아무것도 렌더링하기 전에 중단됩니다.

출력되는 메시지:

pipeline step reads its callers’ render facts, but a pipeline step does not read the components connecting to its host; it reads only the host’s own render facts (<reference>, written in <field>) (파이프라인 단계가 호출자의 렌더 사실을 읽지만, 파이프라인 단계는 호스트에 접속하는 컴포넌트를 읽지 않으며 호스트 자신의 렌더 사실만 읽습니다)

참조는 위 항목과 마찬가지로 그것을 읽어 낸 연결을 기준으로 .render_facts 또는 .render_facts.<name>으로 인용되며, 필드는 단계를 id로 지칭합니다: pipeline[<step>].with 또는 pipeline[<step>].when. 여러 단계가 사실을 읽는 경우, 각 단계는 공통점을 지칭하는 줄 아래에 각자의 보고를 받습니다:

pipeline steps reading their callers’ render facts (호출자의 렌더 사실을 읽는 파이프라인 단계)

해결 방법: 단계에서는 호스트 자신의 렌더 사실을 .context.render_facts로 전체를 적어 읽습니다. 이 사실은 호스트 자신의 렌더에서 오므로, 이를 읽어도 누가 접속하는지에 의존하는 것이 생기지 않습니다. 호출자의 사실은 대신 연결 자체의 리소스를 생성하는 템플릿, 즉 valuesMapping:, workload: 또는 artifacts:에서 FeatureRecipe 엔터티 페이지에 설명된 대로 readsCallerRenderFacts: true를 설정하여 읽습니다. 키를 설정하는 것만으로는 이 중단이 해소되지 않습니다. 검사는 작성된 그대로의 템플릿을 읽으며, 위 항목에서 설명한 한계가 있습니다: 템플릿 실행 중에 만들어지는 참조나, 파일 또는 라이브러리에서 가져온 내용에 작성된 참조는 중단되지 않으며, .context.used_by 옆의 다른 목록에서 render_facts라는 필드를 읽거나, 그 옆의 {{ with .context }} 안에서 호스트 자신의 사실을 .render_facts로 읽는 단계도 중단됩니다.

경계에 대해 한 번 렌더링되는 FeatureRecipe(executionScope: boundary)는 위 항목에서 설명한 이유로 여기서 검사되지 않습니다.

A template reads its targets’ render facts without declaring it (템플릿이 선언 없이 대상의 렌더 사실을 읽음)

컴포넌트에 연결된 FeatureRecipe의 템플릿이 .context.uses 아래의 render_facts, 즉 연결의 호스트가 연결된 컴포넌트들이 자신의 렌더에 대해 보고한 내용을 읽는데, FeatureRecipe가 readsTargetRenderFacts: true를 설정하지 않았습니다.

이 키는 두 가지를 결정합니다. 첫째, 모든 컴포넌트가 렌더링된 후에 연결이 렌더링되게 합니다. 이 키가 없으면 연결은 자신이 연결된 컴포넌트 바로 다음에 렌더링되며, 빌드 순서에서 더 뒤에 오는 대상은 그 시점에 아직 렌더링되지 않았습니다. 둘째, 연결이 읽는 연결 항목에 각 대상의 사실을 올려 놓는 것이 이 키입니다. 이 키가 없으면 .context.uses의 어떤 항목도 .render_facts를 전혀 갖지 않습니다. 아무것도 렌더링하기 전에 템플릿을 거부하면, 대상의 사실을 기대한 곳에서 아무것도 읽지 못하는 템플릿의 빌드 대신, 작성한 필드에 대해 누락된 선언을 보고할 수 있습니다.

출력되는 메시지:

template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts (<reference>, written in <field>) (템플릿이 호스트가 연결된 컴포넌트의 렌더 사실을 읽지만, FeatureRecipe가 readsTargetRenderFacts를 설정하지 않음)

참조는 템플릿이 작성한 그대로입니다: 한 연결의 별칭 아래에 전체를 적은 .context.uses.<alias>.render_facts 또는 .context.uses.<alias>.render_facts.<name>이거나, 템플릿이 연결을 하나씩 읽는 경우 {{ range .context.uses }}, {{ with .context.uses.<alias> }} 안에서 또는 선택한 한 연결에서, 그 연결을 기준으로 한 .render_facts 또는 .render_facts.<name>입니다. 필드는 템플릿이 작성된 블록을 지칭합니다: valuesMapping, workload 또는 artifacts[<output-name>]. 같은 사실을 읽는 파이프라인 단계의 with: 또는 when:은 FeatureRecipe가 무엇을 설정하든 대신 다음 항목으로 보고됩니다. 여러 필드가 사실을 읽는 경우, 각 필드는 공통점을 지칭하는 줄 아래에 각자의 보고를 받습니다:

attachment templates reading the render facts of the components their host is wired to, without declaring it (선언 없이 호스트가 연결된 컴포넌트의 렌더 사실을 읽는 연결 템플릿)

해결 방법: FeatureRecipe의 spec에 readsTargetRenderFacts: true를 설정합니다. readsCallerRenderFacts: true는 호스트가 연결된 컴포넌트가 아니라 호스트에 접속하는 컴포넌트에 사실을 올려 놓으므로 이 중단을 해소하지 않습니다. 이 키는 모든 컴포넌트가 렌더링된 후에 연결을 렌더링하고 각 대상의 사실을 해당 연결에 올려 놓으며, 렌더링되는 내용은 그 밖에 아무것도 바꾸지 않습니다. FeatureRecipe 엔터티 페이지를 참조하십시오. 계약은 키 자체이며, 이 중단은 키가 필요함이 눈에 보이는 템플릿을 찾도록 도울 뿐입니다. 검사는 작성된 그대로의 템플릿을 읽으므로, 템플릿 실행 중에 만들어지는 참조나 파일 또는 라이브러리에서 가져온 내용에 작성된 참조는 중단되지 않습니다. 그러한 FeatureRecipe에도 키는 똑같이 설정하십시오. .context.uses를 조금이라도 읽으면서 다른 값에서 render_facts라는 필드도 읽는 템플릿({{ range .context.used_by }} 안의 호출자 사실 포함)도 중단됩니다. 키를 설정하고, 템플릿이 호출자의 사실을 읽는 경우 readsCallerRenderFacts도 설정하십시오.

경계에 대해 한 번 렌더링되는 FeatureRecipe(executionScope: boundary)는 위의 호출자 항목에서 설명한 이유로 여기서 검사되지 않습니다.

A pipeline step reads its targets’ render facts (파이프라인 단계가 대상의 렌더 사실을 읽음)

컴포넌트에 연결된 FeatureRecipe에서 파이프라인 단계의 with: 또는 when:이 .context.uses 아래의 render_facts, 즉 연결의 호스트가 연결된 컴포넌트들이 자신의 렌더에 대해 보고한 내용을 읽습니다.

단계는 호스트 자신의 Recipe가 읽는 방식대로 호스트가 맺는 연결을 읽으며, 그 대상의 렌더 사실은 결코 읽지 않습니다. 이는 readsTargetRenderFacts: true를 설정했는지와 관계없이 모든 FeatureRecipe에 해당합니다. 단계는 호스트 컴포넌트 자신의 문서를 다시 쓸 수 있으며, 호스트 자신의 렌더는 대상이 게시한 것을 읽을 뿐 대상이 내보낸 것은 읽지 않으므로, 단계의 템플릿은 그러한 사실 없이 평가됩니다. 따라서 그것을 읽는 단계는 아무것도 읽지 못하게 되며, 빌드는 그 읽기를 빈 값으로 렌더링하는 대신 아무것도 렌더링하기 전에 중단됩니다.

출력되는 메시지:

pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host’s own render facts (<reference>, written in <field>) (파이프라인 단계가 호스트가 연결된 컴포넌트의 렌더 사실을 읽지만, 파이프라인 단계는 호스트 자신의 렌더 사실만 읽음)

참조는 위 항목과 같이 인용되며, 필드는 단계를 id로 지칭합니다: pipeline[<step>].with 또는 pipeline[<step>].when. 여러 단계가 사실을 읽는 경우, 각 단계는 공통점을 지칭하는 줄 아래에 각자의 보고를 받습니다:

pipeline steps reading the render facts of the components their host is wired to (호스트가 연결된 컴포넌트의 렌더 사실을 읽는 파이프라인 단계)

해결 방법: 단계에서는 호스트 자신의 렌더 사실을 .context.render_facts로 전체를 적어 읽습니다. 대상의 사실은 대신 연결 자체의 리소스를 생성하는 템플릿, 즉 valuesMapping:, workload: 또는 artifacts:에서 FeatureRecipe 엔터티 페이지에 설명된 대로 readsTargetRenderFacts: true를 설정하여 읽습니다. 키를 설정하는 것만으로는 이 중단이 해소되지 않습니다. 검사는 작성된 그대로의 템플릿을 읽으며, 위 항목에서 설명한 한계가 있습니다.

경계에 대해 한 번 렌더링되는 FeatureRecipe(executionScope: boundary)는 위의 호출자 항목에서 설명한 이유로 여기서 검사되지 않습니다.

Cross-node type safety violation via selector: (셀렉터를 통한 노드 간 타입 안전성 위반)

카탈로그 작성자가 연결하거나 부착할 수 있는 대상을 제한하려고 작성하는 두 가지 레이블 표현식은 하나의 중단으로 다룹니다. 둘 다 같은 방식으로 실패하기 때문입니다. 즉, 카탈로그 엔터티가 선언한 표현식을 레이블 집합이 충족하지 않는 경우입니다.

대상이 소켓의 selector:를 충족하지 못하는 uses: 엣지. usesSchema 소켓이 엣지의 반대쪽 끝에 부착된 대상 Component를 배제하는 selector: 필드를 선언합니다. 셀렉터는 카탈로그 작성자가 “이 소켓은 레이블이 이 표현식과 일치하는 대상만 받는다”고 말하는 방법이며, 소켓 이름 조회는 충족하지만 셀렉터 표현식은 충족하지 못하는 엣지는 타입 안전성 위반입니다.

출력되는 메시지:

selector violation ("", declared on socket "", not satisfied by the labels of ""). Add the labels the selector requires to the target’s component type, or wire the socket to a component that already carries them. (셀렉터 위반: 소켓에 선언된 셀렉터 표현식을 대상의 레이블이 충족하지 않습니다. 셀렉터가 요구하는 레이블을 대상의 component 유형에 추가하거나, 이미 그 레이블을 가진 component에 소켓을 연결하십시오.)

컴포넌트가 Feature의 appliesTo:를 충족하지 못하는 부착. Feature는 자신이 부착될 수 있는 컴포넌트를 appliesTo:와 appliesToAnyOf:에 선언합니다. 단일 표현식의 요구 사항은 모두 함께 충족되어야 하고, 대안들은 그중 하나만 충족되면 됩니다. 두 영역은 모두 충족되어야 하며, Feature가 생략한 영역은 무엇이든 충족합니다. Feature의 선언이 허용하지 않는 레이블을 가진 컴포넌트에 대한 부착은 위의 엣지 경우와 같은 종류의 위반입니다.

출력되는 메시지:

selector violation ("", declared by Feature "", not satisfied by the labels of ""). Add the labels the Feature’s appliesTo requires to this component’s type, or attach a Feature whose applicability the component already satisfies. (셀렉터 위반: Feature가 선언한 appliesTo 표현식을 component의 레이블이 충족하지 않습니다. Feature의 appliesTo가 요구하는 레이블을 이 component의 유형에 추가하거나, component가 이미 적용 조건을 충족하는 Feature를 연결하십시오.)

두 표현식 모두 레이블 문법이 전혀 읽을 수 없는 형태로 작성될 수도 있습니다. 이 경우 같은 중단으로 보고되지만, 마지막 값이 충족하지 못한 레이블 집합이 아니라 읽을 수 없었던 이유입니다. 이것으로 평가할 수 없었던 표현식과 평가되어 거짓이 된 표현식을 구별합니다.

selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity. (셀렉터 위반: Feature가 선언한 appliesTo 표현식을 평가할 수 없습니다. Feature의 카탈로그 엔터티에서 appliesTo 셀렉터를 수정하십시오.)

문법이 읽을 수 없는 소켓 셀렉터는 무언가가 소켓을 연결하기 전에도 거부됩니다. aggrega validate는 카탈로그 전체에 대해서든 하나의 Component 또는 Feature에 대해서든, 그 엔터티 자체 문서가 선언하는 모든 소켓 셀렉터를 읽고, 소켓을 통해 연결된 엣지가 있는지와 관계없이 문법이 읽을 수 없는 셀렉터를 이 같은 조건으로 거부합니다:

selector violation ("", declared on socket "", which could not be evaluated: ""). Correct the selector on the socket’s declaration in the component type’s usesSchema. (셀렉터 위반: 소켓에 선언된 셀렉터를 평가할 수 없습니다. 컴포넌트 타입의 usesSchema에서 소켓 선언의 셀렉터를 수정하십시오.)

Feature의 소켓에서는 해결 방법이 대신 그 Feature의 usesSchema를 지목합니다. 아직 아무것도 소켓을 연결하지 않았으므로 결함은 카탈로그 엔터티에 있습니다. 이는 CATALOG_ERROR로 분류되며 엔터티의 파일을 지목합니다.

이 중단은 대상이 되는 작성 키(uses: 소켓 항목 또는 부착을 지정하는 features: 항목)를 그것을 선언한 파일과 함께 담으므로, 보고되는 위치는 문서의 시작이 아니라 수정할 항목입니다. 서브시스템 안에서 작성된 Component는 그것이 작성된 서브시스템에 단계별로 위치가 지정됩니다. 부착은 그것을 작성한 문서에서 그것을 작성한 features: 항목에 위치가 지정되고, 그 문서의 작성자에게 귀속됩니다. Aggregate의 컴포넌트 자체 블록이나 서브시스템 블록이면 개발자 오류이고, Release만 만드는 부착이면 해당 컴포넌트에 대한 항목 또는 그 컴포넌트를 포함하는 경계의 features: 블록으로서 운영자 오류입니다. 두 문서가 모두 부착을 작성한 경우에는 type이 지정된 곳에 위치가 지정되며, Aggregate는 항상 이를 지정합니다. 연결에 작성된 부착은 그것을 작성한 문서에서 해당 연결의 features: 아래 키에 위치가 지정됩니다. 즉, Aggregate의 연결 항목이거나, Release만 만드는 부착이면 Release의 엣지별 항목입니다. Release만 부착한 Feature가 그 선언이 허용하지 않는 컴포넌트에 부착되면 다음과 같이 표시됩니다.

[OPS_ERROR E0007] release.yaml at .spec.boundaries.main.components.app.features.metrics
selector violation ("component.aggrega.ai/type in (server, worker)", declared by Feature "core/prometheus-exporter", not satisfied by the labels of "app"). Add the labels the Feature's appliesTo requires to this component's type, or attach a Feature whose applicability the component already satisfies.

그리고 같은 부착을 Aggregate의 컴포넌트에 작성하면 [DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.app.features.metrics로 표시됩니다. 어노테이션 기반 확장이 만든 부착은 어떤 features: 항목도 작성하지 않았으므로, 컴포넌트를 선언하는 문서에서 그 컴포넌트 자체의 features: 키에 개발자 오류로 위치가 지정됩니다.

엣지 위반 해결 방법: uses: 엣지를 레이블이 셀렉터를 충족하는 Component로 연결하거나, 카탈로그 엔터티의 셀렉터 표현식을 의도한 대상 부류를 받아들이도록 조정하십시오. aggrega inspect로 대상 Component의 metadata.labels를 검토하여 어떤 레이블을 가지고 있는지 확인하십시오.

부착 위반 해결 방법: 선언이 허용하는 레이블을 가진 컴포넌트에 Feature를 부착하거나, Feature의 appliesTo:를 넓히십시오. Feature가 실제로 둘 이상의 컴포넌트 부류를 지원하는 경우에는 appliesToAnyOf: 아래에 대안을 추가합니다. 컴포넌트가 조건을 충족해야 하는데 그렇지 않다면, 빠진 것은 대개 레이블입니다. aggrega inspect로 검토하고 표현식이 요구하는 레이블을 Component의 metadata.labels에 추가하십시오.

Unknown provider (알 수 없는 provider)

Recipe가 capability: <name>을 선언했는데 <name>이 컴파일러가 지원하는 어떤 provider도 가리키지 않습니다. 컴파일러는 알지 못하는 provider에 렌더링을 디스패치할 수 없습니다.

출력되는 메시지:

unknown provider: <provider-name> (알 수 없는 provider)

해결 방법: provider 이름의 철자가 올바른지 확인하십시오. cloudformation, compose, helm, helm-chart, terraform이 내장 provider 플러그인이 지원하는 이름입니다. 사용자 정의 엔터프라이즈 provider를 의도했다면, 그 이름을 지원하는 provider 렌더링 Plugin(spec.provider.capabilities에 그 이름이 있는 pluginType: provider)이 빌드가 가리키는 카탈로그 워크스페이스에 있는지 확인하십시오.

A capability is served by more than one provider plugin (하나의 capability를 둘 이상의 provider 플러그인이 지원함)

빌드가 도달한(또는 pull이 해석한) capability를 둘 이상의 provider 렌더링 Plugin(pluginType: provider이며 각각 spec.provider.capabilities에 그 capability를 나열)이 지원하는데, 워크스페이스가 어느 것이 렌더링할지 선택하지 않았습니다. 빌드는 provider를 임의로 고르는 대신 중단하고 두 후보를 모두 지정합니다. 같은 capability에 대해 두 플러그인을 가진 카탈로그는 유효합니다. 두 게시자가 각각 helm이나 compose용 플러그인을 배포할 수 있으며, 카탈로그는 둘 다 받아들입니다. 모호함은 사용 시점에만 드러납니다. 이 중단은 로드 시점이 아니라 빌드나 pull이 실제로 경합 중인 capability에 도달할 때 발생합니다.

출력되는 메시지. 빌드를 중단시킨 규칙이 먼저 나오고, 그 뒤에 세부 사항(어떤 capability인지, 어떤 후보인지, 작성할 바인딩)이 이어집니다.

capability is served by more than one provider plugin; add a plugins.providers entry to select one: capability "<capability-name>" is served by more than one provider plugin (<plugin-1>, <plugin-2>); add a plugins.providers entry for "<capability-name>" selecting one (capability를 둘 이상의 provider 플러그인이 제공합니다. 하나를 선택하는 plugins.providers 항목을 추가하십시오.)

해결 방법: 워크스페이스 구성에 capability를 키로 하고 그것을 렌더링할 플러그인 식별자를 값으로 선택하는 plugins.providers 항목을 추가하십시오. 두 플러그인은 연합 카탈로그에 그대로 두십시오. 바인딩은 이 워크스페이스가 경합 중인 capability를 어느 플러그인에 디스패치할지 알려 줍니다.

The plugin serving a provider cannot assemble what that provider combines (provider를 제공하는 플러그인이 해당 provider가 결합하는 출력을 조립할 수 없음)

provider는 디스패치 그룹의 노드별 출력이 어떻게 처리되는지를 명시합니다. 각 노드의 출력을 디스패치 경로에 그대로 쓰거나, 프래그먼트를 하나의 문서로 접거나, 각 노드를 하나의 감싸는 구조 안의 고유 위치에 배치합니다. provider가 출력이 결합된다고 명시하는 경우(병합된 compose 파일, umbrella 차트), 이를 제공하는 플러그인은 결합을 수행하는 export를 제공해야 합니다. 이 중단은 그렇지 않은 경우에 발생합니다. 플러그인이 노드별 렌더링(render_node)을 알리지만 대응하는 assemble_boundary가 없어서, 그룹의 노드는 렌더링할 수 있어도 그 출력을 병합할 수 없는 경우입니다.

이 불일치의 양쪽 모두 플러그인에 속합니다. 디스패치 그룹의 출력이 어떻게 처리되는지는 플러그인이 로드될 때 자신에 대해 보고하는 내용의 일부이며, 결합을 수행할 export는 Plugin 엔티티의 spec.exports 아래 항목 중 하나로서 같은 보고와 대조됩니다. 따라서 이 중단은 export 표면이 제공하지 않는 조립을 주장하는 플러그인을 지목합니다.

빌드는 조립을 건너뛰지 않고 중단합니다. 건너뛰면 하나의 아티팩트가 예상되던 경로에 각 노드의 프래그먼트를 쓰고 성공을 보고하게 되며, 이후 단계에서는 그 프래그먼트를 조립을 주장하지 않는 provider가 설계상 출력하는 평면적인 노드별 출력과 구별할 수 없습니다. 그러면 누락된 아티팩트가 빌드 시점이 아니라 출력이 적용되는 시점에 드러나게 됩니다.

디스패치 경로가 없는 디스패치 그룹은 건너뜁니다. 경로 없이 쓰이는 출력은 노드별 출력이므로, 결합에 관한 주장이 적용될 조립 대상이 없습니다.

출력되는 메시지 — 문제가 되는 디스패치 그룹마다 하나의 결과가 보고되며, provider와 해당 그룹이 조립되는 경로를 명시합니다:

provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>") (디스패치 그룹을 조립해야 하는 provider가 경계 조립기를 제공하지 않음)

문제가 되는 디스패치 그룹이 둘 이상이면, 결과들은 dispatch groups whose provider offers no boundary assembler 보고 아래에 함께 표시됩니다.

해결 방법: render_node와 assemble_boundary를 모두 알리는 플러그인으로 해당 capability를 제공합니다. spec.exports 작성 표면은 ../entities/plugin.md를, 조립 export가 받는 내용은 ../schema/plugins/wasm-provider.md를 참고합니다. 플러그인을 직접 작성하는 경우 두 쪽을 맞추는 것은 작성자의 몫입니다. 조립 export를 추가하거나, 조립을 주장하지 않도록 보고하여 각 노드의 출력이 병합되지 않은 채 디스패치 경로에 놓이게 합니다. 게시된 플러그인을 사용하는 경우 두 export를 모두 제공하는 버전을 선택하거나, 해당 capability에 대해 provider가 조립을 주장하지 않는 플러그인을 선택합니다.

A boundary-level Feature’s output reaches no assembled file (경계 수준 Feature의 출력이 어떤 조립된 파일에도 도달하지 않음)

경계의 features: 아래에 부착되고 FeatureRecipe가 executionScope: boundary를 선언한 Feature는 경계 전체에 대해 한 번 렌더링되며, 그 출력은 경계 자체의 directory:와 subDirectory:가 그것에 대해 평가되는 디렉터리로 갑니다. 출력을 하나의 문서로 합치는 provider(compose는 하나의 docker-compose.yaml로, cloudformation은 하나의 스택으로 합칩니다)는 이러한 Feature의 기여를 그곳에서 경계의 컴포넌트들로 조립하는 파일의 일부로만 씁니다. 그 파일은 적어도 하나의 컴포넌트 출력이 같은 provider 아래 같은 디렉터리에 놓이는 경우에만 존재합니다.

경계의 컴포넌트가 다른 곳에 놓이면 그 파일은 존재하지 않습니다. 컴포넌트가 subDirectory:로 다른 곳에 보내지는 중첩 경계에 있는 경우(예: 각 컴포넌트가 자기 파일을 갖도록 하는 "{{ .component_id }}"), 또는 Feature의 출력과 공유되지 않는 디렉터리 아래에 있는 경우입니다. Feature의 디렉터리에는 아무것도 조립되지 않으므로 그 출력은 어디에도 쓰이지 않으며(compose 브리지라면 어떤 파일에도 담기지 않는 게이트웨이 서비스가 됩니다), 그런데도 빌드는 성공을 보고하게 됩니다. 그래서 빌드가 대신 중단됩니다.

provider가 각 기여를 독자적인 파일로 쓰는 Feature(helm, helm-chart, terraform)는 영향을 받지 않습니다. 그 파일들은 옆에 무엇이 조립되든 상관없이 쓰입니다.

출력되는 메시지입니다. 위반하는 Feature마다 하나의 결과가 있으며, 경계의 features: 아래 그 항목 위치에 놓이고, 경계, Feature, 그 출력이 라우팅된 디스패치 경로, provider를 지정합니다.

boundary-level Feature’s output is routed to a dispatch path nothing assembles (boundary "<boundary>", feature "<instance>", dispatch path "<path>", provider "<provider>"). attach the Feature at a boundary whose output path also receives its components, or give the boundary’s components the directory the Feature’s output is routed to (경계 수준 Feature의 출력이 아무것도 조립되지 않는 디스패치 경로로 라우팅되었습니다. 출력 경로가 그 컴포넌트들도 받는 경계에 Feature를 부착하거나, Feature의 출력이 라우팅되는 디렉터리를 경계의 컴포넌트에 지정하십시오)

부모 경계 bridge에 부착된 compose 브리지에서, 그 유일한 자식 경계가 각 컴포넌트를 subDirectory: "{{ .component_id }}" 아래에 두면 다음과 같이 출력됩니다.

[OPS_ERROR E0365] release-compose.yaml at .spec.boundaries.bridge.features.gateway
boundary-level Feature's output is routed to a dispatch path nothing assembles (boundary "bridge", feature "gateway", dispatch path "bridge/compose", provider "compose"). attach the Feature at a boundary whose output path also receives its components, or give the boundary's components the directory the Feature's output is routed to

위반하는 Feature가 둘 이상이면, 결과들은 boundary-level Features whose output is routed to a dispatch path nothing assembles 보고서 아래에 함께 도착합니다.

해결 방법: Feature의 디렉터리를 그 경계의 컴포넌트도 놓이는 디렉터리로 만듭니다. 자체 출력 경로가 그 컴포넌트들을 받는 경계에 Feature를 부착하거나, Feature의 출력이 라우팅되는 디렉터리를 컴포넌트에 지정합니다. 자식 경계라면 자체 subDirectory: 없이 directory: "{{ .parent_boundary.directory }}"를 써서 부모의 파일을 공유하게 합니다. 메시지는 Feature의 출력이 라우팅된 디렉터리를 지정하며, 그것이 공유해야 할 디렉터리입니다.

Path-template references a variable outside the allowlist (경로 템플릿이 허용 목록 밖의 변수를 참조함)

directory: 또는 subDirectory: 템플릿이 경로 템플릿 변수 허용 목록에 없는 변수 이름을 참조합니다. 예를 들어 {{ .parmaeters.region }} 같은 오타이거나, Recipe 렌더링 컨텍스트에는 있지만 경로 템플릿에는 노출되지 않는 필드(.context.inject 또는 .values 등)입니다. directory: 템플릿의 {{ .component_id }}도 같은 중단에 해당합니다. 이 변수는 존재하고 subDirectory: 템플릿은 이를 읽을 수 있지만, 경계의 directory:는 Component마다가 아니라 경계 전체에 대해 한 번 평가되므로, 그곳에 Component별 변수를 쓰면 출력 경로가 어느 Component가 먼저 평가되었는지에 따라 달라지게 됩니다.

경로 템플릿은 렌더링 작업이 시작되기 전 파싱 시점에, 경로 템플릿 컨텍스트가 정의하는 변수에서 해당 표면이 거부하는 변수를 뺀 목록과 대조하여 검증됩니다. 또한 컴파일러는 경로 템플릿을 missingkey=error 의미 체계로 평가하므로, 허용 목록에는 있지만 평가 시점에 정의되지 않은 참조는 디렉터리 경로에 빈 문자열을 조용히 렌더링하는 대신 명시적인 오류를 발생시킵니다.

이 중단은 변수에 관한 것입니다. 허용된 변수 아래의 키를 잘못 입력한 경우({{ .manifest.recipe_nmae }})는 위의 “Template references a root the render context does not define (템플릿이 렌더 컨텍스트가 정의하지 않는 루트를 참조함)”으로 보고되며, .manifest가 정의하는 키를 나열합니다. 변수 자체는 허용되었고 키만 잘못되었기 때문입니다.

출력되는 메시지:

path template references a field not in the documented allowlist ("<dotted-path>", written in "<directory|subDirectory>", the render context defines "<the variables that field may read>") (경로 템플릿이 문서화된 허용 목록에 없는 필드를 참조함)

해결 방법: 필드 이름을 경로 템플릿 허용 목록에 있는 이름으로 고치거나 참조를 제거합니다. directory:의 허용 목록은 {{ .capability }}, {{ .boundary_name }}, {{ .parameters.X }}, {{ .manifest.recipe_name }}, {{ .parent_boundary.* }}이며, subDirectory:는 여기에 {{ .component_id }}를 추가합니다. 다른 표면(Recipe valuesMapping, FeatureRecipe injectMapping 등)은 다른 컨텍스트 형태를 사용합니다. .context.*, .values, .infra, .locals에 대한 참조는 의도적으로 경로 템플릿에 노출되지 않습니다. 경로 출력은 값 렌더링의 문제가 아니라 구조의 문제이기 때문입니다.

Path collision: two contributors emit at incompatible paths (경로 충돌: 두 기여자가 호환되지 않는 경로에 출력함)

경로 선언이 같은 조립 경로로 평가되는 두 경계가 서로 다른 provider를 거칩니다. 둘 다 그곳에서 조립되고 각자 상대가 모르는 파일을 쓰므로, 하나가 디스크에서 다른 하나를 조용히 대체합니다. 그리고 대체된 출력을 만든 빌드는 성공한 것처럼 보입니다.

기본 subDirectory:는 각 provider에 고유한 하위 경로를 부여하므로, 두 provider가 하나의 경로에 도달하는 것은 선언이 같은 값으로 평가되도록 작성된 경우뿐입니다. 예를 들어 두 경계가 directory:를 공유하면서 둘 다 subDirectory:를 같은 리터럴로 고정한 경우입니다.

출력되는 메시지. 기여하는 경계마다 하나의 결과가 보고되므로, 출력이 해당 경로에 도달한 모든 경계가 하나의 메시지 안의 목록으로 묶이지 않고 각각 명시됩니다. 오류는 두 provider가 하나의 경로에서 만나는 것이므로 결과는 항상 두 개 이상이며, 공통점을 밝히는 보고 아래에 함께 표시됩니다:

assembly paths reached by more than one provider (둘 이상의 provider가 도달한 조립 경로)

각 결과는 경로, 출력이 그 경로에 도달한 경계, 그리고 해당 경계가 거치는 provider를 명시합니다:

dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>") (디스패치 경로에서 여러 provider 출력이 생성됨)

api-net 경계와 db-net 경계가 모두 directory: ./dist/shared와 subDirectory: merged를 선언하고, 하나는 helm을, 다른 하나는 compose를 거치는 빌드는 다음을 출력합니다:

[OPS_ERROR E0048]
assembly paths reached by more than one provider
caused by (2):
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "db-net", provider "compose")
---
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "api-net", provider "helm")

보고에는 짧은 코드가 붙고 그 아래의 각 결과에는 범주만 붙습니다. 이는 수집된 실패를 보고하는 모든 보고가 사용하는 형태입니다. 이 문법은 error-translation.md를 참고합니다.

해결 방법: 각 경계에 서로 다른 directory:를 지정하거나(별도 경로로 조립되도록), subDirectory:를 기본값으로 두어 각 provider의 출력이 고유한 하위 경로에 놓이게 합니다. compose-bridge 패턴은 의도적으로 두 하위 경계를 하나의 조립 경로로 합칩니다. 이 패턴에서는 두 경계가 같은 provider를 대상으로 하고 호환되는 캐스케이드 해석 annotation을 지녀야 합니다.

A boundary’s output directory is not a directory beneath the output root (boundary의 출력 디렉터리가 출력 루트 아래의 디렉터리가 아님)

boundary의 directory:와 subDirectory:는 평가된 뒤 그 출력이 기록될 디렉터리로 결합되며, 그 경로는 한 번 정규화됩니다. out/a, out//a, ./out/a, out/a/는 하나의 디렉터리입니다. 정규화된 경로가 출력 루트 아래의 디렉터리가 아니면 빌드는 아무것도 기록하기 전에 중단됩니다. 이는 출력 루트 밖으로 올라가는 경로(.., ../escape, a/../..), 절대 경로(/srv/out), 또는 디렉터리를 전혀 가리키지 않는 경로입니다. 빈 값이나, 하위 디렉터리를 비활성화한 directory: "."처럼 출력 루트 자체로 정규화되는 값이 이에 해당합니다.

경로는 평가된 그대로 검사되므로, 작성된 텍스트가 아니라 템플릿의 결과가 판정됩니다. 메시지는 오류의 원인이 된 필드를 지목합니다. 디렉터리만으로 이미 출력 루트를 벗어나거나 하위 디렉터리가 결합되지 않는 경우에는 directory:, 그 외에는 subDirectory:이며, 해당 필드가 평가된 값과 그로 인해 생성된 경로를 함께 표시합니다.

출력되는 메시지:

boundary output directory does not name a directory beneath the output root (Release "<release>", boundary "<boundary>", directory: "<value>", output path "<path>"). write a directory beneath the output root, such as “deploy/prod” — no leading ”/”, no ”..” climbing above it, and not the output root itself (boundary 출력 디렉터리가 출력 루트 아래의 디렉터리를 가리키지 않음. “deploy/prod”처럼 출력 루트 아래의 디렉터리를 작성하십시오. 앞에 “/”를 붙이지 말고, 위로 올라가는 “..”를 쓰지 말며, 출력 루트 자체도 쓰지 마십시오)

하위 디렉터리에 오류가 있는 경우에는 세 번째 값이 대신 subDirectory: "<value>"로 표시됩니다.

해결 방법: 메시지가 지목한 필드를 출력 루트 아래의 디렉터리로 작성합니다. 출력 루트 옆에 두려던 디렉터리는 대신 그 안에 두어야 합니다. boundary의 출력을 directory:에 바로 기록하려면 subDirectory: "."를 설정합니다. 이때도 디렉터리 자체는 고유한 디렉터리를 가리켜야 합니다.

boundary 수준 Feature의 이름이 . 또는 ..입니다

각 기여자에게 고유한 디렉터리를 부여하는 provider(modules/ 아래의 terraform, charts/ 아래의 helm-chart)는 boundary에 연결된 Feature를 boundary의 component들 옆에, 인스턴스 이름만으로 된 디렉터리에 배치합니다. boundary의 features: 키는 .과 ..를 허용하지만, 둘 다 디렉터리 이름이 아닙니다. .은 Feature의 파일을 모든 기여자를 담는 디렉터리에, ..은 그 위 디렉터리에 두게 되므로, 파일이 provider가 Feature에 부여한 위치 밖에 놓이게 됩니다. 그래서 빌드는 대신 중단됩니다. 그 밖의 이름은 audit.v2처럼 점이 포함된 이름을 포함해 영향을 받지 않습니다.

출력되는 메시지:

boundary-level Feature instance name is not a directory name (Release "<release>", boundary "<boundary>", feature "<instance>"). rename the Feature instance under the boundary’s features to an ordinary name, such as “audit” (boundary 수준 Feature 인스턴스 이름이 디렉터리 이름이 아님. boundary의 features 아래 Feature 인스턴스 이름을 “audit”처럼 일반적인 이름으로 바꾸십시오)

해결 방법: boundary의 features: 아래 인스턴스 이름을 일반적인 이름으로 바꿉니다.

Instance-ID collision across boundaries assembling to the same path (같은 경로로 조립되는 boundary 간 인스턴스 ID 충돌)

같은 (경로, provider) 튜플로 조립되는 두 boundary가 동일한 인스턴스 ID를 가진 component를 기여합니다. 병합된 조립 결과는 두 component 조각을 구별할 수 없습니다. 하나의 Helm 차트는 web-server라는 이름의 Deployment 두 개를 가질 수 없고, 하나의 docker-compose 파일은 api라는 이름의 서비스 두 개를 가질 수 없습니다.

출력되는 메시지:

multiple contributors share an instance ID at the same dispatch path: dispatch path "<path>" provider "<provider>" already contains node "<instance-id>" (contributing boundaries: [<boundaries>]); component instance IDs must be unique within an assembly group (같은 디스패치 경로에서 여러 기여자가 인스턴스 ID를 공유함. component 인스턴스 ID는 조립 그룹 안에서 고유해야 함)

해결 방법: Aggregate에서 충돌하는 component 중 하나의 이름을 바꾸거나, 두 boundary를 별도의 directory: 경로로 분리하여 각 component 인스턴스가 고유한 조립 결과에 놓이도록 합니다.

Two contributors write the same output path (두 기여자가 같은 출력 경로에 기록함)

하나의 어셈블리에 기여하는 두 기여자가 같은 출력 경로에 파일을 생성합니다. 이는 위의 인스턴스 ID 충돌과 다릅니다. 컴포넌트의 이름은 서로 다르고 어셈블리는 이들을 구별할 수 있지만, 이들이 내보내는 파일이 하나의 경로에 놓입니다. 이 충돌은 provider가 각 기여자의 출력을 컴포넌트별 위치 아래가 아니라 나란히 쓰는 경우에 가장 자주 발생하며, 이때 Recipes가 같은 파일 이름을 내보내는 두 컴포넌트(예: 둘 다 main.tf라는 이름의 두 artifacts: 항목)가 하나의 경로에서 만납니다. 어셈블러 자체의 출력도 같은 방식으로 기여자의 파일과 충돌할 수 있습니다.

같은 파일 이름을 생성하는 두 기여자가 충돌하는지는 provider가 그들을 어디에 배치하는지에 달려 있습니다. 각 기여자를 조립 내 고유한 위치 아래에 중첩하는 provider는 이름이 같은 두 파일을 분리하지만, 기여자를 나란히 기록하는 provider는 그렇지 않습니다. 비교는 기여자가 생성한 이름이 아니라 파일이 기록될 최종 경로를 기준으로 하므로, 중첩된 경우는 보고되지 않습니다.

빌드는 두 파일 중 하나를 기록하고 다른 하나를 버리는 대신 중단됩니다. 조용히 해결할 올바른 방법은 없습니다. 한 파일의 이름을 바꾸거나 접미사를 붙이면 아무도 작성하지 않은 이름을 만들어 내게 되고, 내용을 병합하면 아무도 작성하지 않은 문서를 만들어 내게 됩니다. 충돌하는 모든 경로가 보고되고 그 경로에 기록하는 모든 기여자가 표시되므로, 한 번의 빌드로 충돌을 하나씩이 아니라 전체 상황을 파악할 수 있습니다.

출력되는 메시지. 충돌하는 경로마다 결과가 하나씩 보고됩니다. 해당 조립에 몇 개의 boundary가 참여했든 한 번만 보고되므로, 기여자들이 두 경로에서 만난 빌드는 두 경로를 모두 알려 주며 어느 충돌도 두 번 보고되지 않습니다.

assembled output collision: two contributors write the same output path (output path "<output-path>", written by "<contributor-1> and <contributor-2>", assembled within "<boundary-1> and <boundary-2>") (조립된 출력 충돌: 두 기여자가 같은 출력 경로에 기록함)

각 기여자는 그 정체에 따라 표시되며, 이것이 그 이름이 어디에 작성되는지를 알려 줍니다. component 인스턴스는 component <name>, boundary에 연결된 feature는 feature <name>, 조립 자체의 병합된 출력은 the <provider> assembly로 표시됩니다. 기여자는 이름 순으로 나열되므로, 같은 입력의 모든 빌드에서 문장이 동일합니다.

Recipe가 boundary의 공유 출력에 기여하는 파일도 이 규칙의 대상입니다. Recipe의 boundary: 블록은 provider 자체의 조립된 출력 옆에 파일 이름당 한 번씩 파일을 기록합니다. 하나의 이름을 동일한 바이트로 선언하는 여러 component는 하나의 파일이며 충돌하지 않습니다. 서로 다른 바이트로 선언하면 여기서 충돌하며, 파일과 그것을 선언한 모든 component가 표시됩니다. provider의 조립 자체가 기록하는 이름도 마찬가지입니다. 예를 들어 terraform의 aggrega.modules.tf는 기여자 중 the terraform assembly를 표시합니다. 여러 component가 동일하게 선언한 파일이 조립 자체의 파일과 만나면 component <name-1> and component <name-2>처럼 그 모든 component가 함께 표시됩니다.

조립에 입력된 boundary도 표시되며, 하나를 지목하지 않고 나열됩니다. directory: 선언이 같게 평가되는 boundary들은 하나로 조립되며, 충돌 자체로는 만난 기여자들이 그중 어느 boundary에서 선언되었는지 알 수 없습니다. 따라서 결과는 선언을 통해 그들을 분리할 수 있는 모든 boundary를 제시하며, 그중 어느 것도 원인이라고 단정하지 않습니다. 같은 이유로 결과는 Release 문서 전체를 대상으로 보고됩니다. 그 안의 boundary 하나를 지목하면 해당 경로에 아무것도 기여하지 않았을 수도 있는 문서로 안내하게 되기 때문입니다.

둘 이상의 경로가 충돌하면, 결과는 공통점을 설명하는 보고서 아래에 함께 표시됩니다.

assembled output paths written by more than one contributor (둘 이상의 기여자가 기록한 조립 출력 경로)

해결 방법: 직접 관리하는 Recipe에서 내보내는 파일의 이름을 바꿔 두 파일이 더 이상 만나지 않도록 합니다. 대상은 artifacts: 키, boundary: 블록의 키, 또는 Workload 변환이 도출하는 파일 이름입니다. 두 Recipes가 하나의 공유 파일을 선언하고 같은 구성을 의도한다면 두 선언을 바이트 단위로 동일하게 만듭니다. 두 기여자가 실제로 별개의 출력에 속한다면 각 boundary에 서로 다른 directory: 경로를 지정하여 각각 따로 어셈블되도록 합니다.

The same name is derived more than once inside the output (출력 안에서 같은 이름이 두 번 이상 도출됨)

하나의 어셈블리가 내보내는 파일 내부의 어떤 것에 대해, 하나만 있을 수 있는 자리에서 같은 이름이 두 번 사용되는 경우입니다. 이는 두 가지 방식으로 발생합니다. 두 기여자가 같은 이름을 도출하거나, 하나의 기여자 자체의 출력이 그 이름을 두 번 담는 경우입니다. 이는 위의 두 충돌과는 다릅니다. 두 기여자가 관련된 경우 컴포넌트의 이름은 서로 다르고 그 파일은 서로 다른 경로에 놓이므로 어셈블리의 형태에는 아무 문제가 없습니다. 문제는 내용 안의 이름입니다. 예를 들어 대상이 하나의 리소스를 가리키는 데 사용하는 식별자나, 하나의 출력이 다른 쪽에서 참조할 수 있도록 게시되는 이름 같은 것입니다.

어떤 이름을 비교하는지는 provider가 어셈블리의 출력을 어떻게 처리하는지에 따라 정해집니다. provider가 그 출력을 하나의 문서(하나의 스택 템플릿, 하나의 compose 파일)로 병합하는 경우, 그 하나의 문서 안의 이름끼리 비교되며, 자신의 출력이 별도의 파일로 작성되는 기여자는 그 문서 밖에 있습니다. 그 기여자의 이름은 다른 누구의 이름과도 만나지 않으므로 그 사이에서는 아무것도 중단되지 않으며, 무엇을 이름 변경하더라도 이는 달라지지 않습니다. 반대로 provider가 각 기여자의 출력을 각자의 파일로 작성하는 경우(차트 렌더, 매니페스트 집합), 어셈블리의 모든 기여자가 다른 모든 기여자와 비교됩니다. 그러한 출력에서 이름은 개별 파일 안이 아니라 그 파일들을 하나의 집합으로 읽는 대상 전체에서 고유해야 하기 때문입니다.

FeatureRecipe 자체의 리소스는 호스트 컴포넌트의 리소스와 같은 경로를 따릅니다. 첨부는 호스트가 속한 어셈블리에 기여하기 때문입니다. 따라서 provider가 병합하는 경우, 첨부의 이름은 두 컴포넌트의 이름이 비교되는 것과 똑같이 호스트 컴포넌트의 이름 및 다른 모든 첨부의 이름과 비교됩니다. 모두가 하나의 문서 안에 들어가며, 같은 두 이름 중 하나가 그 안에서 다른 하나를 대체하기 때문입니다. provider가 병합하지 않는 경우, 첨부의 리소스는 첨부 대상 컴포넌트의 이름을 딴 디렉터리 아래에 작성되며, 그 이름은 여전히 어셈블리의 모든 기여자와 비교됩니다. 클러스터 전체에서 고유해야 하는 리소스 식별자가 걸러지는 곳이 바로 여기입니다. 따라서 비교는 두 경우 모두 같으며, 다른 점은 대체될 이름이 결국 어디에 놓이는지뿐입니다.

이 중단의 절반은 이 모든 것의 영향을 받지 않습니다. 바로 하나의 기여자 자체의 출력이 이름을 두 번 담는 경우입니다. 이는 하나의 기여자가 작성한 출력 안에서 이름이 두 번 사용된 것이므로, 그 출력이 어디에 작성되든 중단되며, 분리해야 할 두 대상은 항상 그 안에 있습니다.

이러한 이름 대부분은 provider 자체의 이름으로, 컴포넌트 인스턴스와 리소스로부터 도출됩니다. 따라서 도출의 근거가 되는 부분이 일치하면 두 컴포넌트가 하나의 이름에 도달할 수 있으며, 같은 방식으로 한 컴포넌트의 두 리소스가 일치하는 부분으로 만들어지면 하나의 컴포넌트가 같은 이름에 두 번 도달할 수도 있습니다. 이름은 파일 자체의 바이트 안에 있으므로 어셈블리는 이를 볼 수 없습니다. provider가 도출한 이름을 보고하고, 빌드가 이를 비교합니다.

한 종류의 이름은 provider가 아니라 빌드 자체의 것이며, 같은 방식으로 보고됩니다. FeatureRecipe가 내보내는 모든 리소스에 붙는 식별자로, 출력에는 aggrega.ai/component-id 레이블로 나타납니다. 이는 component-id라는 이름 종류로 보고되므로, 내보낸 출력에서 같은 문자열을 찾을 수 있습니다. FeatureRecipe가 리소스를 합성하는 경우 그 식별자는 리소스의 이름이 되기도 합니다. 작성자가 제공한 차트나 프래그먼트를 렌더링하는 경우에는 그 렌더 안의 이름은 호스트 컴포넌트의 이름으로 유지되고 레이블만 식별자를 담습니다.

컴포넌트에 첨부된 feature의 경우, 이 식별자는 고정된 접두부 뒤에 feature가 첨부된 컴포넌트와 features: 아래에 작성한 키로 구성됩니다. 호스트 컴포넌트가 값에 포함되는 이유는, 여러 컴포넌트에 첨부된 하나의 feature 이름이 각 컴포넌트에서 별도의 리소스 집합을 내보내며, 각 집합에는 고유한 식별자가 필요하기 때문입니다.

바운더리에 첨부된 feature의 경우, 이 식별자는 별도의 접두부 뒤에 feature의 이름과 바운더리 경로의 각 세그먼트로 구성됩니다. 두 경우 모두 치환이 아니라 구성 방식을 사용합니다. 레이블 문자 집합이 허용하지 않는 문자는 치환되지 않고 풀어서 기록되며, 각 부분은 어떤 기록된 부분에도 포함될 수 없는 문자열로 연결되므로, 구별할 수 있는 두 첨부는 항상 두 개의 식별자에 도달합니다. 유일하게 남는 문제는 길이입니다. 레이블 값으로는 너무 긴 구성된 식별자는 전체의 다이제스트를 중심으로 축약되며, 축약된 두 식별자는 원칙적으로 만날 수 있습니다. 이 중단은 이름이 비교되는 두 기여자 사이에서 그러한 만남을 보고하며, 하나의 컴포넌트에 있는 두 첨부는 호스트의 provider가 이들을 함께 어셈블하는 경우 언제나 그러한 두 기여자입니다. 각 식별자가 어떻게 구성되는지는 ../providers/well-known-annotations.md를 참조하십시오.

Kubernetes 렌더는 고유한 이름 종류를 보고합니다. 렌더링이 생성하는 각 리소스가 metadata.name에 담는 이름입니다. 이러한 이름은 출력 전체가 아니라 해당 kind 안에서, 그리고 클러스터가 네임스페이스에 보관하는 kind라면 해당 네임스페이스 안에서 고유해야 하므로, 이름 종류는 그 범위가 무엇인지를 나타냅니다. 이름 종류는 resource-names로 시작하고, 이어서 리소스의 kind와 리소스가 놓이는 네임스페이스를 담습니다. 네임스페이스는 리소스가 스스로 지정한 것이며, 지정하지 않은 경우 바운더리에 주석으로 지정된 것입니다. 따라서 resource-names:Service--default는 default에 놓이는 Service들의 이름입니다. Kubernetes API가 모든 네임스페이스 밖에 보관하는 kind(ClusterRole, StorageClass, CustomResourceDefinition)와, 같은 렌더 안의 CustomResourceDefinition이 범위 Cluster로 선언하는 사용자 정의 kind는 문서에 어떤 네임스페이스가 적혀 있든 kind만 담습니다. resource-names:ClusterRole은 출력이 담는 모든 ClusterRole의 이름입니다. 영문자와 숫자 이외의 문자는 치환되지 않고 풀어서 기록되며, 두 부분은 어떤 기록된 부분에도 포함될 수 없는 문자열로 연결되므로, 서로 다른 두 쌍이 하나의 이름 종류에 도달하는 일은 없으며, kind 단독이 kind와 네임스페이스로 이루어진 이름 종류에 도달하는 일도 없습니다. Service와 Deployment는 이름을 공유할 수 있으며, 두 네임스페이스는 네임스페이스 범위 kind의 같은 이름을 각각 독립적으로 가질 수 있으므로, 둘 다 중단되지 않습니다. 이름 자체는 차트가 작성한 그대로 보고되므로, 템플릿에서 검색할 문자열이 됩니다.

따라서 하나의 출력에 기여하는 두 기여자가 각각 클러스터 전역 객체 하나를 같은 이름으로 작성하면, Release가 이들을 두 네임스페이스에 배치하더라도 중단됩니다. 둘 다 적용하면 그 하나의 객체를 두 번 작성하게 되기 때문입니다. 또한 하나의 차트가 그러한 객체를 서로 다른 두 네임스페이스 아래에 작성하면, 렌더는 이를 두 파일로 내보내며, 이는 하나의 기여자가 이름을 두 번 담는 것으로 중단됩니다. 렌더 안의 어떤 것도 분류하지 않는 kind(렌더가 그 CustomResourceDefinition을 내보내지 않는 사용자 정의 kind, 또는 apiVersion을 지정하지 않은 문서)는 네임스페이스 범위 kind처럼 네임스페이스 안에서 비교됩니다. 렌더 안의 어떤 것도 클러스터가 이를 네임스페이스 밖에 보관한다고 말하지 않기 때문입니다. 따라서 두 기여자가 그러한 객체 하나를 두 네임스페이스에 작성하면 서로 만나지 않습니다.

이름은 하나의 출력에 대한 기여자 사이에서 비교되며, 두 출력 사이에서는 결코 비교되지 않습니다. 두 바운더리는 각각 고유한 디렉터리(직접 지정한 디렉터리, 또는 directory:를 지정하지 않은 각 바운더리에 주어지는 디렉터리)를 가질 때 두 출력이 되며, 빌드의 어떤 것도 두 출력이 하나의 클러스터에 적용되는지 두 클러스터에 적용되는지 알려 주지 않습니다. 하나의 오퍼레이터의 CustomResourceDefinition을 두 클러스터 각각에 배포하면 두 출력에 같은 이름이 있게 되며, 이는 올바릅니다. 따라서 각각 클러스터 전역 객체 하나를 같은 이름으로 작성하는 두 바운더리는 둘 다 하나의 클러스터에 적용되더라도 빌드됩니다. 그런 경우에는 객체를 둘 중 하나에서만 내보내십시오.

이 중단에 가장 자주 이르는 배치는 하나의 component에 두 Features가 연결되고, 각각이 작성자가 제공한 차트를 전달하는 경우입니다. 두 차트는 모두 같은 release 이름, 즉 호스트 component의 이름으로 렌더링됩니다. 이는 차트를 연결해도 작성자가 이미 선언하고 배포한 리소스의 이름이 바뀌지 않도록 하기 위함이며, 리소스 이름을 release 이름을 따서 짓는 것은 차트가 가장 흔히 하는 일 중 하나입니다. 출력의 형태에는 잘못된 것이 없습니다. 두 리소스가 단지 하나의 이름을 가질 뿐입니다. component의 provider가 개별 문서를 쓰는 경우 각 연결은 자체 디렉터리 아래에 쓰며, 둘을 모두 적용하면 마지막에 적용된 것만 남습니다. 그룹을 하나의 문서로 합치는 경우 두 연결 모두 그 문서에 기여하며, 두 이름 중 하나가 그 안에서 다른 하나를 대체합니다. 직접 관리하는 차트에서 리소스 이름을 바꾸거나, 두 연결을 구별하는 무언가를 포함한 이름을 부여하십시오. 이때 템플릿에 도달해야 하는 것은 연결입니다. 두 차트 모두 호스트의 release 이름으로 렌더링되므로 연결 이름만 바꿔서는 아무것도 달라지지 않기 때문입니다. FeatureRecipe의 valuesMapping:을 통해 .attachment_name을 차트에 전달하고, 리소스 이름의 바탕이 되는 차트 자체 값에 이를 설정하십시오.

두 번째 배치는 두 개가 아니라 하나의 Feature로 같은 중단에 이릅니다. 템플릿이 리소스 이름을 리터럴로 쓰는 차트가 두 component에 연결된 경우입니다. 각 호스트는 자체 release 이름으로 이를 렌더링하므로, 두 복사본이 하나의 이름을 갖는 유일한 이유는 리터럴입니다. 리소스 이름을 .Release.Name을 따서 지으면 호스트가 다시 이름에 반영되며, 이는 release 식별자로 리소스 이름을 만드는 차트가 이미 하는 방식입니다.

세 번째 배치는 같은 형태가 한 단계 더 안쪽의 작성 표면에서 나타나는 경우입니다. 차트가 아니라 artifacts:를 통해 리소스를 전달하는 FeatureRecipe가 하나의 이름으로 두 component에 연결되고, 그 본문이 리소스 이름을 리터럴로 쓰는 경우입니다. 각 연결의 출력은 호스트 이름을 딴 디렉터리 아래에 놓이므로 생성된 경로가 다르고 출력의 형태에는 잘못된 것이 없습니다. 그러나 두 본문은 같은 이름을 가지며, 둘을 모두 적용하면 마지막에 적용된 것만 남습니다. artifacts 본문의 이름은 차트가 렌더링한 이름과 똑같이 비교됩니다. 둘은 같은 클러스터의 같은 리소스를 기술하므로, 이름이 어디서 왔는지는 둘을 모두 적용할 때 일어나는 일에 아무런 차이를 만들지 않습니다. 이 해석은 두 이름이 함께 읽힌다는 데 근거하며, 이는 provider가 각 기여자의 출력을 대상이 하나의 집합으로 읽는 파일로 쓰는 경우에 일어납니다. provider가 대신 assembly의 출력을 하나의 문서로 병합하는 경우에는 각 연결의 파일이 그 문서 밖에 있고 그 안의 이름은 해당 파일로 범위가 한정되므로, 그러한 두 연결은 만나지 않으며 빌드가 진행됩니다.

모든 이름이 보고되는 것은 아니므로, 중단되지 않은 빌드가 출력이 최종적으로 갖게 될 모든 이름이 비교되었음을 확인한 것은 아닙니다. 클러스터가 이름을 짓도록 남겨 둔 리소스, 즉 name 대신 generateName을 선언한 리소스는 아직 이름이 없으므로 보고할 이름이 없습니다. 또한 컨트롤러가 나중에 읽도록 다른 필드에 쓰인 이름은 리소스 이름이 아니므로 아무것도 이를 비교하지 않습니다. 두 한계 모두 생성된 문서를 읽는 방식의 속성이므로, 렌더링된 차트 템플릿에 적용되는 것과 똑같이 artifacts 본문에도 적용됩니다.

artifacts: 본문은 템플릿이므로, 호스트마다 달라야 하는 이름은 리터럴로 쓰지 않고 조합합니다. .context.rendered_name은 호스트 component 자체의 provider가 부여하는 이름이고(helm에서는 Kubernetes 이름이 허용하는 문자로 표기된 release 이름입니다), .attachment_name은 연결할 때 사용한 키이므로, {{ .context.rendered_name }}-{{ .attachment_name }}은 모든 호스트와 모든 연결에서 리소스에 고유한 이름을 부여합니다. provider가 그러한 이름을 보고하지 않는 호스트에서는 대신 호스트의 식별자인 .context.instance_id로 이름을 조합하십시오. 작성된 하나의 본문은 연결된 각 호스트에 그 안의 이름을 그대로 가지고 도달하며, 리터럴은 모든 호스트에서 같습니다. 따라서 클러스터에서 고유해야 하는 이름에는 이러한 형태를 부여하십시오.

이름의 의미는 전혀 해석되지 않습니다. 보고된 두 이름은 같은 텍스트이거나 그렇지 않을 뿐입니다. 그래서 누가 도출했든 같은 보고가 모든 종류의 이름을 다룹니다.

component의 각 부분은 렌더링될 때마다 보고되므로, 하나의 component에 대해 한 이름이 둘 이상의 보고에 나타날 수 있습니다. 이는 하나의 리소스가 자신이 속한 각 보고에서 이름으로 나타나는 것이지 이름이 두 번 사용된 것이 아니며, 중단되지 않습니다. 중단되는 것은 하나의 보고가 한 이름을 두 번 가지는 경우입니다. 그 보고는 이름이 실제로 두 번 사용된 출력을 기술하기 때문입니다.

이 해석은 무엇을 하나의 기여자로 보느냐에 달려 있으며, component-id 종류의 경우 답은 component나 그것이 놓인 경계가 아니라 연결입니다. 연결은 그에 대해 작성한 두 좌표로 식별됩니다. 연결된 component와 features: 아래의 키, 또는 경계 경로와 그 경계에서의 이름입니다. 따라서 하나의 component에 있는 두 연결은 서로 다른 component에 있는 두 연결과 똑같이 두 기여자이며, 두 경계에 쓰인 하나의 feature 이름은 각 경계에서 이름이 같더라도 두 기여자입니다. 두 기여자라는 점이 이러한 각 배치에서 식별자를 비교 가능하게 합니다. 그중 둘이 실제로 비교되는지 여부는 여기의 다른 모든 이름과 같은 규칙을 따르므로, provider가 병합하는 경우 출력이 자체적인 별도 파일로 쓰이는 연결은 병합된 문서 밖에 있으며 자기 자신과만 비교됩니다. 따라서 하나의 식별자에 이르는 두 연결은 그 출력이 서로에게 닿을 수 있는 곳에서는 중단되며, 각 발견 사항은 두 좌표를 모두 명시하므로 어떤 두 대상을 분리해야 하는지 알 수 있습니다. 두 좌표가 모두 조합된 값의 일부이므로, 구별할 수 있는 두 연결은 길이가 맞는 한 항상 두 식별자에 이릅니다. 그래서 이 중단에 이르는 배치는 대상에 비해 너무 긴 값이 단축되고 단축된 두 값이 만난 경우입니다. 단축된 두 식별자가 만나지만 출력이 서로에게 닿을 수 없는 경우(병합하는 provider 아래에서 하나의 component에 있는 두 연결이 각각 별도 파일로 쓰이는 경우)에는 아무것도 이를 비교하지 않으며, 두 리소스 집합이 하나의 aggrega.ai/component-id를 공유하게 됩니다.

중단되어야 할 것처럼 보이지만 중단되지 않는 배치가 하나 있어 명확히 밝혀 둡니다. 두 component에 feature를 같은 이름으로 연결하는 것은 완전히 지원되며 이름을 바꿀 필요가 없습니다. component가 조합된 값의 일부이므로 api의 metrics와 web의 metrics는 두 식별자에 이르고 각 component의 리소스는 자체 식별자를 갖습니다. 이는 설계상 여러 component에 걸쳐 하나의 연결 이름을 만들어 내는 cascade가 작성자에게 다른 이름을 쓸 여지를 남기지 않기 때문에 중요합니다. FeatureRecipe가 리소스를 전달하는 모든 방식은 생성하는 대상에 식별자를 부여하며, 소스를 vendor하여 그대로 렌더링하기만 하는 방식도 마찬가지이므로 모두 비교됩니다. FeatureRecipe가 아무것도 생성하지 않는 feature에는 비교할 것이 없습니다.

빌드는 하나를 유지하고 다른 하나를 버리는 대신 중단됩니다. 올바른 조용한 해결책은 없습니다. 첫 번째를 유지하면 선언한 리소스가 출력에서 완전히 빠진 채 빌드가 성공을 보고하게 되고, 빠진 리소스를 참조하던 모든 것이 조용히 남은 리소스로 해석됩니다. 충돌하는 모든 이름이 보고되며, 각각 이름의 종류와 그것을 도출한 모든 기여자가 명시됩니다. 따라서 충돌을 하나씩 보는 대신 한 번의 빌드로 전체 상황을 알 수 있습니다. 자체 출력이 이름을 두 번 가지는 기여자는 그 이름을 두 번 이상 도출한 것으로 명시되며, 이를 통해 분리해야 할 두 대상이 두 component 사이가 아니라 그 하나의 component 안에 있음을 알 수 있습니다.

출력되는 메시지. 충돌하는 이름마다 기여자당 하나의 결과가 보고되므로, 이름을 도출한 모든 기여자는 한 메시지 안의 목록으로 묶이지 않고 각각 따로 명시됩니다. 두 기여자가 이름을 도출한 경우 결과는 최소 두 개이며, 이들은 공통점을 설명하는 보고 아래에 함께 나타납니다:

dispatch groups whose contributors derive one name more than once in one key space (기여자들이 하나의 키 공간에서 하나의 이름을 두 번 이상 도출하는 디스패치 그룹)

각 결과는 이름, 그 이름의 종류, 이름을 도출한 기여자, 그리고 그 출력이 병합되는 어셈블리의 provider와 경로를 명시합니다:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<contributor>", provider "<provider>", dispatch path "<path>") (도출된 이름 충돌: 하나의 키 공간에서 하나의 이름이 두 번 이상 도출됨)

기여자는 그 정체에 따라 명시되며, 이것이 그 이름이 어디에 작성되는지를 알려 줍니다. 컴포넌트 인스턴스는 derived by component, 경계에 연결된 기능은 derived by feature로 표시됩니다.

기여자 자신의 이름만으로 식별되지 않는 경우 두 번째 좌표가 뒤따르며, 어떤 좌표인지는 종류에 따라 다릅니다. 경계에 연결된 기능은 경계의 경로를 포함합니다. 하나의 기능 이름이 둘 이상의 경계에 작성될 수 있기 때문입니다:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by feature "<feature-name>", attached at boundary "<boundary-path>", provider "<provider>", dispatch path "<path>") (도출된 이름 충돌: 하나의 키 공간에서 하나의 이름이 두 번 이상 도출됨)

컴포넌트는 렌더링 시 그 이름을 도출한 연결의 키를 포함합니다. 컴포넌트는 작성한 키마다 하나의 연결을 가지기 때문입니다:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<component>", carrying attachment "<attachment-key>", provider "<provider>", dispatch path "<path>") (도출된 이름 충돌: 하나의 키 공간에서 하나의 이름이 두 번 이상 도출됨)

컴포넌트 자체의 렌더링, 즉 provider가 연결 중 하나가 아니라 컴포넌트 자체를 위해 도출한 이름에는 두 번째 좌표가 없으므로, 결과는 컴포넌트 이름에서 끝납니다.

단일 기여자 자신의 출력이 그 이름을 두 번 포함하는 경우 그 기여자가 유일한 결과이므로, 위에 보고 없이 단독으로 나타납니다. 그리고 다른 기여자와 만난 것이 아니라 이름을 두 번 이상 도출한 것으로 명시됩니다:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived more than once by component "<contributor>", provider "<provider>", dispatch path "<path>") (도출된 이름 충돌: 하나의 키 공간에서 하나의 이름이 두 번 이상 도출됨)

여기서도 두 번째 좌표는 위와 같은 조건으로 기여자 뒤에 따라오므로, 한 연결 자체의 출력 안에서 반복이 일어나면 그것을 포함하는 컴포넌트만이 아니라 그 연결이 명시됩니다.

해결 방법: 두 기여자가 명시된 경우 Aggregate에서 둘 중 하나의 이름을 바꾸어, 그로부터 도출되는 이름이 다른 쪽과 더 이상 일치하지 않게 합니다. 이름의 종류가 component-id인 경우 각 결과가 이미 바꿀 대상을 명시합니다. carrying attachment "…"는 해당 컴포넌트의 features: 블록 아래의 키이고, feature "…" attached at boundary "…"는 해당 경계의 features: 블록 아래의 이름입니다. 두 결과가 명시하는 경계만 다른 경우 두 연결은 두 경계에서 하나의 이름을 가진 것입니다. 둘 중 하나의 이름을 바꾸거나, 두 경계에 서로 다른 directory: 경로를 지정하여 출력이 더 이상 병합되지 않게 합니다. 두 이름이 빌드가 조합한 것이라면 대상에 맞게 축약된 후에야 만날 수 있으므로, 빌드에 맡기지 말고 그 이름을 구성하는 부분을 직접 줄입니다. 두 이름 모두 명시적으로 설정한 것, 즉 Recipe가 provider에 전달하는 값이나 provider가 읽는 어노테이션에서 도출된 경우, 둘 중 제어할 수 있는 쪽에서 그것을 변경합니다. 두 기여자가 실제로 별개의 출력에 속한다면 경계에 서로 다른 directory: 경로를 지정하여 각각 따로 어셈블되고 두 이름이 만나지 않게 합니다. 단일 기여자가 이름을 두 번 이상 도출한 것으로 명시된 경우 충돌하는 두 대상은 모두 그 한 컴포넌트 안에 있습니다. 해당 Recipe가 생성하는 리소스 중 이름이 일치하는 두 리소스를 찾아, 그중 하나의 이름의 기반, 즉 선언된 키나 구성에 쓰인 값을 변경하여 provider가 각각에 고유한 이름을 도출하게 합니다. 이름의 종류가 resource-names:ClusterRole처럼 그 자체로 클러스터 범위 종류인 경우, 명시된 문서들은 어느 네임스페이스에 배치되었든 클러스터의 하나의 객체를 기술합니다. 하나의 기여자에서만 내보내거나(정의 설치 스위치처럼 차트가 제공하는 값을 통해), 둘이 별개의 객체여야 한다면 제어하는 차트나 본문에서 하나에 고유한 이름을 부여합니다. 단일 기여자가 이에 대해 두 번 명시되었다면 그것을 두 네임스페이스에 작성한 것이며, 두 문서 중 하나를 제거해야 합니다.

An authored export name is one the build derives for a cross-stack reference (작성한 export 이름이 빌드가 스택 간 참조를 위해 도출하는 이름과 같음)

cloudformation Recipe의 Outputs: 블록은 직접 작성한 CloudFormation이며, 그 안의 항목은 Name:을 가진 자체 Export:를 가질 수 있습니다. 그 이름은 작성된 그대로 조립된 스택에 도달합니다. 이와 별개로, uses 엣지가 한 boundary에서 다른 boundary로 넘어가면 provider는 소비되는 값을 release, boundary, component, 제공 키로부터 도출한 이름의 Export를 가진 스택 Output으로 게시합니다. 이 중단은 두 이름이 만나는 곳에서 발생합니다. 작성한 이름이 같은 빌드에서 도출된 이름과 같으면 스택이 하나의 export 이름을 두 곳에서 두 번 선언하게 되는데, export 이름은 고유해야 합니다.

중단은 두 이름이 일치할 때만 일어납니다. Outputs 항목에 export 이름을 선언하는 것은 지원되며, 도출된 어떤 이름과도 일치하지 않는 이름은 도출된 이름들과 함께 아무 경고 없이 게시됩니다. 단, 스택 간 참조가 자신이 소비하는 키에 대해 자체 export를 게시하는 스택 출력의 항목은 예외입니다. 그곳의 Export:는 도출된 이름과 정확히 같은 이름을 갖지 않으면 중단됩니다. 이 경우는 The output a cross-stack reference publishes on already carries an Export (스택 간 참조가 게시하는 출력에 이미 Export가 있음)입니다.

이 중단은 도출된 export 이름을 그 이름을 구성한 네 부분과 함께 제시하므로 어떤 boundary 간 참조가 그 이름을 만들었는지 알 수 있으며, 선언이 놓인 스택 출력의 이름도 알려 줍니다. 이 이름은 Recipe가 작성한 이름이 아니라 provider가 조립한 이름으로 표시되는데, provider가 component와 항목을 논리 ID가 허용하는 문자와 숫자로 인코딩하여 그 이름을 만들기 때문에 둘 중 어느 것이 작성된 문자열과도 같지 않습니다. 검색할 부분은 export 이름입니다. 작성한 항목은 중단 메시지와 정확히 같은 철자로 그 이름을 쓰며, 바로 그 때문에 둘이 충돌하므로, 메시지와 자신의 파일 양쪽에 모두 나타나는 유일한 문자열입니다.

비교 범위는 하나의 스택입니다. 즉 그 스택이 선언하는 export 이름을 그 스택으로 게시되는 boundary 간 참조에 대해 도출된 이름과 비교합니다. 두 스택끼리는 비교하지 않으며, CloudFormation 내장 함수로 작성된 export 이름은 배포 시점에 해석되므로 비교할 이름이 없습니다. 어떤 이름이 계정과 리전에 이미 배포된 export들과 충돌하는지는 배포의 속성이며, 빌드는 이를 관찰하지 않습니다.

출력되는 메시지. 조건은 실패의 종류를 나타내고 provider 자체의 문장이 무슨 일이 일어났는지 설명합니다. 이를 둘러싼 보고서는 연결 중인 uses 엣지도 알려 줍니다:

two things a plugin produced occupy one name in its output (플러그인이 생성한 두 항목이 출력에서 하나의 이름을 차지합니다) cloudformation-provider: an export name a cross-boundary link derives is already declared by another Outputs entry in the same stack: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and another Outputs entry of the same stack already declares that same export name — that declaration sits under the stack output <stack-output>, a name this provider assembles rather than one a Recipe wrote; each shadowing Outputs entry spells its export name exactly as the halt does, so searching your Recipes for that name reaches the entry — rename the export name the entry declares, or remove that entry’s Export block and let the link publish the export (cloudformation-provider: 경계를 넘는 링크가 도출하는 export 이름을 같은 스택의 다른 Outputs 항목이 이미 선언하고 있습니다. 링크는 Release의 경계에 있는 컴포넌트의 provides 키에 대해 export 이름을 도출하며, 같은 스택의 다른 Outputs 항목이 이미 같은 export 이름을 선언하고 있습니다. 그 선언은 Recipe가 작성한 이름이 아니라 이 provider가 조합하는 이름인 스택 출력 아래에 있습니다. 가리는 각 Outputs 항목은 중단 메시지와 정확히 같은 철자로 export 이름을 쓰므로, Recipes에서 그 이름을 검색하면 해당 항목을 찾을 수 있습니다. 항목이 선언하는 export 이름을 바꾸거나, 그 항목의 Export 블록을 제거하고 링크가 export를 게시하도록 하십시오)

해결 방법: 중단 메시지가 알려 주는 export 이름을 Recipes에서 검색합니다. 그 이름을 선언하는 Outputs 항목은 철자가 동일합니다. 그런 다음 그 export 이름이 더 이상 일치하지 않도록 이름을 바꾸거나, 그 항목의 Export: 블록을 제거하고 스택 간 연결이 export를 직접 게시하게 합니다. 항목이 엣지가 소비하는 것과 같은 값을 내보내기 위해 존재했다면 보통 제거하는 것이 올바릅니다. provider가 어차피 그 값에 대한 Export를 게시하므로 직접 작성한 것은 아무것도 더하지 않습니다. 항목이 직접 정한 이름으로 값을 가져오는 다른 소비자를 위해 값을 내보내는 경우에는 작성한 Export:를 유지하고 대신 이름을 바꿉니다.

The output a cross-stack reference publishes on already carries an Export (스택 간 참조가 게시하는 출력에 이미 Export가 있음)

uses 엣지가 한 boundary에서 다른 boundary로 넘어가면, provider는 소비되는 값의 Export를 생산하는 component와 제공 키에 대해 자신이 조립하는 스택 출력에 게시합니다. 이는 cloudformation Recipe의 Outputs: 블록이 그 키 아래에 항목을 작성할 때 도달하는 것과 같은 출력입니다. 그 출력에 이미 있는 Export:는 그 Name:이 provider가 도출하는 이름과 정확히 같을 때만 유지됩니다. 그것은 같은 값에 대한 이전의 스택 간 참조가 이미 게시한 export이므로, 모든 소비자가 하나의 이름을 가져옵니다. 그 밖의 Export:는 중단됩니다. provider의 export를 쓰면 작성한 내용을 덮어쓰게 되고, 작성한 것을 유지하면 모든 소비자가 참조가 게시한 적 없는 이름을 가져오게 되기 때문입니다.

이 중단은 그 출력에 있는 다음 네 가지 형태의 Export:에서 발생합니다:

  • 다른 문자열인 Name:;
  • CloudFormation 내장 함수로 작성된 Name:. 배포 시점에 해석되므로 provider가 그 철자를 읽을 수 없습니다;
  • 아무 이름도 지정하지 않는 Export: 블록;
  • 블록이 아니라 단순 값으로 작성된 Export:.

다른 Outputs 항목에 선언한 export 이름은 An authored export name is one the build derives for a cross-stack reference (작성한 export 이름이 빌드가 스택 간 참조를 위해 도출하는 이름과 같음)에서 별도로 비교됩니다.

출력되는 메시지. 조건은 실패의 종류를 나타내고 provider 자체의 문장이 무슨 일이 일어났는지 설명합니다. 이를 둘러싼 보고서는 연결 중인 uses 엣지도 알려 줍니다:

two things a plugin produced occupy one name in its output (플러그인이 생성한 두 항목이 출력에서 하나의 이름을 차지합니다) cloudformation-provider: the stack output a cross-boundary link publishes its export on already carries an Export the link did not write: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and the stack output this provider assembles for that key and component <what-it-found>; remove that entry’s Export block and let the link publish the export every consumer imports (cloudformation-provider: 경계를 넘는 링크가 export를 게시하는 스택 출력에 링크가 작성하지 않은 Export가 이미 있습니다. 링크는 Release의 경계에 있는 컴포넌트의 provides 키에 대해 export 이름을 도출하며, 이 provider가 그 키와 컴포넌트에 대해 조립하는 스택 출력은 다음과 같습니다. 그 항목의 Export 블록을 제거하고 링크가 모든 소비자가 가져오는 export를 게시하도록 하십시오)

<what-it-found>는 위 형태의 순서대로 다음 중 하나입니다:

already declares the export name <name> (이미 export 이름을 선언하고 있음) already declares an export name that is not a string — one given as an intrinsic, which resolves at deploy time, so this provider cannot read what it spells (이미 문자열이 아닌 export 이름을 선언하고 있음. 배포 시점에 해석되는 내장 함수로 지정되어 이 provider가 그 철자를 읽을 수 없음) already carries an Export block declaring no export name (export 이름을 선언하지 않는 Export 블록이 이미 있음) already carries an Export that is not a block, where CloudFormation expects one carrying a Name (CloudFormation이 Name을 가진 블록을 기대하는 곳에 블록이 아닌 Export가 이미 있음)

해결 방법: 중단 메시지가 알려 주는 component의 Recipe에서, 메시지가 알려 주는 제공 키 아래에 작성된 Outputs 항목을 찾아 그 항목의 Export: 블록을 제거합니다. 그러면 스택 간 연결이 모든 소비자가 가져오는 export를 게시합니다. 이 빌드 밖의 소비자를 위해 직접 정한 이름으로도 값을 내보내야 한다면, 다른 키 아래의 Outputs 항목에 그 Export:를 작성합니다. 빌드가 도출하는 이름이 아닌 한 그곳의 export 이름은 지원됩니다.

Chart-name mismatch on a merged helm-chart umbrella (병합된 helm-chart 상위 차트의 차트 이름 불일치)

둘 이상의 boundary가 같은 helm-chart provider 조립 경로에 기여하지만, (boundary 어노테이션 캐스케이드를 통해 해석된) 실제 aggrega.ai/chart-name 어노테이션이 일치하지 않습니다. Helm 상위(umbrella) 차트는 정확히 하나의 차트 이름을 가지며, 렌더러는 충돌하는 후보 중 하나를 고를 수 없습니다.

출력되는 메시지. 기여하는 boundary마다 하나의 결과가 보고되며, 각 결과는 그 boundary가 해석한 값을 담으므로, 일치하지 않는 이름들은 하나의 출력된 목록이 아니라 결과 하나에 하나씩 도착합니다. 결과들이 함께 도착하는 보고서는 공통점을 다음과 같이 밝힙니다:

merged dispatch groups whose boundaries disagree on the assembly name (boundary들이 조립 이름에 대해 일치하지 않는 병합된 디스패치 그룹)

각 결과는 그 boundary가 해석한 값, 그 값을 읽은 어노테이션, boundary, provider, 그리고 병합되는 경로를 알려 줍니다:

merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>") (병합 경로 조립에 충돌하는 조립 이름 어노테이션 값이 있음)

해결 방법: 기여하는 모든 boundary에 일치하는 aggrega.ai/chart-name 어노테이션을 선언하거나(기여자들이 부모 boundary를 공유하면 캐스케이드 메커니즘 덕분에 중복 없이 부모에 한 번만 선언하면 됩니다), boundary들을 별도의 directory: 경로로 나누어 각각 자체 상위 차트를 갖게 합니다.

FeatureRecipe template references a field outside its scope’s allowlist (FeatureRecipe 템플릿이 해당 범위의 허용 목록 밖의 필드를 참조함)

executionScope: boundary인 FeatureRecipe가 경계에 대해 한 번 실행되는 템플릿, 즉 그 locals:, provides:, valuesMapping:, artifacts: 또는 파이프라인 단계의 with:나 when:에서 .context.instance_id, .context.inject, .context.uses처럼 component 전용 필드를 참조합니다. 이 필드들은 boundary 범위에서 의미 있는 값을 갖지 않습니다. 반대 조건도 성립합니다. component 범위 FeatureRecipe(기본값)가 .boundary.* 필드를 참조하면 같은 검사기에서 실패합니다. 검증은 렌더링 작업이 시작되기 전, 파싱 시점에 해당 범위의 필드 허용 목록에 대해 실행됩니다. 경계 범위 FeatureRecipe의 injectMapping은 여기에서 검사되지 않습니다. 이것은 attachment가 도달하는 각 컴포넌트에 대해 그 컴포넌트의 컨텍스트에서 한 번씩 실행되므로 .context.*를 읽으며, 그 안의 .boundary 참조는 위의 “Template references a root the render context does not define (템플릿이 렌더 컨텍스트가 정의하지 않은 루트를 참조함)”에서 보고됩니다.

출력되는 메시지:

FeatureRecipe template references a per-component-only field with executionScope: boundary ("<dotted-path>", written in "<field>", the render context defines "<the roots the boundary-scope context defines>") (executionScope가 boundary인 FeatureRecipe 템플릿이 컴포넌트 전용 필드를 참조합니다)

valuesMapping이 .context.instance_id를 읽는 경계 범위 FeatureRecipe는 다음과 같이 출력합니다.

[CATALOG_ERROR E0039] scope-probe-fr at .spec.valuesMapping
FeatureRecipe template references a per-component-only field with executionScope: boundary (".context.instance_id", written in "valuesMapping", the render context defines ".values, .infra, .locals, .provides, .features, .metadata, .steps, .source, .boundary")

해결 방법: 해당 범위에서 사용할 수 있는 필드에 맞게 템플릿을 다시 작성하거나, FeatureRecipe의 executionScope를 변경합니다. 경계 범위 FeatureRecipes는 .boundary.path, .boundary.boundary_name, .boundary.components, .boundary.*_uses_edges 컬렉션, .boundary.labels, .boundary.annotations, .boundary.feature_attachments를 참조합니다. Component 범위 FeatureRecipes는 .context.instance_id, .context.inject, .context.uses, .context.labels, .context.annotations를 참조합니다. 두 범위 모두 .values, .infra, .locals, .provides, .steps, .metadata를 공유합니다. Release 파라미터는 이 표면에서 별도의 필러가 아닙니다. 그것을 참조하는 values 또는 infra 항목을 통해 FeatureRecipe 템플릿에 전달됩니다.

Self-inject value template references cross-node data (자기 주입 값 템플릿이 노드 간 데이터를 참조함)

컴포넌트 수준 inject: value: 템플릿이 .context.inject 또는 .context.uses에서 값을 가져옵니다. inject 파이프는 이 패스가 구성하고 있는 대상이므로, 컴포넌트 자체의 자기 주입 값 안에 있는 템플릿은 이를 읽을 수 없습니다.

이렇게 되는 것은 이 표면의 .context 때문입니다. 여기에는 instance_id, labels, annotations만 들어 있고 그 밖의 것은 없습니다. 따라서 .context.inject와 .context.uses는 이 표면의 컨텍스트가 정의하지 않는 키이며, 이 참조는 위의 “Template references a root the render context does not define(템플릿이 렌더 컨텍스트가 정의하지 않는 루트를 참조함)”으로 파싱 시점에, 어떤 렌더링도 시작되기 전에 중단됩니다. 진단은 템플릿이 속한 메커니즘과 전달 키를 알려 주고, 여기서 .context가 실제로 정의하는 키를 나열합니다. 그래서 같은 보고가 노드 간 데이터에 실제로 접근하려는 경우와 {{ .context.nmae }} 같은 단순한 오타를 모두 다룹니다. 오타 쪽이 더 흔한 실수이며, 그렇지 않았다면 아무것도 렌더링되지 않았을 것입니다.

출력되는 메시지 — 참조 수준의 세부 정보이며, 이를 둘러싼 보고는 노드, 메커니즘, 전달 키도 알려 줍니다:

template references a root the render context does not define (template self-inject.<mechanism>[<key>] references .context.inject, .context defines .context.instance_id, .context.labels, .context.annotations) (템플릿이 렌더 컨텍스트가 정의하지 않는 루트를 참조함)

컴포넌트 수준 inject: 블록은 Aggregate에서 작성되므로 보고의 모든 프레임은 개발자 도메인에 속합니다.

해결 방법: 컴포넌트 간 연결을 uses[].inject 항목으로 옮기십시오. 노드 간 컨텍스트는 그곳에서 사용할 수 있습니다. 컴포넌트 수준 자기 주입 value: 템플릿은 해당 컴포넌트 자체의 values와 infra, .context.instance_id / .context.labels / .context.annotations, 그리고 .metadata만 참조하도록 유지하십시오.

Missing template key — asymmetric policy (누락된 템플릿 키 — 비대칭 정책)

누락된 키의 처리는 템플릿 표면에 따라 다릅니다. 빈 렌더링 결과가 경계가 있는 곳, 즉 작성자가 다시 읽어 볼 수 있는 manifest 필드에 들어가는 경우에는 누락이 허용되고 그 읽기는 아무것도 렌더링하지 않습니다. 반면 빈 렌더링 결과가 잘못된 구조나 잘못된 판정을 만들어 내는 경우에는, 표면이 참조를 아무것도 아닌 것으로 해석하는 대신 거부합니다.

  • Aggregate의 매개변수 보간, 즉 Aggregate 자체 텍스트가 담고 있는 {{ .parameters.<key> }} 참조는 이러한 표면 중 가장 먼저 실행됩니다. 카탈로그가 해석되기 전에 원시 문서를 대상으로 실행되므로, 그 정책은 다른 어떤 표면도 아직 보지 않은 텍스트에 적용됩니다. Release가 채우지 않은 매개변수에 대한 참조는 아무것도 렌더링하지 않으며, 그런 읽기에 대한 default 파이프나 if 가드는 채워지지 않은 매개변수에 대해서와 똑같이 동작합니다. 템플릿이 반복하는 참조는 아무것도 없는 것으로 계속 반복되며, 이는 선택적 목록을 순회할 때 원하는 동작입니다. 다만 텍스트가 그 참조를 출력하기도 하면, 아래의 “A template reads and iterates a path that holds nothing (템플릿이 아무것도 담지 않은 경로를 읽으면서 반복함)”에서 설명하는 대로 중단됩니다. 부모가 없는 참조, 예를 들어 db 매개변수가 채워지지 않았는데 .parameters.db.host를 참조하는 경우는 여전히 중단됩니다. 내려갈 대상이 없고, 부모를 제공하면 중단을 조용히 잘못된 아티팩트와 맞바꾸게 되기 때문입니다. 한 가지 한계는 정책이 아니라 한계로 밝혀 둘 만합니다. 표면이 정의하지 않는 루트에 고정된 참조는 아무것도 아닌 것으로 렌더링되지 않고 그대로 남으므로, 보간된 문서에 템플릿 엔진 자체의 자리 표시 텍스트인 <no value>로 남게 됩니다. 이 표면에서는 이에 대해 중단하는 것이 없으므로, 모든 매개변수 참조를 .parameters에 고정하고, 남아 있는 <no value>는 루트의 철자 오류로 읽으십시오.
  • 경로 템플릿(Release 경계의 directory: / subDirectory:)은 missingkey=error로 평가됩니다. 표면이 제공하지 않는 변수에 대한 참조는 파싱 시점에 중단되며(위의 “Path-template references a variable outside the allowlist (경로 템플릿이 허용 목록 밖의 변수를 참조함)” 참조), 키가 선언되어 있는 .manifest 아래의 잘못 입력된 키도 마찬가지입니다. 허용되지만 평가 시점에 정의되지 않은 참조, 예를 들어 Release가 제공하지 않는 .parameters 키는 디렉터리 경로에 빈 문자열을 조용히 렌더링하는 대신 명시적인 오류를 발생시킵니다.
  • assertions(Component, Feature, Recipe 또는 FeatureRecipe에 있는)는 missingkey=error로 평가됩니다. 정의되지 않은 키에 대한 참조는 엔터티, 인스턴스, 어설션을 명시하는 no-such-key 진단과 함께 중단됩니다. 이 엄격함이 어설션을 신뢰할 수 있게 만듭니다. 참조가 빈 값으로 렌더링된 조건식은 아무것도 아닌 것과 비교되어 통과할 것이므로, 오타 하나가 어설션이 강제하려고 작성된 규칙을 조용히 무력화할 것입니다. 폴백이 실행되기 전에 단순 참조가 중단되므로, 이 표면에서는 일반 default가 선택적 필드의 폴백을 제공하지 않습니다. 참조를 hasKey로 보호하거나, 존재 여부 확인을 직접 수행하는 optional 헬퍼를 사용하십시오. index로 키를 읽는 것도 폴백을 제공하지 않습니다. index는 맵에 없는 맵 키에 대해 그 키를 명시하며 중단합니다.
  • 값 템플릿(Recipe의 valuesMapping, locals: 및 provides: 항목, artifacts: 본문, Workload 본문, FeatureRecipe의 injectMapping 및 pipeline.with, 그리고 컴포넌트 수준 자기 주입 value: 템플릿)은 missingkey=zero로 평가되므로, 정의되지 않은 키에 대한 참조는 빌드를 중단하지 않습니다. 그 읽기는 아무것도 렌더링하지 않으며, 아티팩트에 도달하는 것도 바로 그 빈 결과입니다. 이 표면에서 여전히 중단되는 것은 작성자가 제공한 적 없는 컨테이너를 거쳐 내려가는 참조입니다. 예를 들어 tls가 작성되지 않았는데 .values.tls.ca를 참조하는 경우로, 내려갈 대상이 없기 때문입니다. 아무것도 없는 것으로 렌더링되는 것은 모든 컨테이너가 존재하는 참조의 마지막 키뿐입니다. 컨텍스트가 정의하지만 아무것도 담고 있지 않은 최상위 필드, 즉 아무것도 합성하지 않는 Recipe의 .workload나 첨부가 없는 컴포넌트의 .features도 통째로 읽으면 같은 방식으로 아무것도 렌더링하지 않습니다. 하나의 참조는 어떻게 표기하든 하나의 참조입니다. .values.list, $.values.list, (.values).list는 같은 키를 가리키므로, 한 표기로 그 키를 순회하는 것은 모든 표기로 순회하는 것이며, 괄호로 감싼 필러에서 읽은 키는 직접 쓴 표기와 정확히 같은 방식으로 렌더링되거나 중단됩니다. 템플릿이 순회하는 키는 설정되지 않았을 때 아무것도 없는 것으로 계속 반복되며, 템플릿이 출력하면서 순회도 하는 키는 설정되지 않았을 때 중단됩니다. 아래의 “A template reads and iterates a path that holds nothing (템플릿이 아무것도 담지 않은 경로를 읽으면서 반복함)”을 참조하십시오. 가드는 예상대로 동작합니다. {{ .values.optional_field | default "fallback" }}은 실제로 대체 값을 제공하는데, 설정되지 않은 값은 default에게는 빈 값으로, if에게는 거짓으로 간주되기 때문입니다. 없음과 0 값을 구별해야 하는 작성자, 즉 “키 없음”과 “키가 있으나 비어 있음”을 구별해야 하는 작성자는 templates/sprig-functions.md에 설명된 optional 헬퍼를 사용하고, 주어진 키를 템플릿마다 한 가지 방식으로만 읽습니다. 같은 템플릿이 .values.<key>로도 읽는 키는 존재하는 것으로 간주되므로, optional은 대체 값이 아니라 그 빈 값을 보고합니다. 이 정책이 다루지 않는 것은 index를 통한 읽기입니다. 맵에 없는 키로 맵을 인덱싱하면 모든 표면에서와 마찬가지로 여기서도 그 키를 지목하며 중단됩니다. 아래의 “A template indexes a map with a key the map does not hold (템플릿이 맵에 없는 키로 맵을 인덱싱함)”을 참조하십시오.
  • source: 좌표, 즉 Recipe 또는 FeatureRecipe에 있는 구조화된 source: 블록의 템플릿 필드(version, ref, chart, module_subdir)는 missingkey=error로 평가됩니다. 아무것도 제공하지 않는 키에 대한 참조는 아무것도 아닌 것으로 해석되지 않고 소스 필드를 명시하며 중단됩니다. 빈 version이나 ref는 작성자가 지정한 것과 다른 아티팩트를 고정하게 되며, 그 고정은 이후의 모든 빌드가 재현하는 대상이기 때문입니다. 이 표면은 사용 가능한 함수 집합이 다른 곳이기도 하며, 블록 자체의 작성 순서가 거부하는 locals: 참조가 어떤 것도 평가되기 전에 중단되는 곳이기도 합니다. 아래를 참조하십시오.
  • 타입이 지정된 매개변수 계약은 보간이 실행되기 전에 매개변수 계약 계층에서 필수 매개변수 누락 및 계약 위반 사례를 잡아냅니다. 위의 “Parameter type mismatch / contract violation (매개변수 타입 불일치 / 계약 위반)”을 참조하십시오.

헬퍼 집합은 값 템플릿, 경로 템플릿, 어설션 전반에서 동일합니다. Sprig의 함수와 Aggrega 자체 함수(optional 및 capitalizedWords)입니다. Sprig의 fail도 그중 하나이므로, 아래 “A value template failed while it ran (값 템플릿이 실행 중에 실패함)”에서 설명하듯 값 템플릿은 자체 메시지로 빌드를 중단할 수 있습니다. 어설션은 바로 그 목적으로 작성되는 표면이며, 빌드를 중단하는 것이 그 목적의 전부입니다. 이 세 가지 사이에서 다른 것은 누락 키 정책입니다. optional은 경로 템플릿에서도 사용할 수 있으며, 엄격한 정책이 먼저 작동하지 않은 상태로 .parameters에서 키를 읽습니다. source: 좌표 해석은 함수 집합 자체가 다르며, 아래에 별도의 하위 절이 있습니다. Aggregate의 매개변수 보간은 Sprig의 함수만 제공하므로, 그곳에서는 Aggrega 헬퍼를 둘 다 사용할 수 없습니다. 좌표와 보간을 포함해 이 모든 표면에서 같은 방식으로 읽히는 함수가 하나 있습니다. 바로 index로, 읽는 맵에 키가 없으면 그 키를 명시하며 중단합니다.

경로 템플릿 누락 시 출력되는 메시지는 해당 조건을 문서화하는 항목인 위의 “Path-template references a variable outside the allowlist (경로 템플릿이 허용 목록 밖의 변수를 참조함)” 아래에 인용되어 있으므로, 여기서 다시 쓰지 않고 한 번만 적습니다.

해결 방법: 경로 템플릿 누락의 경우, 필드 이름을 path-template-variables.md에 문서화된 허용 목록에 있는 이름으로 수정하십시오. 어설션 누락의 경우, 참조를 수정하거나(대부분의 보고는 키의 철자 오류입니다), 필드가 실제로 선택적이라면 hasKey로 보호하거나 optional 헬퍼를 사용하십시오. 단순 참조를 default로 감싸도 중단은 해소되지 않습니다. 폴백이 실행되기 전에 참조가 해석되기 때문입니다. index로 읽는 것도 마찬가지인데, index는 맵에 없는 키에 대해 중단하기 때문입니다. 빈 렌더링이 바람직하지 않은 값 템플릿 누락의 경우, optional 헬퍼를 사용하거나, 누락된 키를 Release 값이 있는 Aggregate의 타입이 지정된 parameters.* 선언으로, uses[].inject를 통해 연결된 상위 Component의 provides: 항목으로, 또는 같은 엔터티의 locals: 항목으로 제공하십시오.

source: 좌표를 해석하면 더 좁은 함수 집합이 등록됩니다

구조화된 source: 블록은 그것이 지정하는 아티팩트를 고정(pin)할 수 있도록 해석되며, 이 해석에는 Aggrega 자체 헬퍼만 등록되고 그 밖의 것은 등록되지 않습니다. optional과 capitalizedWords를 사용할 수 있고, index는 Recipe가 렌더링될 때와 똑같이 맵에 없는 키에서 중단됩니다. Sprig의 함수는 사용할 수 없습니다. Recipe나 FeatureRecipe가 템플릿을 작성하는 표면 가운데 함수 집합이 다른 곳은 이곳뿐이므로, 같은 Recipe의 다른 곳에서 올바르게 렌더링되는 표현식도 여기서는 거부될 수 있습니다. 더 좁은 집합은 의도된 것입니다. 무엇이 고정되는지는 작성자가 제공하는 values와 infra로 결정되어야 하는데, Sprig의 함수 중에는 시계, 환경, 난수 소스 또는 네트워크를 읽는 함수가 포함되어 있습니다.

source: 필드에서, 또는 그 필드가 읽는 locals: 항목에서 Sprig 함수를 호출하면 파싱 시점에 중단됩니다. 진단은 E0111로 시작하며, 해당 항목, 그 항목을 읽는 source: 필드, 해석하지 못한 함수, 그리고 이 표면이 실제로 등록하는 헬퍼를 명시합니다:

resolve: parse template at <name>:<version>.spec.locals.<key>, read by <name>:<version>.spec.source.<field>: resolve: source-template parse error (cause: template: <name>:<version>.spec.locals.<key>:1: function "<function>" not defined); a source field, and every locals entry it reads, is evaluated when the source is resolved with Aggrega’s own helpers only (optional, capitalizedWords and index), not the Sprig functions a render adds; write the value without that function, or move the value into a locals entry no source field reads

source: 필드가 직접 함수를 호출하는 경우에도 같은 방식으로 보고되며, 이때는 필드만 명시합니다.

범위는 좌표가 읽는 항목입니다. 좌표를 해석하면 source: 필드가 읽는 각 locals: 항목과, 그 항목이 다시 읽는 각 항목이 평가되며, 그 밖의 항목은 평가되지 않습니다. 어떤 source: 필드도 도달하지 않는 항목은 source를 해석하는 동안 평가되거나 파싱되거나 검사되지 않으므로, 렌더링에 필요한 local(Sprig 함수로 산술 연산을 하거나 .context.instance_id를 따라 리소스 이름을 짓는 local 등)은 아티팩트 고정에 아무런 영향을 주지 않습니다. 이러한 항목은 Recipe가 렌더링될 때 평가되고, 그 안의 결함도 그때 보고됩니다. 필드가 어떤 항목을 읽는지는 필드의 텍스트로 결정되므로, 특정 항목을 지정하지 않는 방식으로 .locals를 읽는 필드({{ index .locals "version" }}, 블록 전체를 optional에 넘기거나 변수에 바인딩하는 경우)는 모든 항목을 평가하게 되며, 그렇게 도달한 항목에 대한 진단에는 그 사실이 표시됩니다. 즉 read by <field> 대신 evaluated for <field>, which reads the locals block as a whole rather than by entry, so every entry is evaluated라고 표시됩니다.

두 가지 형태는 이 표면에 속하지 않으며, Recipe가 어느 형태인지 알면 같은 표현식이 어떤 Recipe에서는 허용되고 다른 Recipe에서는 거부되는 이유를 알 수 있습니다:

  • 일반 문자열로 작성된 source:(매핑이 아닌 URI나 로컬 경로)는 그대로 사용되므로 평가할 필드가 없으며, 여기서는 locals: 블록이 전혀 해석되지 않습니다.
  • source:를 선언하지 않는 엔터티는 좌표를 해석하지 않으므로, 그 locals: 블록은 해당 엔터티 자체의 렌더링에서만 해석되며, 그곳에서는 전체 함수 집합이 적용됩니다.

좌표가 읽는 모든 항목에 대해 참조 순서 계약은 여기서도 동일합니다. 좌표를 해석할 때는 평가하는 각 항목에서 렌더링이 거부하는 것과 같은 참조를 거부합니다. 즉 블록이 자신보다 아래에 선언하는 형제 항목을 읽는 항목과, 블록이 선언하지 않는 키를 읽는 모든 템플릿입니다. 둘 다 위의 “locals: entry references a sibling defined later in the same block (locals: 항목이 같은 블록에서 나중에 정의된 형제 항목을 참조함)”과 “locals: key does not exist (locals: 키가 존재하지 않음)”에 설명된 조건을 보고하며(어느 해석이 먼저 도달하든 같은 조건이고 해결 방법도 같습니다), 보고에는 해당 항목이 평가된 대상인 source: 필드가 명시됩니다. 어떤 source: 필드도 읽지 않는 항목의 결함은 Recipe가 렌더링될 때 같은 조건으로 거부됩니다.

이 표면이 실제로 건너뛰는 것은 좌표가 본질적으로 해석할 수 없는 항목입니다. 즉 아티팩트가 렌더링되는 동안에만 존재하는 데이터를 읽는 항목이며, .context.instance_id가 이를 위한 대표적인 경우입니다. 이러한 항목은 건너뛰므로, 좌표가 실행되지 않는 분기에서 그런 항목에 도달하는 Recipe도 여전히 고정됩니다. 좌표 자체가 그 항목을 필요로 한 경우에는 해석이 source: 필드를 명시하며 중단되고(위에서 이 표면에 대해 설명한, E0110으로 시작하는 누락 키 보고입니다), 읽지 못한 키와 함께 그 항목이 여기서 값을 갖지 않는 이유를 인용합니다:

resolve: evaluate template at <name>:<version>.spec.source.<field>: resolve: source-template evaluation failure at lock time (cause: template: … map has no entry for key "<key>"); it reads <name>:<version>.spec.locals.<key>, which could not be evaluated here (cause: template: … map has no entry for key "context")

source: 필드도, 그 필드가 읽는 locals: 항목도 .provides를 읽을 수 없습니다. locals: 블록은 provides: 블록에 값을 공급하며 그 반대는 없으므로, 이 표면에서 .provides를 읽는 템플릿은 빈 값으로 해석되는 대신 그 본질인 역방향 참조로서 거부됩니다. 이 거부는 이후 단계에서 충족될 잠금 시점의 부재가 아니므로(어떤 순서로도 이 참조는 유효해지지 않습니다), 좌표가 어디서 해석되든 같은 방식으로 보고됩니다. 진단은 E0112로 시작하며, 해당 필드 또는 항목과 그것을 읽는 필드를 명시하고, 참조의 문제점을 설명하며, 표현식이 대신 읽을 수 있는 표면을 제시합니다:

source-version template at <name>:<version>.spec.source.<field> references .provides, which is an invalid reverse reference (locals feed provides, never the reverse) — refactor to read only .values and .infra (and .locals over the same): resolve: source-template references .provides (invalid reverse reference)

중단이 나타나는 시점: lockfile을 채우거나 갱신하는 동안입니다. 즉 aggrega pull, 또는 lockfile을 채우는 빌드(--auto-pull, --upgrade, 또는 워크스페이스 auto_pull 설정)입니다. 각 실패는 하나의 진단으로 보고되며, 무엇이 잘못되었는지를 나타내는 코드로 시작합니다. 파싱되지 않는 템플릿은 E0111, .provides 참조는 E0112, 파싱은 되었지만 평가할 수 없는 템플릿은 E0110이며, 터미널과 aggrega serve에 연결된 편집기 모두에서 동일합니다. source: 필드의 누락 키는 사용할 수 없는 함수와 달리 파싱 시점이 아니라 실행 시점에 보고되며, 해당 필드와 읽지 못한 키를 명시합니다.

해결 방법: optional은 이 표면 그리고 모든 값 템플릿, 경로 템플릿, 어서션에 등록되어 있으므로 이식성 있는 선택입니다. {{ default "25.0.8" .values.chart_version }} 대신 {{ optional .values "chart_version" "25.0.8" }}를 사용하십시오. 바꾸기 전에 의미상의 차이를 확인하십시오. optional은 키가 없을 때 동작하고 default는 값이 비어 있을 때 동작하므로, 빈 문자열이나 0으로 작성된 키는 optional에서는 작성된 값을 유지하고 default에서는 대체됩니다. 표현식에 Sprig 함수가 꼭 필요한 경우(대체값을 제공하는 것이 아니라 문자열을 변형하는 경우)에는 좌표가 읽는 범위 밖에 두십시오. 즉 어떤 source: 필드도 읽지 않는 locals: 항목에 두거나, 그 값을 사용하는 표면(valuesMapping, Workload 본문, artifacts: 항목)에 두십시오.

A template indexes a map with a key the map does not hold (템플릿이 맵에 없는 키로 맵을 인덱싱함)

템플릿이 index를 통해 맵을 읽는데({{ index .values "replicas" }}, 또는 템플릿이 계산한 키 이름을 쓰는 {{ index .context.inject.env $apiKeyVar }}), 요청한 키가 맵에 없는 경우입니다. index는 그 지점에서 중단하고 키 이름을 알려 주며, 이는 템플릿을 평가하는 모든 표면에서 동일합니다. 값 템플릿, locals: 및 provides: 항목, 경로 템플릿, 어설션, 구조화된 source: 좌표, Aggregate의 파라미터 보간과 그 파라미터의 validate: 술어, 그리고 스키마의 x-aggrega-when: 및 x-aggrega-validate: 술어가 이에 해당합니다.

이는 index만의 특성이며, 어떤 표면의 누락 키 정책도 이를 바꾸지 않습니다. 앞의 “Missing template key — asymmetric policy (누락된 템플릿 키 — 비대칭 정책)”에서 설명한 대로, 열린 필러에서 설정되지 않은 키를 점 표기로 읽으면 값 템플릿에서는 여전히 아무것도 렌더링되지 않으며, 작성자가 그런 키를 제공했는지 검사하는 템플릿은 영향을 받지 않습니다. 중단되는 것은 맵에 없는 키를 index에 요청하는 경우입니다. index는 템플릿이 이름을 계산하는 키에 접근하는 방법입니다. 예를 들어 소비하는 Recipe가 정한 변수 이름으로 자격 증명을 읽는 경우입니다. 중단이 없다면 그 읽기는 빌드가 성공한 채로 템플릿 엔진의 자리 표시자 텍스트 <no value>를 아티팩트에 넣게 됩니다. 즉 그 텍스트를 키로 삼아 서버가 시작됩니다. index가 내놓는 다른 모든 결과는 템플릿 엔진 자체의 것입니다. 리스트나 문자열의 위치, 범위를 벗어난 위치, 맵에 있는 키가 그렇습니다. 값이 null인 키도 포함되며, 이 경우 <no value>가 출력됩니다.

보고의 마지막 줄로 출력되는 메시지입니다. 그 위의 프레임은 노드와 템플릿이 있는 필드를 알려 주며, Recipe 또는 FeatureRecipe 값 템플릿에서는 헤드에 이 조건의 코드가 붙습니다:

template: <template>:<line>:<column>: executing "<template>" at <index <map> <key>>: error calling index: template indexes a map with a key the map does not hold (key "<key>"). read a key that may be absent through a function that tests for it first, such as optional, get or hasKey (템플릿이 맵에 없는 키로 맵을 인덱싱합니다. 없을 수 있는 키는 optional, get, hasKey처럼 먼저 키의 존재를 확인하는 함수를 통해 읽으십시오)

템플릿 실패를 자체 조건으로 보고하는 표면, 즉 provides: 항목(“A provides: template could not be evaluated (템플릿을 평가할 수 없음)”), 파라미터 보간(“A {{ .parameters.* }} reference cannot be interpolated (참조를 보간할 수 없음)”), 스키마 술어(“An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (술어를 평가할 수 없음)”), source: 좌표(“Resolving a source: coordinate registers a narrower function set (좌표를 해석하면 더 좁은 함수 집합이 등록됨)”)에서는 헤드에 해당 조건의 코드가 붙고, 위의 줄은 키를 포함하여 그 조건이 담는 이유가 됩니다.

해결 방법: 키가 정당하게 없을 수 있는지 판단하십시오.

  • 없을 수 있는 경우. 먼저 존재 여부를 검사하는 함수를 통해 읽으십시오. {{ optional .values "replicas" 1 }}은 키가 없으면 대체값을, 있으면 그 값이 무엇이든 그 값을 반환합니다. Sprig의 get은 없는 키에 대해 빈 문자열을 반환하고, hasKey는 읽지 않고 검사합니다. optional은 파라미터 보간과 파라미터 또는 스키마의 술어를 제외한 모든 표면에 등록되어 있으며, 그 예외 표면에서는 Sprig의 get과 hasKey를 제공합니다. source: 좌표에는 optional이 등록되고 Sprig는 등록되지 않습니다.
  • 없으면 안 되는 경우. 키를 제공하십시오. 메시지가 알려 주는 키는 템플릿이 요청한 키이므로, 흔한 원인은 다른 이름으로 게시된 키(key가 Recipe가 읽는 변수 이름과 다른 자격 증명), 템플릿이나 작성된 값의 키 오타, 그리고 키를 전달할 연결이 구성되지 않은 경우입니다.

A template reads and iterates a path that holds nothing (템플릿이 아무것도 담고 있지 않은 경로를 읽고 반복함)

템플릿이 경로를 있는 그대로 출력하는 동시에 같은 경로를 순회합니다. 예를 들어 하나의 valuesMapping에 "user": "{{ .values.user }}"와 "users": "{{ range .values.user }}…{{ end }}"가 함께 있는 경우입니다. 그런데 데이터가 그 위치에 아무것도 담고 있지 않습니다. 즉 키가 설정되지 않았거나, null을 담고 있거나, 컨텍스트가 정의하지만 아무것도 담지 않는 최상위 필드입니다. 예를 들어 워크로드를 합성하지 않는 Recipe의 .workload가 그렇습니다. 빌드는 템플릿이 실행되기 전에 중단되고 그 경로를 명시합니다. 이는 설정되지 않은 값을 아무것도 없는 것으로 렌더링하는 모든 곳에서 적용됩니다. 즉 위의 “Missing template key — asymmetric policy (템플릿 키 누락 — 비대칭 정책)”에 나열된 값 템플릿과 Aggregate의 매개변수 보간입니다.

각 읽기는 단독으로는 답이 있습니다. 출력되는 설정되지 않은 값은 아무것도 렌더링하지 않고, 순회되는 값은 아무것도 반복하지 않습니다. 두 방식으로 모두 읽히는 경로는 어느 쪽 답도 가질 수 없습니다. 아무것도 없는 것으로 렌더링하면 range가 텍스트에서 실패하게 되고, 설정되지 않은 상태로 두면 빌드가 성공하는 동안 템플릿 엔진의 자리 표시자 텍스트 <no value>가 아티팩트에 출력됩니다. 그래서 어느 답도 주어지지 않고 대신 빌드가 멈춥니다.

경로를 출력하는 것으로 간주되는 범위는 좁으며, 템플릿이 확실히 그것을 출력하는 곳에 선이 그어집니다:

  • 출력되는 경우는 액션이 경로만으로 이루어지고 다른 것은 없을 때입니다. {{ .values.user }}, {{ $.values.user }}, {{ (.values).user }}, 또는 경로에 바인딩된 변수, 즉 {{ $u := .values.user }} 다음의 {{ $u }}가 템플릿이 실행될 때마다 도달하는 지점에 있는 경우입니다.
  • 출력되지 않는 경우는 읽기가 if, with 또는 range 본문 안이나 else 분기 안에 있을 때입니다. 그 읽기가 실행되는지 여부는 조건에 달려 있고, 그 조건이 바로 읽기가 아무것도 없는 값을 만나지 않도록 막는 테스트일 수 있기 때문입니다. 따라서 range .values.user 옆의 {{ if .values.user }}{{ .values.user }}{{ end }}는 항상 그랬듯이 렌더링됩니다. 또한 가드 자체의 테스트, 변수 할당, 또는 함수의 인수인 경우 — {{ .values.user | quote }}, {{ toYaml .values.user }} — 에도 출력으로 간주되지 않습니다. 그 출력은 자리 표시자가 아니라 함수의 답이기 때문입니다.

실제로 실행되는 본문 안에서 아무것도 담고 있지 않은 경로를 출력하면 여전히 <no value>가 기록되며, 이 검사는 거기까지 미치지 않습니다. 경로의 한 표기는 다른 모든 표기와 같은 경로이므로, 한 표기로 된 출력과 다른 표기로 된 range는 함께 판단되며, 메시지는 템플릿이 먼저 작성한 표기를 인용합니다. 값을 담고 있는 경로는 항상 그랬듯이 출력되고 반복되며, 부모가 아무것도 담고 있지 않은 경로는 아무것도 없는 값을 따라 내려갈 때 이미 발생하는 중단에 맡겨집니다.

출력되는 메시지이며, 보고서의 마지막 줄로 나타납니다. 그 위의 프레임은 노드와 템플릿을 명시하고, 머리에는 이 조건의 코드가 붙습니다:

template reads a path as a value and iterates it, and the data holds nothing at that path (path <path>). supply a value at the path, guard the printed read with an if or with over the path, or read it one way only (템플릿이 경로를 값으로 읽으면서 반복하는데, 데이터가 그 경로에 아무것도 담고 있지 않습니다. 경로에 값을 제공하거나, 출력되는 읽기를 그 경로에 대한 if 또는 with로 보호하거나, 한 가지 방식으로만 읽으십시오)

Aggregate의 매개변수 보간도 같은 줄을 이 조건의 코드로 보고합니다. provides: 항목은 템플릿 실패를 “A provides: template could not be evaluated (템플릿을 평가할 수 없음)” 아래에서 보고하므로, 그 경우 머리에는 그 조건의 코드가 붙고 위의 줄은 경로를 포함하여 그 조건이 담는 이유가 됩니다.

해결 방법: 템플릿이 두 가지 읽기 중 어느 것을 의도하는지 결정하십시오.

  • 경로가 반드시 있어야 하는 경우. 경로를 제공하십시오. Aggregate의 values:, Release의 infra:, 또는 Release가 채우는 매개변수에 제공하거나, 그것을 관리하는 스키마에서 필수로 선언하여 누락이 작성된 곳에서 보고되도록 하십시오.
  • 경로가 없어도 되는 경우. 출력되는 읽기를 보호하십시오. {{ with .values.user }}{{ . }}{{ end }} 또는 {{ if .values.user }}{{ .values.user }}{{ end }}는 경로가 설정되지 않았을 때 아무것도 출력하지 않으며, 그 옆의 range는 계속 아무것도 없는 것으로 반복합니다.
  • 읽기 하나로 충분한 경우. 경로를 한 가지 방식으로만 읽으십시오. 필요한 것도 함께 기록하는 range를 쓰거나, toYaml이나 join처럼 설정되지 않은 값에 대해 스스로 답을 내는 함수를 통해 출력하십시오.

A value template failed while it ran (값 템플릿이 실행 중에 실패함)

Recipe 또는 FeatureRecipe의 값 템플릿(위의 “Missing template key — asymmetric policy (누락된 템플릿 키 — 비대칭 정책)”가 나열하는 템플릿 중 하나로, Workload 본문, artifacts: 본문, locals: 항목 등이 포함됩니다)이 파싱되고 실행을 시작했지만 텍스트를 생성하기 전에 멈췄습니다. 멈춘 원인은 템플릿 엔진 자체의 이유이며, 중단 보고는 그 아래에 이를 담습니다. 아무것도 제공되지 않은 컨테이너를 통과해 내려가는 참조(예: tls가 작성되지 않았는데 {{ .values.tls.ca }}를 참조하는 경우), 두 가지 유형의 값 비교(예: {{ if eq .context.instance_id 1 }}는 텍스트와 숫자를 비교하여 cannot compare text with a number로 중단됩니다), 또는 Sprig의 fail 호출입니다. 값 템플릿은 자체 메시지로 입력을 거부하기 위해 이를 호출할 수 있습니다.

이러한 템플릿에서 발생하는 네 가지 실패는 대신 각자의 조건 아래에서 보고됩니다. provides: 항목은 아래의 “A provides: template could not be evaluated (템플릿을 평가할 수 없음)” 아래에서 보고되며, 그 메시지 안에 이 문장과 엔진의 이유가 담깁니다. 맵에 없는 키를 index로 읽는 경우는 위의 “A template indexes a map with a key the map does not hold (템플릿이 맵에 없는 키로 맵을 인덱싱함)” 아래에서 보고됩니다. 아무것도 담고 있지 않은 하나의 경로를 출력하고 순회하는 템플릿은 실행되기 전에 거부되며, 위의 “A template reads and iterates a path that holds nothing (템플릿이 아무것도 담고 있지 않은 경로를 읽고 반복함)” 아래에서 보고됩니다. 그리고 파싱되지 않는 템플릿은 실행되기 전에 멈추므로 이 조건에 해당하지 않습니다.

출력되는 메시지입니다. 그 위의 프레임이 컴포넌트 인스턴스와 템플릿(예: recipe "<recipe>" workload template 또는 Recipe "<recipe>" locals["<key>"])을 지정하고, 템플릿 엔진 자체의 줄이 그 아래에 이어집니다.

a value template failed while it ran (값 템플릿이 실행 중에 실패했습니다)

엔진의 줄은 template: <template>:<line>:<column>: executing "<template>" at <<expression>>: <reason> 형식이며, fail 호출의 경우 error calling fail: <the message the template wrote>입니다. 템플릿은 Recipe 또는 FeatureRecipe 작성자가 작성하므로, 빌드는 이 중단을 CATALOG_ERROR 태그로 보고합니다. aggrega pull은 읽어 들이는 외부 입력을 찾기 위해 Release를 렌더링할 때 같은 실패를 만납니다. 이때 실패를 보고하고, 그래도 잠금 파일의 의존성 고정을 기록하며, 외부 입력 고정이 불완전할 수 있다고 알립니다. 빌드는 이 실패에서 중단됩니다.

해결 방법: 보고서 끝에 있는 엔진의 이유를 읽습니다. 템플릿, 줄과 열, 그리고 멈춘 표현식이 지정되어 있습니다. 아무것도 제공되지 않은 컨테이너라면 그것을 제공하거나, 없는 것 안으로 결코 내려가지 않도록 읽기를 보호합니다({{ with .values.tls }}{{ .ca }}{{ end }} 또는 optional 헬퍼). 두 유형을 비교한 경우에는 같은 것끼리 비교합니다. 숫자는 따옴표 없이 쓴 숫자와, 텍스트는 따옴표로 쓴 텍스트와 비교하거나, toString으로 한쪽을 텍스트로 바꿉니다. fail 호출이라면 메시지는 템플릿 작성자의 것이며, 해당 Recipe가 무엇을 필요로 하는지 알려 줍니다. 그것을 제공하거나, 작성한 내용을 받아들이는 Recipe에 컴포넌트를 매핑합니다.

A governance plugin rejected the build (거버넌스 플러그인이 빌드를 거부함)

운영자는 컴파일러가 구축한 그래프나 렌더링한 아티팩트에 대해 판정 역할로 거버넌스 플러그인을 연결할 수 있습니다. 이런 플러그인은 읽고 판정을 반환합니다. 호스트에는 플러그인에서 돌아온 변경을 적용할 경로가 없으므로, 판정 역할은 빌드를 거부할 수는 있어도 빌드를 준수하도록 고쳐 쓸 수는 없습니다. 거부가 할 수 있는 전부이며, 무엇을 바꿀지는 그것을 읽는 사람에게 맡겨집니다.

빌드를 멈추는 것은 halt 판정뿐입니다. warn과 info 판정은 보고되고 빌드는 계속됩니다. 플러그인이 반환한 모든 halt 판정은 플러그인이 내보낸 순서대로 보고되므로, 한 번의 실행으로 전부 알 수 있습니다.

빌드가 출력하는 메시지는 플러그인 자체의 것으로, 반환된 그대로 표시되고 반환한 플러그인 정보로만 감싸집니다. 따라서 메시지가 얼마나 구체적이고 실행 가능한지는 컴파일러가 아니라 플러그인이 결정합니다. 판정에 선택적 세부 정보가 있으면 대괄호 안에 각 부분의 이름과 함께 이어집니다. 코드, 규칙 식별자, 분류, 소스 참조, 위치, 제안이 그것입니다. 기록되는 조건은 policy violation이며, 진단 헤드의 짧은 코드도 이것으로 해석됩니다.

거부는 문서가 아니라 거버넌스 연결에 귀속되므로 파일 위치가 없습니다. 이를 만들어 낸 키가 없으며, 해결책은 정책을 충족하거나 연결을 재검토하는 것입니다.

출력되는 메시지:

policy plugin "<plugin>" rejected the build: <the plugin's own message> [code=<code>; rule_id=<rule>; classification=<class>; source_ref=<reference>; location=<where>; suggest=<suggestion>] (정책 플러그인이 빌드를 거부했습니다)

대괄호 부분은 판정에 세부 정보가 있을 때만 나타나며, 그 안의 각 부분도 플러그인이 설정한 경우에만 나타납니다.

해결 방법: 플러그인의 메시지와, 제공된 경우 제안을 읽으십시오. 지적이 옳다면 문제로 지적된 부분을 바꾸십시오. 정책이 이 Release에 적용되지 말아야 한다면 이는 연결에 관한 문제입니다. 거버넌스 연결은 워크스페이스 구성의 plugins.governance 아래에서 구성되며, 어떤 플러그인이 어떤 역할로 실행될지는 문서가 재정의할 수 있는 것이 아니라 운영자가 결정합니다.

A governance attachment’s settings do not match the plugin’s declared schema (거버넌스 연결의 설정이 플러그인이 선언한 스키마와 일치하지 않음)

거버넌스 플러그인은 연결이 전달하는 설정에 대한 스키마를 선언할 수 있습니다. 연결의 with.settings 아래에 작성된 설정은 플러그인이 디스패치되기 전에 그 스키마로 검사됩니다. 따라서 잘못 구성된 연결은 형태가 잘못된 입력으로 플러그인에 전달되어 플러그인이 해석한 대로 돌아오는 대신, 있는 그대로 구성 오류로 보고됩니다.

이 순서가 검사의 핵심입니다. 또한 이 때문에 거부와 명확히 구별됩니다. 플러그인은 실행되지 않았고, 판정도 내려지지 않았으며, 빌드에 대해 아무것도 판단되지 않았습니다. 설정 스키마를 선언하지 않은 플러그인은 어떤 설정이든 받아들이므로, 그런 플러그인에 대한 연결에서는 이 조건이 발생하지 않습니다.

검사는 모든 거버넌스 역할에 적용됩니다. ir-verdict, render-verdict, label-transform 또는 annotation-transform에 작성된 연결은 플러그인이 디스패치되기 전에 설정이 스키마로 검사됩니다. with.settings는 모든 역할에서 같은 작성 키이며, 모든 역할이 먼저 스키마로 이를 검사합니다. 변환 역할은 빌드가 그것을 적용하는 곳에서 실행되며, 먼저 풀을 수행하는 빌드에서는 그 풀 중에 실행됩니다. 따라서 그곳의 메시지는 auto-pull: label-transform:처럼 그것을 디스패치한 단계로 시작합니다.

출력되는 메시지입니다. 연결이 작성된 역할과 연결이 지정한 플러그인, 고정 문장, 그리고 스키마 검사 결과 순으로 나옵니다:

ir-verdict: plugin "<the attachment's uri>": with.settings does not satisfy the plugin’s declared settings schema: <what the schema check found>: policy attachment settings do not satisfy the plugin’s declared settings schema (정책 연결 설정이 플러그인이 선언한 설정 스키마를 충족하지 않음)

해당 역할에 작성된 연결의 경우 앞부분은 render-verdict가 됩니다. 스키마 검사 결과는 스키마 검증기 자체의 보고이며 여러 줄에 걸칩니다.

해결 방법: plugins.governance에서 해당 연결의 with.settings 아래 설정을 수정하십시오. 메시지 중간의 세부 정보가 문제가 된 키와 그 위치에서 스키마가 기대한 내용을 알려 줍니다. 플러그인이 선언하는 설정은 플러그인 자체의 참조 문서에 설명되어 있습니다.

A pipeline step failed (파이프라인 단계가 실패함)

FeatureRecipe는 파이프라인을 선언할 수 있습니다. 파이프라인은 단계의 순서열이며, 각 단계는 노드가 출력한 문서에 대해 플러그인 export를 디스패치하므로 Feature가 컴포넌트 자체의 Recipe가 생성한 출력을 가공할 수 있습니다. 이 조건은 단계가 실패할 때, 문서 집합에 없는 것을 패치가 지정하는 경우를 제외한 모든 이유로 보고되는 조건입니다. 그 경우는 아래에 별도의 보고가 있습니다.

실패한 대상은 단계의 id와 인덱스로 명명되며, 뒤따르는 절이 어느 부분이 실패했는지 알려 줍니다. 단계의 with 입력 렌더링, 호출 자체, 호스트가 읽을 수 없는 출력, 플러그인이 반환한 오류, 플러그인이 내보낸 error 심각도 진단, 패치 엔진이 거부한 패치, 또는 순회에 없는 범위를 지정한 패치입니다.

실패한 단계는 전체가 롤백됩니다. 문서는 단계 실행 전 상태로 복원되고 단계 자체의 출력도 함께 폐기되므로, 이후 단계의 when이나 with는 부분적인 결과를 읽을 수 없습니다. 그런 다음 optional: true로 선언된 단계는 경고로 보고되고 순회가 계속되며, optional이 아닌 단계는 빌드를 중단합니다. optional:이 허용하지 않는 것은 선언된 계약의 위반입니다. 아래 항목을 참조하십시오.

출력되는 메시지:

pipeline step failed: step "<id>" (index <n>) with: <what the render could not do> pipeline step failed: step "<id>" (index <n>) invoke: <what the call could not do> pipeline step failed: step "<id>" (index <n>) error diagnostic: <the plugin's message> pipeline step failed: scope "<scope>" key "<key>": <what the patch engine refused> pipeline step failed: unknown patch scope "<scope>"

해결 방법: 단계 id를 읽은 다음 인덱스 뒤의 절을 읽으십시오. 이 절은 단계의 어느 쪽을 살펴봐야 하는지 알려 줍니다. with 실패는 단계 자체의 with: 블록에 있는 템플릿 문제이며 작성자가 수정해야 합니다. error 진단은 입력에 대한 플러그인 자체의 설명입니다. 거부된 패치와 알 수 없는 범위는 노드가 출력한 것에 대한 플러그인의 출력 문제이며 플러그인 작성자가 수정해야 합니다. 단계가 실제로 실패해도 되는 경우, 즉 필수 변환이 아닌 선택적 보강인 경우에는 optional: true로 선언하십시오. 단, 이는 실패를 허용할 뿐 깨진 계약을 허용하지는 않는다는 점에 유의하십시오.

A pipeline step’s typed input or output does not satisfy its declared contract (파이프라인 단계의 타입 지정 입력 또는 출력이 선언된 계약을 충족하지 않음)

플러그인 export는 받는 입력과 반환하는 출력에 대한 스키마를 선언할 수 있습니다. 둘 다 검사됩니다. 렌더링된 with 값은 호출 전에, 반환된 출력은 호출 후에 검사됩니다. 공유 계약이 선언하지 않은 심각도의 진단도 같은 기준으로 거부됩니다.

이는 optional: true로 선언된 단계에서도 중단됩니다. 이 구분이 바로 이 조건이 단계 실패와 별도로 존재하는 이유의 전부입니다. optional은 제 역할을 하지 못한 단계, 즉 실패한 호출이나 이의를 제기한 플러그인을 허용합니다. 호스트가 라우팅할 수 없는 출력이나 export가 받는다고 밝힌 형태가 애초에 아니었던 입력은 허용하지 않습니다. 선언된 계약은 약속이며, 계약이 깨진 단계를 조용히 건너뛴 빌드는 아무것도 하지 않은 Feature에 대해 성공을 보고하게 됩니다.

출력되는 메시지:

pipeline step "<id>" with input does not satisfy the declared input contract: <what the schema check found>: pipeline step typed-I/O contract violation (파이프라인 단계의 with 입력이 선언된 입력 계약을 충족하지 않음) pipeline step "<id>" returned outputs that do not satisfy the declared output contract: <what the schema check found>: pipeline step typed-I/O contract violation (파이프라인 단계가 선언된 출력 계약을 충족하지 않는 출력을 반환함)

그리고 계약이 선언하지 않은 진단 심각도의 경우, 단계 실패 프레임 안에서 다음과 같이 출력됩니다:

pipeline step failed: step "<id>" (index <n>): <the severity the host could not route>: pipeline step typed-I/O contract violation (파이프라인 단계 타입 지정 I/O 계약 위반)

단계의 with 템플릿이 민감한 것으로 선언된 값을 읽는 경우, 입력 위반은 값을 명시하지 않습니다. 스키마 검사 결과는 실패한 각 위치와 이를 거부한 키워드로 대체되고, 이유를 밝히는 안내로 끝납니다(at '/origin': pattern (the value is withheld because the template that rendered this input reads a value declared sensitive)). 따라서 수정할 필드는 여전히 명시됩니다. vocabulary/compact-form-authoring.md의 “What a refusal says about a declared value”를 참조하십시오.

해결 방법: 입력 위반의 경우, export가 선언한 스키마에 맞게 단계의 with: 블록을 수정하십시오. 세부 내용에 필드와 기대된 값이 명시됩니다. 출력 위반과 선언되지 않은 심각도는 플러그인이 수정해야 합니다. 단계의 선언이 잘못된 것이 아니므로 optional로 표시해도 어느 쪽도 해결되지 않습니다.

A pipeline patch addresses a document the set does not hold, or one with no tree to address (파이프라인 패치가 집합에 없는 문서 또는 지정할 트리가 없는 문서를 지정함)

파이프라인 단계는 범위와 키로 문서를 지정하며, 두 가지 형태의 지정이 거부됩니다.

집합에 해당 문서가 없는 경우. 단계가 전달받은 문서에 없는 범위-키 쌍을 패치했습니다. 편집될 것이 없으므로, 아무것도 없는 대상에 패치를 적용하고 성공을 보고하는 대신 순회가 중단됩니다:

pipeline patch targets a document not present in the set: scope "<scope>" key "<key>" (파이프라인 패치가 집합에 없는 문서를 대상으로 함)

지정할 트리가 없는 경우. 일부 단위에는 패치가 가리킬 수 있는 구조가 없습니다. 바이너리 본문, 자유 텍스트, provider가 안전하게 순회할 수 없는 영역 등입니다. 이러한 단위도 미디어 타입과 바이트가 태그된 채 단계에 전달되므로 선택하여 통째로 출력할 수는 있지만, 경로가 해석될 대상이 없으므로 패치할 수는 없습니다. 이러한 단위에 대한 패치는 조용히 건너뛰지 않고 중단됩니다:

pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>" (파이프라인 패치가 불투명한(비구조화) 단위를 대상으로 함)

무엇이 구조화된 것으로 간주되는지는 고정된 검사가 아니라 provider 자체의 단위 해석에 따르므로, 같은 내용이라도 한 provider에서는 지정할 수 있고 다른 provider에서는 불투명할 수 있습니다.

둘 다 순회 자체의 거부이며, 빌드는 패치를 수행한 파이프라인의 노드에 대해 이를 보고하므로 위 메시지는 해당 노드를 명시하는 중단 아래에 출력됩니다. 그 중단은 같은 두 가지 지정 오류의 빌드 중단 형태로, 아래 “A pipeline step addresses documents the node does not have (파이프라인 단계가 노드에 없는 문서를 지정함)”에 설명되어 있습니다. 그 항목은 단계가 아무것도 지정하지 못하는 세 번째 경우, 즉 어떤 호스트 컴포넌트에도 대응하지 않는 위치에서 호스트 컴포넌트의 문서를 요청하는 경우도 다룹니다.

해결 방법: 둘 다 작성자가 아니라 플러그인 작성자가 수정해야 합니다. 단계는 실행 대상인 문서 집합을 받으며 그 안에 어떤 키가 있는지 읽을 수 있으므로, 대상이 없다는 것은 단계가 이 노드가 출력하지 않은 문서를 지정했다는 뜻입니다. 존재하는 문서를 패치하거나, 의도한 문서를 먼저 출력한 뒤 이후 단계에서 패치하십시오. 불투명한 단위의 경우 패치를 단위 전체의 출력으로 바꾸십시오. 불투명한 본문은 편집되지 않고 대체됩니다.

패치의 test 연산이 문서와 일치하지 않음

패치는 test 연산을 포함할 수 있으며, 이 연산은 뒤따르는 연산이 적용되기 전에 어떤 경로에 무엇이 있는지 단언합니다. 단언이 성립하지 않으면 엔진은 패치 전체를 거부합니다. 이 때문에 조건부 패치는 낙관적인 패치가 아니라 진정한 조건부 패치가 됩니다. 편집하기 전에 테스트하는 플러그인은 자신이 알아보지 못하는 문서는 건드리지 않겠다고 말하는 것입니다.

이 조건으로 보고되는 형태는 두 가지입니다. 경로에 아무것도 없는 경우이며, 메시지가 이를 알려 줍니다. 또는 값이 있지만 단언한 값이 아닌 경우이며, 이는 단순한 거부로 보고됩니다. 단언한 값도, 발견된 값도 인용되지 않습니다.

출력되는 메시지:

jsonpatch: test operation failed: no value at path jsonpatch: test operation failed

파이프라인 단계의 출력이 패치를 담고 있었다면, 거부는 해당 단계의 실패 아래에 단계를 명시하며 나타납니다. 레이블 변환 플러그인의 패치가 담고 있었다면, 레이블 패치 거부 아래에 나타납니다.

해결 방법: 결함은 문서가 아니라 플러그인에 있습니다. 문서에 없는 값을 기대한 테스트는 대개 플러그인이 작성 대상이 아닌 형태, 즉 다른 provider의 출력이나 같은 파이프라인의 앞선 단계가 이미 변경한 문서에 대해 실행되고 있다는 뜻입니다. 패치를 직접 수정할 수 있다면, 테스트를 문서가 실제로 담고 있는 내용에 맞게 완화하거나, 패치 안에서 테스트하는 대신 단계의 when 게이트가 해당 경우를 건너뛰도록 하십시오.

workload: 형식과 그 옆의 필드가 일치하지 않음

workload:는 form:을 선언합니다. 이는 실행되는 대상의 형태를 특정 대상 하나의 어휘가 아니라 모든 대상이 이해하는 용어로 나타낸 것입니다. 일부 필드는 한 형식에서만 의미가 있으며, 필요한 필드 없이 선언된 형식은 일관되게 렌더링할 내용이 없습니다. 어느 대상이 workload를 변환하기 전에 양방향이 모두 검사되므로, 불일치는 각 대상이 쓰는 표현으로 대상마다 한 번씩 보고되는 것이 아니라 작성한 내용에 대해 한 번만 보고됩니다.

다섯 가지 조합이 검사되며, 각각은 양쪽 절반과 작성할 내용을 명시하는 고유한 문장으로 보고됩니다:

workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule

각각은 workload를 읽던 component 인스턴스 위치에 표시되며, 불일치가 작성된 한 블록의 두 필드 사이에 있으므로 변환 결함으로 보고됩니다.

이들이 기록되는 조건, 즉 단축 코드가 가리키는 조건은 persistentTemplate volume requires form: stateful, form: reference requires an endpoint, endpoint requires form: reference, form: scheduled requires a schedule, schedule requires form: scheduled입니다.

한 조합은 한 방향으로만 검사됩니다. 레플리카별 클레임 템플릿이 없는 form: stateful workload는 평범한 것이며 아무것도 보고되지 않습니다. 규칙은 클레임 템플릿이 그 형식만 제공하는 안정적인 레플리카별 식별자를 필요로 한다는 것이지, 그 형식이 클레임 템플릿을 필요로 한다는 것이 아닙니다. 나머지 두 조합은 양방향으로 검사됩니다. endpoint와 schedule은 각각 의미를 갖는 형식이 정확히 하나뿐이기 때문입니다.

두 endpoint 짝은 Workload 스키마에도 들어 있습니다. 따라서 둘 중 하나를 어기는 workload는 위의 문장에 도달하기 전에 스키마 단계에서 E0214로 거부됩니다. reference 이외의 형식(생략된 form:도 stateless로 읽히므로 포함됩니다)에 있는 endpoint:는 다음과 같이 거부됩니다.

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here (workload 검증 실패(스키마 단계): endpoint 값이 여기서 허용되지 않는 형태와 일치함)

그리고 endpoint:가 없는 form: reference는 대신 .endpoint: missing required property: endpoint로 끝납니다. 해결 방법은 그 짝의 문장이 제시하는 것과 같습니다.

해결 방법: 각 문장은 두 필드를 명시하고 두 가지 해결책을 모두 제시합니다. 형식에 필요한 필드를 추가하거나, 형식을 해당 필드가 속하는 형식으로 바꾸거나, 편집 후 남겨진 필드라면 제거하십시오. schedule: 값을 지우고 키를 남겨 두는 것이 이 오류를 가장 흔히 일으키는 형태입니다.

워크로드 schedule:이 검사가 허용하는 표현식이 아님

form: scheduled workload는 언제 실행되는지를 나타내는 schedule:을 담고 있으며, 이 값은 어느 대상이 읽기 전에 구조가 검사됩니다. 허용되는 표기는 두 가지입니다. 다섯 가지 매크로 @hourly, @daily, @weekly, @monthly, @yearly 중 하나이거나, 필드가 숫자와 문자 *, ,, -, /만 사용하는 5필드 crontab 표현식입니다.

검사가 읽는 것과 읽지 않는 것. 검사는 필드 수를 세고 필드 안의 문자를 확인합니다. 범위, 단계 연산, 요일 이름은 평가하지 않으므로, 숫자가 범위를 벗어난 5필드 표현식은 여기서 통과하며 이를 거부하는 것은 대상의 몫입니다. 앞에 초 필드가 붙은 6필드 표현식은 거부됩니다. 이 표면이 허용하는 것은 5필드이며, 초가 필요한 대상은 다른 방법으로 받습니다.

출력되는 메시지:

workload schedule is not a valid cron expression; use a 5-field crontab expression (e.g. “0 0 * * *”) or one of @hourly, @daily, @weekly, @monthly, @yearly

이 오류가 기록되는 조건은 schedule is not a valid cron expression이며, 단축 코드가 가리키는 것이 이 조건입니다.

해결 방법: 먼저 필드 수를 세어 보십시오. 필드가 네 개 또는 여섯 개인 schedule이 가장 흔한 원인이며, 한 필드 안에 잘못 들어간 공백은 그 필드를 둘로 나눕니다. 요일이나 월 이름은 숫자로 바꾸고, 의도한 바를 나타내는 매크로가 있다면 매크로를 사용하십시오.

A workload suspend: is set on a form other than scheduled (workload의 일시 중지 필드가 예약 실행 이외의 형식에 설정됨)

suspend: true는 form: scheduled workload의 반복 일정을 보류합니다. 예약된 리소스는 렌더링되지만, 재개될 때까지 그 일정에 따라 시작되는 실행은 없습니다. 다른 형식은 일정을 지니지 않으므로, 다른 형식에서는 이 필드가 보류할 대상이 없으며, 빌드는 이 필드를 조용히 버리는 workload를 렌더링하지 않고 중단됩니다. 이 검사는 다른 형식 짝 검사와 함께, 어떤 대상이 workload를 변환하기 전에 실행되며, 여기서도 생략된 form:은 stateless로 읽힙니다.

출력되는 메시지:

workload declares suspend but is not form: scheduled; declare form: scheduled with a schedule or remove suspend (workload가 suspend를 선언했지만 form: scheduled가 아닙니다. schedule과 함께 form: scheduled를 선언하거나 suspend를 제거하십시오)

이 결과는 workload를 읽고 있던 컴포넌트 인스턴스에 위치하며, 변환 결함으로 보고됩니다. 기록되는 조건은 suspend requires form: scheduled이며, 짧은 코드가 해석되는 대상이 바로 이것입니다.

이 규칙은 한 방향으로만, 그리고 true일 때만 적용됩니다. suspend:가 없는 form: scheduled workload는 평범한 경우로 일정에 따라 실행되며, 기본값인 suspend: false는 어떤 형식에서도 아무것도 유발하지 않습니다.

해결 방법: workload가 누군가 시작할 때만 실행되도록 의도했다면 schedule:이 있는 form: scheduled로 만들고 suspend: true를 유지합니다. 그렇지 않다면 작성한 형식을 유지하고, 다른 어떤 형식도 읽지 않는 suspend:를 제거합니다.

라이브러리 $import:가 bare-name 형식으로 작성되지 않았습니다

Recipe와 FeatureRecipe의 세 필드는 본문을 그 자리에 작성하는 대신 라이브러리에서 가져올 수 있습니다. artifacts.<name>: 항목, valuesMapping:, 그리고 workload:입니다. 각 필드는 $import:에 라이브러리의 bare name을 쓰고, 이어서 #, 그다음 해당 필드가 읽는 표면상의 항목 경로를 씁니다. 각각 #/artifacts/, #/mappings/, #/workloads/입니다. 이 형식이 아닌 값은 빌드가 해석할 수 있는 어떤 것도 가리키지 않으며, 필드가 해석될 때 거부됩니다.

세 필드는 의도적으로 서로를 그대로 반영하도록 설계되어 있으므로, 오류는 세 필드 모두에서 같은 내용으로 표시되고 표면만 달라집니다:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>" valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>" workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>"

@로 작성된 버전은 라이브러리를 찾을 수 없다는 오류로 넘어가지 않고, 대신 사용할 표기와 함께 보고됩니다. 이 형식에서 가장 흔한 실수이기 때문입니다:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>"

여기서 보고되는 형태가 하나 더 있으며, 이는 표기 실수가 아닙니다. ArtifactLibrary 번들 자체의 파일 본문은 다른 번들의 $import:일 수 없습니다. 하나의 파일 슬롯은 여러 파일로 확장될 수 없으므로, 중첩된 import는 작성자가 작성하지 않은 무언가로 해석되는 대신 거부됩니다. 대신 번들이 소비되는 지점에서 번들들을 조합하십시오.

component 자체의 Recipe가 작성하는 artifacts: 항목은 렌더링이 시작되기 전에 결정되므로, 보고는 해당 Recipe의 artifacts: 블록에 위치하며 참조, 번들, 중첩 import를 본문에 담은 파일, 그리고 import가 작성된 항목을 명시합니다. 이런 형태인 번들의 모든 파일은 한 번의 빌드에서 보고되며, 둘 이상이면 결과는 artifacts entries whose library import the compiler cannot resolve 아래에 묶입니다:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/) ("<the value as written>", bundle "<bundle>", bundle file "<filename>", artifacts entry "<key>"). a bundle file body cannot import another bundle — compose the two at the artifacts entry that consumes them

FeatureRecipe가 작성하는 artifacts: 항목은 번들이 해석될 때 같은 조건을 보고하며, 이런 형태인 첫 번째 파일을 명시합니다:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): bundle "<bundle>" file "<filename>" body is a field-root $import: (nested library import inside a bundle file is not supported; compose at the consumption site)

component 자체의 Recipe가 작성하는 valuesMapping:은 렌더링이 시작되기 전에 결정되므로, 보고는 해당 Recipe의 valuesMapping: 키에 위치하며 사용할 표기를 함께 제시합니다:

valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/mappings/

FeatureRecipe가 작성하는 valuesMapping:은 참조가 해석될 때, 위 목록에 있는 형식으로 보고됩니다.

component 자체의 Recipe가 작성하는 workload:는 렌더링이 시작되기 전에 결정되므로, 보고는 해당 Recipe의 workload: 키에 위치하며 사용할 표기를 함께 제시합니다:

workload $import: is not a bare-name workload-library reference (#/workloads/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/workloads/

FeatureRecipe가 작성하는 workload:는 참조가 해석될 때, 위 목록에 있는 형식으로 보고됩니다.

해결 방법: 값을 <Library>#<entry-path> 형식으로 다시 작성합니다. 선택될 수 있는 버전의 하한이 필요한 경우에만 라이브러리 이름 뒤에 :<version>을 추가합니다. 프래그먼트가 필드와 일치하는지 확인하십시오. workload:에 #/mappings/… 항목 경로를 쓰면 해당 필드가 읽지 않는 표면을 가리키게 되며, 누락된 항목으로 보고되지 않고 여기에서 보고됩니다. 스키마의 $ref:에도 같은 식별 형식이 적용되며, 그 거부는 위의 “A $ref: is not written in a form the compiler can resolve (참조가 컴파일러가 해석할 수 있는 형식으로 작성되지 않음)”에 설명되어 있습니다.

A library $import: names a library or an entry the catalog does not hold (라이브러리 $import:가 카탈로그에 없는 라이브러리나 항목을 지정함)

$import:는 올바르게 작성되었지만 그것이 가리키는 대상이 존재하지 않습니다. 세 가지 라이브러리 종류에 걸쳐 참조의 두 부분을 다루는 여섯 가지 조건이 있으며, 어느 조건이 발생했는지에 따라 어느 부분을 확인해야 하는지 알 수 있습니다. 즉, 라이브러리 자체가 빌드에서 보이는 범위에 없거나, 라이브러리는 있지만 해당 항목을 게시하지 않는 경우입니다.

참조가 해석되는 대상 집합은 워크스페이스 자체의 카탈로그와, 빌드가 로드될 때 lockfile이 고정하여 가져온 라이브러리들입니다. 따라서 Release의 의존성 클로저 안에서 아무것도 의존성을 선언하지 않은 라이브러리는, 그 안을 가리키는 참조가 아무리 올바르게 작성되어 있어도 이 집합에 포함되지 않습니다.

라이브러리가 없는 경우:

artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>") (artifact-library import가 카탈로그에 없는 ArtifactLibrary를 참조함) mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>") (mapping-library import가 카탈로그에 없는 MappingLibrary를 참조함) workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>") (workload-library import가 카탈로그에 없는 WorkloadLibrary를 참조함)

항목이 없는 경우:

artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>" (artifact-library import가 ArtifactLibrary에 없는 번들을 참조함) mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>" (mapping-library import가 MappingLibrary에 없는 항목을 참조함) workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>" (workload-library import가 WorkloadLibrary에 없는 항목을 참조함)

컴포넌트 자체의 Recipe가 작성한 artifacts: 항목은 누락된 번들을 고유한 형식으로 보고합니다. 이 항목은 렌더링이 시작되기 전에 결정되므로, 보고는 해당 Recipe의 artifacts: 블록에 위치하며 참조의 두 부분과 함께 import가 작성된 항목을 지정합니다:

artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>") (artifact-library import가 ArtifactLibrary에 없는 번들을 참조함)

컴포넌트 자체의 Recipe가 작성한 valuesMapping:은 같은 이유로 누락된 항목을 고유한 형식으로 보고합니다. 이것 역시 렌더링이 시작되기 전에 결정되므로, 보고는 해당 Recipe의 valuesMapping: 키에 위치하며 참조의 두 부분을 모두 지정합니다:

mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>") (mapping-library import가 MappingLibrary에 없는 항목을 참조함)

컴포넌트 자체의 Recipe가 작성한 workload:는 같은 이유로 누락된 항목을 고유한 형식으로 보고합니다. 이것 역시 렌더링이 시작되기 전에 결정되므로, 보고는 해당 Recipe의 workload: 키에 위치하며 참조의 두 부분을 모두 지정합니다:

workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>") (workload-library import가 WorkloadLibrary에 없는 항목을 참조함)

FeatureRecipe가 작성한 artifacts: 항목, FeatureRecipe가 작성한 valuesMapping: 또는 workload:, 그리고 빌드에서 보이지 않는 라이브러리에 대한 모든 참조는 참조가 해석될 때 위 두 목록의 형식으로 보고됩니다.

각 메시지는 어느 부분이 실패했든 라이브러리와 항목을 모두 지정하므로, 아무것도 열어 보지 않고도 보고 하나만으로 누락된 라이브러리와 누락된 항목을 구별할 수 있습니다.

해결 방법: 누락된 항목의 경우, 라이브러리가 게시하는 내용과 이름을 대조하십시오. 항목 이름은 해당 라이브러리 자체 맵의 키이며 대소문자를 구분합니다. 누락된 라이브러리의 경우, 대개 참조는 올바르고 부족한 것은 클로저입니다. 해당 라이브러리에 대한 의존성을 선언하여 로드되도록 하고, lockfile을 갱신하여 고정되도록 하십시오. 한 워크스페이스에서는 도달할 수 있고 다른 워크스페이스에서는 도달할 수 없는 라이브러리는 같은 결함을 반대편에서 본 것입니다.

A library $import: addresses its library by registry location (라이브러리 $import:가 레지스트리 위치로 라이브러리를 지정함)

라이브러리 $import:는 라이브러리를 식별자로 지정하며, 라이브러리가 게시된 레지스트리로 지정하지 않습니다. 이름이 어느 레지스트리를 통해 해석되는지는 워크스페이스 구성이 정하고 어느 버전이 사용되는지는 lockfile이 정하므로, 호스트를 포함한 참조는 빌드가 결정해야 할 두 가지를 카탈로그 문서에 고정하게 되며, 그러면 해당 문서는 다르게 구성된 워크스페이스에서 더 이상 동작하지 않습니다.

이러한 참조가 여전히 이 중단에 도달할 수 있는 경우는 보기보다 좁습니다. Recipe와 FeatureRecipe 자체의 $import: 필드는 세 위치 어디에서도 레지스트리 접두사를 허용하지 않는 스키마에 의해 더 일찍 거부됩니다. 남는 것은 어떤 스키마도 기술하지 않는 참조, 즉 라이브러리 항목 자체의 본문에서 읽어 낸 참조입니다. 이 참조는 그것을 소비하는 엔티티가 작성하지 않았으며 본문이 해석되기 전까지는 볼 수 없습니다.

valuesMapping: 및 workload: 표면에서 출력되는 메시지이며, 여기서 리졸버는 값만 보고합니다:

library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>" (라이브러리 $import:에 레지스트리 호스트가 포함되어 있습니다. 라이브러리를 순수 이름 식별자로 참조하십시오)

artifacts: 항목은 이 중단에 도달하지 않으며, 여기서 이를 찾고 있다면 그 이유를 알아 둘 가치가 있습니다. 그 자체의 참조는 다른 모든 위치와 마찬가지로 문서의 나머지와 함께 거부됩니다. 또한 다른 두 표면과 달리, 본문 자체가 import인 번들 파일은 따라가지 않고 거부되므로 호스트를 포함한 참조가 도착할 수 있는 본문이 없습니다.

해결 방법: 호스트와 라이브러리 이름 앞의 모든 부분을 제거하여 <Library>#<entry-path>만 남기십시오. 문제가 되는 값이 직접 게시하는 라이브러리가 아니라 소비하는 라이브러리 안에 있다면, 수정은 해당 라이브러리 작성자의 몫입니다. 수정이 반영될 때까지는 다른 항목을 import하거나 본문을 제자리에 작성하면 빌드가 통과됩니다.

Two artifact outputs of one Recipe carry the same filename (한 Recipe의 두 아티팩트 출력이 같은 파일 이름을 가짐)

Recipe의 artifacts: 블록은 키마다 하나의 출력을 지정하며, 키에 import된 번들은 그 아래에 자신의 파일들을 제공합니다. 두 출력이 하나의 파일 이름에 도달하면 하나가 다른 하나를 덮어쓰게 되므로, 빌드는 어느 것을 남길지 선택하는 대신 중단됩니다.

이것은 잔여 보호 장치이며, 그렇다고 밝히는 것도 이 장치의 일부입니다. 출력은 작성된 키로 이름이 지어지고, 매핑 키는 한 문서 안에서 고유하며, 작성 표면은 키를 단일 파일 이름으로 제한합니다. 따라서 작성된 두 항목은 충돌할 수 없으며, 키가 다른 키의 번들이 생성하는 중첩 이름을 표기할 수도 없습니다. 이 보호 장치가 여전히 다루는 것은 작성된 문서 자체의 중복 키 거부를 거치지 않고 프로젝션에 도달한 내용, 즉 파일에서 읽은 것이 아니라 빌드가 실행되는 동안 조립된 상태입니다. 따라서 여기서 보고되는 충돌은 눈에 보이는 줄이 아니라 빌드가 조립된 방식을 가리킵니다.

이 오류는 Recipe마다 해당 Recipe 자체의 출력에 대해 발생하며, 이 점이 조립 과정에서 서로 다른 두 기여자가 하나의 경로에 도달하는 경우와 구별되는 점입니다. 그 경우는 위의 “Two contributors write the same output path (두 기여자가 같은 출력 경로에 기록함)”이며, 해결 방법이 다릅니다.

출력되는 메시지:

artifacts output filename collision: two artifact outputs carry the same filename (Recipe "<recipe>", artifact output "<filename>" emitted more than once) (artifacts 출력 파일 이름 충돌: 두 아티팩트 출력이 같은 파일 이름을 가짐)

해결 방법: 메시지가 지정하는 Recipe를 열고, 그 artifacts: 키를 해당 Recipe가 import하는 번들이 제공하는 파일들과 대조하십시오. 키가 실제로 서로 다른데도 충돌이 계속된다면 문서에는 잘못이 없으며, 빌드를 유지 관리하는 담당자에게 이 보고를 전달할 가치가 있습니다.

An ArtifactLibrary bundle file names no file of its own under the key it was imported at (ArtifactLibrary 번들 파일이 가져온 키 아래에 자체 파일을 지정하지 않음)

번들을 가져오는 artifacts: 항목은 그 번들의 파일마다 하나의 출력으로 확장되며, 각 출력은 가져오기가 작성된 키 아래에 중첩됩니다. 따라서 키는 디렉터리를 지정하고, 번들이 제공하는 모든 파일은 그 아래에 자체 이름으로 놓입니다. 그 디렉터리 밖으로 올라가거나, 절대 위치를 지정하거나, 아무것도 지정하지 않는 파일 이름은 그렇지 않으므로, 빌드는 사용하는 Recipe가 선택하지 않은 위치에 파일을 두는 대신 중단됩니다.

아무것도 지정하지 않는다는 것은 키 아래 한 파일의 유일한 표기가 아닌 모든 이름을 포함합니다. .와 ./, 그리고 x/..처럼 다시 키로 수렴하는 이름은 키 자체를 지정하므로, 파일이 키의 디렉터리가 있어야 할 자리에 기록됩니다. 끝에 붙거나 중복된 /가 있거나 . 또는 .. 부분이 있는 이름(x/, a//b, ./a, a/./b, a/../b)은 다른 이름이 가리킬 수 있는 파일의 두 번째 표기입니다. a/b 옆의 a//b는 한 파일에 대한 두 이름이며, 충돌이 보고되지 않은 채 하나가 다른 하나를 덮어쓰게 됩니다. 빈 이름도 거부됩니다.

이것이 방지하는 것은 출력 디렉터리 밖으로의 쓰기가 아니라 조용한 재배치입니다. 파일이 기록되는 위치는 다시 한 번 검사되므로, 충분히 멀리 올라가는 이름은 어떤 경우에도 그곳에서 거부됩니다. 그 검사를 통과하는 이름은 정확히 한 단계만 올라가는 이름입니다. 이 이름은 출력 디렉터리 안으로 되돌아오지만, 아무도 선택하지 않은 위치에 놓입니다. 이 경로의 모든 충돌 검사는 이름을 해석된 대로가 아니라 구성된 대로 읽으므로, 이는 거부된 쓰기보다 더 나쁩니다. 그런 두 파일이 충돌 보고 없이 하나의 출력으로 해석될 수 있고, 어느 쪽이 남을지는 누구도 작성하지 않은 것에 의해 결정됩니다.

키 안에 평범하게 작성된 중첩 레이아웃은 영향을 받지 않습니다. 번들은 rbac/role.yaml처럼 자체 하위 디렉터리를 가질 수 있으며, 이를 사용 키 아래에 중첩하는 것이 키의 용도입니다. ..config나 role.v1.yaml처럼 한 부분 안에 점을 포함할 뿐인 이름은 평범한 이름입니다.

사용하는 Recipe와 게시된 번들은 보통 서로 다른 작성자가 작성하므로, 메시지는 양쪽을 해결 방법과 함께 지정합니다.

컴포넌트 자체의 Recipe가 작성한 artifacts: 항목은 렌더링 전에 결정되므로, 보고는 그 Recipe의 artifacts: 블록에 위치하며 먼저 파일을, 그다음 파일이 나온 라이브러리와 사용되는 항목을 지정합니다. 이름이 거부된 번들의 모든 파일이 한 번의 빌드에서 보고되며, 둘 이상이면 결과가 artifacts entries whose library import the compiler cannot resolve 아래에 묶입니다:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under ("<filename>", ArtifactLibrary "<library>", artifacts entry "<key>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (ArtifactLibrary 번들 파일 이름이 출력이 중첩되는 artifacts 키 아래에 자체 파일을 지정하지 않습니다. ArtifactLibrary 번들 안의 파일 이름을 사용되는 artifacts 키 아래의 평범한 파일 이름(예: “config.yaml” 또는 “rbac/role.yaml”)으로 바꾸십시오. ”.”나 ”..” 부분, 앞이나 끝에 붙거나 중복된 ”/“는 없어야 합니다)

FeatureRecipe가 작성한 artifacts: 항목은 번들이 해석될 때 같은 조건을 보고하며, 작성된 recipe와 첫 번째 해당 파일을 지정합니다:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under (Recipe "<recipe>", artifact "<key>", bundle file "<filename>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (ArtifactLibrary 번들 파일 이름이 출력이 중첩되는 artifacts 키 아래에 자체 파일을 지정하지 않습니다. ArtifactLibrary 번들 안의 파일 이름을 사용되는 artifacts 키 아래의 평범한 파일 이름(예: “config.yaml” 또는 “rbac/role.yaml”)으로 바꾸십시오. ”.”나 ”..” 부분, 앞이나 끝에 붙거나 중복된 ”/“는 없어야 합니다)

해결 방법: ArtifactLibrary 안의 파일 이름을 키 아래의 평범한 파일 이름으로 바꿉니다. 라이브러리가 본인의 것이 아니라면, 업스트림에서 수정되는 동안 다른 번들을 가져오거나 항목을 그 자리에 직접 작성하면 빌드가 통과합니다. 완전히 다른 위치에 놓일 파일은 그곳으로 이동하는 이름이 아니라, 해당 키에 둔 두 번째 artifacts: 항목이어야 합니다.

An imported artifact no longer matches the digest recorded beside its Recipe (가져온 아티팩트가 Recipe 옆에 기록된 다이제스트와 더 이상 일치하지 않음)

로컬 파일을 가져오는 artifacts: 항목은 Recipe가 고정될 때(aggrega pin으로, 또는 같은 단계를 실행하도록 요청된 pull이나 push로) 그 내용이 고정됩니다. 파일 바이트의 다이제스트가 Recipe 옆의 entity.lock에 기록됩니다. Recipe의 boundary.artifacts: 항목도 같은 방식으로 고정되고 비교되며, boundary/<key> 아래에 기록되는데 이것이 메시지가 부여하는 이름입니다. 모든 빌드는 파일을 다시 읽고 다시 다이제스트를 계산하여 불일치를 거부합니다. 따라서 고정된 후 편집된 파일은 검사된 것처럼 렌더링되지 않습니다. aggrega pull --verify도 같은 비교를 수행하며 불일치를 같은 메시지로 보고합니다.

비교 대상은 렌더링 결과가 아니라 항목의 내용입니다. 아티팩트 본문은 템플릿이며, 이를 평가하면 컴포넌트 인스턴스마다 다른 값이 대입되므로, 출력에 대한 다이제스트는 값이 다른 모든 인스턴스에서 불일치하게 됩니다. 기록된 내용은 Recipe를 바인딩하는 모든 인스턴스에서 같은 텍스트이며, 이것이 기록된 하나의 다이제스트를 비교 대상으로 삼는 것이 옳은 이유입니다.

아무도 고정하지 않은 Recipe는 옆에 핀이 없으며, 빌드는 이를 비교하지 않습니다. 빌드에게 핀의 부재는 불일치가 아니며, 비교할 대상이 없다는 뜻입니다. 그런 Recipe에 대한 pull은 대신 An entity reads an input the lock beside it records no pin for (엔터티가 옆의 lock에 핀이 기록되지 않은 입력을 읽음)에서 설명하는 대로 중단됩니다. 파일이 편집되기 전에 작성된 lockfile이 먼저 보고합니다. 엔터티의 행이 가져온 파일도 포함하기 때문이며, 이는 A local source no longer matches the pins recorded beside its Recipe (로컬 소스가 Recipe 옆에 기록된 핀과 더 이상 일치하지 않음)에서 설명하고, 같은 절에서 빌드가 이 비교를 만나는 경우도 설명합니다.

세 가지 표면이 서로 다른 문서에 대해 같은 검사를 수행합니다. 컴포넌트 자체의 Recipe, 컴포넌트에 연결된 Feature, 경계에 연결된 Feature입니다. 따라서 FeatureRecipe의 내용은 호스트 컴포넌트의 Recipe 옆이 아니라 FeatureRecipe 옆에 기록된 다이제스트와 비교됩니다. 두 연결 표면에서는 메시지가 연결도 지정하며, 이것이 어느 문서를 열어야 하는지 알려 줍니다.

출력되는 메시지:

imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (가져온 아티팩트의 내용이 entity.lock에 기록된 다이제스트와 일치하지 않습니다. 파일을 의도적으로 변경했다면 해당 파일을 가져오는 엔티티에서 aggrega pin을 실행하여 새 다이제스트를 기록하고, 그렇지 않다면 파일을 복원하십시오) imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>", attachment "<attachment>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (가져온 아티팩트의 내용이 entity.lock에 기록된 다이제스트와 일치하지 않습니다. 첨부 정보가 함께 표시됩니다. 파일을 의도적으로 변경했다면 해당 파일을 가져오는 엔티티에서 aggrega pin을 실행하여 새 다이제스트를 기록하고, 그렇지 않다면 파일을 복원하십시오)

해결 방법: 두 가지 답이 있으며, 어느 쪽이 맞는지는 편집이 의도된 것인지에 달려 있습니다. 의도된 것이라면 Recipe에서 aggrega pin을 실행하여 파일의 현재 바이트로 핀을 다시 만들고, 다시 작성된 entity.lock을 커밋합니다. 의도되지 않았다면 파일을 복원합니다. 기록된 다이제스트는 고정된 바이트의 기록이며, 변경된 파일을 렌더링한 빌드는 아무도 검증하지 않은 내용을 배포하게 됩니다.

A local source no longer matches the pins recorded beside its Recipe (로컬 소스가 Recipe 옆에 기록된 핀과 더 이상 일치하지 않음)

source:가 옆에 있는 디렉터리나 파일을 지정하는 Recipe 또는 FeatureRecipe는 엔터티가 고정될 때(aggrega pin으로, 또는 같은 단계를 실행하도록 요청된 pull이나 push로) 그 소스가 고정됩니다. 엔터티 옆의 entity.lock은 소스가 엔터티의 게시물에 제공하는 파일마다 하나의 다이제스트를 파일 경로를 키로 하여 기록합니다. lock에 기록된 후에는 모든 빌드가 provider가 소스를 읽기 전에 현재 상태의 소스를 그 핀과 비교하고 불일치를 거부합니다. 따라서 고정된 후 편집된 차트나 모듈은 검사된 것처럼 렌더링되지 않습니다. aggrega pull --verify도 같은 비교를 수행하며 불일치를 같은 메시지로 보고합니다. 빌드는 소스를 해석하던 컴포넌트 인스턴스와 그 아래의 Recipe 문서를 지정합니다.

소스는 하나의 파일 집합으로 비교됩니다. 내용이 바뀐 파일, 소스에 추가된 파일, 소스에서 제거된 파일은 각각 엔터티가 렌더링하는 원본을 바꾸므로, 각각 파일의 현재 다이제스트 및 기록된 다이제스트와 함께 보고됩니다. 엔터티 옆에 있지만 소스가 제공하지 않는 파일(Recipe 옆의 메모나 README)은 비교되지 않습니다. ./charts/{{ .values.flavour }}처럼 템플릿으로 작성된 소스는 어느 디렉터리를 지정할지가 각 Release에 의해 결정되므로 엔터티 디렉터리의 모든 파일을 제공합니다. 이런 형태에서는 디렉터리 안 어느 파일을 편집해도 보고됩니다.

lock에 소스의 핀이 기록되지 않은 Recipe는 빌드가 비교할 대상이 없습니다. 빌드는 이를 거부하지 않습니다. 고정하지 않는 pull이나 push는 An entity reads an input the lock beside it records no pin for (엔터티가 옆의 lock에 핀이 기록되지 않은 입력을 읽음)에서 설명하는 대로 거부합니다. Recipe가 더 이상 선언하지 않는 로컬 소스에 대해 lock에 남아 있는 핀은 Recipe가 읽는 어떤 것도 고정하지 않으므로 아무것과도 비교되지 않습니다. pull이 레지스트리에서 해석한 Recipe는 대신 lockfile이 그 게시물의 내용에 대해 기록한 다이제스트로 다뤄집니다.

변경 전에 작성된 lockfile이 먼저 보고합니다. lockfile은 엔터티를 그 내용으로 기록하며 소스의 파일도 그 일부이므로, 파일이 바뀌기 전에 작성된 lockfile을 가진 빌드나 aggrega pull --verify는 이 비교가 실행되기 전에 중단되고, The lockfile no longer matches what the release resolves to (lockfile이 release가 해석하는 결과와 더 이상 일치하지 않음)가 엔터티와 두 다이제스트를 지정합니다. 일반 aggrega pull은 An entity reads an input the lock beside it records no pin for (엔터티가 옆의 lock에 핀이 기록되지 않은 입력을 읽음)로 바뀐 파일을 지정합니다. 가져온 파일도 마찬가지입니다. lockfile에 엔터티 자체의 항목이 없는 경우, 빌드와 검증 pull이 만나는 것은 이 비교입니다: Manifest가 Release가 도달하는 Component 또는 Feature의 이름이기도 한 참조로 지정하는 Recipe나 FeatureRecipe는 그 참조 아래에 Component 또는 Feature로 기록되므로, Recipe의 파일이 바뀌어도 lockfile에서는 아무것도 바뀌지 않습니다.

출력되는 메시지:

the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (엔티티의 로컬 소스 파일이 entity.lock에 기록된 핀과 일치하지 않습니다(파일의 다이제스트가 기록된 핀과 다릅니다). 소스를 의도적으로 변경했다면 엔티티에 aggrega pin을 실행하여 파일을 다시 기록하고, 그렇지 않다면 파일을 복원하십시오) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and no pin is recorded for it). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (엔티티의 로컬 소스 파일이 entity.lock에 기록된 핀과 일치하지 않습니다(파일에 대해 기록된 핀이 없습니다). 소스를 의도적으로 변경했다면 엔티티에 aggrega pin을 실행하여 파일을 다시 기록하고, 그렇지 않다면 파일을 복원하십시오) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> is no longer in the source and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (엔티티의 로컬 소스 파일이 entity.lock에 기록된 핀과 일치하지 않습니다(파일이 더 이상 소스에 없지만 핀은 기록되어 있습니다). 소스를 의도적으로 변경했다면 엔티티에 aggrega pin을 실행하여 파일을 다시 기록하고, 그렇지 않다면 파일을 복원하십시오)

해결 방법: 가져온 파일과 마찬가지로 두 가지 답이 있으며, 어느 쪽이 맞는지는 변경이 의도된 것인지에 달려 있습니다. 의도된 것이라면 Recipe에서 aggrega pin을 실행하여 소스 파일을 다시 고정하고, 다시 작성된 entity.lock을 커밋합니다. 의도되지 않았다면 메시지가 지정하는 파일을 복원합니다.

엔터티의 게시물이 포함하는 모든 파일은 엔터티 자체 디렉터리에서 읽히며, 그곳의 심볼릭 링크는 따라가지 않고 거부됩니다. 링크를 따라가면 링크가 가리키는 바이트가 엔터티 디렉터리 밖을 포함해 어디에서든 링크 자체의 이름으로 아티팩트에 게시되고, 그 아티팩트는 다이제스트가 계산되며 서명이 적용되는 경우 서명됩니다. 반대로 건너뛰면 내용이 디렉터리와 조용히 달라진 아티팩트가 게시됩니다. 따라서 모든 형태의 링크가 같은 방식으로 거부됩니다. 파일에 대한 링크, 디렉터리에 대한 링크, 아무 곳도 가리키지 않는 링크, 자기 자신을 가리키는 링크, 서로를 가리키는 두 링크입니다.

거부는 엔터티의 파일을 읽는 모든 곳에서 이루어집니다. aggrega pin, 무엇이든 패킹하기 전의 게시(드라이 런 포함), entity.lock을 엔터티 파일과 대조하는 pull과 검증 pull, 로컬 소스를 핀과 비교하는 빌드, provider에게 넘기기 전에 로컬 소스 디렉터리를 읽는 렌더링입니다. 메시지는 엔터티 문서 옆의 경로로 링크를 지정하며, 진단은 링크 자체에 위치합니다.

무시 규칙이 제외하는 링크는 엔터티가 포함하는 파일이 아니므로, 그 규칙이 제외하는 다른 파일처럼 건너뛰며 따라가지 않습니다. 그 규칙은 엔터티가 고정될 때 entity.lock에 기록된 것이므로, .aggregaignore에 추가한 줄은 엔터티를 다시 고정할 때 적용됩니다.

출력되는 메시지:

a symbolic link sits among the files an entity carries (<path>). remediation: replace the link with a copy of what it points to, placed inside the entity’s own directory. A link met inside a source directory can instead be left out with a line in the .aggregaignore beside the entity, which takes effect when the entity is pinned again. A link is refused rather than followed because the bytes it points to would travel under the link’s name, from wherever it points (엔터티가 포함하는 파일 중에 심볼릭 링크가 있습니다. 해결: 링크를 그것이 가리키는 대상의 사본으로 바꾸어 엔터티 자체 디렉터리 안에 두십시오. 소스 디렉터리 안의 링크는 대신 엔터티 옆 .aggregaignore에 한 줄을 추가해 제외할 수 있으며, 이는 엔터티를 다시 고정할 때 적용됩니다. 링크를 따라가면 가리키는 바이트가 어디에서든 링크 이름으로 옮겨지므로 링크는 거부됩니다)

해결 방법: 엔터티에 링크가 가리키는 대상이 필요하다면 링크를 엔터티 디렉터리 안의 사본으로 바꾸고 엔터티를 다시 고정합니다. 링크가 편의를 위한 것이고 엔터티가 읽지 않는다면, 엔터티 문서 옆의 .aggregaignore에 그 경로를 추가하고 다시 고정합니다. 엔터티와 함께 배포되는 파일에서 엔터티가 포함하는 것을 결정하는 규칙을 설명합니다.

An entity reads an input the lock beside it records no pin for (엔터티가 옆의 lock에 pin이 기록되지 않은 입력을 읽음)

Recipe나 FeatureRecipe는 자신의 문서 밖에 있는 바이트에 의존할 수 있습니다. 좌표가 완전히 기술된 원격 source:, artifacts 항목이 $import로 가져오는 파일, 그리고 옆의 디렉터리나 파일을 지정하는 source:의 파일들이 그렇습니다. 각각의 pin은 엔터티 옆의 entity.lock에 기록되며, 이를 기록하는 것은 엔터티 작성자의 단계인 aggrega pin입니다. 따라서 pull은 이러한 pin을 스스로 기록하지 않습니다. Release가 빌드하는, 사용자의 카탈로그 디렉터리 중 하나에 있는 엔터티에 대해 pull은 이 단계가 기록할 내용과 lock이 보유한 내용을 비교하고, lock에 pin이 없거나 입력이 더 이상 일치하지 않는 pin을 보유한 경우, 요청 없이 작성자의 디렉터리에 쓰는 대신 중단합니다. 자체 lockfile을 채우는 빌드는 pull이며 같은 방식으로 중단합니다.

push는 게시하려는 하나의 엔터티에 대해 같은 비교로 중단합니다. 번들이 빌드되기 전, 그리고 어떤 레지스트리에도 접속하기 전에, push는 이 단계가 해당 엔터티에 대해 기록할 내용을 옆의 lock과 비교하고, push가 이 단계를 직접 실행하도록 요청받지 않은 한 같은 방식으로 거부합니다. 드라이 런도 포함됩니다. 메시지가 끝에서 제안하는 내용은 두 경우에 다릅니다. 각 명령마다 pin을 기록하게 하는 고유한 방법이 있기 때문입니다. 보고하는 내용은 다르지 않습니다.

로컬 소스는 하나의 파일 집합으로서 pin과 대조됩니다. lock이 그중 아무것도 기록하지 않은 경우, 소스가 기여하는 각 파일이 여기서 누락된 것으로 보고됩니다. 기록한 경우, pin 이후 추가된 파일은 누락된 것으로, 변경되거나 제거된 파일은 입력이 더 이상 일치하지 않는 pin으로 보고되며, 빌드는 같은 변경을 A local source no longer matches the pins recorded beside its Recipe (로컬 소스가 Recipe 옆에 기록된 pin과 더 이상 일치하지 않음)으로 보고합니다. Recipe가 더 이상 선언하지 않는 로컬 소스(source:가 제거되었거나 이제 원격 아티팩트를 지정하는 경우)에 대해 lock이 여전히 기록하고 있는 pin은 Recipe가 읽는 어떤 것도 고정하지 않으므로, pull, push, 검증 pull, 빌드 어느 것도 중단시키지 않습니다. 다음 aggrega pin이 이를 제거합니다.

메시지는 누락된 모든 입력을 분류별로 명시합니다. 각각은 url과 해석된 버전으로 명시되는 remote source, 이를 소비하는 artifacts 키로 명시되는 imported file, 또는 엔터티 옆의 경로로 명시되는 local source file입니다. 따라서 pin이 필요한 것이 소스인지 파일인지 알 수 있습니다. Release 안의 그러한 엔터티는 한 번의 실행에서 모두 보고됩니다.

레지스트리에서 해석된 엔터티는 pull에 의해 이 대조를 받지 않습니다. 게시 시점에 이미 받았기 때문입니다. 이러한 엔터티는 사용자가 작성하는 디렉터리가 아니라 콘텐츠 캐시에 있으므로, pull은 그 옆의 lock을 읽지도 쓰지도 않으며, 그 소스는 Release의 lockfile과 대조됩니다. aggrega push로 게시된 엔터티는 그 시점에 이 단계가 기록할 모든 pin을 lock이 기록하지 않았다면 게시 시 거부되었으며, 그 lock은 게시된 번들 안에 함께 포함됩니다.

pull과 push에서 출력되는 메시지:

an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded, imported file <key>: the recorded pin no longer matches it). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have every pull in this workspace record the pins itself instead, set pin_sources_at_pull: true in the workspace configuration (엔터티가 읽는 입력에 대해 옆의 entity.lock에 기록된 핀이 없습니다. 해결 방법: 엔터티에 aggrega pin을 실행하고 엔터티 옆에 작성되는 entity.lock을 커밋하십시오. 대신 이 작업 공간의 모든 pull이 핀을 직접 기록하게 하려면 작업 공간 구성에서 pin_sources_at_pull을 true로 설정하십시오) an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have this publication record the pins itself instead, re-run it with --pin-sources; to have every publication in this workspace record them, set pin_sources_at_push: true in the workspace configuration (엔터티가 읽는 입력에 대해 옆의 entity.lock에 기록된 핀이 없습니다. 해결 방법: 엔터티에 aggrega pin을 실행하고 엔터티 옆에 작성되는 entity.lock을 커밋하십시오. 대신 이 게시가 핀을 직접 기록하게 하려면 pin-sources 플래그를 붙여 다시 실행하십시오. 이 작업 공간의 모든 게시가 핀을 기록하게 하려면 작업 공간 구성에서 pin_sources_at_push를 true로 설정하십시오)

게시 메시지의 가운데 절은 게시에 사용한 인터페이스가 받아들이는 것을 명시합니다. 터미널에서는 --pin-sources, 데몬에서는 pinSources 필드, 어시스턴트 도구에서는 pin_sources 인수입니다.

해결 방법: 엔터티가 사용자의 것이라면 aggrega pin을 실행하고 기록되는 entity.lock을 커밋한 다음 다시 pull 또는 push하십시오. 또는 번들이 빌드되기 전에 이 단계를 실행하는 --pin-sources로 push하십시오. 다른 사람의 것(별도의 디렉터리에서 소비하는 카탈로그)이라면 게시자가 아직 pin하지 않은 것입니다. 모든 pull이 pin을 직접 기록하도록 워크스페이스 구성에 pin_sources_at_pull: true를 설정하거나, 한 번의 pull에 --pin-sources를 전달하십시오. aggrega pin에서 이 단계를 자세히 설명합니다.

A provides: template could not be evaluated (provides: 템플릿을 평가할 수 없음)

provides: 항목은 다른 컴포넌트가 의존성 연결을 통해 읽는 값을 생성하는 템플릿입니다. 이 조건은 평가할 수 없는 항목이 보고하는 것입니다. 구문 분석되지 않는 템플릿, 이 인터페이스가 등록하지 않는 함수 호출, 렌더 컨텍스트가 제공하지 않은 것을 거쳐 내려가는 참조, 또는 맵에 없는 키에 대한 index 읽기가 해당됩니다.

이는 같은 블록에서 평가 이전에 실행되는 두 가지 거부, 즉 자체 완결 집합 밖의 루트에 대한 참조와 블록 자체의 작성 순서가 거부하는 참조와는 구별되며, 둘 다 위에서 설명했습니다. 그 둘은 변경할 표현식을 명시하지만, 이 조건은 평가 자체가 보고한 내용을 그대로 담으며, 그래서 항목 이름이 함께 표시됩니다.

컴포넌트 인스턴스, 블록 내 항목, 평가가 보고한 내용을 명시하는 출력 메시지:

provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>) (provides 템플릿 평가 실패)

평가가 무엇을 보고했든, 첫머리에는 이 조건의 코드 E0056이 붙습니다. 평가가 자체의 중단 조건으로 멈춘 경우(맵에 없는 키를 index로 읽는 것이 일반적입니다), 그 조건은 이 조건을 대신하지 않고 이 조건 아래에 보고됩니다. caused by (2): 아래에서 이 조건의 문장이 먼저 오고, 평가 자체의 보고가 그 문장을 포함하여 두 번째로 옵니다. 따라서 코드로 대조하는 독자는 실패한 모든 provides: 항목을 E0056으로 식별하고, 평가가 실패한 원인은 그 아래의 조건에서 읽습니다. 그 조건의 문장은 모든 조건의 표에서 자체 코드로 연결되며, 없는 키의 경우 E0327입니다.

해결 방법: 메시지가 명시하는 키에서 Recipe의 provides: 블록을 열고 보고된 사유를 읽으십시오. 사유는 대개 구문 분석 위치나 함수를 명시합니다. 이 인터페이스의 누락 키 처리는 존재하지 않는 마지막 키를 실패 대신 빈 값으로 렌더링하므로, 여기서의 실패는 구조적 결함입니다. 구문 분석되지 않는 템플릿, 제공된 적 없는 컨테이너를 거쳐 내려가는 참조, 또는 맵에 없는 키에 대한 index 읽기이며, 보고된 사유가 이를 명시합니다. 값이 실제로 선택 사항이라면, 없을 수도 있는 것을 거쳐 내려가는 대신 optional 헬퍼를 통해 읽으십시오.

A Recipe or FeatureRecipe does not publish a provides key its contract declares (Recipe 또는 FeatureRecipe가 계약이 선언한 키를 게시하지 않음)

Component와 Feature는 각각 schema.provides 아래에 자신을 바인딩하는 모든 것이 게시할 키, 즉 소비자가 연결을 작성할 때 기준으로 삼는 출력 계약을 선언합니다. Component에 바인딩된 Recipe와 Feature에 바인딩된 FeatureRecipe는 그 계약이 지정하는 모든 키를 생성해야 합니다. 그렇지 않은 것은 거부됩니다. 그렇지 않으면 누락된 키가 아무것도 전달하지 않기 때문입니다. 소비자의 참조는 설정되지 않은 변수, 빈 인수, 또는 존재하지 않는 파일로 도착하며, 그 이유에 대해서는 아무것도 알려 주지 않습니다.

계약은 키의 존재 여부일 뿐, 그 이상은 아닙니다. 선언된 모든 키가 나타나야 하며, 추가 키는 허용됩니다. 값 자체는 결코 검사되지 않습니다. 값은 문자열로 전달되는 불투명한 포인터이므로, 계약이 선언하는 타입은 빌드가 수행하는 검사가 아니라 소비자에게 전하는 진술로 남습니다.

모든 부족분이 보고됩니다. 키 세 개가 부족한 Recipe는 세 개의 결과를 발생시키며, 각 결과는 해당 Recipe의 provides: 블록에서 자신의 항목 위치에 표시되므로, 한 번의 빌드로 세 개를 모두 수정할 수 있습니다. 메시지는 누락된 키, 그 키를 선언한 계약의 타입, 그리고 Recipe가 바인딩된 인스턴스를 지정합니다. 마지막 항목은 하나의 Recipe가 한 타입의 여러 인스턴스를 담당할 때 두 결과를 구별해 줍니다.

출력되는 메시지:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares ("<key>", declared by component type "<type>", bound to component instance "<instance>") (Recipe 또는 FeatureRecipe가 추상 엔터티의 schema.provides 계약이 선언한 provides 키를 게시하지 않음: 해당 키, 이를 선언한 컴포넌트 유형, 바인딩된 컴포넌트 인스턴스)

Feature와 FeatureRecipe의 짝은 attachment 자체의 해석을 통해 같은 조건을 보고하며, 그 짝과 키를 지정합니다:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares (<attachment context>, <the FeatureRecipe> does not publish provides key "<key>" declared by <the Feature>’s schema.provides contract) (Recipe 또는 FeatureRecipe가 추상 엔터티의 schema.provides 계약이 선언한 provides 키를 게시하지 않음: 연결 컨텍스트, 그리고 FeatureRecipe가 Feature의 schema.provides 계약이 선언한 provides 키를 게시하지 않음)

이 경우에는 정렬 순서상 첫 번째 누락 키를 보고하고 멈추므로, 이 짝은 빌드당 키 하나를 지정하는 반면 Component 짝은 모든 키를 지정합니다. 어느 쪽이든 키는 정렬 순서로 순회되며, 이 덕분에 두 경우 모두 실행 간에 결과가 같습니다.

해결 방법: 누락된 키를 Recipe 또는 FeatureRecipe의 provides: 블록에 추가하거나, 아무것도 그 키를 게시할 것으로 기대되지 않는다면 Component 또는 Feature의 schema.provides에서 제거합니다. 템플릿이 아무것도 렌더링하지 않는 키도 빈 문자열을 값으로 하여 여전히 게시되므로, 존재하지만 비어 있는 항목은 계약을 충족하며 여기에서 보고되지 않습니다. 빈 값이 빌드를 중단시켜야 한다면 어서션에서 거부합니다. Recipe의 어서션은 해석된 provides: 값을 읽습니다.

An assertion stopped the build (어서션이 빌드를 중단함)

Component, Feature, Recipe 또는 FeatureRecipe는 assertions:를 가질 수 있습니다. 이는 텍스트를 생성하는 것이 아니라 입력을 거부하는 것이 목적인 이름 있는 템플릿입니다. 어서션은 fail을 호출하며, 이를 호출하면 빌드가 중단됩니다. 인수는 작성자가 이를 마주칠 사람을 위해 쓴 메시지입니다.

어서션은 두 시점에 평가되므로, 규칙은 자신이 다루는 상태를 읽습니다. Component나 Feature의 어서션은 카탈로그가 해석된 후 어떤 것도 렌더링되기 전에 실행되고, Recipe나 FeatureRecipe의 어서션은 바인딩이 확정된 후 그 바인딩이 렌더링되기 전에 실행됩니다.

아무것도 제공하지 않는 키에 대한 참조도 여기에서 보고됩니다. 이 표면은 엄격한 누락 키 처리로 평가합니다. 바로 참조가 빈 값으로 렌더링된 조건식이 아무것도 아닌 것과 비교하여 조용히 통과하지 않도록 하기 위해서입니다. 그렇지 않으면 오타 하나가 어서션이 강제하려고 작성된 규칙을 무력화할 것입니다. 이 때문에 이 표면에서는 일반 default가 대체 값을 제공하지 않습니다. 대체 값이 실행되기 전에 참조 자체가 평가를 중단시키기 때문입니다. 참조를 hasKey로 보호하거나 optional 헬퍼를 사용합니다. index를 통해 읽어도 “A template indexes a map with a key the map does not hold (템플릿이 맵에 없는 키로 맵을 인덱싱함)”에서 설명하는 대로 키를 지정하며 중단됩니다.

출력되는 메시지는 엔터티 종류와 타입, 인스턴스, 어서션을 지정한 다음 어서션 자체가 작성한 메시지를 담습니다:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <fail …>: error calling fail: assertion failed: <the message the assertion wrote> (fail 호출 중 오류: 어서션 실패)

그리고 아무것도 제공하지 않는 키의 경우, 조건 자체의 문장 뒤에 템플릿 엔진의 문장이 이어집니다.

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": assertion failed: template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <.reference>: map has no entry for key "<key>" (어서션 실패: 템플릿 실행 중 맵에 해당 키의 항목이 없음)

그리고 조건식이 아니라 평가가 실패한 경우:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>" parse: <what the parse reported> (엔터티 종류, 유형, 인스턴스, 어서션 이름에 이어 어서션 경로의 파싱: 파싱이 보고한 내용)

민감하다고 선언된 값은 메시지에 나타나지 않습니다. 어서션이 그런 값을 읽고, 하나의 따옴표 문자열로 다 써 놓은 문장으로 fail을 호출하면(fail "…"처럼 아무것도 파이프로 넘기지 않고 아무것도 조합하지 않는 경우), 그 문장은 어서션이 읽은 것을 전혀 인용하지 않으므로 값의 내용과 관계없이 메시지에 그 문장이 쓰인 그대로 담깁니다. 메시지가 값을 인용하면, 메시지에는 값 대신 <redacted>가 표시됩니다. 메시지가 그 밖의 다른 방식으로 조합되고 어서션의 동작이 값의 내용에 따라 달라졌다면, 실패한 표현식 뒤의 메시지는 failure text withheld: this template reads a value declared sensitive, and the failure depends on what that value holds로 대체되며, 중단과 그 코드는 바뀌지 않습니다. 무엇이 선언된 것으로 간주되는지, 그리고 어떤 거부가 이 범위 밖에 있는지는 vocabulary/compact-form-authoring.md의 “거부가 선언된 값에 대해 말하는 것”에 있습니다.

단독으로 검사되면 엔터티는 실패한 어서션을 경고로 보고합니다. Recipe 파일이 주어진 aggrega validate, aggrega serve를 통한 편집기의 해당 파일 검사, 그리고 entity가 주어진 aggrega mcp의 validate 도구는 Release가 설정하는 값이 아니라 자리 표시자와 스키마 기본값을 중심으로 Recipe를 빌드하므로, Release를 기다리는 어서션과 망가진 어서션을 구별할 수 없습니다. 이때 fail을 호출하는 어서션은 Recipe 자신의 것이든 Recipe가 구현하는 Component가 선언한 것이든, 위의 메시지를 담고 A Release must satisfy this assertion before a build of it can pass. 문장으로 끝나는 경고로 보고되며, 검사는 통과합니다. 아무것도 제공하지 않는 키에 대한 참조와 파싱되지 않는 어서션은 실패한 어서션이 아닙니다. 각각은 어서션 자체 텍스트의 결함이며, 해당 검사는 다른 결함과 똑같이 판단합니다. 빌드에는 항상 Release가 있으며, 여기에서 설명한 대로 어서션에서 중단됩니다. 실패한 어서션은 경고입니다를 참조하십시오.

해결 방법: 마지막 콜론 뒤의 메시지는 어서션 작성자의 것이며, 무엇을 바꿔야 하는지 알려 주는 것은 바로 그 메시지입니다. 어서션은 마주치면 답을 알 수 있도록 작성됩니다. 보고 내용이 작성자의 문장이 아니라 누락된 키라면 어서션 자체에 결함이 있는 것입니다. 참조를 수정하거나 위에서 설명한 대로 보호합니다. 이 Release에 규칙이 적용되지 않아야 한다면, 그것은 여러분 자신의 파일이 아니라 어서션을 가진 엔터티에 관한 문제입니다.

A pipeline step addresses documents the node does not have (파이프라인 단계가 노드에 없는 문서를 지정함)

파이프라인 단계는 스코프와 키로 문서를 지정합니다. 지정한 주소가 아무것에도 닿지 않는 경우는 세 가지 조건으로 나뉘며, 각 조건은 실제로 일어나지 않은 편집에 대해 단계가 성공을 보고하게 두지 않고 빌드를 중지합니다.

노드가 그 문서를 출력하지 않았습니다. 패치가 이 노드가 생성한 문서에 없는 스코프-키 쌍을 지정합니다:

node "<instance>": pipeline PATCH targets a document the node did not emit (노드: 파이프라인 PATCH가 노드가 출력하지 않은 문서를 대상으로 합니다)

지정할 호스트가 없습니다. 단계가 아무 호스트도 마주하지 않는 위치에서 호스트 component의 문서에 접근했습니다. 자신의 출력만이 유일한 스코프인 component 자체 파이프라인이나, 하나의 component가 아니라 경계에 연결된 Feature가 그런 위치입니다. 이러한 파이프라인이 실행되는 곳에서는 호스트 스코프가 비어 있으므로, 그 안을 가리키는 주소는 아무것에도 해석되지 않습니다:

node "<instance>": pipeline /host operation from a step with no host component (노드: 호스트 컴포넌트가 없는 단계에서 파이프라인 /host 작업이 수행되었습니다)

문서에 지정할 트리가 없습니다. 일부 단위에는 경로가 가리킬 수 있는 구조가 없습니다. 바이너리 본문, 자유 텍스트, 대상이 안전하게 탐색할 수 없는 영역 등이 그렇습니다. 이러한 단위도 단계에 전달되므로 선택하여 통째로 출력할 수는 있지만, 패치할 수는 없습니다:

node "<instance>": pipeline PATCH target is not parseable structured YAML/JSON (노드: 파이프라인 PATCH 대상이 파싱 가능한 구조화된 YAML/JSON이 아닙니다) pipeline PATCH target is not parseable structured YAML/JSON (node "<instance>", document "<key>") (파이프라인 PATCH 대상이 파싱 가능한 구조화된 YAML/JSON이 아닙니다)

각 메시지에는 그 아래에 탐색 과정이 직접 설명한 주소 내용이 함께 표시되며, 각 메시지의 위치는 해당 파이프라인을 만든 component 인스턴스입니다.

세 가지 중 두 가지는 탐색 전에도 보고됩니다. 위치에 호스트 문서가 있는지 여부는 파이프라인이 작성된 위치에서 결정되므로, 호스트 문서가 없는 위치에서 호스트 문서에 작업한다고 선언한 단계는 노드가 렌더링되기를 기다리지 않고 빌드가 모든 플러그인의 선언을 파악한 시점에 지적됩니다. 경계에 연결된 Feature는 단계와 함께 명시됩니다:

pipeline /host operation from a step with no host component (호스트 컴포넌트가 없는 단계에서 파이프라인 /host 작업이 수행되었습니다) pipeline /host operation from a step with no host component ("<attachment>") (호스트 컴포넌트가 없는 단계에서 파이프라인 /host 작업이 수행되었습니다)

두 보고는 같은 결과가 두 번 나오는 것이 아니라 하나의 조건을 나눈 것입니다. 선언으로 판단할 수 있는 것은 선언에서 판단하고, 실행에서만 볼 수 있는 것은 실행에 맡깁니다. 자신의 스코프를 선언한 단계라도 다른 스코프를 대상으로 하는 작업을 반환할 수 있기 때문입니다.

이 세 가지는 파이프라인 탐색 자체가 보고하는 주소 지정 거부의 빌드 중지 형태이며, 위의 “A pipeline patch addresses a document the set does not hold, or one with no tree to address (파이프라인 패치가 집합에 없는 문서 또는 지정할 트리가 없는 문서를 지정함)“에 설명되어 있습니다.

해결 방법: 세 가지 모두 사용자가 아니라 단계 작성자가 해결할 문제입니다. 대상이 없는 경우에는 노드가 실제로 출력하는 문서를 패치하거나, 의도한 문서를 앞 단계에서 출력하고 뒤 단계에서 패치합니다. 단계는 전달받은 키를 읽을 수 있습니다. 호스트가 없는 경우에는 단계를 호스트 component를 마주하는 위치로 옮기거나, 대신 그 위치 자체의 문서를 지정하거나, 단계를 제거합니다. 트리가 없는 단위의 경우에는 패치를 단위 전체를 출력하는 emit으로 바꿉니다. 불투명한 본문은 편집하지 않고 교체합니다.

A pipeline patch addresses output that has not been assembled yet (파이프라인 패치가 아직 조립되지 않은 출력을 지정함)

일부 provider는 디스패치 그룹의 노드별 출력을 하나의 문서로 합칩니다. 병합된 compose 파일이나 umbrella 차트가 그 예입니다. 병합이 일어나기 전에는 개별 문서가 없고 조각만 있으므로, 그중 하나를 지정하는 패치는 가리킬 대상이 없습니다. 따라서 이러한 component에 대한 파이프라인은 통째로 연기되었다가 병합으로 문서가 생성된 뒤 다시 실행됩니다. 이것이 일반적인 경로이며 작성자가 할 일은 없습니다.

이 조건은 그럼에도 패치가 조각에 도달했을 때 빌드에 보고되는 것입니다. 이 조건이 가리키는 경우는 연결된 Feature 자체의 출력입니다. component의 provider가 그룹을 합치는 경우, 연결의 파이프라인 전체는 병합으로 문서가 생성될 때까지 보류되며, 그 재실행에 전달되는 것은 component의 문서뿐입니다. Feature 자체 출력에 대한 단계는 component가 렌더링되는 동안에만, 즉 병합이 일어나기 전에만 제공되므로 지정할 대상이 없습니다. 이는 Feature 자체 출력이 어떻게 전달되든 마찬가지입니다. 병합에 합류하든 별도의 문서로 기록되든, 그 스코프는 재실행이 전달하는 스코프가 결코 아닙니다.

출력(emit)은 영향을 받지 않습니다. emit은 문서를 편집하지 않고 추가하며, 모든 provider에서 노드별로 실행되므로 이 조건과 전혀 관계가 없습니다.

이 조건은 탐색 전에 플러그인과 provider가 선언한 내용으로부터 보고되고, 노드가 렌더링되는 동안 최종 안전장치로 다시 보고됩니다. 출력되는 메시지:

pipeline PATCH targets an assembler provider’s pre-assembly fragments ("<attachment>") (파이프라인 PATCH가 어셈블러 provider의 조립 전 조각을 대상으로 합니다) pipeline PATCH targets an assembler provider’s pre-assembly fragments (node "<instance>", <scope>-scope document "<key>" is rendered by an assembler provider). the post-assembly phase re-runs this PATCH once the documents are discrete (파이프라인 PATCH가 어셈블러 provider의 조립 전 조각을 대상으로 합니다. 문서가 개별 문서가 되면 조립 후 단계에서 이 PATCH를 다시 실행합니다)

해결 방법: Feature 자체 문서 대신 component의 문서를 지정합니다. 이것이 병합 후 재실행되는 형태입니다. 또는 component를 디스패치 그룹을 합치지 않는 provider로 옮기거나, 단계를 제거합니다. 셋 중 무엇이 맞는지는 단계가 무엇을 바꾸려고 작성되었는지에 달려 있으며, 메시지가 지정된 스코프를 명시하므로 판단할 수 있습니다. FeatureRecipe 자체의 capability:를 바꾸는 것은 해결책이 아닙니다. 병합 후 재실행에 어느 스코프가 전달되는지는 바뀌지 않으며, 이 조건은 바로 그 점에 관한 것입니다.

A pipeline step’s plugin does not claim the provider rendering what it addresses (파이프라인 단계의 플러그인이 지정 대상을 렌더링하는 provider를 지원한다고 선언하지 않음)

파이프라인 단계가 사용하는 플러그인은 테스트를 거친 provider를 선언할 수 있습니다. 이 목록은 암묵적인 “비슷한 것이면 무엇이든”이 아니라 명시적인 선언입니다. 플러그인이 명시하지 않은 provider에 대해 플러그인을 실행하면 다른 출력 형태에 맞춰 작성된 패치가 적용될 위험이 있으므로, 빌드는 시도하지 않고 중지합니다.

단계와 대조되는 provider는 그 단계가 지정하는 문서를 렌더링하는 provider입니다. component의 문서에 대한 단계라면 component 자체의 provider이고, Feature의 문서에 대한 단계라면 Feature 자체의 provider입니다. component에 연결된 Feature에서는 두 경우가 모두 생기며, 이는 서로 다른 두 문서에서 나온 서로 다른 두 값입니다.

비어 있거나 없는 선언 목록은 아무것과도 일치하지 않으므로, 그러한 플러그인을 사용하는 모든 단계가 여기에서 보고됩니다. 빌드가 플러그인에 질의할 수 없었던 경우는 다르며 여기에서 보고되지 않습니다. 얻을 수 없는 자체 보고는 빈 선언이 아니라 선언의 부재이며, 그러한 단계는 해석, 로드 또는 자체 보고 실패 자체로 중지되고, 고쳐야 할 것도 그 실패입니다.

이 조건은 빌드가 모든 플러그인이 자신에 대해 선언하는 내용을 파악한 시점, 즉 해당 단계를 호출할 실행보다 앞서 보고되며, 빌드당 한 번이 아니라 작성된 단계마다 한 번씩 보고됩니다. 따라서 작성자는 한 번의 빌드로 파이프라인에서 문제가 되는 모든 단계를 확인할 수 있습니다. Provider 이름은 정확히 일치하는지로 비교됩니다.

출력되는 메시지입니다. 첫 번째는 component 자체 파이프라인에서, 두 번째는 Feature의 파이프라인에서 나오며 두 번째는 연결도 함께 명시합니다:

pipeline plugin is not compatible with the rendering provider ("<provider>") (파이프라인 플러그인이 렌더링하는 provider와 호환되지 않습니다) pipeline plugin is not compatible with the rendering provider ("<attachment>", "<provider>") (파이프라인 플러그인이 렌더링하는 provider와 호환되지 않습니다)

해결 방법: 결과는 작성된 단계에 위치하며, 메시지가 명시하는 provider가 선언과 맞춰야 할 대상입니다. 직접 만든 플러그인이라면 해당 provider로 테스트한 뒤 플러그인이 선언하는 호환성에 그 provider를 추가합니다. 그렇지 않다면 그 provider를 지원한다고 선언하는 플러그인 버전을 선택하거나, 플러그인이 지원하는 provider로 해당 스코프를 렌더링하거나, 단계를 제거합니다.

A provider refused a node’s input (provider가 노드의 입력을 거부함)

provider는 컴포넌트에 대해 전달받은 입력을 렌더링하기 전에 검사하고, 발견한 내용을 보고할 수 있습니다. 중단 심각도의 발견 사항은 빌드를 멈추고, 경고 및 정보 심각도의 발견 사항은 빌드 출력과 함께 표시될 뿐 출력되는 바이트에는 아무 영향을 주지 않습니다.

이것은 컴파일러가 아니라 provider 자신이 입력을 읽은 결과이므로, 무엇에 이의를 제기하고 얼마나 구체적으로 표현할지는 provider가 결정합니다. 컴파일러는 컴포넌트와 provider를 명시하고, provider의 메시지를 반환된 그대로 전달합니다. provider가 여러 개를 보고한 경우 세미콜론으로 구분되어 함께 전달되므로, 한 번의 빌드로 모든 메시지를 확인할 수 있습니다.

입력이 컴포넌트 자체의 Recipe에 속하든 부착된 Feature에 속하든 같은 경로가 사용되므로, provider의 검사는 양쪽에서 동일하게 나타납니다.

출력되는 메시지:

provider rejected node input: node "<instance>", provider "<provider>": <the provider's messages>

해결 방법: provider의 메시지를 읽으십시오. 메시지는 해석된 입력 중 무엇을 받아들일 수 없었는지 알려 줍니다. 입력은 Recipe의 값과 컴포넌트 자체의 구성으로 조립되므로, 수정할 곳은 대개 그중 하나입니다. provider가 무엇을 요구하는지는 해당 provider의 레퍼런스 페이지에 나와 있습니다. provider가 문서에서 변경할 수 없는 것에 이의를 제기하는 경우, 그것은 Recipe나 플러그인을 작성한 사람에게 문의할 사항입니다.

A provider rendered the same input twice and produced different output (provider가 같은 입력을 두 번 렌더링하여 다른 출력을 생성함)

동일한 입력이 주어지면 빌드는 동일한 출력을 생성합니다. 이것은 리뷰 도구와 배포 도구가 빌드 결과를 읽을 때 기준으로 삼는 계약입니다. 선택적으로 활성화하는 빌드 모드가 이를 직접 검사합니다. 각 컴포넌트를 같은 입력으로 두 번 렌더링하고 출력된 바이트를 비교합니다. 두 렌더링 결과가 일치하지 않는 provider는 두 렌더링 사이에 상태를 유지하거나, 그 밖의 이유로 입력의 함수가 아닌 것이며, 빌드가 중단됩니다.

일반 빌드는 각 컴포넌트를 한 번만 렌더링하므로, 이 조건은 검사 모드에서만 발생합니다. 이 모드가 제공된다고 해서 일반 빌드에서 달라지는 것은 없습니다.

비교 대상은 provider가 출력한 원시 출력, 즉 렌더링된 아티팩트가 잘려 나오는 바로 그 바이트이므로, 최종 파일까지 남는 차이뿐 아니라 생성된 출력의 어느 부분에서든 차이가 있으면 감지됩니다.

출력되는 메시지:

rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic

해결 방법: 먼저 메시지가 명시한 컴포넌트를 두 번 빌드하고 출력을 비교하여 무엇이 다른지 찾으십시오. 차이가 소싱한 차트가 렌더링할 때마다 새로 생성하는 값, 예를 들어 Secret이나 ConfigMap 안의 무작위 비밀번호, 생성된 키, 타임스탬프인 경우, 결함은 provider가 아니라 그 차트의 출력에 있으며 두 가지 방법 중 하나로 직접 해결할 수 있습니다. 차트가 그 값을 위해 제공하는 설정을 통해 Recipe의 valuesMapping:에서 값을 공급하면 차트가 더 이상 값을 생성하지 않습니다. 또는 생성된 문서가 Release에 포함되어서는 안 되는 것이라면(예: 운영자가 별도로 공급하는 Secret), Recipe의 omits: 항목으로 빌드에서 제외하십시오. Recipe → omits: 필드를 참조하십시오. 그 밖의 경우 결함은 문서가 아니라 provider에 있으며, 작성하는 어떤 내용으로도 해결할 수 없습니다. 메시지가 식별한 컴포넌트를 명시하여 해당 provider를 제공하는 플러그인의 게시자에게 보고하십시오. 흔한 원인은 타임스탬프, 무작위 값, 또는 작성자가 쓴 순서가 아니라 맵의 반복 순서를 따르는 정렬입니다. 수정될 때까지 일반 빌드 모드는 영향을 받지 않으며, 검사를 통과한 버전으로 플러그인을 고정하는 것이 실질적인 대안입니다.

An omits entry left out nothing the source rendered (omits 항목이 소스가 렌더링한 것을 아무것도 제외하지 않음)

Recipe 또는 FeatureRecipe의 omits: 목록 중 빌드에 적용되는 모든 항목(when:이 없거나, 비어 있거나, 참인 항목)은 소스가 렌더링한 것 중 적어도 하나를 출력에서 제외해야 합니다. 즉 차트가 렌더링하는 문서, compose 파일이 선언하는 service, volume 또는 config, CloudFormation 템플릿이 선언하는 리소스입니다. 소스를 렌더링하는 provider는 각 항목을 렌더링한 결과와 대조하고 각 항목이 몇 개의 단위를 제외했는지 보고합니다. 아무것도 제외하지 않은 항목이 있으면 빌드가 중단됩니다.

아무것도 일치하지 않는 항목은 더 이상 사실이 아닌, 소스에 대한 진술입니다. 흔한 원인은 항목이 가리키는 것의 이름을 바꾸거나 제거한 소스 업그레이드이며, 이 경우 이름이 바뀐 문서나 service는 새 이름으로 출력에 포함되는데, 이는 바로 그 항목이 막으려던 것입니다. 다른 원인은 항목 자체의 실수입니다. 이를 그냥 넘기면 항목이 제외하려던 것이 배포되므로, 빌드는 중단되고 해당 항목을 명시합니다.

메시지는 노드, provider, 항목을 선언한 문서, 그 문서의 omits: 목록에서 0부터 센 항목의 위치, 그리고 항목이 해석된 kind, name, namespace를 명시합니다. namespace는 항목이 namespace를 지정한 경우에만 표시됩니다. 컴포넌트에 부착된 FeatureRecipe의 경우 노드는 그 컴포넌트이고, 경계에 부착된 경우에는 메시지 위의 줄이 부착과 그 경계를 명시합니다. 여러 항목이 아무것도 일치하지 않은 경우 작성한 순서에서 첫 번째 항목이 명시되므로, 실행할 때마다 같은 항목이 명시됩니다. 템플릿이 민감한 것으로 선언된 값을 읽은 필드는 해석된 값 대신 <redacted>로 표시됩니다. when:에 의해 제외된 항목은 provider에 전달되지 않으며 검사되지도 않습니다.

출력되는 메시지. 범주는 대괄호로 묶인 머리 부분에 표시됩니다:

an omits entry left out nothing the source rendered (node "<node-id>", provider "<provider>", "<document>" omits[<position>], kind "<kind>", name "<name>", namespace "<namespace>"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause

머리 부분에는 이 조건의 짧은 코드 E0334가 표시됩니다.

해결 방법: 항목을 소스가 현재 렌더링하는 것과 비교하십시오. 항목을 제거한 상태로 빌드하여 컴포넌트가 렌더링하는 내용을 확인한 다음, 항목의 kind, name 또는 namespace를 수정하거나, 항목이 가리키던 것이 사라졌다면 항목을 제거하십시오. 차트의 경우 항목은 문서 자체의 kind, metadata.name, 그리고 항목이 namespace를 지정한 경우 문서가 속한 namespace로 문서를 지정합니다. compose 파일의 경우 service, volume 또는 config를 키로 지정합니다. CloudFormation 템플릿의 경우 소스의 어느 템플릿에서든 리소스를 Type과 논리 ID로 지정합니다. Recipe → omits: 필드를 참조하십시오.

A provider’s omitted counts do not match the omits entries it was handed (provider의 제외 개수가 전달받은 omits 항목과 일치하지 않음)

렌더링된 단위를 제외한다고 선언하는 provider는 전달받은 모든 omits: 항목에 대해 그 항목이 몇 개의 단위와 일치했는지 보고합니다. 항목마다 하나의 개수를, 항목이 전달된 순서대로 보고합니다. 보고가 없거나, 개수가 너무 적거나 많거나, 0보다 작은 개수가 들어 있으면 항목이 무언가를 제외했는지 알 방법이 없으므로 빌드가 중단됩니다. 작성한 내용이 원인이 아닙니다. 이 조건은 반환한 출력이 스스로 선언한 계약을 지키지 않는 provider를 보고합니다.

출력되는 메시지. 메시지는 노드와 provider를 명시한 다음, 전달된 항목 수와 반환된 내용, 즉 개수가 몇 개였는지 또는 0보다 작은 개수와 그 개수가 주어진 항목을 명시합니다:

a provider’s omitted counts do not match the omits entries it was handed (node "<node-id>", provider "<provider>", handed <n> omits entries, returned <m> omitted counts) (provider의 제외 개수가 전달받은 omits 항목과 일치하지 않음)

헤드에는 이 조건의 짧은 코드 E0336이 들어 있습니다.

해결 방법: 해당 provider를 제공하는 플러그인의 게시자에게 메시지가 식별하는 컴포넌트를 명시하여 보고합니다. provider가 지켜야 할 사항은 플러그인 계약의 렌더링된 단위 제외에 설명되어 있습니다.

Assembled output still carries a cross-boundary placeholder (조립된 출력에 경계 간 자리 표시자가 남아 있음)

의존성 연결이 조립된 두 출력 사이를 가로지르는 경우, 연결이 전달하는 값은 소비하는 쪽이 렌더링되는 동안에는 알 수 없습니다. 그 값은 다른 쪽에서 게시되며 양쪽이 모두 조립된 후에 해석됩니다. 따라서 빌드는 소비하는 컴포넌트의 입력에 자리 표시자를 기록하고, 조립이 완료되면 provider가 이를 자체 형식의 교차 참조로 대체합니다.

이 조건은 그 대체 과정에서 살아남은 자리 표시자를 보고합니다. 살아남았다는 것은 해석이 그 자리 표시자에 도달하지 못했다는 뜻입니다. 값이 provider가 다룰 수 없는 위치에 놓였거나(대개 값 전체로 존재하지 않고 더 긴 문자열 안에 이어 붙여진 경우입니다), 반대편에 해석할 대상이 없는 경계 교차가 표시된 경우입니다. 자리 표시자는 결코 유효한 출력이 아니므로, 빌드는 자리 표시자가 포함된 파일을 내보내지 않고 중단됩니다.

메시지는 파일을 작성한 provider와 파일이 위치한 경로를 명시합니다. 경로는 하나의 조립 안에서만 고유하므로 둘을 함께 써야 하나의 파일을 식별할 수 있습니다. 첫 번째 파일만이 아니라 문제가 있는 모든 파일이 보고되며, 각 파일은 그 파일이 속한 조립에 몇 개의 경계가 기여했든 한 번만 보고됩니다. 보고는 Release 문서 내부의 경계가 아니라 Release 문서 전체를 대상으로 합니다. 결함은 경계 선언이 아니라 값이 파일에 도달한 방식에 있으므로, 변경해야 할 경계 선언은 없습니다.

출력되는 메시지:

assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>") (조립된 출력에 해석되지 않은 경계 간 링크 자리 표시자가 남아 있음)

해결 방법: 가장 흔한 원인은 소비하는 쪽이 값을 더 긴 문자열에 보간한 경우입니다. 교차 참조는 주입되는 값 전체로 존재해야 하므로, Recipe의 매핑을 변경하여 값을 온전히 전달하고 대신 대상 자체의 어휘로 그 주변을 구성합니다. 값이 온전히 존재하는데도 자리 표시자가 남아 있다면 결함은 해석의 provider 쪽에 있으며, 해당 플러그인의 게시자가 처리할 문제입니다.

템플릿은 생산자의 값을 연결에서 직접 .context.uses.<alias>.provides로 읽을 수 있으며, 경계 범위 FeatureRecipe에서는 .boundary 아래의 경계 연결에서 읽습니다. 연결이 서로 다른 출력으로 렌더링되는 두 컴포넌트를 잇고 provider가 자체 참조로 이를 연결하는 경우, 그 값들은 각각 플레이스홀더로 템플릿에 도달하며 provider는 두 출력이 모두 조립되면 이를 교체합니다. 교체되는 것은 스택 간 참조이거나 값 자체입니다. 따라서 템플릿은 이런 값을 복사만 할 수 있습니다. 값을 통째로 쓰거나, 더 긴 문자열 안에 쓰거나, quote처럼 값을 그대로 두는 함수를 거쳐 쓰는 것입니다.

비교, 분기, 길이, 또는 값을 바꾸는 함수(eq, if, len, upper, trimPrefix)는 값이 아니라 플레이스홀더를 기준으로, 아무 표시 없이 판정됩니다. 빌드는 템플릿을 두 번 평가하여 이를 검사합니다. 한 번은 플레이스홀더로, 한 번은 실제 값으로 평가하며, 각 플레이스홀더를 다시 써 넣은 뒤 둘이 일치하지 않으면 중단합니다. 이는 이런 연결을 읽는 모든 템플릿에 적용됩니다. Recipe 자체의 템플릿, 연결된 FeatureRecipe의 injectMapping:, 경계 범위 FeatureRecipe의 템플릿입니다.

메시지는 템플릿(필드와 그것이 속한 Recipe)을 명시하고, 차이를 좌우하는 provides 값마다 소비 컴포넌트, 연결의 별칭과 소켓, 생산 컴포넌트를 명시합니다. 템플릿이 복사만 한 값은 명시되지 않습니다.

출력되는 메시지:

a template does more than copy a value it reads off a cross-boundary link (template "<template>", provides key "<key>" that component "<consumer>" reads off its connection "<alias>" on socket "<socket>" to component "<producer>"). Copy the value as it stands, whole or inside a larger string, because the provider writes in its place what the value becomes in the other output, and branch on a value of the component’s own instead (템플릿이 경계 간 링크에서 읽은 값을 복사하는 것 이상으로 다룹니다. 메시지는 템플릿, provides 키, 소켓 위의 연결에서 그 키를 읽는 소비 컴포넌트, 생산 컴포넌트를 명시합니다. provider가 그 자리에 다른 출력에서 그 값이 되는 것을 쓰므로 값을 통째로 또는 더 긴 문자열 안에 그대로 복사하고, 대신 컴포넌트 자체의 값으로 분기하십시오)

해결 방법: 메시지가 명시한 값을 테스트하거나 변환하지 말고 복사하며, 결정은 연결이 읽는 값이 아니라 소비 컴포넌트가 직접 작성하는 값, 즉 자신의 values 또는 infra 키 중 하나를 기준으로 내리십시오. 복사된 값이 다른 스택에서 무엇이 되는지는 CloudFormation provider에서 설명합니다.

A provider named a directory for a contributor that is not one directory (provider가 기여자에 대해 단일 디렉터리가 아닌 디렉터리를 지정함)

하나의 상위 출력 안에서 각 기여자를 고유한 위치에 배치하는 provider는 그 위치들이 놓일 디렉터리를 선언하며, 빌드는 각 컴포넌트의 식별자를 그 안에 조합합니다. 이 값은 정확히 하나의 디렉터리를 지정해야 합니다. 경로 구분자가 포함되거나 현재 디렉터리 또는 상위 디렉터리를 지정하는 값은 컴포넌트의 파일을 고유 위치 아래가 아닌 다른 곳에 배치하게 되어, 조립 바깥으로 완전히 벗어나거나 조립 안에서 조용히 재배치됩니다.

빌드는 그러한 경로를 조합하지 않고 중단됩니다. 메시지는 값을 선언한 provider와 값 자체를 명시하므로, 어떤 provider를 변경해야 하고 무엇을 선언했는지 분명히 알 수 있습니다.

그러한 디렉터리를 선언하지 않는 provider는 영향을 받지 않습니다. 이 경우 각 기여자는 자기 이름으로 배포 디렉터리 바로 아래에 위치하므로, 상위 디렉터리를 지정하지 않는 것은 누락이 아니라 정당한 선택입니다.

출력되는 메시지:

provider named a directory for each contributor’s own sub-directory that is not a single directory name: provider "<provider>" declared nest_segment "<value>"; the value must name one directory, carrying no path separator and naming neither the current nor the parent directory (provider가 각 기여자의 하위 디렉터리에 대해 단일 디렉터리 이름이 아닌 디렉터리를 지정함)

해결 방법: 어떤 카탈로그 문서도 이 값을 만들지 않으므로 직접 작성한 파일에서 수정할 것은 없습니다. 이 값은 provider를 제공하는 플러그인에서 나옵니다. 메시지가 명시하는 값을 인용하여 해당 플러그인의 게시자에게 보고합니다. 플러그인을 직접 작성한 경우에는 단일 디렉터리 이름을 선언하거나, 아무것도 선언하지 않고 각 기여자가 배포 디렉터리에 위치하도록 합니다.

A boundary-scope Feature is attached only to a component (경계 범위 Feature가 컴포넌트에만 연결됨)

FeatureRecipe는 컴포넌트마다 한 번씩이 아니라 경계에 대해 한 번 생성한다고 선언할 수 있습니다. 컴포넌트마다 하나씩이 아니라 경계가 포함하는 모든 것에 대해 하나의 공유 리소스를 생성하는 것입니다. 따라서 그러한 연결은 경계에 작성해야 합니다. 그 이름의 연결을 컴포넌트에만 작성하면 레시피가 생성할 범위가 지정되지 않으므로, 어느 경계에서 실행할지, 어떤 값을 읽을지, 출력을 어디에 기록할지 결정할 수 없습니다.

컴포넌트에도 함께 작성하는 것은 일반적이며 보고되지 않습니다. 경계에 선언된 연결은 그 경계에 중첩된 범위에 있는 컴포넌트를 포함하여 경계가 포함하는 모든 컴포넌트에 적용되므로, 이를 함께 기재하는 것이 일반적인 형태입니다. 검사하는 것은 컴포넌트 자신의 범위나 이를 감싸는 범위가 그 이름을 선언하는지 여부입니다. 검색은 컴포넌트가 위치한 곳에서 바깥쪽으로 진행하며 이름을 선언한 첫 번째 범위에서 멈춥니다. 감싸는 범위가 이미 선언한 연결을 컴포넌트가 자신에게 다시 기재하면 범위에만 기재한 형태와 똑같이 렌더링되며, 같은 이유로 허용됩니다.

어떤 범위에도 배치되지 않은 컴포넌트는 탐색할 대상이 없으므로, 그 컴포넌트의 경계 범위 연결은 여기서 보고됩니다. 그러한 레시피가 생성할 수 있는 범위가 없으므로 이것이 정확한 해석입니다.

출력되는 메시지. 연결과 컴포넌트가 위치한 범위를 명시합니다:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>", on a component in boundary "<boundary>") (연결이 executionScope: boundary인 FeatureRecipe를 바인딩하지만 컴포넌트를 포함하는 어떤 경계도 이를 선언하지 않음)

그리고 어떤 범위에도 속하지 않아 그러한 값을 제공하지 않는 컴포넌트의 경우:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>") (연결이 executionScope: boundary인 FeatureRecipe를 바인딩하지만 컴포넌트를 포함하는 어떤 경계도 이를 선언하지 않음)

해결 방법: 연결을 컴포넌트에만 선언하지 말고, 생성 대상이 될 경계, 즉 컴포넌트가 위치한 범위나 이를 감싸는 범위의 features: 아래에 선언합니다. 컴포넌트별 생성을 의도했다면, 대신 FeatureRecipe가 경계 범위를 선언하지 않는 Feature를 연결합니다.

The sandbox refused a plugin (샌드박스가 플러그인을 거부함)

모든 플러그인은 작업을 수행하도록 허용되기 전에 자신이 무엇이고 무엇이 필요한지 보고하며, 샌드박스는 그 보고를 자신이 허용할 준비가 된 범위와 대조합니다. 이 조건은 샌드박스가 받아들이지 않는 보고 전체를 포괄하며, 문장은 그중 어느 부분이 거부되었는지 알려 줍니다. 호스트가 지원하지 않는 플러그인 인터페이스 버전, 호스트에 해당 어휘가 없는 플러그인 종류, 외부 네트워크 접근이나 파일 시스템 접근을 요청하는 플러그인, 호스트가 제공하는 집합 밖의 호스트 호출을 지정하거나 허용된 집합 밖의 네임스페이스에서 가져오는 플러그인, 누락되었거나 형식이 잘못된 export, 닫힌 집합 밖의 값을 가진 필드, 또는 아예 읽을 수 없는 자체 보고가 그것입니다.

거부는 플러그인이 실행되기 전에 일어나며, 거부된 플러그인은 실패가 전달되기 전에 종료되므로 요청한 것이 잠시라도 허용되는 일은 없습니다.

플러그인이 가질 수 없는 것 중 일부는 처음부터 허용되지 않으므로 여기서 검사하지 않습니다. 호스트는 게스트에게 고정된 시계를 주고, 파일 시스템도, 환경도, 자체 출력을 보낼 곳도 주지 않으므로, 이들 중 어느 것에 접근하려는 게스트는 미리 거부되는 것이 아니라 시도하는 시점에 실패합니다. 이 조건이 다루는 것은 플러그인이 자신에 대해 하는 보고이며, 시작 전에 검사됩니다.

출력되는 메시지. 각 메시지의 끝에는 조건의 문장이 오고, 그 앞부분은 플러그인과 보고 중 거부된 부분을 지정합니다. 호스트가 지원하지 않는 인터페이스 버전:

plugin "<plugin>" declares abi_version "<declared>"; host speaks "<supported>": wasm: plugin rejected by the sandbox (플러그인이 선언한 abi_version을 호스트가 지원하지 않음: wasm: 샌드박스가 플러그인을 거부함)

호스트에 해당 어휘가 없는 플러그인 종류:

plugin "<plugin>" declares unknown plugin_type "<declared>": wasm: plugin rejected by the sandbox (플러그인이 알 수 없는 plugin_type을 선언함: wasm: 샌드박스가 플러그인을 거부함)

읽을 수 없는 자체 보고:

wasm: plugin "<plugin>" describe() output is not valid JSON: <what the read reported>: wasm: plugin rejected by the sandbox (wasm: 플러그인의 describe() 출력이 유효한 JSON이 아님: wasm: 샌드박스가 플러그인을 거부함)

종류가 요구하는 export가 없는 플러그인. 종류 자체를 읽어 오는 것과 같은 레지스트리에서 이름을 가져옵니다:

<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox (플러그인이 필요한 export를 선언하지 않음: wasm: 샌드박스가 플러그인을 거부함)

고정된 집합으로 닫힌 필드가 다른 값을 가진 경우. 같은 형태가 assembly 모드와 export별 operates 및 scope 필드에도 적용됩니다:

plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox (플러그인의 export가 알 수 없는 scope를 선언함: wasm: 샌드박스가 플러그인을 거부함)

쌍을 이루는 기능이 두 export 없이 선언되었거나, export가 해당 선언 없이 있는 경우:

plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox (플러그인이 경계 간 연결 기능을 선언했지만 두 export를 모두 내보내지 않음: wasm: 샌드박스가 플러그인을 거부함)

Recipe가 결코 선택할 수 없는 기능 이름. 콜론이 포함된 이름을 제공하는 provider나 그런 이름과 호환되는 파이프라인 단계가 해당하며, 이는 Recipe의 capability:가 마지막 콜론까지는 이름으로, 그 뒤는 버전 고정으로 읽히기 때문입니다. 파서의 parse:<format>과 임포터의 import:<format>은 거부되지 않습니다. 콜론이 그 이름의 일부이고, Recipe를 통하지 않고 형식으로 조회되기 때문입니다. 같은 거부로 인해 이런 플러그인의 엔터티는 배포용으로 생성되지도 않습니다:

plugin "<plugin>" (plugin_type "provider") serves the capability "<name>", which contains a colon; a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so no Recipe can name "<name>": report the capability name without a colon: wasm: plugin rejected by the sandbox (플러그인이 콜론을 포함한 capability를 제공함. Recipe의 capability 참조는 마지막 콜론까지를 capability로, 그 뒤를 버전 고정으로 읽으므로 어떤 Recipe도 이 이름을 지정할 수 없음: 콜론 없는 capability 이름을 보고해야 함: wasm: 샌드박스가 플러그인을 거부함)

그리고 플러그인이 선언한 호스트 호출과 바이너리가 실제로 사용하는 호스트 호출의 대조. 이는 양방향으로 검사되므로 플러그인은 사용하지 않는 인터페이스를 내세울 수도, 사용하는 인터페이스를 숨길 수도 없습니다:

plugin "<plugin>" declares host function "<name>" in describe() that its wasm does not import: wasm: plugin rejected by the sandbox (플러그인이 describe()에서 wasm이 가져오지 않는 호스트 함수를 선언함: wasm: 샌드박스가 플러그인을 거부함) plugin "<plugin>" imports host function "<name>" that its describe() does not declare: wasm: plugin rejected by the sandbox (플러그인이 describe()에서 선언하지 않은 호스트 함수를 가져옴: wasm: 샌드박스가 플러그인을 거부함)

해결 방법: 엔터티 파일의 어떤 내용도 이 조건의 원인이 아니며 작성 내용을 바꿔서는 해결되지 않습니다. 거부되는 보고는 플러그인 자신의 것입니다. 배포된 플러그인을 사용하는 경우 메시지를 해당 플러그인 배포자에게 보고하고, 그동안에는 호스트가 받아들이는 버전을 선택합니다. 직접 만든 플러그인이라면 메시지가 필드와 두 값을 모두 지정하므로 문장이 가리키는 대로 수정하면 됩니다. 호스트가 지원하는 인터페이스 버전을 사용하고, 호스트가 아는 종류를 선언하고, 모든 필드를 닫힌 집합 안의 값으로 유지하고, 종류가 요구하는 export를 선언하고, 바이너리가 사용하는 호스트 호출을 더도 덜도 없이 정확히 선언합니다.

A plugin is not the kind of plugin the socket expects (플러그인이 소켓이 기대하는 종류가 아님)

각 연결 지점은 어떤 종류의 플러그인으로 디스패치하는지 명시하고, 모든 플러그인은 자신의 종류를 보고합니다. 이 조건은 둘이 일치하지 않을 때 보고됩니다. 린터가 기대되는 곳에 연결된 provider 제공 플러그인, 임포터가 기대되는 곳에 연결된 파서, 터미널 명령이 아닌데 터미널 명령으로 실행된 플러그인 등이 해당합니다. 검사는 플러그인이 로드될 때 이루어지므로 잘못된 종류의 플러그인은 요청받았을 작업에 도달하지 않습니다.

그래도 시도하지 않고 중단하는 이유는 종류마다 인터페이스가 다르기 때문입니다. 다른 종류의 플러그인은 자신에게 없는 export를 통해 호출될 것이고, 돌아온 결과는 그 플러그인이 만든 적 없는 형태로 읽힐 것입니다.

종류를 단정하지 않고 플러그인의 자체 보고를 읽는 경우는 영향을 받지 않습니다. 구성된 항목을 나열하거나 플러그인용 엔터티를 생성하는 것처럼 플러그인이 자신에 대해 무엇이라고 하는지만 알고자 하는 기능은 기대하는 종류를 명시하지 않으며, 그곳에서는 이 검사를 건너뜁니다.

출력되는 메시지. 플러그인과 두 종류를 지정하며, 기대되는 종류는 선언된 값과 함께 말로도 제시됩니다:

wasm: plugin "<plugin>": expected a <kind in words> plugin (plugin type "<expected>") but its describe() reports plugin type "<reported>": wasm: declared plugin type does not match plugin describe() (wasm: 예상한 종류의 플러그인이 아니며 describe()가 다른 plugin type을 보고함: wasm: 선언된 plugin type이 플러그인의 describe()와 일치하지 않음)

해결 방법: 연결 지점이 받는 종류의 플러그인을 연결합니다. 메시지에 기대되는 종류가 나와 있습니다. 의도한 플러그인이 맞다면 연결 위치가 잘못된 것이므로 그 종류에 맞는 기능으로 옮깁니다. 직접 만든 플러그인이 기대되는 종류여야 한다면 플러그인이 자신에 대해 잘못된 종류를 보고하고 있는 것이며, 이는 연결하는 구성이 아니라 플러그인에서 수정해야 합니다.

A plugin failed while it was running (플러그인이 실행 중에 실패했습니다)

작업을 요청받은 플러그인이 결과를 반환하지 않았습니다. 세 가지 조건이 이 경우를 다루며, 이들을 구분하는 것은 실패가 전달된 방식뿐입니다. 충돌한 플러그인, 스스로 실행을 중단한 플러그인, 그리고 끝까지 실행된 뒤 요청받은 작업을 수행할 수 없다고 보고한 플러그인입니다. 이들은 의도적으로 하나의 분류 체계를 이루며, 빌드가 플러그인이 실패하는 모든 방식을 동일하게 다루도록 합니다.

충돌한 플러그인. 플러그인 내부의 대부분의 결함(도달할 수 없는 명령어, 0으로 나누기, 메모리 밖 읽기)은 빠져나오는 과정에서 일반적인 실패로 바뀌므로 이 조건에 도달하지 않습니다. 이 조건은 그 경로 뒤에 놓인 안전망으로, 그 경로를 벗어난 충돌을 위한 것입니다.

스스로 실행을 중단한 플러그인. 종료를 요청하는 플러그인은 플러그인 모델에 쓰임이 없는 일을 하는 것입니다. 플러그인은 종료가 아니라 자신이 호출된 호출을 통해 결과를 반환합니다. 해당 플러그인의 실행만 중단되며, 빌드 프로세스는 영향을 받지 않습니다.

실패를 보고한 플러그인. 플러그인이 반환하는 결과 봉투에는 작업을 완료할 수 없었다고 알릴 자리가 있으며, 그렇게 알리는 메시지는 결과로 읽히지 않고 실패로 전달됩니다.

출력되는 메시지는 각각 플러그인 또는 export를 명시하며, 실패가 제공한 내용을 담습니다. 충돌은 복구된 값을 담습니다.

wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call (wasm: 게스트 플러그인이 호출 중에 패닉을 일으켰습니다)

스스로 중단한 플러그인은 중단 시의 코드를 담습니다.

wasm: plugin "<plugin>" call to <export> invoked proc_exit(<code>): wasm: plugin invoked proc_exit (wasm: 플러그인이 proc_exit를 호출했습니다)

보고된 실패는 플러그인 자체의 메시지를 담습니다.

call "<export>": wasm: guest plugin reported an error: <the plugin's message> (게스트 플러그인이 오류를 보고했습니다)

해결 방법: 세 가지 모두 엔티티 파일에 원인이 있지 않으며, 작성 내용을 바꿔도 해소되지 않습니다. 각각은 플러그인 내부의 결함입니다. 메시지가 가리키는 export를 명시하여 플러그인 게시자에게 메시지를 보고하고, 수정되는 동안 정상 동작했던 버전으로 플러그인을 고정하십시오. 직접 작성한 플러그인이라면 충돌하거나 종료하지 말고 결과 봉투로 실패를 반환하여 빌드가 표시할 수 있는 메시지를 받도록 하십시오. 또한 보고된 실패가 플러그인의 숙고된 응답이라면 그 메시지가 독자에게 표시되므로, 입력의 어떤 부분을 받아들일 수 없었는지 밝혀 두는 것이 좋습니다.

A plugin returned something that is not the shape the socket reads (플러그인이 소켓이 읽는 형태가 아닌 것을 반환했습니다)

모든 연결 지점은 돌려받은 결과를 자신이 기대하는 형태에 대조하여 읽으며, 그 외의 것은 거부합니다. 형태에 선언되지 않은 필드, 값이 선언된 타입이 아닌 필드, 또는 올바른 형식의 결과가 전혀 아닌 바이트가 이에 해당합니다.

읽을 수 있는 부분만 읽지 않고 거부하는 이유는, 그렇게 읽으면 아무 표시 없이 진행되기 때문입니다. 연결이 호출하는 export는 연결마다 선택할 수 있으므로, 연결이 결과 형태가 완전히 다른 export를 지정할 수 있습니다. 맞지 않는 부분을 건너뛰면 빈 결과가 나오는데, 빈 결과 자체도 정당한 응답입니다. 반환된 판정도 없고 제기된 발견 사항도 없다는 뜻이기 때문입니다. 그러면 두 경우를 구별할 수 없게 되고, 빌드는 마치 플러그인이 승인한 것처럼 그대로 진행됩니다.

출력되는 메시지는 결과를 돌려준 export를 명시하고 읽기가 실패한 이유를 담습니다. 둘을 함께 보면 연결이 지정했어야 할 export를 알 수 있습니다.

call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read> (게스트 플러그인이 소켓이 읽는 형태가 아닌 출력을 반환했습니다)

해결 방법: 연결이 지정한 진입 함수를 플러그인이 선언한 export와 대조하십시오. 잘못된 export를 가리키는 연결이 흔한 원인이며, 메시지의 이유가 맞지 않는 필드를 알려 줍니다. export가 올바르다면 플러그인이 연결 지점이 읽지 않는 형태를 반환하고 있는 것이므로 플러그인을 수정해야 합니다. export와 이유를 모두 인용하여 게시자에게 보고하십시오.

A plugin returned a diagnostic at a severity that is not declared (플러그인이 선언되지 않은 심각도의 진단을 반환했습니다)

플러그인은 결과와 함께 관찰 사항을 반환할 수 있으며, 각 관찰 사항은 닫힌 집합의 심각도를 가집니다. 빌드를 중단하고 수정할 내용을 알리는 것, 완료되는 빌드 옆에 표시되는 것, 관찰 사항을 기록만 하고 아무것도 바꾸지 않는 것입니다. 이 집합 밖의 심각도는 호스트가 처리할 경로가 없으므로 빌드가 중단됩니다.

경로를 임의로 고르지 않고 거부하는 이유는 두 대안 모두 더 나쁘기 때문입니다. 처리할 수 없는 관찰 사항을 건너뛰면 할 일이 없는 것으로 취급하게 되는데, 플러그인이 빌드 수락 여부를 결정하는 경우라면 이는 승인으로 읽힙니다. 플러그인이 제기한 이의가 한 번도 표시되지 않은 채 빌드를 통과시키게 됩니다. 중단 심각도로 취급하면 아무도 선택하지 않은 값 때문에 빌드를 거부하게 됩니다. 둘 다 아무 표시 없이 일어나므로, 호스트는 값이 잘못되었다고 알리고 대신 플러그인을 수정하게 합니다.

이 검사는 관찰 사항이 나중에 표시되는 각 위치가 아니라 결과를 읽는 지점에서 한 번 실행됩니다. 이 지점은 플러그인의 식별 정보를 아직 알 수 있는 유일한 지점이기도 합니다. 보고서에 합쳐진 관찰 사항은 어떤 플러그인이 제기했는지 더 이상 알지 못하기 때문입니다.

출력되는 메시지는 플러그인, export, 문제가 된 관찰 사항, 그 값, 그리고 선언된 값들을 명시합니다.

plugin "<plugin>" call "<export>": wasm: guest plugin returned a diagnostic whose severity the contract does not declare: diagnostic <index> has severity "<value>"; the declared severities are "halt", "warn" and "info" (게스트 플러그인이 계약에 선언되지 않은 심각도의 진단을 반환했습니다. 해당 진단의 심각도는 선언된 세 가지 심각도 중 하나가 아닙니다)

해결 방법: 엔티티 파일에 원인이 있지 않습니다. 값은 플러그인에서 나왔습니다. 메시지가 명시한 값을 인용하여 플러그인 게시자에게 보고하십시오. 직접 작성한 플러그인이라면 선언된 세 가지 심각도 중 하나를 출력하십시오. 메시지가 이들을 명시하며, 인덱스는 살펴볼 관찰 사항을 알려 줍니다.

A provider returned two output files under one path (provider가 하나의 경로에 두 개의 출력 파일을 반환했습니다)

provider는 출력을 파일 목록으로 반환하며, 각 파일은 자신이 기록될 경로를 명시합니다. 호스트는 이 파일들을 경로를 키로 하여 수집하고, 자체 직렬화기를 실행하지 않은 채 각 파일의 바이트를 그대로 기록합니다. 두 파일이 같은 경로를 명시하면 그 수집 결과에 하나의 키에 대한 두 값이 남습니다.

하나를 고르지 않고 거부하는 이유는, 어느 쪽을 골라도 나중에 구별할 수 없기 때문입니다. 마지막 것을 유지하면 provider가 기록하라고 한 파일 하나가 버려지고, 첫 번째 것을 유지하면 나중 파일이 버려집니다. 어느 쪽이든 디스크의 출력은 올바른 형식이면서 파일 하나가 부족하고, 파일이 버려졌다는 기록은 남지 않습니다. 또한 남은 경로는 어차피 남았을 경로이므로, 결과의 어떤 부분도 충돌이 있었음을 알려 주지 않습니다. 둘 중 어느 것이 의도된 것인지는 provider만 답할 수 있습니다.

이 조건은 provider가 파일을 반환하는 모든 곳, 즉 하나의 노드를 렌더링할 때와 디스패치 그룹의 출력을 하나의 아티팩트로 조립할 때 발생합니다. 두 경우 모두 조건과 해결 방법이 같으므로 둘 다 이를 보고합니다.

출력되는 메시지는 두 번 반환된 경로와 그 경로가 반환된 노드 또는 디스패치 경로를 명시합니다.

provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>") (provider 게스트가 하나의 경로에 두 개의 출력 파일을 반환했습니다. 규격을 따르는 게스트는 각 출력 경로를 최대 한 번만 반환합니다)

해결 방법: 엔티티 파일에 원인이 있지 않습니다. 경로는 provider에서 나왔습니다. 메시지가 명시한 경로를 인용하여 게시자에게 보고하십시오. 직접 작성한 provider라면 각 출력 경로를 최대 한 번만 반환하십시오. 경로 목록을 집합에 대조하며 만들어 한 경로의 두 번째 파일이 생성되는 지점에서 잡히도록 하고, 두 파일이 모두 필요하다면 두 번째 파일에 별도의 경로를 지정하십시오.

A provider reported a render fact whose value is not a list (프로바이더가 값이 리스트가 아닌 렌더 사실을 보고함)

프로바이더는 파일과 함께 자신이 렌더링한 출력에 대한 사실을 보고할 수 있으며(각각 이름과 값으로 이루어지고, 해당 프로바이더 자체의 문서화된 어휘를 따릅니다), 컴포넌트에 연결된 Features는 템플릿에서 이를 읽습니다. 모든 사실의 값은 항목이 하나뿐이더라도 리스트입니다. 하나의 이름은 컴포넌트의 여러 렌더, 즉 컴포넌트 자체의 프로바이더 호출과 그 컴포넌트에 연결된 Features의 렌더에서 보고될 수 있으며, 이 리스트들은 그 이름을 읽는 템플릿을 위해 해당 이름 아래 하나로 합쳐집니다. 프로바이더는 렌더링 시점에 자신의 보고가 그 이름 아래 유일한 보고가 될지 알 수 없으므로, 값이 객체, 문자열, 숫자, 불리언 또는 null이면 어떤 템플릿이 그 사실을 읽는지와 관계없이 모든 렌더에서 프로바이더가 이를 넘겨주는 지점에서 거부됩니다.

출력되는 메시지는 사실, 그 사실이 보고된 노드, 이를 보고한 프로바이더, 그리고 값이 무엇이었는지를 나타냅니다.

provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact’s value as a JSON array, even with one entry (fact "<fact>", node "<node>", provider "<provider>", its value is <kind>) (프로바이더 게스트가 값이 리스트가 아닌 렌더 사실을 보고했습니다. 규격을 따르는 게스트는 항목이 하나뿐이더라도 모든 렌더 사실의 값을 JSON 배열로 보고합니다)

해결 방법: 엔터티 파일의 어떤 내용도 이 문제의 원인이 아닙니다. 값은 프로바이더에서 왔습니다. 메시지가 나타내는 사실을 인용하여 프로바이더 게시자에게 보고하십시오. 직접 작성한 프로바이더라면 해당 사실의 값을 JSON 배열로 보고하고(단일 객체는 그 객체를 담은 리스트가 됩니다), 프로바이더가 보고하는 사실의 문서에서 이를 리스트로 기술하십시오. 게스트가 출력한 내용에 대한 사실 보고를 참조하십시오.

연결이 두 디스패치 그룹 사이를 가로지르면 양쪽의 프로바이더에게 연결 구성을 요청합니다. 소비되는 쪽은 식별자를 게시하고, 소비하는 쪽은 이를 기준으로 해석하며, 각각 자기 그룹의 출력에 적용할 구조적 연결 구성을 반환할 수 있습니다. 각 연결 구성은 적용 대상 출력 파일을 지정합니다. 이후 단계에서 그 파일을 분할하고, 작업을 적용한 뒤, 바이트 단위로 충실하게 다시 조립합니다.

출력된 어떤 파일과도 일치하지 않는 이름은 그 단계에 분할할 대상을 남기지 않으며, 이 경우 연결 구성을 건너뛰지 않고 거부합니다. 연결 구성이 담은 작업이 연결을 해석하는 것이므로, 이를 버리면 조립된 출력이 아무것도 연결하지 않은 엔드포인트를 참조하게 됩니다. 이는 원인이 된 프로바이더와 멀리 떨어진 배포 시점에 실패하며, 연결 구성이 아니라 연결 자체의 실수처럼 보입니다.

연결 구성이 지정할 수 있는 파일은 해당 그룹 자체의 렌더가 반환한 파일입니다. 이 파일들은 같은 호출에서 프로바이더에게 전달되므로, 프로바이더는 이름을 추측할 필요 없이 주어진 집합에서 하나를 선택하면 됩니다.

출력되는 메시지는 연결 구성이 요청한 파일과 그것이 반환된 엔드포인트를 나타냅니다.

link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group’s own render returned (file "<file>", node "<node>") (링크 패치가 디스패치 그룹이 출력하지 않은 출력 파일을 지정합니다. 규격을 따르는 링크 패치는 그룹 자체의 렌더가 반환한 파일을 지정합니다)

해결 방법: 엔터티 파일의 어떤 내용도 이 문제의 원인이 아닙니다. 이름은 프로바이더에서 왔습니다. 메시지가 나타내는 파일을 인용하여 프로바이더 게시자에게 보고하십시오. 직접 작성한 프로바이더라면 별도로 구성한 이름이 아니라 호출이 전달하는 조립된 파일에서 파일 이름을 가져오십시오. 직접 구성한 경로는 그것을 생성하는 렌더가 바뀌는 순간 낡은 것이 되며, 이 오류가 바로 그런 경우입니다.

A pipeline step’s file emission carries no file (파이프라인 단계의 파일 출력에 파일이 없음)

파이프라인 단계는 패치하는 문서와 함께 새 문서를 출력할 수 있습니다. 각 출력은 종류를 선언하며, 파일 종류의 출력은 기록할 파일, 즉 경로와 내용을 담습니다.

이 경우 종류는 올바르지만 파일이 없으므로, 단계가 선언한 의도를 응답이 실행하지 않은 것입니다. 이것이 아래의 정의되지 않은 종류로 인한 중단과의 차이입니다. 호스트는 emit_file 출력으로 무엇을 해야 하는지 정확히 알지만 그 대상이 없습니다.

아무것도 출력하지 않는 대신 거부하는데, 파일을 조용히 기여하지 않는 출력은 눈에 띄지 않기 때문입니다. 문서를 출력하는 단계는 그 자체가 파이프라인에 있는 이유인 경우가 많고, 그 출력은 이전에 없던 파일입니다. 따라서 이를 건너뛴 빌드는 단계가 실행되었다고 보고하면서도 문서가 빠진 출력을 생성하게 됩니다.

출력되는 메시지는 노드와 단계의 출력 중 어느 것에 문제가 있었는지를 나타냅니다.

emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content (node "<node>", side effect <index>) (emit_file 부수 효과에 파일이 없습니다. 규격을 따르는 emit_file 부수 효과는 경로와 내용을 갖춘 파일을 담습니다)

해결 방법: 엔터티 파일의 어떤 내용도 이 문제의 원인이 아닙니다. 응답은 플러그인에서 왔습니다. 메시지가 나타내는 인덱스를 인용하여 플러그인 게시자에게 보고하십시오. 직접 작성한 플러그인이라면 모든 emit_file 출력에 파일 멤버를 경로와 내용 모두와 함께 채우십시오. 인덱스는 해당 단계 응답의 어느 출력을 살펴봐야 하는지 알려 줍니다.

A pipeline step declares an emission kind the contract does not define (파이프라인 단계가 계약에 정의되지 않은 출력 종류를 선언함)

파이프라인 단계가 반환하는 각 출력은 종류를 선언하며, 계약은 두 가지를 정의합니다. 하나는 파일을 기록하고, 다른 하나는 커스텀 리소스 문서를 기여합니다. 종류는 전송 형식상 열린 문자열이며, 덕분에 기존 플러그인을 깨뜨리지 않고 이후에 새 종류를 추가할 수 있습니다.

바로 그 개방성 때문에 정의되지 않은 종류는 건너뛰지 않고 거부됩니다. 호스트가 정의하지 않은 값은 형태만으로는 이후 버전이 정의할 값과 구별할 수 없습니다. 따라서 이를 건너뛰는 호스트는 단계가 성공을 보고하는 동안 모든 빌드에서 단계가 의도한 내용을 조용히 버리게 됩니다. 거부하면 확장 지점을 열어 두면서도 구멍이 되지 않게 할 수 있습니다. 이 빌드가 정의하지 않은 종류는 받아들여 무시되는 대신, 단계가 보낸 값을 인용하여 정의되지 않은 것으로 보고됩니다.

출력되는 메시지는 노드, 문제가 있었던 출력, 그리고 그 출력이 선언한 종류를 나타냅니다.

side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd (node "<node>", side effect <index>, kind "<value>") (부수 효과가 플러그인 계약에 정의되지 않은 종류를 선언합니다. 규격을 따르는 부수 효과는 emit_file 또는 emit_crd를 선언합니다)

해결 방법: 엔터티 파일의 어떤 내용도 이 문제의 원인이 아닙니다. 값은 플러그인에서 왔습니다. 메시지가 나타내는 종류를 인용하여 플러그인 게시자에게 보고하십시오. 직접 작성한 플러그인이라면 메시지에 나열된 종류 중 하나를 선언하십시오. 정의된 종류의 철자 오류가 흔한 원인이며, 인용되어 돌아온 값이 보낸 값입니다.

A provider’s reassembly is handed a unit its own carve never produced (provider의 재조립에 자체 분할이 만든 적 없는 단위가 전달됨)

출력 형태를 직접 지정할 수 없는 provider는 출력을 스스로 분할할 수 있습니다. 출력 파일을 지정 가능한 단위로 나누어 각각을 토큰 아래에 두고 돌려줍니다. 그러면 파이프라인 단계가 그 토큰으로 단위를 지정하고, 재조립이 편집된 단위를 바이트 단위로 충실하게 파일에 다시 이어 붙입니다. 두 절반은 하나의 계약입니다. 파일을 분할할 때 쓴 토큰이 곧 그 재조립이 해석하는 토큰입니다.

같은 파일의 분할이 만들지 않은 토큰이 재조립에 전달되면, 편집된 내용이 돌아갈 바이트 범위가 없습니다. 단위를 버리지 않고 거부하는 이유는, 버려진 단위가 형식은 올바르지만 단계가 요청받은 편집이 빠진 파일을 만들기 때문입니다. 실패한 것도, 잘못된 형식도 없이 편집만 조용히 사라집니다.

두 절반이 어긋날 수 있는 것은 둘이 나뉘어 있을 때뿐입니다. 즉 코덱이 스스로 분할하고 나머지는 표준 구조적 재조립을 빌려 쓰는 경우입니다. 이때 한 토큰 집합으로 분할하고 다른 집합으로 재조립하면 바로 이 오류가 납니다. 두 절반을 모두 소유한 코덱은 여기에 이를 수 없습니다. 자체 재조립이 자체 토큰을 책임지기 때문입니다.

출력되는 메시지로, 아무것에도 해석되지 않은 토큰과 그 토큰이 지정된 파일을 밝힙니다.

reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens (token "<token>", file "<file>") (reassemble이 분할이 만들지 않은 패치된 단위 토큰을 지정함. 규격을 따르는 코덱은 같은 토큰으로 파일을 분할하고 재조립함)

해결 방법: 엔터티 파일의 어떤 것도 이 오류를 일으키지 않습니다. provider가 직접 만든 것이라면 한쪽 절반이 만드는 토큰이 다른 쪽이 해석하는 토큰이 되게 하십시오. 양쪽에서 각각 따로 도출하지 말고 한 번 도출해 전달하며, 분할 전에 파일을 다시 쓴다면 같은 재작성 형태를 기준으로 재조립하십시오. 직접 만든 provider가 아니라면 메시지가 밝힌 토큰을 인용해 게시자에게 보고하십시오.

A workload declares a form compose cannot express (workload가 compose로 표현할 수 없는 형태를 선언함)

compose provider는 장기 실행 서비스를 렌더링합니다. 머신마다 하나씩 실행되거나, 일정에 따라 실행되거나, 한 번 실행되고 끝난다고 선언한 workload에는 깔끔한 단일 머신 대응물이 없으므로, 렌더링은 일반 서비스를 출력하지 않고 중단됩니다. 일반 서비스로 출력하면 그것을 시작하고 계속 실행시켜 요청된 내용을 잘못 표현하게 됩니다.

출력되는 메시지입니다. 조건은 실패의 종류, 즉 빌드가 선언한 것을 표현할 방법이 없는 provider를 밝히고, provider 자체 문장은 전달받은 형태를 밝힙니다.

a plugin has no expression for a construct this build declares (플러그인에 이 빌드가 선언한 구성에 대한 표현이 없습니다) compose: workload form "<form>" has no compose mapping; compose supports stateless and stateful only: compose cannot express this workload form (compose: 이 workload 형식에는 compose 매핑이 없습니다. compose는 stateless와 stateful만 지원합니다: compose는 이 workload 형식을 표현할 수 없습니다)

해결 방법: 대상이 실제로 단일 머신 compose 환경이라면 작업을 장기 실행 서비스로 표현하십시오. stateless와 stateful 형태가 compose가 렌더링하는 두 가지입니다. 그 형태가 의도한 것이라면 해당 대상에 대응물이 있는 provider를 통해 그 경계를 렌더링하십시오. 머신별 사본, 예약 실행, 완료까지 실행하는 작업은 모두 다른 곳에 직접적인 표현이 있으며, provider 선택은 workload가 아니라 경계의 몫입니다.

A container declares a field compose has no primitive for (컨테이너가 compose에 기본 요소가 없는 필드를 선언함)

두 컨테이너 필드는 compose 대응물이 없으며, 둘 다 버려지지 않고 렌더링을 중단합니다.

컨테이너가 시작되거나 중지되기 직전에 실행되는 훅. compose에는 이를 실행할 것이 없으며, 조용히 실행되지 않는 훅은 빌드 시점이 아니라 실행 시점에 드러나는 정확성 문제입니다.

이름 있는 객체에서 가져오는 일괄 환경 변수. compose는 파일에서 변수를 읽을 수 있지만 객체에 대한 참조는 파일이 아닙니다. 하나를 다른 것으로 재해석하면 아무 말 없이 컨테이너가 받는 내용이 바뀝니다.

둘 다 일반 컨테이너와 메인 컨테이너보다 먼저 실행되는 컨테이너 모두에서 검사되므로, 같은 필드는 어디에 선언되든 중단되며 메시지는 어느 컨테이너에서 왔는지 밝힙니다.

출력되는 메시지. 둘 다 같은 조건, 즉 빌드가 선언한 것을 표현할 방법이 없는 provider를 보고하며, 어느 필드인지는 provider 자체 문장이 말해 줍니다.

a plugin has no expression for a construct this build declares (플러그인에 이 빌드가 선언한 구성에 대한 표현이 없습니다) compose: node "<node>" container "<container>": compose: node "<node>" declares container lifecycle hooks; compose has no lifecycle-hook primitive: compose has no lifecycle-hook primitive; container declares lifecycle hooks (compose: 노드의 컨테이너: compose: 이 노드가 컨테이너 수명 주기 훅을 선언합니다. compose에는 수명 주기 훅 프리미티브가 없습니다: compose에는 수명 주기 훅 프리미티브가 없습니다. 컨테이너가 수명 주기 훅을 선언합니다)

a plugin has no expression for a construct this build declares (플러그인에 이 빌드가 선언한 구성에 대한 표현이 없습니다) compose: node "<node>" container "<container>": compose: node "<node>" declares container envFrom; compose has no env-from-object primitive: compose has no env-from-object primitive; container declares envFrom (compose: 노드의 컨테이너: compose: 이 노드가 컨테이너 envFrom을 선언합니다. compose에는 객체에서 환경 변수를 가져오는 프리미티브가 없습니다: compose에는 객체에서 환경 변수를 가져오는 프리미티브가 없습니다. 컨테이너가 envFrom을 선언합니다)

해결 방법: compose 대상이라면 필드를 제거하고 그 작업을 다른 방식으로 하십시오. 시작 작업은 메인 컨테이너보다 먼저 실행되는 컨테이너에, 종료 작업은 컨테이너 자체의 시그널 처리에 두십시오. 일괄 환경 변수는 명시적 변수로 풀어 쓰거나 compose 대상이 읽을 수 있는 파일로 제공할 수 있습니다. 그 필드가 의도한 것이라면 해당 대상에 그 기본 요소가 있는 provider를 통해 그 경계를 렌더링하십시오.

An omits entry names a kind or a namespace a compose file does not have (omits 항목이 compose 파일에 없는 kind나 네임스페이스를 지정함)

compose 파일을 소스로 하는 Recipe나 FeatureRecipe의 omits: 항목은 그 파일의 최상위 단위 하나를 제외합니다. compose 파일에는 항목이 지정할 수 있는 kind가 정확히 세 가지, 즉 각각 services:, volumes:, configs: 아래 키로 지정되는 service, volume, config가 있으며, 네임스페이스는 없습니다. 그 밖의 kind(차트 문서의 Secret이나 compose network 등)를 지정하거나 namespace를 가진 항목은 파일이 제외할 수 있는 어떤 것도 지정하지 않으므로, 렌더링은 그 항목을 아무것과도 일치하지 않은 항목으로 취급하지 않고 중단됩니다. kind는 정확히 비교되므로 service를 의도한 곳에 Service를 쓰면 거부됩니다. 무엇이든 제외되기 전에 모든 항목이 검사되며, 항목이 작성된 순서에서 처음으로 문제가 된 항목이 지정됩니다.

출력되는 메시지. 둘 다 provider가 표현할 방법이 없는 구성 요소에 대한 조건을 보고하며, provider 자체 문장이 해당 항목과 허용되는 kind를 밝힙니다. 템플릿이 민감하다고 선언된 값을 읽은 필드는 <redacted>로 표시됩니다.

a plugin has no expression for a construct this build declares (플러그인에 이 빌드가 선언한 구성에 대한 표현이 없습니다) compose: an omits entry (name "<name>") names kind "<kind>": compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind (compose: omits 항목이 지원하지 않는 kind를 지정합니다: compose는 services:, volumes: 또는 configs: 아래의 키로 각각 지정되는 service, volume 또는 config만 제외하며 다른 kind는 제외하지 않습니다)

a plugin has no expression for a construct this build declares (플러그인에 이 빌드가 선언한 구성에 대한 표현이 없습니다) compose: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a compose file has no namespaces: compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind; remove the namespace from the entry (compose: omits 항목이 namespace를 지정하지만 compose 파일에는 namespace가 없습니다: compose는 services:, volumes: 또는 configs: 아래의 키로 각각 지정되는 service, volume 또는 config만 제외하며 다른 kind는 제외하지 않습니다. 항목에서 namespace를 제거하십시오)

해결 방법: compose 파일이 하는 방식대로 단위를 지정하십시오. kind: service, volume 또는 config로, name:에는 해당 섹션 아래의 키를 쓰고, namespace:는 삭제하십시오. compose → 소스 모드를 참고하십시오.

An omits entry names a namespace a CloudFormation template does not have (omits 항목이 CloudFormation 템플릿에 없는 네임스페이스를 지정함)

CloudFormation 템플릿을 소스로 사용하는 Recipe 또는 FeatureRecipe의 omits: 항목은 리소스 하나를 제외하며, 이 리소스는 항목의 kind로 지정한 Type과 항목의 name으로 지정한 논리적 ID로 식별됩니다. 템플릿에는 네임스페이스가 없으므로 namespace를 가진 항목은 템플릿이 제외할 수 있는 어떤 것도 지정하지 않으며, 렌더링은 그 항목을 아무것과도 일치하지 않은 항목으로 취급하지 않고 중단됩니다. 무엇이든 제외되기 전에 모든 항목이 검사되며, 항목이 작성된 순서에서 네임스페이스를 가진 첫 번째 항목이 메시지에 지정됩니다.

출력되는 메시지. 프로바이더가 표현할 방법이 없는 구성 요소에 대한 조건을 보고하며, 프로바이더 자체의 문장이 해당 항목과 이 프로바이더가 제외하는 대상을 지정합니다. 템플릿이 민감한 것으로 선언된 값을 읽은 필드는 <redacted>로 표시됩니다:

a plugin has no expression for a construct this build declares cloudformation-provider: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a CloudFormation template has no namespaces: cloudformation leaves out a resource, named by its Type as the entry’s kind and its logical ID under Resources as the entry’s name; remove the namespace from the entry

해결 방법: 항목에서 namespace:를 제거하십시오. 항목은 Type과 논리적 ID만으로 리소스를 지정합니다. cloudformation → 소스 템플릿에서 리소스 제외하기를 참조하십시오.

A published port declares a transport compose cannot spell (게시된 포트가 compose로 표기할 수 없는 전송 프로토콜을 선언함)

게시된 compose 포트는 전송 프로토콜을 항목의 접미사로 나타내며, 이 접미사의 표기는 두 가지입니다. 그 밖의 전송 프로토콜을 선언한 포트에는 compose 표기가 전혀 없습니다.

접미사를 버리지 않고 중단합니다. 기본 전송 프로토콜로 조용히 대체된 게시 포트는 클라이언트가 도달할 수 없는 트래픽을 전달하는 상태로 올라오기 때문입니다. 이는 전송 프로토콜 선언이 막으려는 바로 그 실패가 변환 시점에 다시 생기는 것입니다.

전송 프로토콜을 선언하지 않은 포트는 영향을 받지 않습니다. 이러한 포트는 전송 프로토콜을 가진 적이 없는 포트와 똑같이 접미사 없이 게시됩니다.

출력되는 메시지. 조건은 실패의 종류, 즉 프로바이더가 출력하는 것에 표현 방법이 없는 값을 지정하며, 그 뒤에 프로바이더 자체의 문장이 이어집니다:

a plugin has no representation for a value it was given (플러그인에 전달받은 값을 표현할 방법이 없습니다) compose: node "<node>" apply service ports: compose publishes a port’s transport as a tcp or udp suffix; this port declares a transport compose cannot express (compose: 노드의 서비스 포트 적용: compose는 포트의 전송 프로토콜을 tcp 또는 udp 접미사로 게시합니다. 이 포트는 compose가 표현할 수 없는 전송 프로토콜을 선언합니다)

해결 방법: compose 대상이라면 포트의 전송 프로토콜을 compose가 표기할 수 있는 두 가지 중 하나로 선언하거나, 선언하지 않고 항목이 접미사 없이 게시되도록 하십시오. 그 전송 프로토콜이 의도한 것이라면, 대상이 그것을 표현할 수 있는 프로바이더를 통해 해당 경계를 렌더링하십시오.

A resources quantity cannot be converted to a compose value (리소스 수량을 compose 값으로 변환할 수 없음)

컨테이너의 프로세서 및 메모리 수량과 nvidia.com/gpu 개수는 Kubernetes가 리소스에 사용하는 표기법으로 작성되며, compose는 이를 자체 단위로 나타냅니다. GPU 개수는 NVIDIA 장치 예약의 개수가 됩니다. 따라서 각 값은 수량으로 읽힌 뒤 그 값에서 변환됩니다. 이를 막는 경우는 두 가지이며, 메시지는 그중 어느 것에 해당했는지 알려 줍니다. 하나는 수량이 전혀 아닌 값이고, 다른 하나는 compose에 정확한 형식이 없는 수량입니다. 즉 음수, 바이트의 정수가 아닌 메모리 양, 코어의 소수점 아홉 자리보다 세밀한 프로세서 양, 장치의 정수가 아닌 GPU 개수, 또는 compose가 담을 수 있는 최댓값을 넘는 양입니다. nvidia.com/gpu 요청과 제한이 서로 다른 개수를 요구하는 컨테이너도 중단됩니다. compose는 서비스 하나에 하나의 개수만 예약하기 때문입니다. 값을 반올림하거나 근삿값을 출력하지 않고 중단하는 이유는, 요청한 제한과 조용히 달라진 제한은 무언가가 그 제한을 초과해 중지되기 전까지 아무도 찾지 않는 종류의 차이이기 때문입니다.

출력되는 메시지. 각 메시지는 조건, 즉 프로바이더가 출력하는 것에 표현 방법이 없는 값으로 시작하고, 이어서 리소스, 값이 요청인지 제한인지, Workload 안에서의 경로, 그리고 값을 지정합니다. 수량이 아닌 값에는 그것이 수량이 아닌 이유와 수량의 형식이 뒤따릅니다:

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the <cpu|memory|nvidia.com/gpu> <request|limit> at <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): resources quantity cannot be converted to a compose deploy.resources value

compose가 표현할 수 없는 수량에는 해당 리소스에 대해 compose가 담을 수 있는 범위가 뒤따릅니다:

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the memory <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose memory value is a whole number of bytes from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the cpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose cpus value is a core count from 0 to 9223372036.854775807 with at most nine decimal places: resources quantity cannot be converted to a compose deploy.resources value

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the nvidia.com/gpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose device count is a whole number of devices from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value

GPU 요청과 제한이 서로 다른 개수를 요구하는 경우 두 경로와 두 개수를 모두 지정합니다:

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the nvidia.com/gpu request at <path> and the limit at <path> ask for different counts (<request> and <limit>); compose reserves one device count for a service, so write the same count in both or only the limit: resources quantity cannot be converted to a compose deploy.resources value

Workload의 템플릿이 작성자가 민감한 것으로 선언한 값을 읽는 경우, 어떤 메시지도 거부한 값을 인용하지 않으며, 두 개수도 같은 방식으로 생략됩니다.

해결 방법: 값이 수량이 아니라면 Workload → 리소스 수량에 제시된 형식으로 작성하십시오. m과 같은 접미사만 남은 값은 템플릿이 보간하는 값이 비어 있을 때 남기는 것이므로, 수정할 입력은 템플릿이 읽은 입력입니다. compose가 표현할 수 없는 수량이라면 메시지에 명시된 범위 안의 양을 작성하십시오. 메모리는 어느 단위로든 정수 바이트로(1.5001Gi가 아니라 1536Mi), 프로세서 시간은 코어의 소수점 이하 최대 아홉 자리까지, GPU 개수는 정수 장치 수로(0.5나 500m가 아니라 1) 작성합니다. GPU 요청과 제한이 일치하지 않는다면 두 곳에 같은 개수를 쓰거나 제한만 쓰십시오. 제한은 같은 Workload에 대해 Kubernetes가 스케줄링하는 개수입니다.

A resource quantity the helm provider emits is not a quantity (helm provider가 내보내는 리소스 수량이 수량이 아님)

helm provider는 모든 리소스 수량을 내보내는 매니페스트에 그대로 복사합니다. 각 컨테이너와 init 컨테이너의 resources.requests 및 resources.limits 값(확장 리소스 포함)과 각 볼륨의 ephemeral.sizeLimit, persistent.size, persistentTemplate.size가 그 대상입니다. 그리고 Recipe의 템플릿이 평가한 Workload를 기준으로 각 값을 먼저 수량 형식과 대조합니다. 형식에서 벗어난 값은 여기서 빌드를 중단시킵니다. 그렇지 않으면 빌드는 문제없이 끝나고 차트를 설치할 때 클러스터가 그 값을 거부하게 됩니다.

출력되는 메시지. 조건으로 시작하여 노드, Workload 안에서의 필드 경로, 값, 그리고 그 값이 수량이 아닌 이유를 밝히고, 수량이 취하는 형식을 설명합니다:

a plugin has no representation for a value it was given (플러그인에 전달받은 값을 표현할 방법이 없습니다) helm: node "<node>": <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei) (helm: 노드의 해당 경로에 있는 값이 수량이 아닙니다. 수량은 2, 0.5, 1.5와 같은 숫자이며, 선택적 부호와 함께 정수 지수(1e3, 5E-2) 또는 단위 접미사(n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei) 중 최대 하나를 가질 수 있습니다)

해결 방법: Workload → 리소스 수량에 설명된 형식으로 값을 작성합니다. 필드가 템플릿으로 작성된 경우 수정해야 할 값은 템플릿이 읽은 값입니다. m이나 Mi 같은 접미사만 남은 것은 템플릿이 보간하는 값이 비어 있을 때 남기는 결과이며, Release 매개변수는 작성된 그대로 필드에 전달됩니다.

A service type the helm provider cannot render (helm provider가 렌더링할 수 없는 서비스 유형)

helm provider는 각 Workload services 항목을 항목의 type을 유형으로 하는 Kubernetes Service로 렌더링합니다. Loopback 항목은 포트가 호스트 자체의 루프백 주소에서만 접근 가능하고 다른 곳에서는 접근할 수 없기를 요구하는데, Kubernetes Service에는 그렇게 동작하는 유형이 없습니다. NodePort Service가 어떤 노드 주소에서 수신하는지는 개별 Service가 아니라 클러스터 전체의 설정이기 때문입니다. 따라서 빌드는 리소스를 하나라도 쓰기 전에, 서비스가 선언된 순서상 첫 번째 Loopback 항목에서 중단됩니다.

항목을 다른 유형으로 렌더링하지 않고 중단합니다. Service가 가진 각 유형은 포트가 도달하는 범위를 바꾸기 때문입니다. ClusterIP Service는 항목이 요구하는 외부 공개 범위를 없애고, NodePort Service는 클러스터가 허용하는 모든 노드 주소에 포트를 공개합니다. 이는 항목이 피하려고 존재하는 더 넓은 노출입니다.

출력되는 메시지. 조건으로 시작하여 노드, Workload 안에서의 서비스 경로, 유형을 밝힙니다:

a plugin has no representation for a value it was given (플러그인에 전달받은 값을 표현할 방법이 없습니다) helm: node "<node>": services.<service>: type “Loopback” publishes the service’s ports on the host’s loopback address only, and a Kubernetes Service has no type that does; declare ClusterIP to keep the ports inside the cluster, or NodePort or LoadBalancer to publish them outside it (helm: 노드의 해당 서비스: “Loopback” 타입은 서비스의 포트를 호스트의 루프백 주소에만 게시하지만, Kubernetes Service에는 그렇게 하는 타입이 없습니다. 포트를 클러스터 내부에 두려면 ClusterIP를, 클러스터 외부에 게시하려면 NodePort 또는 LoadBalancer를 선언하십시오)

해결 방법: helm 대상에서는 포트가 클러스터에서 어디까지 도달해야 하는지를 나타내는 유형을 선언합니다. 내부에 두려면 ClusterIP, 공개하려면 NodePort 또는 LoadBalancer를 사용합니다. Loopback 항목은 포트를 127.0.0.1에 공개하는 compose 대상용입니다. Workload → services를 참조하십시오.

A Kubernetes version the helm provider cannot render a chart for (helm provider가 차트를 렌더링할 수 없는 Kubernetes 버전)

helm provider는 컴포넌트나 그 경계에 지정된 aggrega.ai/kubernetes-version 어노테이션이 가리키는 Kubernetes 버전에 맞춰 소스에서 차트를 렌더링하며, 그 값을 helm template --kube-version이 플래그를 읽는 방식으로 읽습니다. 그 플래그가 거부할 값, 즉 "one.two", "latest", "1" 같은 단일 숫자, "01.20"처럼 앞에 0이 붙은 숫자는 차트가 .Capabilities.KubeVersion으로 읽을 버전이 없으므로, 차트를 렌더링하기 전에 빌드가 중단됩니다.

기본 버전으로 차트를 렌더링하지 않고 중단합니다. 차트는 버전을 읽어 API 버전, 필드 또는 전체 메커니즘을 선택하므로, 지정한 버전이 아닌 다른 버전으로 렌더링된 차트는 그 다른 버전에 맞는 형태를 내보냅니다. 이는 배포 대상 클러스터가 실행하지 못할 수도 있는 형태입니다.

빈 값은 거부되지 않습니다. 빈 값은 설정되지 않은 것으로 취급되며, 차트는 기본 버전, 즉 같은 helm 릴리스의 기본 helm template이 렌더링하는 버전으로 렌더링됩니다.

출력되는 메시지. 조건으로 시작하여 노드와 노드가 속한 경계, 어노테이션, 값, 그리고 그 값이 버전이 아닌 이유를 밝히고, 작성해야 할 형식을 설명합니다:

a plugin has no representation for a value it was given (플러그인에 전달받은 값을 표현할 방법이 없습니다) helm: node "<node>" in boundary "<boundary>": annotation aggrega.ai/kubernetes-version: "<value>" is not a Kubernetes version a chart can be rendered for: <reason>; write the version of the cluster the chart deploys to, such as “1.31” or “v1.31.2”, on the component or on its boundary (helm: 해당 경계에 있는 노드의 aggrega.ai/kubernetes-version 어노테이션 값은 차트를 렌더링할 수 있는 Kubernetes 버전이 아닙니다. 차트가 배포되는 클러스터의 버전을 “1.31” 또는 “v1.31.2”와 같이 컴포넌트 또는 그 경계에 작성하십시오)

메시지가 노드와 경계를 모두 밝히는 이유는 provider가 컴포넌트의 어노테이션과 경계의 어노테이션을 함께 읽고 컴포넌트 자체의 값이 우선하므로, 값이 둘 중 어느 쪽에 작성되었을 수도 있기 때문입니다.

해결 방법: 차트가 배포되는 클러스터의 버전을 "1.31" 같은 메이저·마이너 버전이나 "v1.31.2" 같은 전체 버전으로 컴포넌트나 그 경계에 작성하거나, 기본 버전으로 렌더링하려면 어노테이션을 제거합니다. helm → 차트가 렌더링되는 Kubernetes 버전을 참조하십시오.

A health probe cannot be turned into a compose healthcheck (헬스 프로브를 compose healthcheck로 변환할 수 없음)

선언된 헬스 프로브는 compose healthcheck가 되며, 이를 막을 수 있는 경우는 두 가지입니다.

포트를 공개하지 않는 컨테이너에서 HTTP로 경로를 검사하는 프로브. 검사는 컨테이너의 포트에 대한 요청으로 구성되므로, 선언된 포트가 없으면 검사를 구성할 주소가 없습니다.

검사 방법을 전혀 선언하지 않은 프로브. 경로도, 연결할 포트도, 실행할 명령도 없습니다. 검사로 변환할 것이 없습니다. 이는 작성할 가능성이 높은 형태라기보다 스키마 뒤에 있는 안전장치입니다. 프로브는 여기에 도달하기 전에 세 가지 중 하나를 가지고 있는지 검사됩니다.

출력되는 메시지. 둘 다 같은 조건, 즉 provider가 필요로 하지만 정확히 하나의 값으로 확정할 수 없었던 것을 보고하며, provider 자체의 문장이 어느 경우인지 알려 줍니다:

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 확정할 수 없었습니다) compose: node "<node>" container "<container>": probe http: requires at least one container port; container declares none (compose: 노드의 컨테이너: probe http: 컨테이너 포트가 하나 이상 필요하지만 컨테이너가 선언한 포트가 없습니다)

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 확정할 수 없었습니다) compose: node "<node>" container "<container>": probe declares no shape (http/tcp/exec) (compose: 노드의 컨테이너: 프로브가 형태(http/tcp/exec)를 선언하지 않았습니다)

해결 방법: 검사 대상이 될 포트를 프로브와 같은 컨테이너에 선언합니다. HTTP 프로브는 첫 번째 컨테이너 포트를 읽으므로, 검사를 구성하려면 포트가 있어야 합니다. 컨테이너가 실제로 아무것도 공개하지 않는다면 다른 방법으로 검사합니다. 명령을 실행하는 프로브에는 포트가 필요하지 않습니다. 검사 방법이 선언되지 않은 프로브에는 세 가지 중 하나를 지정합니다.

A configmap volume has no file behind it (configmap 볼륨 뒤에 파일이 없음)

구성을 마운트하는 볼륨은 compose 자체의 메커니즘을 통해 이름으로 참조되어 전달되며, 내용을 담는 항목은 Recipe가 내보내는 파일에서 옵니다. 이 조건은 일치하는 항목이 없는 참조가 보고하는 것입니다. 파일이 없으므로 마운트는 뒤에 아무것도 없이 존재하게 되고, 컨테이너는 빈 경로를 읽으며 시작됩니다.

검사는 컴포넌트별이 아니라 어셈블된 출력 전체에 대해 실행되며, 이는 의도된 것입니다. 참조와 내용을 담는 항목은 서로 다른 경로로 도착하고 같은 그룹의 서로 다른 컴포넌트에서 올 수 있으므로, 어셈블된 출력이 둘 다 존재하는 첫 지점입니다. 컴포넌트별 검사라면 같은 그룹의 다른 컴포넌트가 내용을 제공하는 참조를 거부하게 됩니다.

해결되지 않은 참조는 첫 번째 것만이 아니라 모두 안정적인 순서로 보고되므로, 한 번의 빌드로 전부 확인할 수 있습니다.

출력 메시지. 조건이 먼저 오고, 이어서 각 서비스, 그 서비스가 만든 참조, 마운트 위치가 옵니다:

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 해결할 수 없음) compose AssembleBoundary: service "<service>" references config "<name>" mounted at "<path>"; declare each one as a top-level configs: entry from the Recipe’s artifacts: input: configmap volume requires a file emitted via the Recipe’s artifacts: input; none found

해결 방법: 볼륨이 참조하는 이름으로 Recipe의 artifacts: 입력에서 파일을 내보내십시오. 둘은 그 이름으로 일치시키므로, 볼륨이 요구하는 것과 Recipe가 내보내는 것의 불일치가 흔한 원인입니다. 내용이 다른 곳에서 와야 하는 경우라면 볼륨은 맞지 않는 메커니즘입니다. 환경에 속하는 값은 대신 환경으로 보내십시오.

What an omits entry left out is still named by the compose file (omits 항목이 제외한 것을 compose 파일이 여전히 참조함)

omits: 항목은 소싱된 compose 파일에서 서비스, 볼륨 또는 config를 제외하며, compose는 선언하지 않은 것을 참조하는 파일을 거부합니다. 따라서 항목의 단위가 제거되면, 파일의 나머지 부분이 그중 하나를 여전히 참조하는 모든 곳이 렌더링을 중단시킵니다. depends_on, links, volumes_from, extends, build.additional_contexts 값 또는 service: network, IPC, PID, UTS 모드가 참조하는 서비스, volumes: 항목의 소스로 지정된 볼륨, configs: 항목이 참조하는 config가 해당하며, 각 서비스, 각 서비스의 pre_start 훅, 각 job에서 읽습니다. 전체 목록과 참조처럼 보이기만 하는 값은 compose → 소싱 모드에 있습니다.

검사는 선언하는 Recipe 또는 FeatureRecipe 자체의 파일을 읽으므로, 같은 어셈블된 파일의 다른 기여자가 제외된 단위와 같은 이름의 단위를 선언하더라도 렌더링을 중단합니다. 참조는 첫 번째 것만이 아니라 모두 보고되며(서비스는 키 순서로, 그다음 job, 각 서비스의 훅은 그 서비스 뒤에), 한 번의 빌드로 전부 확인할 수 있습니다.

출력 메시지. 조건이 먼저 오고, 이어서 참조하는 각 항목, 그 항목이 참조하는 단위, 참조가 있는 필드가 옵니다:

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 해결할 수 없음) compose: what an omits entry left out is still named by the file: service "<service>" names <kind> "<name>" at <field>; compose refuses a file naming a service, a volume or a config it does not declare: leave out what names it as well, change the reference through valuesMapping, or remove the entry

민감하다고 선언된 값으로 항목 이름이 만들어진 단위는 <redacted>로 표시됩니다.

해결 방법: 둘 중 어느 쪽을 의도했는지 결정하십시오. 참조하는 서비스가 여전히 그 단위를 필요로 한다면 단위를 유지하십시오. 즉 항목을 제거합니다. 필요로 하지 않는다면 Recipe의 valuesMapping:을 통해 참조를 변경하거나(그곳의 목록은 기본 파일의 목록을 대체하므로 depends_on: []로 지울 수 있습니다), 참조하는 서비스도 별도의 항목으로 제외하십시오.

What an omits entry left out is still named by a CloudFormation template (omits 항목이 제외한 것을 CloudFormation 템플릿이 여전히 참조함)

omits: 항목은 소싱된 CloudFormation 템플릿에서 리소스를 제외하며, CloudFormation은 선언하지 않은 리소스를 참조하는 템플릿을 거부합니다. 따라서 항목의 리소스가 제거되면, 남은 템플릿이 그중 하나를 여전히 참조하는 모든 곳이 렌더링을 중단시킵니다. Ref, 목록 형식 또는 점으로 구분된 문자열 형식의 Fn::GetAtt, 리소스의 DependsOn, Fn::Sub의 변수가 해당하며, 각 리소스 본문과 각 output의 어디에서든 읽습니다. 전체 목록과 참조처럼 보이기만 하는 값은 cloudformation → 소싱된 템플릿에서 리소스 제외하기에 있습니다.

검사는 선언하는 Recipe 또는 FeatureRecipe 자체의 템플릿들을 함께 읽습니다. 그 템플릿 중 다른 하나가 여전히 선언하는 논리적 ID에 대한 참조는 중단되지 않지만, 제외된 리소스에 대한 참조는 다른 컴포넌트가 같은 논리적 ID의 리소스를 선언하더라도 렌더링을 중단합니다. 참조는 첫 번째 것만이 아니라 모두 보고되며(소스가 담고 있는 순서대로 템플릿별로, 각 템플릿의 리소스와 그다음 output을 키 순서로), 한 번의 빌드로 전부 확인할 수 있습니다.

출력 메시지. 조건이 먼저 오고, 이어서 각 참조에 대해 참조가 있는 템플릿, 참조하는 리소스, 참조 방식, 템플릿 루트로부터의 경로로 나타낸 위치가 옵니다:

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 해결할 수 없음) cloudformation-provider: what an omits entry left out is still named by the source’s templates: template "<template>" names resource "<logical-id>" (type "<type>") by <Ref|Fn::GetAtt|DependsOn|Fn::Sub> at <path>; CloudFormation refuses a template naming a resource it does not declare: leave out what names it as well, or remove the entry

항목의 필드가 민감하다고 선언된 값으로 만들어진 경우, 그 리소스의 논리적 ID와 타입은 <redacted>로 표시되며, 그 논리적 ID를 나타내는 경로의 단계도 마찬가지입니다.

해결 방법: 둘 중 어느 쪽을 의도했는지 결정하십시오. 참조하는 리소스가 여전히 제외된 리소스를 필요로 한다면 유지하십시오. 즉 항목을 제거합니다. 필요로 하지 않는다면 참조하는 리소스도 별도의 항목으로 제외하십시오. 파라미터에 바인딩된 값은 그 파라미터에 대한 참조만 대체하므로, 리소스에 대한 참조는 그것으로 변경할 수 없습니다. 리소스를 참조하는 output은 제외할 수 없으므로, output이 참조하는 리소스는 남습니다.

A valuesMapping key names no parameter of a sourced CloudFormation template (valuesMapping 키가 소싱된 CloudFormation 템플릿의 어떤 파라미터도 가리키지 않음)

소싱된 CloudFormation 템플릿은 선언한 Parameters를 통해 값을 받으며, 그 템플릿을 소싱하는 Recipe 또는 FeatureRecipe의 valuesMapping은 채우는 파라미터마다 키 하나를 씁니다. 소스의 어떤 템플릿도 선언하지 않은 파라미터를 가리키는 키는 갈 곳이 없으므로, 렌더링은 그 키를 버리지 않고 중단됩니다. 이는 CloudFormation 자체가 알 수 없는 파라미터에 대해 보고할 실패를, 아직 직접 고칠 수 있을 때 보고하는 것입니다. 파라미터를 채우는 것은 valuesMapping뿐입니다. 아무것도 매핑하지 않은 값은 이런 방식으로 읽히지 않으므로, 컴포넌트나 attachment가 다른 입력을 위해 쓴 자체 값은 이 조건에 해당하지 않습니다.

출력 메시지. 조건이 먼저 오고, 이어서 아무것도 가리키지 않은 모든 키와 소스의 각 템플릿이 선언하는 것이 옵니다:

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 해결할 수 없음) cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping writes the key "<key>", and no template of the source declares a parameter of that name: template "<template>" declares "<parameter>", …; a sourced template takes values only through the parameters it declares, so rename the key to the parameter it is meant for, or remove it from the valuesMapping

해결 방법: 키를 메시지에 나열된 파라미터와 비교하고(철자가 틀린 키가 흔한 원인입니다) 이름을 바꾸거나, valuesMapping에서 제거하십시오. cloudformation → 소싱된 템플릿의 파라미터에 대한 값을 참조하십시오.

다른 component가 소싱된 템플릿의 바인딩이 채운 CloudFormation 파라미터를 참조합니다

소싱된 템플릿의 파라미터를 그 템플릿을 소싱하는 Recipe 또는 연결된 Feature의 FeatureRecipe의 valuesMapping으로 채우면, 해당 소스의 모든 템플릿에서 그 파라미터에 대한 모든 참조가 대체되고 그 선언이 제거됩니다. 같은 조립된 스택의 다른 곳에서 온 콘텐츠, 즉 다른 component의 프래그먼트나 소싱된 템플릿, 또는 Feature가 연결된 component의 프래그먼트가 여전히 Ref, Fn::Sub 변수 또는 규칙의 Fn::ValueOf로 그 파라미터를 지칭하면, 스택이 더 이상 선언하지 않는 것을 지칭하게 됩니다. CloudFormation은 스택을 배포할 때 이를 거부하므로 조립이 중단됩니다. 스택의 어떤 component가 자체 파라미터나 리소스의 논리적 ID로 여전히 선언하는 이름은 스택이 해석하는 참조이므로 중단되지 않습니다.

출력되는 메시지. 조건이 먼저 나오고, 이어서 각 참조에 대해 그 참조가 있는 component와 템플릿, 파라미터, 그리고 해당 Recipe 또는 연결된 FeatureRecipe의 valuesMapping이 그 파라미터를 채운 component가 나옵니다. component에 연결된 Feature는 그 component로 지칭되고, 경계에 연결된 Feature는 그 리소스가 aggrega.ai/component-id로 지니는 식별자로 지칭됩니다. 이 식별자는 경계의 경로와 연결의 이름으로 구성되며, 예를 들면 bfr--stack--aux입니다:

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 해석할 수 없습니다) cloudformation-provider: a parameter a sourced template’s binding filled is still referenced from elsewhere in the assembled stack: component "<component>"’s template "<template>" references parameter "<parameter>", which the valuesMapping of a Recipe or FeatureRecipe rendering for component "<component>" binds; …; binding a parameter removes its declaration from the source that declares it, and no template in the stack declares it any more, so the reference names nothing CloudFormation can resolve: reference what the binding component publishes instead, declare the parameter in the template that references it, or remove the key from the valuesMapping (소싱된 템플릿의 바인딩이 채운 파라미터가 조립된 스택의 다른 곳에서 여전히 참조됩니다. 파라미터를 바인딩하면 선언이 제거되므로, 바인딩하는 component가 게시하는 것을 참조하거나, 참조하는 템플릿에 파라미터를 선언하거나, valuesMapping에서 키를 제거하십시오)

해결 방법: 참조하는 component에 그 값이 필요하면, 값을 채우는 component가 provides를 통해 값을 게시하게 하고 그것을 참조합니다. 또는 참조하는 템플릿에 파라미터를 선언하여 자체 값을 받게 합니다. 또는 valuesMapping에서 키를 제거하여, 파라미터가 선언된 채로 남고 모든 component가 스택 배포 시 전달되는 값을 읽게 합니다. cloudformation → 소싱된 템플릿 파라미터의 값을 참조하십시오.

CloudFormation 파라미터에 바인딩된 값이 파라미터의 타입을 받을 수 없습니다

파라미터에 바인딩된 리터럴은 스택을 배포할 때 CloudFormation이 그 파라미터의 Type에 대해 전달된 같은 값을 변환하는 방식으로 변환됩니다. 그러한 변환이 없으면 렌더링이 중단됩니다. 즉 Number 또는 List<Number>에 바인딩된 숫자가 아닌 값, 하나의 값을 받는 파라미터에 바인딩된 리스트나 매핑, 그리고 AWS::SSM::Parameter::Value<…> 파라미터에 바인딩된 모든 리터럴입니다. 이 파라미터의 값은 CloudFormation이 템플릿이 아니라 Parameter Store에서 읽습니다. 템플릿이 Fn::Sub 변수로 지칭하는 파라미터에 바인딩된 리스트도 렌더링을 중단합니다. 변수는 하나의 문자열을 치환하기 때문입니다.

출력되는 메시지. 조건이 먼저 나오고, 이어서 파라미터, 그 템플릿과 타입, 그리고 값이 맞지 않는 이유가 나옵니다. 값은 인용되지 않습니다:

a plugin has no representation for a value it was given (플러그인에 주어진 값에 대한 표현이 없습니다) cloudformation-provider: parameter "<parameter>" of template "<template>" is of type <type>, and <why the value does not fit> (템플릿의 파라미터 타입에 값이 맞지 않습니다)

해결 방법: 파라미터의 타입에 맞는 값을 바인딩합니다. Parameter Store 타입이라면 {{resolve:ssm:…}} 동적 참조나 내장 함수를 바인딩합니다. 또는 스택 배포 시 전달되는 값을 위해 파라미터를 바인딩하지 않은 채로 둡니다.

CloudFormation 파라미터에 바인딩된 값이 그 제약 조건이 거부하는 값입니다

파라미터에 바인딩된 리터럴은 템플릿이 그 파라미터에 선언한 제약 조건, 즉 AllowedValues, AllowedPattern, MinLength, MaxLength, MinValue, MaxValue에 대해 검사됩니다. 이는 스택 배포 시 전달되는 값에 CloudFormation이 수행하는 검사를 빌드 시점으로 옮긴 것으로, 파라미터를 채워도 템플릿이 선언한 검사가 없어지지 않게 합니다. 내장 함수와 동적 참조는 스택이 배포될 때까지 값이 존재하지 않으므로 CloudFormation의 검사에 맡깁니다.

출력되는 메시지. 조건이 먼저 나오고, 이어서 파라미터, 그 템플릿, 그리고 제약 조건이 나옵니다. 값은 인용되지 않습니다:

a plugin has no representation for a value it was given (플러그인에 주어진 값에 대한 표현이 없습니다) cloudformation-provider: the value bound to parameter "<parameter>" of template "<template>" does not satisfy its <constraint>, which CloudFormation would refuse when the stack deploys; bind a value the parameter admits (바인딩된 값이 제약 조건을 충족하지 않으므로 CloudFormation이 배포 시 거부합니다. 파라미터가 허용하는 값을 바인딩하십시오)

해결 방법: 제약 조건이 허용하는 값을 바인딩합니다. 허용되는 값은 템플릿 자체의 파라미터 선언에 나와 있습니다.

CloudFormation 파라미터에 바인딩된 시크릿이 템플릿에 기록됩니다

파라미터에 바인딩된 값은 템플릿에 기록되며, 스택의 템플릿을 읽을 수 있는 누구나 그 값을 읽을 수 있습니다. 템플릿이 NoEcho로 선언한 파라미터에 리터럴이 바인딩되면 렌더링이 중단되고, Recipe 또는 FeatureRecipe의 valuesMapping이 작성자가 민감하다고 선언한 값을 읽는 경우에는 그 매핑이 바인딩하는 모든 리터럴에서 중단됩니다. 그 출력은 어느 것도 원래의 값으로 추적할 수 없기 때문입니다. 동적 참조와 내장 함수는 내장 함수 안의 텍스트를 포함하여 주어진 그대로 기록됩니다. 따라서 매핑이 Fn::Sub 문자열에 이어 붙인 민감한 값은 그 텍스트로 템플릿에 도달하며, 시크릿 자체를 템플릿 밖에 두는 것은 동적 참조뿐입니다.

출력되는 메시지. 조건이 먼저 나오고, 이어서 파라미터와 대신 바인딩할 것이 나옵니다. 값은 인용되지 않습니다. 다음 중 하나입니다:

a plugin has no representation for a value it was given (플러그인에 주어진 값에 대한 표현이 없습니다) cloudformation-provider: parameter "<parameter>" of template "<template>" is declared NoEcho, and the value bound to it would be written into the template as it stands; bind a dynamic reference ({{resolve:secretsmanager:…}} or {{resolve:ssm-secure:…}}) or an intrinsic function instead, or leave the parameter unbound for a deploy-time value (파라미터가 NoEcho로 선언되어 바인딩된 값이 그대로 템플릿에 기록됩니다. 대신 동적 참조나 내장 함수를 바인딩하거나, 배포 시 값을 위해 파라미터를 바인딩하지 마십시오)

cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping reads a value declared sensitive, so a literal it produces is refused, and binding parameter(s) "<parameter>", … would write a literal into the template as it stands; … (Recipe 또는 FeatureRecipe의 valuesMapping이 민감하다고 선언된 값을 읽으므로 생성된 리터럴이 거부되며, 파라미터를 바인딩하면 리터럴이 그대로 템플릿에 기록됩니다)

해결 방법: 시크릿을 Secrets Manager나 Parameter Store 보안 문자열로 저장하고, 내장 함수의 텍스트에 이어 붙이는 대신 {{resolve:secretsmanager:<secret>}} 또는 {{resolve:ssm-secure:<name>}} 같은 동적 참조를 바인딩합니다. 또는 스택 배포 시 전달되는 값을 위해 파라미터를 바인딩하지 않은 채로 둡니다. cloudformation → 소싱된 템플릿 파라미터의 값을 참조하십시오.

CloudFormation이 해석하지 않는 위치에 동적 참조가 바인딩됨

CloudFormation은 리소스의 속성 안에서는 동적 참조를 해석하지만, EC2 사용자 데이터와 AWS::CloudFormation::Init 메타데이터 안에서는 해석하지 않으며, 템플릿의 Outputs는 스택을 읽는 누구에게나 보여 줍니다. 따라서 소스의 어느 템플릿이든 UserData 속성, 해당 메타데이터 또는 Outputs에서 참조하는 파라미터에 동적 참조가 바인딩되면, 배포할 수 없거나 노출되는 위치에 도달하는 대신 렌더링이 중단됩니다.

출력되는 메시지. 조건이 먼저 오고, 이어서 파라미터, 템플릿, 그리고 해당 템플릿이 파라미터를 참조하는 위치가 옵니다. 값은 인용되지 않습니다.

a plugin has no representation for a value it was given (플러그인에 전달된 값을 표현할 방법이 없습니다) cloudformation-provider: the value bound to parameter "<parameter>" is a dynamic reference, and template "<template>" references the parameter in <where>, where CloudFormation does not resolve a dynamic reference or shows it to whoever reads the stack; bind an intrinsic function instead, or leave the parameter unbound for a deploy-time value (해당 파라미터에 바인딩된 값이 동적 참조이며, 템플릿이 CloudFormation이 동적 참조를 해석하지 않거나 스택을 읽는 누구에게나 이를 보여 주는 위치에서 그 파라미터를 참조합니다. 대신 내장 함수를 바인딩하거나, 배포 시점의 값을 위해 파라미터를 바인딩하지 않은 채로 두십시오)

해결 방법: 파라미터를 바인딩하지 않은 채로 두고 스택 배포 시 값을 전달하거나, 템플릿이 그 위치에서 필요로 하는 것을 산출하는 내장 함수를 바인딩합니다.

규칙이 바인딩된 CloudFormation 파라미터를 이름으로 읽음

템플릿의 Rules에 있는 Fn::ValueOf는 Ref를 통하지 않고 논리 ID로 파라미터를 지정하며, 스택 배포 시 그 파라미터에 전달된 값을 읽습니다. 파라미터를 바인딩하면 소스의 모든 템플릿에서 해당 선언이 제거되므로, 그 템플릿들 중 어디에 있든 규칙이 아무것도 가리키지 않게 되어 렌더링이 중단됩니다.

출력되는 메시지. 조건이 먼저 오고, 이어서 규칙, 해당 템플릿, 파라미터가 옵니다.

a plugin has no expression for a construct this build declares (이 빌드가 선언한 구성 요소를 플러그인이 표현할 수 없습니다) cloudformation-provider: rule "<rule>" of template "<template>" reads parameter "<parameter>" through Fn::ValueOf, which names a declared parameter by its logical ID, and binding the parameter removes its declaration from the source; leave the parameter unbound so the rule can read it at deploy (템플릿의 규칙이 선언된 파라미터를 논리적 ID로 지정하는 Fn::ValueOf를 통해 파라미터를 읽는데, 파라미터를 바인딩하면 소스에서 그 선언이 제거됩니다. 규칙이 배포 시에 읽을 수 있도록 파라미터를 바인딩하지 않은 채로 두십시오)

해결 방법: valuesMapping에서 해당 파라미터의 키를 제거합니다. 그러면 파라미터가 선언된 채로 남고, 규칙은 스택 배포 시 전달된 값을 읽습니다.

조립된 CloudFormation 스택이 변환을 담을 수 없음

조립된 스택의 Transform은 모든 컴포넌트의 것으로부터 구성되며, 변환은 템플릿 전체를 처리합니다. 따라서 효과가 자신을 위해 작성된 내용에 국한되지 않는 변환은 다른 컴포넌트의 내용이 배포되는 방식을 바꾸도록 허용되는 대신 거부됩니다. AWS::CodeDeployBlueGreen과 AWS::Include는 항상, 계정이 정의한 매크로와 AWS::ServiceCatalog는 다른 컴포넌트가 함께 있을 때, AWS::LanguageExtensions는 다른 컴포넌트의 서버리스 내용과 함께 있을 때, AWS::Serverless-2016-10-31은 그 Globals가 다른 컴포넌트의 서버리스 리소스에 미치거나 그 이벤트 소스 중 하나가 다른 컴포넌트가 선언한 리소스를 지정할 때 거부됩니다. 전체 표는 cloudformation → 조립된 스택의 최상위 섹션에 있습니다.

출력되는 메시지. 조건이 먼저 오고, 이어서 스택의 모든 컴포넌트, 변환과 그것을 선언한 컴포넌트들, 그리고 담을 수 없는 이유가 옵니다.

a plugin has no expression for a construct this build declares (이 빌드가 선언한 구성 요소를 플러그인이 표현할 수 없습니다) cloudformation-provider: the assembled stack of component "<component>", … cannot carry the transform "<transform>", declared by component "<component>": <why> (나열된 컴포넌트들의 조립된 스택은 해당 컴포넌트가 선언한 transform을 담을 수 없습니다. 이유가 뒤따릅니다)

해결 방법: 변환을 선언한 컴포넌트를 별도의 경계에 두어 그 스택에 변환이 바꿀 수 있는 것이 없도록 합니다. 또는 메시지가 다른 컴포넌트가 선언한 내용을 지정하는 경우, 그 내용을 변환을 선언한 컴포넌트로 옮깁니다.

두 컴포넌트가 한 쌍의 변환을 반대 순서로 지정함

조립된 스택은 각 컴포넌트 자체의 순서와 CloudFormation이 문서화한 순서로부터 구성된 하나의 순서로 변환을 실행합니다. 두 순서가 동시에 성립할 수 없는 경우, 즉 두 컴포넌트가 한 쌍의 변환을 반대로 나열하거나, CloudFormation이 반대로 문서화한 AWS::Serverless-2016-10-31을 AWS::LanguageExtensions보다 앞에 나열하는 컴포넌트가 있으면, 작성할 단일 순서가 없으므로 렌더링이 중단됩니다.

출력되는 메시지. 조건이 먼저 오고, 이어서 해당 쌍과 각 방향으로 순서를 지정한 주체가 옵니다.

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 항목을 정확히 하나의 값으로 해석할 수 없습니다) cloudformation-provider: the transforms "<first>" and "<second>" are ordered both ways — "<first>" before "<second>" by <who>, and "<second>" before "<first>" by <who> — and the assembled stack’s Transform runs them in one order; declare them in one order (두 transform이 양방향으로 순서가 지정되어 있지만 조립된 스택의 Transform은 이를 하나의 순서로 실행합니다. 하나의 순서로 선언하십시오)

해결 방법: 두 변환을 모두 나열하는 모든 컴포넌트에서 그 쌍을 하나의 순서로 선언하고, CloudFormation이 순서를 문서화한 경우 그 순서를 따릅니다.

두 항목이 하나의 스택 출력 이름에 도달함

스택 출력 이름은 문자와 숫자만 허용하므로, 작성한 내용에서 이 알파벳이 허용하지 않는 문자를 버리는 대신 인코딩하여 이름을 구성합니다. 따라서 따로 작성한 두 항목은 따로 유지되며, 이 중단은 그럼에도 두 항목이 하나의 이름에 도달하는 경우를 보고합니다. 두 항목이 작성된 곳에 하나의 출력을 내보내면 그중 하나가 아무 알림 없이 사라지므로, 렌더링이 중단됩니다.

둘 이상의 항목이 만난 모든 이름이 보고되고, 각 이름 뒤의 모든 항목이 안정적인 순서로 지정됩니다. 따라서 한 번의 빌드로 충돌의 한쪽이 아닌 전체를 확인할 수 있습니다.

출력되는 메시지. 조건으로 시작하고 프로바이더 자체의 세부 내용이 이어집니다.

two things a plugin produced occupy one name in its output (플러그인이 생성한 두 항목이 출력에서 하나의 이름을 차지합니다) cloudformation-provider: two entries an author wrote reach one stack Output name: <the entries that met> reach the Output name "<name>"; an Output name is built by encoding the component and the entry into the letters and digits a logical id admits, rather than by dropping what it does not, so two entries an author wrote apart stay apart — renaming either end clears the build (작성자가 쓴 두 항목이 하나의 스택 Output 이름에 도달합니다. Output 이름은 허용되지 않는 문자를 버리지 않고 컴포넌트와 항목을 논리적 ID가 허용하는 문자와 숫자로 인코딩하여 만들어지므로, 작성자가 구분해 쓴 두 항목은 구분된 채로 유지됩니다. 어느 한쪽의 이름을 바꾸면 빌드가 통과합니다)

해결 방법: 항목 중 하나 또는 컴포넌트 중 하나의 이름을 바꿔 두 항목이 더 이상 하나의 이름에 도달하지 않도록 합니다. 메시지가 양쪽을 모두 지정합니다. 이름에는 작성한 구두점과 대소문자가 버려지지 않고 인코딩되어 담기므로, 둘 중 어느 차이든 이름에 남으며 다르게 작성된 두 항목은 다른 이름을 갖습니다.

CloudFormation 프래그먼트가 하나의 키를 두 번 작성함

매핑은 키당 하나의 값을 담으므로, 같은 키를 두 번 작성한 프래그먼트는 마지막에 온 본문을 유지하고 다른 하나를 버리게 됩니다. 그 매핑이 리소스나 출력을 담는 블록이라면, 버려진 본문은 작성되었지만 결과에 포함되지 않는 리소스나 출력입니다. 대신 렌더링이 중단됩니다.

키가 작성된 두 위치가 모두 보고됩니다. 두 번 작성된 키는 대개 서로 다른 두 키를 의도한 두 번의 편집이며, 작성자가 어느 쪽을 바꿀지 판단하려면 양쪽이 모두 필요하기 때문입니다.

출력되는 메시지. 조건으로 시작하고 프로바이더 자체의 세부 내용이 이어집니다.

two things a plugin produced occupy one name in its output (플러그인이 생성한 두 항목이 출력에서 하나의 이름을 차지합니다) cloudformation-provider: one mapping key is written more than once: the key "<key>" is written at line <first> and again at line <second>; a mapping holds one value per key, so one of the two bodies would be dropped — remove one, or rename one so each key is written once (하나의 매핑 키가 두 줄에 걸쳐 두 번 이상 작성되었습니다. 매핑은 키마다 하나의 값만 가지므로 두 본문 중 하나가 버려집니다. 하나를 제거하거나, 각 키가 한 번만 작성되도록 하나의 이름을 바꾸십시오)

해결 방법: 메시지가 지정한 두 행에서 프래그먼트를 엽니다. 두 본문이 하나를 의도한 것이라면 이제 중복된 쪽을 제거하고, 둘을 의도한 것이라면 하나의 이름을 바꿔 각각 고유한 키를 갖도록 합니다. 프래그먼트는 템플릿이므로, 키가 문자 그대로 작성되지 않고 조합되는 경우에는 소스만 보지 말고 렌더링된 텍스트를 확인합니다.

A cross-boundary reference has no consuming stack to be written into (경계를 넘는 참조를 기록할 소비 측 스택이 없음)

의존 연결이 별도로 조립되는 두 출력 사이를 넘나드는 경우, 소비 측은 자리 표시자와 함께 렌더링되고 참조는 양쪽이 모두 존재하게 된 뒤에 기록됩니다. 이 조건은 소비 측의 조립된 출력에 스택 템플릿이 전혀 없을 때 발생합니다. 참조를 기록할 문서가 없으므로 자리 표시자를 교체할 수 없습니다.

출력되는 메시지. 조건이 실패의 종류를 밝히고, provider 자체의 문장이 어느 입력인지 알려 줍니다:

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 확정하지 못함) cloudformation-provider: cross-boundary link resolve received no consumer stack template (경계를 넘는 링크 확정 과정에서 소비 측 스택 템플릿을 받지 못함)

해결 방법: 소비 측 컴포넌트 안에 작성한 어떤 내용도 이 문제를 일으키지 않습니다. 이는 해당 경계가 조립한 결과의 형태 때문입니다. 먼저 소비 측이 실제로 CloudFormation provider로 렌더링되는지 확인합니다. 다른 것을 조립하는 경계로 넘어가는 연결에는 참조가 들어갈 스택이 없으며, 이러한 연결은 같은 provider가 조립하는 두 경계 사이에 두어야 합니다. 양쪽이 모두 CloudFormation이어야 하는 경우라면 소비 측 경계가 스택 템플릿을 생성하지 않은 것이며, 이는 그 경계에 기여하는 Recipes를 작성한 사람에게 확인할 문제입니다.

A cross-boundary reference was spliced into a longer string (경계를 넘는 참조가 더 긴 문자열 안에 이어 붙여짐)

CloudFormation 교차 참조는 텍스트가 아니라 객체이므로 값을 통째로만 대체할 수 있습니다. 이 조건은 자리 표시자가 더 큰 문자열 안에서 발견되었을 때, 즉 주입된 값 전체로 전달되지 않고 그 주위에 값이 조합되었을 때 보고됩니다. 객체로 바꿔 넣을 대상이 없으므로, 대상이 읽을 수 없는 형태로 참조를 내보내는 대신 렌더링이 중단됩니다.

출력되는 메시지. 조건이 먼저 나오고, 이어서 값과 그 값이 전달된 연결이 나옵니다:

a plugin has no representation for a value it was given (플러그인에 전달받은 값을 표현할 방법이 없습니다) cloudformation-provider: cross-boundary link value is interpolated into a larger string; only a whole-scalar injection can carry a cross-stack reference: output key "<key>" on socket "<socket>" (경계를 넘는 링크 값이 더 긴 문자열 안에 보간되었습니다. 스칼라 값 전체를 주입하는 경우에만 교차 스택 참조를 전달할 수 있습니다)

해결 방법: 값 주위에 조합하지 말고 값을 통째로 전달합니다. 소비 측이 연결 문자열이나 URL처럼 더 긴 문자열 안에서 값을 필요로 하는 경우, 참조가 존재하기 전에 Recipe의 템플릿에서 조합하지 말고 대상 자체의 어휘로 참조로부터 그 조합을 구성합니다. 이어 붙이기는 값을 주입하는 매핑에서 일어나므로, 그 줄을 수정해야 합니다.

Two rendered resources land at one output file (렌더링된 두 리소스가 하나의 출력 파일에 놓임)

렌더링된 각 리소스는 리소스의 종류와 이름에서 파일 이름이 정해지는 파일에 기록됩니다. 이 둘을 공유하는 두 리소스는 같은 파일 이름을 가지므로 하나가 다른 하나의 자리를 차지하게 되며, 두 리소스가 렌더링된 곳에 파일 하나만 내보내는 대신 렌더링이 중단됩니다.

똑같이 렌더링되는 두 리소스는 충돌이 아닙니다. 내용이 바이트 단위로 일치하면 하나만 남겨도 잃는 것이 없으므로 렌더링은 계속됩니다. 따라서 같은 결과로 두 번 포함된 템플릿은 보고되지 않습니다.

출력되는 메시지. 조건이 먼저 나오고, 이어서 리소스를 생성한 두 템플릿과 두 리소스가 만난 파일이 나옵니다:

two things a plugin produced occupy one name in its output (플러그인이 생성한 두 항목이 출력에서 하나의 이름을 차지합니다) helm: node "<node>": rendered resources "<one template>" and "<the other>" both derive output "<file>" with differing content: two rendered resources derive the same output filename with differing content (렌더링된 두 리소스가 내용이 서로 다른데도 같은 출력 파일 이름을 도출합니다)

해결 방법: 두 리소스에 서로 다른 식별자를 부여합니다. 보통 다른 것은 이름이며, 파일 이름은 이름에서 정해집니다. 메시지에 두 템플릿이 모두 나오므로 둘을 열어 각각 무엇을 생성하는지 확인합니다. 두 템플릿이 같은 리소스를 하나의 이름으로 렌더링한다면, 그중 하나가 오래된 사본인 경우가 많습니다. 둘 다 필요하다면 이는 두 개의 리소스이므로 각각 고유한 이름이 있어야 합니다.

A synthesized StatefulSet has no single service to govern it (합성된 StatefulSet을 관리할 단일 서비스가 없음)

인스턴스별 스토리지를 선언한 워크로드는 StatefulSet으로 렌더링되며, StatefulSet은 자신을 관리하는 서비스 하나, 즉 각 인스턴스에 안정적인 주소를 부여하는 서비스를 지정합니다. 그 서비스는 자체 클러스터 주소 없이 선언된 서비스입니다. 두 가지 형태에서 렌더링이 중단됩니다. 하나도 선언되지 않아 지정할 대상이 없는 경우와, 둘 이상이 선언되어 어느 것이 관리하는지 답할 수 없는 경우입니다. 어느 쪽이든 대상이 거부하는 StatefulSet이 만들어지므로, 이를 내보내는 대신 렌더링이 중단됩니다.

출력되는 메시지. 두 메시지 모두 같은 조건, 즉 provider가 필요로 하지만 정확히 하나의 값으로 확정하지 못한 것을 보고하며, provider 자체의 문장이 두 형태 중 어느 것에 해당하는지 알려 줍니다. 각 메시지는 노드를 밝히는 프레임 아래에 출력됩니다:

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 확정하지 못함) synthesized StatefulSet requires a headless governing Service (declare a service with type: Headless); none found: synthesized StatefulSet has no headless governing Service (합성된 StatefulSet에는 관리용 headless Service가 필요함(type: Headless인 서비스를 선언할 것). 찾지 못함: 합성된 StatefulSet에 관리용 headless Service가 없음)

a plugin could not resolve something it requires to exactly one value (플러그인이 필요로 하는 것을 정확히 하나의 값으로 확정하지 못함) synthesized StatefulSet declares more than one headless Service; the governing Service is ambiguous (declare exactly one type: Headless service): synthesized StatefulSet has more than one headless Service (합성된 StatefulSet이 headless Service를 둘 이상 선언함. 관리용 Service가 모호함(type: Headless 서비스를 정확히 하나 선언할 것): 합성된 StatefulSet에 headless Service가 둘 이상 있음)

해결 방법: 워크로드에 headless 유형의 서비스를 정확히 하나 선언합니다. 하나도 선언되지 않았다면 추가합니다. 인스턴스별 스토리지가 있는 워크로드에는 이 서비스가 필요하며, 각 인스턴스에 계속 유지되는 주소를 부여하는 것이 바로 이 서비스입니다. 둘 이상 선언되었다면 관리해야 할 서비스 하나만 남기고 나머지는 일반 유형으로 바꾸거나 제거합니다. 두 번째 headless 서비스는 대개 headless일 필요가 없었던 서비스입니다.

A plugin reported a failure it did not classify (플러그인이 분류하지 않은 실패를 보고함)

빌드를 중단하는 플러그인은 두 가지를 보고합니다. 무슨 일이 일어났는지 설명하는 자체 문장과, 그 문장이 가리키는 실패의 종류입니다. 종류는 컴파일러가 선언하는 작은 집합으로, 표현할 방법이 없는 구성 요소, 하나의 값으로 확정할 수 없었던 입력, 하나의 이름을 원하는 두 생성물, 표현할 방법이 없는 값이 있으며, 이 조건은 실패가 그중 어디에도 맞지 않을 때 플러그인이 선택하는 조건입니다.

이 조건은 목적지가 아니라 대체 수단입니다. 다른 종류 중 하나가 맞는데도 이 조건을 선택하는 플러그인은 아는 것보다 적게 알려 주는 것이며, 문구는 무언가가 단순히 잘못되었다는 것이 아니라 플러그인이 분류를 하지 않았다는 점을 분명히 밝힙니다. 따라서 남용된 대체 수단은 올바른 보고와 구별되지 않는 것이 아니라 알아볼 수 있습니다.

출력되는 메시지. 조건이 먼저 나오고 플러그인 자체의 문장이 뒤따릅니다:

a plugin reported a failure that none of the declared kinds names (플러그인이 선언된 어떤 종류에도 해당하지 않는 실패를 보고함) <the plugin's own sentence>

해결 방법: 플러그인 자체의 문장을 읽습니다. 빌드에 고유한 모든 내용은 그 문장에 있습니다. 조건 자체는 플러그인에 해당하는 종류가 없었다는 것만 알려 줍니다. 직접 만든 플러그인이라면 실패가 실제로 해당하는 종류를 선택합니다. 그렇지 않다면 그 문장을 플러그인 배포자에게 그대로 전달합니다.

A plugin named a condition the socket does not declare (플러그인이 소켓이 선언하지 않은 조건을 지정함)

플러그인은 자체 번호를 만들어 내는 대신 이 컴파일러가 선언하는 조건을 보고하므로, 전달되는 식별자는 항상 aggrega explain이 답할 수 있는 것입니다. 이 중단은 그 밖의 것을 지정하는 보고가 일으킵니다. 아무것도 등록되지 않은 번호, 폐기된 번호, 해석되는 등록과 철자가 다른 짧은 코드, 또는 서로 다른 두 조건을 가리키는 식별자 쌍이 그렇습니다.

보고를 조용히 철회하지 않고 중단합니다. 식별자를 버리고 일반 플러그인 실패 조건을 그대로 두면, 조건을 전혀 지정하지 않은 플러그인의 빌드와 똑같아 보이는 빌드가 만들어지므로, 이를 고쳐야 하는 사람은 고칠 것이 있었다는 사실을 결코 알 수 없습니다. 대신 제시된 번호를 보고하면 아무것으로도 해석되지 않는 식별자를 건네게 됩니다.

빌드는 여전히 무엇이 빌드를 멈췄는지 전달받습니다. 이 중단은 문제가 된 번호를 인용하고, 그 번호가 어떤 조건으로도 해석되지 않는 이유를 밝히고, 플러그인이 더 나은 식별자가 없을 때 사용하는 일반 조건을 지정하며, 플러그인 자체의 문장을 변경 없이 그대로 전달합니다.

출력되는 메시지:

wasm: guest plugin named a condition the socket does not declare: the guest named "<offered>", and <why it resolves to no condition>; a plugin names a condition this compiler declares, and reaches for one of <the generic conditions and their codes> when it has none better: <the plugin's own sentence>

해결 방법: 엔터티 파일의 어떤 내용도 이를 일으키지 않습니다. 잘못된 것은 플러그인의 보고이며, 플러그인이 보고하던 실패는 실제로 일어난 것입니다. 메시지의 마지막 부분인 플러그인 자체의 문장에 따라 조치합니다. 플러그인을 직접 작성했다면 이 컴파일러가 선언하는 조건을 보고합니다. 실패가 더 구체적인 조건 중 어느 것에도 해당하지 않으면 메시지에 나열된 일반 종류 중 하나를 사용합니다. 직접 작성한 플러그인이 아니라면 문제가 된 번호를 플러그인 게시자에게 전달합니다.

A source artifact is cached without a workspace root to anchor it (기준이 될 워크스페이스 루트 없이 소스 아티팩트가 캐시됨)

획득한 소스 아티팩트는 워크스페이스 아티팩트 캐시 아래의 슬롯에 저장되며, 그 슬롯의 경로는 워크스페이스 루트에서 바깥쪽으로 구성됩니다. 이 조건은 루트가 비어 있는 상태로 전달된 경우를 보고합니다. 이 경우 슬롯 경로가 상대 경로가 되어, 바이트가 기록될 때 프로세스가 마침 위치한 디렉터리를 기준으로 해석되고, 아무도 선택하지 않은 위치에 캐시가 놓이게 됩니다.

이는 해석되지 않고 거부됩니다. 잘못된 위치에 기록된 슬롯은 슬롯이 없는 것보다 나쁘기 때문입니다. 이후의 읽기는 올바른 위치를 찾아보고 아무것도 찾지 못해 다시 획득하므로, 아무것도 담지 않는 것처럼 보이는 캐시만 보이고 그 이유를 가리키는 것은 아무것도 없게 됩니다.

출력되는 메시지. 조건 자체의 문장으로 시작하고, 아티팩트를 식별하는 정보가 뒤따릅니다:

cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>)

해결 방법: 엔터티 파일의 어떤 내용도 이를 일으키지 않으며 어떤 작성 변경으로도 해소되지 않습니다. 워크스페이스 루트는 카탈로그에 작성되는 것이 아니라 빌드를 구동하는 쪽이 제공합니다. 워크스페이스 안에서 빌드를 실행하여 루트가 빈 값으로 전달되지 않고 탐색되게 합니다. 직접 작성한 소프트웨어에서 컴파일러를 구동한다면 워크스페이스 루트를 명시적으로 전달합니다. 캐시를 실제로 현재 디렉터리 기준의 상대 경로로 두려는 호출자는 점 하나를 전달하며, 이는 허용되고 그 의도를 명시적으로 나타냅니다.

A value would place a cached file outside the cache (값이 캐시된 파일을 캐시 밖에 둠)

캐시된 엔터티와 캐시된 소스 아티팩트는 각각 캐시가 지정한 슬롯에 놓이며, 그 슬롯은 값으로 구성됩니다. 엔터티의 참조와 해석된 버전, 또는 소스의 종류, url, chart, module_subdir, 버전과 다이제스트입니다. 각 값은 레이아웃의 한 위치를 지정합니다. 이 조건은 해당 값에 대해 기록되는 것을 그 값이 지정하는 위치가 아닌 다른 곳, 즉 다른 슬롯 옆이나 아예 캐시 밖으로 옮기게 될 값을 보고하며, 그곳에 무언가를 기록하거나 읽기 전에 그 값을 거부합니다.

이 값들 대부분은 캐시가 제어하지 않는 곳에서 옵니다. 레지스트리가 제공한 본문, 디스크에서 다시 읽은 레코드, Recipe 또는 FeatureRecipe 작성자가 작성한 좌표가 그렇습니다. 버전이 아닌 경로인 버전, 자신의 위치 위로 올라가는 url 경로나 module_subdir, 점 디렉터리로 해석되는 참조는 모두 여기서 거부됩니다. 디렉터리 하나를 지정하는 값, 그리고 자신의 위치나 그 아래에 머무는 url 경로나 module_subdir는 영향을 받지 않습니다.

위로 올라가는 module_subdir는 무엇이든 가져오기 전에 거부됩니다. git-repository 소스의 경우 같은 값이 pull이 보관하는 저장소의 디렉터리도 지정하며, 저장소 위로 올라가는 값은 pull이 체크아웃 옆의 파일을 읽게 만듭니다. 따라서 pull은 저장소를 가져오기 전에 module_subdir를 판정하고, 위로 올라가는 값을 이 조건으로 거부하며 해당 키 아래에 인용합니다. 아무것도 가져오지 않고, 체크아웃 옆의 어떤 것도 읽지 않습니다. 값 안의 백슬래시는 Windows 경로처럼 구분자로 읽히므로, ..\shared는 어느 한 머신에서 체크아웃 옆을 읽는 대신 모든 머신에서 거부됩니다. 값의 앞이나 뒤에 있는 구분자는 제거되므로 /charts/app는 charts/app를 지정합니다.

출력되는 메시지. 조건 자체의 문장으로 시작하고, 작성된 키 아래에 작성된 그대로의 값, 그리고 해결책이 뒤따릅니다:

a value a cache location is built from would place cached files outside the place it names in the cache (version "../../../etc" for entity "demo/app/web"). a version, a name, a kind or a host names one directory of the cache, so it carries no / or \ and is neither . nor ..; a URL path or a module subdirectory may name directories beneath its place but may not climb above it. Correct the value where it was written, or, where a registry served it, ask its publisher to publish a version that carries a well-formed one

해결 방법: 값을 직접 작성했다면, 즉 Recipe 또는 FeatureRecipe의 source.version, url, module_subdir라면, 디렉터리 하나 또는 자신의 위치 안에 머무는 경로를 지정하도록 수정합니다. 메시지는 값과 그 값을 읽은 키를 인용합니다. 레지스트리가 제공한 값이라면 게시된 엔터티가 올바르지 않은 버전이나 좌표를 담고 있는 것이며, 이는 직접 변경해서 고칠 수 없습니다. 메시지는 가져온 대상을 지정하며, 해결책은 그 게시자에게 있습니다.

여러 작업은 지정한 위치가 아니라 스스로 정한 위치에 자체 파일을 쓰거나 제거합니다. 빌드의 출력 디렉터리와 빌드가 그곳에 쓰는 모든 파일, 그리고 추적 빌드가 교체하는 .trace 디렉터리, pull이 쓰는 Release의 잠금 파일과 그 옆의 플러그인 신뢰 기록, aggrega pin이 쓰고 소스를 고정하는 pull이 고정하는 각 엔터티 옆에 쓰는 엔터티 옆의 entity.lock, 명령이 워크스페이스 구성을 쓸 때의 워크스페이스 .aggrega-config.yaml, pull이 채우고 aggrega cache clear와 aggrega cache prune이 비우는 아티팩트 캐시와 그 각 하위 트리, pull이 서명을 검증한 각 아티팩트에 대해 그 캐시에 보관하는 서명 번들, aggrega import가 쓰는 초안, aggrega plugin gen-catalog가 출력 디렉터리 아래에 쓰는 Plugin 엔터티, 그리고 기본 Release가 기록될 때 편집기의 언어 서버가 쓰는 .aggrega/active-release 표식과 이를 담는 .aggrega 디렉터리가 그렇습니다. 명령줄, 편집기의 언어 서버, 어시스턴트의 도구 중 어느 쪽이 작업을 시작했든 동일하게 적용됩니다. 워크스페이스 경계에서 여기에 적용되는 규칙과 의도적으로 워크스페이스 밖에 닿는 경로를 설명합니다.

각 위치에는 머물러야 할 디렉터리가 있으며, 어느 디렉터리인지는 작업이 그 위치를 구성하는 기준 디렉터리에 따라 달라집니다.

  • 워크스페이스: 워크스페이스 안에서 구성되는 모든 것에 해당합니다. 일반적인 경우이며, 지정한 디렉터리가 워크스페이스 안에 있을 때도 적용됩니다. 빌드의 dist와 .trace는 빌드를 어느 폴더에서 실행하든 항상 이곳, 즉 워크스페이스 루트 아래에 구성되며, 출력 디렉터리를 지정하지 않은 import의 초안도 마찬가지입니다.
  • 워크스페이스 밖에 있는 지정한 디렉터리: 그 아래에서 구성되는 모든 것에 해당합니다. aggrega plugin gen-catalog 또는 aggrega import에 전달하는 출력 디렉터리, 워크스페이스 밖에 있는 지정한 Release 또는 워크스페이스 구성이 지정한 Release의 디렉터리(그 옆의 잠금 파일과 신뢰 기록에 대해), 그리고 aggrega pin에 지정한 엔터티의 디렉터리 또는 --catalog로 지정하거나 구성이 catalog_dirs에 나열한 카탈로그 디렉터리(그 안 각 엔터티 옆의 entity.lock에 대해)가 그렇습니다. 디렉터리 자체는 지정한 그대로 사용되며, 링크인 디렉터리는 링크를 거쳐 가리키는 곳에 쓰입니다. 그 아래에 쓰이는 것은 그 디렉터리 안에 머뭅니다.
  • 아티팩트 캐시 디렉터리 자체: 그 아래 캐시에 쓰이는 모든 것과 aggrega cache clear 및 aggrega cache prune이 그곳에서 제거하는 모든 것에 해당합니다. 기본값 .aggrega/cache뿐 아니라 구성이 워크스페이스 루트 밖으로 올라가도록 작성한 artifact_cache_dir(../shared-cache)도 마찬가지입니다. 캐시 자체의 디렉터리나 그 안의 파일이 캐시 디렉터리 밖으로 이어지는 링크이면, 그 링크가 워크스페이스 안의 다른 곳으로 이어지더라도 거부됩니다. 따라서 캐시에 쓰이는 것도, clear나 prune이 제거하는 것도 캐시 밖의 파일에 닿지 않습니다. 캐시 디렉터리 자체의 위치가 먼저 판단됩니다. 워크스페이스 루트 안에 작성된 캐시 디렉터리는 워크스페이스 안에서는 어디로 이어지든 따라가지만, 워크스페이스로 제한되므로 워크스페이스 밖으로 이어지면 거부됩니다. 워크스페이스 루트 밖으로 올라가도록 작성된 캐시 디렉터리는 지정한 그대로 사용되며, 링크이면 링크를 거쳐 가리키는 곳에 쓰입니다.

각 위치는 그곳에 무언가를 쓰거나 제거하기 전에 검사됩니다. 경로 중 존재하는 가장 깊은 부분은, 도중의 모든 심볼릭 링크를 따라간 결과가 머물러야 할 디렉터리이거나 그 아래에 있어야 합니다. 도중 어디서든 그 디렉터리 밖으로 이어지는 링크가 있으면(다른 곳의 디렉터리에 링크된 dist, 다른 프로젝트의 파일에 링크된 잠금 파일, 다른 작업과 공유하는 디렉터리에 링크된 .aggrega/cache, 다른 곳에 링크된 gen-catalog 출력 디렉터리 아래의 디렉터리 등) 쓰기나 제거가 밖에서 일어나게 되므로, 작업은 대신 중단되고 그 경로는 원래 상태 그대로 남습니다. 이는 빌드에서 가장 중요합니다. 그렇지 않으면 링크인 출력 디렉터리를 비우고 다시 쓰는 과정에서 머신의 다른 곳에 있는 디렉터리를 삭제하고 다시 쓰게 됩니다.

아무 곳도 가리키지 않는 링크는 있는 그대로, 즉 존재하지 않는 것으로 취급되므로 그 링크를 담은 디렉터리가 검사됩니다. 그런 링크가 작업이 막 생성하려는 경로의 맨 끝에 있으면 파일은 링크가 가리키는 곳에 생성되므로, 가리키는 위치도 함께 검사됩니다. 경로가 머물러야 할 디렉터리 안의 어딘가를 가리키는 링크는 평소대로 따라갑니다.

출력되는 메시지입니다. 조건 자체의 문장으로 시작하고, 이어서 작업이 쓰거나 제거하려던 경로(writing 또는 removing이 어느 쪽인지 나타냄), 머물러야 할 디렉터리, 도중에 만난 링크와 그 링크가 이어지는 위치, 그리고 해결 방법이 나옵니다. dist가 워크스페이스 밖으로 이어지는 링크인 빌드는 처음 건드리게 될 작업, 즉 이전 출력을 비우는 단계에서 중단됩니다.

a path this operation writes or deletes leads through a link out of the directory it must stay inside (removing <workspace>/dist/boundaries, which must stay inside <workspace>, the link <workspace>/dist leads to <elsewhere>/dist-target). nothing was written to or removed from that path. Remove the link, or make it lead to a place inside <workspace>, and run the operation again (이 작업이 쓰거나 삭제하는 경로가 링크를 거쳐 반드시 안에 머물러야 하는 디렉터리 밖으로 이어집니다. 해당 경로에는 아무것도 쓰거나 제거하지 않았습니다. 링크를 제거하거나 작업 공간 안의 위치로 이어지도록 한 뒤 작업을 다시 실행하십시오)

이 진단에는 범주가 없습니다. 잘못된 것은 작성한 문서가 아니라 디스크상의 배치이기 때문입니다.

해결 방법: 메시지가 지정한 링크를 제거하고 작업을 다시 실행하여 그 위치에 실제 디렉터리나 파일이 생성되게 하거나, 링크가 메시지가 지정한 디렉터리 안의 어딘가로 이어지게 하여 따라갈 수 있게 합니다. 엔터티 파일의 어떤 내용도 이 문제의 원인이 아니며, 작성 내용을 바꿔도 해결되지 않습니다.

작업이 쓰는 이름에 Windows가 담을 수 없는 부분이 있음

Windows에서는 일부 이름이 쓰인 그대로 파일에 도달하지 않습니다. Windows가 장치용으로 예약한 이름, 즉 CON, PRN, AUX, NUL, CONIN$, CONOUT$, COM0부터 COM9까지, LPT0부터 LPT9까지, 그리고 위 첨자 1, 2, 3으로 표기한 COM 및 LPT 이름은 대소문자와 뒤에 오는 확장자에 관계없이 파일이 아니라 장치를 가리킵니다. 따라서 nul, Aux.yaml, com1.txt는 모두 장치입니다. 또한 마침표나 공백으로 끝나는 경로 부분은 Windows가 쓰인 그대로 유지하지 않고 잘라 낼 수 있습니다. 이러한 이름을 쓰면 그 바이트가 이름이 가리키는 파일이 아닌 다른 곳에 놓이게 됩니다.

따라서 작업이 Windows 컴퓨터의 디렉터리 아래에 스스로 정하지 않은 이름을 쓰려 할 때, 그러한 부분을 담은 이름은 아무것도 쓰기 전에 거부됩니다. 대상은 다음과 같습니다. 캐시가 읽기 위해 아카이브를 펼칠 때 소스 아티팩트나 카탈로그 엔터티가 담고 있는 아카이브의 항목, 빌드가 출력 디렉터리에 렌더링하는 파일, 임포터가 aggrega import에 반환하는 초안(드라이 런이든 실제 쓰기든 마찬가지), 그리고 어느 표면이 편집을 요청했든 aggrega edit-document가 다시 쓰는 문서입니다. 이름의 모든 부분은 Windows가 읽는 방식대로 백슬래시를 구분자로 읽어 판단됩니다. 따라서 aux/x.yaml은 디렉터리 aux 때문에, report.은 끝의 마침표 때문에, .. \evil.yaml은 두 점과 공백으로 된 첫 부분 때문에 거부됩니다. 한 이름 때문에 거부된 집합은 나머지도 전혀 쓰지 않습니다. 아카이브는 펼쳐지지 않고, 빌드의 출력은 지워지거나 쓰이지 않으며, 어떤 초안도 디스크에 도달하지 않습니다.

Linux와 macOS에서는 같은 이름이 지정된 그대로 쓰이며, 이 조건은 발생하지 않습니다. 쓰이는 위치인 디렉터리 밖으로 올라가는 이름은 다른 결함이며, 이 조건을 검사하기 전에 모든 플랫폼에서 해당 작업 고유의 메시지와 함께 거부됩니다.

출력되는 메시지. 조건 고유의 문장으로 시작하고, 이어서 이름, Windows가 담을 수 없는 부분, 이름이 쓰일 디렉터리를 밝힌 다음 해결 방법을 제시합니다:

a name this operation writes holds a path segment Windows cannot hold as written (the name "aux/x.yaml", its segment "aux", beneath <directory>). It was not written. 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; rename that segment where the name is produced (이 작업이 쓰는 이름에 Windows가 쓰인 그대로 담을 수 없는 경로 세그먼트가 있습니다(위의 이름, 그 세그먼트, 그 아래에 쓰려던 디렉터리). 이 이름은 쓰이지 않았습니다. Windows는 CON, PRN, AUX, NUL, COM1, LPT1 같은 장치 이름을 대소문자와 뒤따르는 확장자에 관계없이 예약하며, 마침표나 공백으로 끝나는 세그먼트를 쓰인 그대로 담지 않습니다. 이름이 만들어지는 곳에서 해당 세그먼트의 이름을 바꾸십시오)

이 진단에는 범주가 없습니다. 이름은 컴파일러가 결함을 귀속시킬 하나의 문서가 아니라, 그것을 만들어 낸 주체, 즉 아카이브의 게시자, Recipe나 라이브러리, 임포터, 편집이 지정한 경로에서 나오기 때문입니다.

해결 방법: 이름이 나오는 곳에서 메시지가 지정한 부분의 이름을 바꿉니다. 아카이브 항목의 경우 게시된 소스 아티팩트나 엔터티가 그 대상이며, 이는 게시자만 변경할 수 있습니다. 렌더링된 파일의 경우 Recipe나 ArtifactLibrary가 부여하는 출력 이름이, 초안의 경우 그 이름을 정한 임포터가, 편집의 경우 문서의 경로가 대상입니다. Windows 컴퓨터 쪽에서 무엇을 하더라도 이 이름을 쓰인 그대로 사용할 수 있게 되지는 않습니다.

빌드를 중단하지 않는 조건

위의 모든 조건은 빌드를 중단합니다. 일부 조건은 빌드를 중단하지 않으면서도 고유한 단축 코드와 메시지를 가지며, 어느 페이지에서 왔든 가지고 있는 코드가 항상 무언가로 연결되도록 여기에 정리되어 있습니다.

이 조건들은 네 가지 종류로 나뉘며, 해결 방법을 찾기 전에 그 차이를 알아 두는 것이 좋습니다.

  • 권고. 빌드는 이를 보고하고 계속 진행하며, 렌더링된 출력은 조치 여부와 관계없이 동일합니다. 각각은 warnings.md에서 자세히 설명합니다. 무엇이 이를 발생시키는지, 컴파일의 어느 단계에서 읽히는지, 무엇을 출력하는지, 어떻게 대처해야 하는지를 다루며, 아래 항목은 내용을 반복하지 않고 해당 섹션을 안내합니다.
  • 편집기가 흡수하는 조건. 편집기 통합 자체가 응답하며, 빌드의 출력에도 진단에도 도달하지 않습니다.
  • 앞선 거부 뒤에 있는 안전장치. 이것이 보호하는 규칙은 빌드를 중단하는 조건이 그보다 먼저 적용하므로, 빌드는 앞선 조건을 먼저 만납니다.
  • 빌드가 아닌 명령에서의 거부. 실제 해결책이 있는 강제 중단입니다. 이를 만난 명령은 종료되고 아무것도 게시, 기록, 변경되지 않습니다. 그러나 컴파일의 어떤 단계도 여기에 도달하지 않으므로 빌드는 이를 보고하지 않습니다. 아티팩트 게시 또는 서명, 엔티티 입력 고정, 레지스트리 추가, 문서 편집, 외부 소스 설명을 초안 작성 파일로 변환, 카탈로그 전체 검사(정확성 검사 또는 게시 관례에 따른 검사)에서 이를 만나게 되며, 각 항목은 어느 명령에 속하는지와 누가 해결할 수 있는지를 설명합니다.

어노테이션 바인딩이 하나의 경로를 두 pillar 목록 모두에 선언함

권고입니다. Manifest 어노테이션 바인딩이 같은 점 표기 경로를 maps.infra 목록과 maps.values 목록 모두에 지정합니다. 이러한 중복 선언은 합법이며 컴파일러는 이를 단속하지 않습니다. 라우팅 동점 처리 규칙이 결정적으로 해당 경로를 infra로 보내므로, 그 경로의 values 측은 Aggregate에서 도달할 수 없게 됩니다.

메시지는 다음으로 시작합니다:

annotation binding declares one path in both pillar lists (어노테이션 바인딩이 하나의 경로를 두 pillar 목록 모두에 선언함)

이 권고는 빌드가 위의 “An annotation routes through a pillar its authoring side may not use”에서 설명하는 중단을 만나기 전에 경고합니다. 권고는 이른 단계의 표면이고, 그 중단은 강제 적용의 표면입니다. 이 린트는 warnings.md의 “Binding-map-overlap lint”에서 설명합니다.

어태치먼트 이름이 선언된 슬롯과 한 번의 편집 차이임

권고입니다. 컴포넌트가 Feature를 자기 타입이 선언한 슬롯이 아닌 이름으로 어태치하지만, 그 이름이 어떤 슬롯과 한 번의 편집 차이 안에 있습니다. 슬롯 이름 오타가 보이는 형태입니다. 어떤 슬롯도 선언하지 않은 이름으로 어태치하는 것은 합법이므로 아무것도 중단되지 않습니다. 권고가 알려 주는 것은 그 결과입니다. 즉 해당 어태치먼트는 의도한 슬롯을 채우는 것이 아니라 자유 어태치먼트가 되며, 슬롯은 비어 있는 채로 남습니다. 커넥션에서는 같은 오타가 합법이 아니므로 대신 근접한 슬롯을 지정하며 중단됩니다. “A connection carries an attachment under a name its socket declares no slot for”를 참고하십시오. 어태치먼트의 Feature가 근접한 슬롯의 selector:를 충족하는 경우 권고는 발생하지 않습니다. 그 짝은 “An attachment written under another name fits a slot its component leaves empty” 아래의 중단이 판정하며, 슬롯이 비어 있을 때 이를 보고합니다.

메시지는 다음으로 시작합니다:

attachment name is a near miss for a declared slot (어태치먼트 이름이 선언된 슬롯과 근소하게 다름)

warnings.md의 “Attachment-slot near-miss lint”에서 짝 판정 기준 및 의도적으로 잡아내지 않는 경우와 함께 설명합니다.

uses: 소켓 이름이 선언된 소켓과 한 번의 편집 차이임

권고입니다. 컴포넌트 자신의 uses: 블록이 자기 타입이 선언하지 않았지만 어떤 소켓과 한 번의 편집 차이 안에 있는 소켓을 지정합니다. 개발자는 Aggregate가 선언하는 토폴로지를 소유하며 카탈로그가 예상하지 못한 소켓을 지정할 수 있으므로, 그 표면에서 타입이 선언하지 않은 소켓 이름은 합법이며 아무것도 중단되지 않습니다. 권고가 알려 주는 것은 그 결과입니다. 철자가 틀린 이름은 셀렉터도 에지별 계약도 없는 자체 임시 커넥션을 만들고, 의도한 소켓은 연결되지 않은 채로 남습니다.

메시지는 다음으로 시작합니다:

uses socket name is a near miss for a declared socket (uses 소켓 이름이 선언된 소켓과 근소하게 다름)

warnings.md의 “Uses-socket near-miss lint”에서 설명합니다. 소유 엔티티의 usesSchema에 없는 소켓 이름이 실제로 중단되는 인접한 두 표면은 위의 “uses: socket not declared in the owning entity’s usesSchema (소유 엔티티에 선언되지 않은 소켓)”에서 다룹니다.

Recipe가 Component가 선언하지 않은 provides 키를 게시함

권고입니다. 컴포넌트에 바인딩된 Recipe가 provides: 아래에, 컴포넌트의 타입이 spec.schema.provides: 계약에 선언하지 않은 키를 게시합니다. Component가 선언한 것보다 많이 게시하는 것은 합법이며 앞으로도 합법입니다. 계약은 부분집합을 요구하고 상위집합을 허용합니다. 권고가 알려 주는 것은 어느 쪽에서도 보이지 않는 결과입니다. uses: 에지를 건너 읽는 소비자는 Recipe가 내보내는 내용이 아니라 대상의 선언된 계약을 보므로, 선언되지 않은 키는 전달되지 않고 이를 읽는 소비 템플릿은 빈 값으로 렌더링됩니다.

메시지는 다음으로 시작합니다:

Recipe publishes a provides key its Component does not declare (Recipe가 Component가 선언하지 않은 provides 키를 게시함)

반대의 경우는 권고가 아닙니다. Recipe가 게시하지 않는 키를 Component가 선언하면 계약이 이행되지 않은 채로 남아 중단됩니다. warnings.md의 “Undeclared-provides-key lint”에서 설명합니다.

선언된 파라미터를 아무것도 읽지 않음

권고입니다. Aggregate가 spec.parameters: 아래에 항목을 선언했지만 그 Aggregate 자체 텍스트의 어떤 {{ .parameters.<key> }} 참조도 이를 읽지 않으므로, Release가 무엇을 제공하든 렌더링된 출력은 동일합니다. 컴파일러는 작성자가 어떤 조절 값을 노출하는지 단속하지 않으며, 파라미터는 그것을 읽을 참조보다 먼저 정당하게 선언될 수 있으므로, 이는 중단하지 않고 권고합니다.

메시지는 다음으로 시작합니다:

declared parameter is read by no reference in the Aggregate (선언된 파라미터를 Aggregate의 어떤 참조도 읽지 않음)

warnings.md의 “Unread declared-parameter warnings”에서 설명하며, 기본값이 면제 사유가 되지 않는 이유와 판독이 볼 수 있는 참조와 볼 수 없는 참조도 다룹니다.

provider 바인딩이 빌드가 읽는 어떤 플러그인도 제공하지 않는 기능을 지정함

권고입니다. plugins.providers 항목이 기능을 지정하되 플러그인은 지정하지 않으며, 빌드가 읽는 provider 플러그인 중 카탈로그 디렉터리에 있든, 컴파일러에 내장되어 있든, lockfile에 기록되어 있든 어느 것도 그 기능을 제공하지 않습니다. 이는 기능 이름의 철자 오류가 보이는 형태이며, 이러한 항목은 아무것도 읽지 않습니다. 바인딩은 Recipe가 해당 기능을 요청할 때만 참조되며, 플러그인을 지정하지 않은 바인딩은 그것이 없어도 기능 해석이 선택했을 것 외에는 아무것도 선택하지 않습니다.

빌드가 확신할 수 없으므로 중단하지 않고 권고합니다. 바인딩은 전체 워크스페이스에 대해 한 번 작성되지만 빌드는 하나의 Release를 대상으로 하므로, 그 기능을 제공하는 플러그인은 다른 Release만 읽는 플러그인일 수 있습니다. 플러그인을 지정하는 항목은 다르게 판정되며, 확실히 잘못된 경우 중단됩니다. 위의 “A plugins.providers binding names a plugin that does not serve the capability”를 참고하십시오.

메시지는 다음으로 시작합니다:

plugins.providers entry names a capability no provider-rendering plugin the build reads serves (plugins.providers 항목이 빌드가 읽는 어떤 provider 렌더링 플러그인도 제공하지 않는 기능을 지정함)

이어서 해당 기능과, 한 번의 편집 차이에 제공되는 기능이 있으면 그 기능을 표시합니다. warnings.md의 “Provider-binding unserved-capability warning”에서 설명합니다.

An editor position falls outside the document (편집기 위치가 문서 범위를 벗어남)

편집기가 흡수하는 조건입니다. 커서 위치에 의존하는 편집기 기능(정의로 이동, 호버, 자동 완성)은 먼저 문서의 파싱된 구조 안에서 커서 위치를 찾습니다. 이 조건은 그 위치가 문서에 없는 줄을 가리킬 때 해당 단계가 보고하는 것으로, 편집이 진행 중이어서 편집기가 보낸 위치가 문서가 이미 지나간 텍스트를 기준으로 측정되었을 때 일시적으로 발생합니다.

메시지는 다음과 같습니다:

position out of range (위치가 범위를 벗어남)

빌드에도 진단에도 도달하지 않습니다. 이 조건을 만날 수 있는 모든 기능은 오류를 표시하는 대신 결과 없음으로 응답하며, 이는 편집기 프로토콜이 요구하는 동작입니다. 응답할 수 없는 요청은 아무것도 반환하지 않고, 편집기는 다음 키 입력 후 다시 요청합니다.

파일에서 수정할 것은 없으며, 빌드에도 아무것도 나타나지 않습니다. 다음 편집에서 회복되지 않고 계속 응답하지 않는 기능은 결함으로 보고할 가치가 있습니다.

스키마 병합 단계 자체의 입력 보호 장치

빌드가 도달하지 않는 보호 장치입니다. Component나 Feature가 다른 것을 확장하고 둘 다 스키마를 선언하면, 그 스키마들은 하나로 결합됩니다. 결합을 수행하는 라이브러리는 구조적으로 병합할 수 없는 입력을 거부합니다:

merger: invalid merge input (merger: 잘못된 병합 입력)

이 보호 장치는 결합 단계에 속하며, 빌드는 이 단계에 도달합니다. 확장하는 엔터티와 그 기반이 모두 스키마를 선언할 때마다 그렇습니다. 이 장치가 막는 것은 빈 체인을 받거나 스키마가 없는 체인 항목을 받는 경우인데, 호출자는 둘 중 어느 것도 넘길 수 없습니다. 호출자는 이미 존재가 확인된 스키마로만 체인을 구성하고, 그 체인이 비어 있지 않을 때만 결합합니다.

이 보호 장치가 남아 있는 이유는 공개된 라이브러리가 잘못된 형식의 입력을 거부하는 것이기 때문입니다. 이를 제거해도 빌드가 도달할 수 있는 중단은 하나도 사라지지 않으며, 오히려 그런 입력을 넘긴 컴파일러 외부의 호출자에게 명확한 거부 대신 충돌을 일으키게 되므로 명백히 더 나쁩니다.

체인 자체는 이 단계의 관심사가 아닙니다. 순환하는 체인과 깊이 한도를 넘는 체인은 스키마가 결합되기 전에 단일 extends: 순회에서 거부됩니다. 위의 “Cyclic extends chain (순환하는 extends 체인)”과 “An extends: chain runs past the depth bound (extends 체인이 깊이 한도를 넘음)”을 참조하십시오.

이 조건이 여기 수록된 것은 선언되어 있고 고유한 코드를 가지므로, 가지고 있는 코드가 무언가로 해석되게 하기 위해서입니다. 작성할 수 있는 어떤 것도 이 조건을 만들어 내지 않으며, 이를 만났다면 위에서 설명한 구조가 더 이상 유지되지 않는다는 뜻입니다. 우회하기보다 결함으로 보고할 가치가 있습니다.

An explicit value displaced one an annotation supplied (명시적 값이 어노테이션이 제공한 값을 대체함)

권고입니다. 어노테이션 기반 확장은 Aggregate나 Release가 가진 어노테이션을 자체 구성을 갖춘 Feature 연결로 바꿉니다. 같은 연결에 명시적으로 작성된 구성(컴포넌트, 그 위의 범위, 또는 Release에)도 있으면, 둘이 함께 다루는 각 키에서 명시적 값이 우선합니다. 이것이 의도된 규칙이며 출력 결과도 틀리지 않으므로 빌드는 완료됩니다. 권고가 알려 주는 것은 그 결과입니다. 해당 키에 대한 어노테이션의 기여는 출력 어디에서도 더 이상 보이지 않으며, 어노테이션을 작성한 사람은 그것이 억제되었다는 사실을 모를 수 있습니다.

무언가를 바꾼 대체만이 아니라 모든 대체를 보고합니다. 병합이 억제된 값을 덮어쓰므로 비교할 대상이 남지 않고 두 값이 일치했는지 말해 줄 것도 없습니다. 대체가 일어났다는 기록이 증거의 전부입니다. 이 기록은 연결 캐스케이드 전체와 확장이 하나로 합쳐진 뒤에 읽히며, 그 시점이 기록이 존재하는 가장 이른 지점입니다.

메시지는 다음으로 시작합니다:

annotation contribution overridden by an explicit value (어노테이션 기여가 명시적 값으로 재정의됨)

이어서 대체된 어노테이션, 그것을 대체한 키의 좌표, 대체된 어노테이션이 작성된 위치가 나옵니다. 앞에 붙는 위치는 해당 발견이 있는 문서와 그 안의 키입니다:

<file> at <authored key>: annotation contribution overridden by an explicit value ("<annotation-key>", component "<component>", attachment "<attachment>", pillar "<pillar>", key "<the key at issue>", annotation declared at "<where the annotation was written>") (어노테이션 기여가 명시적 값으로 재정의됨)

이 값 중 두 가지는 잘못 읽기 쉽습니다. component는 대체한 항목에 컴포넌트가 있을 때만 표시됩니다. 범위 전체에 대해 작성된 항목에는 자체 컴포넌트가 없으며, 갖지 않았던 컴포넌트를 표시하면 아무도 작성하지 않은 키로 독자를 보내게 됩니다. 그리고 annotation declared at은 대체된 어노테이션이 작성된 위치를 나타내며, 그것을 대체한 컴포넌트에 작성되지 않은 경우에는 그 어노테이션을 상속받은 범위가 됩니다. 따라서 컴포넌트 키를 다른 이름으로 반복한 것이 아닙니다.

대처 방법: 명시적 값이 의도한 것이라면 아무것도 하지 않아도 됩니다. 이 권고는 우선순위가 뜻밖의 일이 아니라 선택이 되도록 하기 위해 존재합니다. 의도한 것이 아니라면 범위가 다른 두 가지 방법이 있습니다. 명시적 항목을 삭제하면 어노테이션의 값이 해당 키로 전달됩니다. 또는 어노테이션을 가진 컴포넌트나 범위에서 어노테이션을 제거하면 기여가 전혀 이루어지지 않으며, 이는 해당 어노테이션이 제공하는 다른 모든 키에도 영향을 줍니다. 양쪽 모두 필요하지만 키가 다르다면, 의도보다 넓게 미치는 쪽을 좁혀 둘이 더 이상 겹치지 않게 하십시오.

A connection crosses between two different providers’ assembled outputs (연결이 서로 다른 두 프로바이더의 조립된 출력 사이를 가로지름)

의존성 연결의 양 끝이 서로 다른 출력으로 조립되는 경우, 경계 간 링크를 지원한다고 알리는 프로바이더는 이를 기본적으로 연결합니다. 생성하는 쪽에서 참조를 게시하고 소비하는 쪽에서 그것을 해석합니다. 이 연결은 한 프로바이더 고유의 어휘로 작성되며, 프로바이더는 다른 프로바이더가 게시한 참조를 해석할 수 없습니다. 따라서 양 끝이 서로 다른 프로바이더로 렌더링되는 연결은 어느 쪽에서도 연결되지 않습니다.

이는 권고이며 빌드를 멈추지 않습니다. 연결은 여전히 값을 전달합니다. 주입 계약이 다른 곳에서와 똑같이 생성하는 쪽의 스칼라를 소비하는 쪽으로 넘겨 주므로, 남는 것은 깨진 연결이 아니라 일반적인 방식으로 연결된 작동하는 연결입니다. 이 발견이 알려 주는 것은 기대했을 수 있는 기본 연결이 일어나지 않았다는 사실이며, 이에 대응하든 하지 않든 출력은 바뀌지 않습니다.

링크를 지원한다고 알리는 프로바이더가 하나만 있어도 보고됩니다. 양 끝이 모두 주장할 필요는 없습니다. 하나의 주장만으로도 기본 연결이 기대되었으나 불가능하다는 뜻이며, 그 프로바이더를 연결한 작성자가 그것을 원한 사람입니다. 양쪽 주장을 요구하면 한 프로바이더는 링크하고 다른 프로바이더는 링크하지 않는 일반적인 혼합 배포에서 아무것도 알려 주지 못하는데, 이 경우가 바로 이 권고의 대상입니다.

양 끝이 어디에 배치되었는지는 고려되지 않습니다. 조립된 출력은 경로와 프로바이더를 함께 사용해 식별되므로, 프로바이더가 다른 두 끝은 배치와 관계없이 항상 서로 다른 출력에 있습니다. 읽히는 것은 두 프로바이더와 그 두 주장입니다.

그러한 연결마다 한 번 보고되며, 연결이 작성된 문서와 키에 위치가 지정됩니다.

출력되는 메시지이며, 먼 쪽 끝을 먼저 표시한 다음 소켓과 각 끝의 프로바이더를 표시합니다:

cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>") (서로 다른 프로바이더가 렌더링하는 엔드포인트 간의 경계 간 링크는 지원되지 않음)

해결 방법: 연결이 이미 전달하는 스칼라 값으로 충분하다면 아무것도 할 필요가 없습니다. 이는 결함이 아니라 알림입니다. 기본 연결이 필요하다면 양 끝이 하나의 프로바이더로 렌더링되어야 합니다. 한쪽 끝을 다른 쪽의 프로바이더를 거치는 경계로 옮기거나, 두 기능을 하나의 프로바이더로 제공하십시오. 둘 다 불가능하다면 값을 전달하는 형태가 배포가 가진 것이며, 연결은 작동합니다.

A command-line plugin runner was built without a way to find plugins (명령줄 플러그인 실행기가 플러그인을 찾는 방법 없이 구성됨)

터미널 명령을 제공하는 플러그인은 먼저 플러그인 참조를 바이트로 변환해야 하는 구성 요소가 실행합니다. 이 조건은 해당 구성 요소가 변환을 담당하는 부분 없이 구성되어, 참조에서 실행할 대상으로 이어지는 경로가 없음을 보고합니다.

이 조건은 빌드가 아니라 터미널 명령에 관한 것이므로 컴파일의 어떤 단계도 이 조건에 도달하지 않습니다. 이 조건은 설치된 명령이 디스패치되는 곳에서 발생하며, 그 결과는 어떤 빌드의 중단이 아니라 해당 명령의 시작 실패입니다.

배포되는 명령줄 도구의 어떤 경로도 이 조건을 발생시킬 수 없습니다. 도구가 해당 구성 요소를 구성하는 모든 곳에서 조회 기능을 제공하므로, 이 가드는 다른 무언가가 조회 기능을 빠뜨린 채 구성 요소를 구성할 때에만 작동합니다.

출력되는 메시지이며, 이 조건 자체의 문장입니다.

cliplugin: no plugin resolver configured (cliplugin: 플러그인 리졸버가 구성되지 않음)

해결 방법: 엔터티 파일의 어떤 내용도 이 조건을 일으키지 않으며, 카탈로그나 워크스페이스에 무엇을 작성해도 해소되지 않습니다. 배포된 명령줄 도구를 실행하는 경우에는 도달할 수 없는 조건입니다. 시작되지 않는 설치된 명령은 다른 문제를 보고하고 있는 것이므로, 출력된 메시지를 읽어야 합니다. 플러그인 실행기를 자체 소프트웨어에 내장하는 경우에는, 실행기를 생성할 때 플러그인 참조를 바이트로 해석하는 조회 기능을 제공하십시오.

A registry alias is already bound to another host (레지스트리 별칭이 이미 다른 호스트에 바인딩됨)

빌드가 아니라 워크스페이스에 레지스트리를 추가할 때의 거부입니다. 별칭은 하나의 레지스트리 항목을 선택하는 짧은 이름이므로 항목 전체에서 고유합니다. 이미 다른 호스트가 보유한 별칭을 등록하면, 기존 바인딩을 가리도록 허용하지 않고 거부합니다. 가리도록 허용하면 그 별칭을 사용하는 모든 참조가 가리키는 대상이 조용히 바뀌기 때문입니다.

같은 호스트를 기존 별칭으로 다시 추가하는 것은 충돌이 아닙니다. 이 경우 항목이 그 자리에서 갱신되며, 호스트의 다른 설정을 바꾸려고 명령을 다시 실행할 때 일어나는 일이 바로 이것입니다.

출력되는 메시지이며, 별칭과 그 별칭을 이미 보유한 호스트를 명시합니다:

workspaceconfig: registry alias "<alias>" is already used by host "<host>"; choose a different alias or address that host directly: registry alias is already used by another host (workspaceconfig: 레지스트리 별칭이 이미 해당 호스트에서 사용 중입니다. 다른 별칭을 선택하거나 그 호스트를 직접 지정하십시오: 레지스트리 별칭이 이미 다른 호스트에서 사용 중입니다)

해결 방법: 수정은 명령줄에서 운영자가 합니다. 새 레지스트리에 다른 별칭을 지정하거나, 별칭 없이 두고 호스트로 참조하십시오. 별칭을 새 호스트로 옮기려는 경우에는 먼저 .aggrega-config.yaml에서 메시지가 명시한 항목의 별칭을 제거하십시오. 이 거부는 별칭 이동이 레지스트리 추가의 부수 효과가 아니라 의도적으로 하는 작업이 되도록 존재합니다.

A registry serves a trust document that cannot be read as one (레지스트리가 신뢰 문서로 읽을 수 없는 신뢰 문서를 제공함)

빌드가 아니라 레지스트리를 추가할 때의 거부입니다. 레지스트리는 아티팩트 서명에 사용될 것으로 예상하는 서명 ID를 게시할 수 있으며, 그러면 운영자가 직접 옮겨 적지 않아도 레지스트리를 추가할 때 이를 고정할 수 있습니다. 이 조건은 레지스트리가 신뢰 정책으로 사용할 수 없는 문서로 응답했음을 보고합니다.

엔드포인트가 응답했기 때문에 바로 강한 거부가 됩니다. 아무것도 게시하지 않는 레지스트리는 허용되는 평범하고 예상된 결과입니다. 읽을 수 없는 무언가를 게시하는 레지스트리는 구성 오류이며, 거기서 아무것도 고정하지 않으면 레지스트리가 고정된 것처럼 보이면서 실제로는 조용히 고정되지 않은 상태로 남게 됩니다.

여기서 보고되는 형태는 세 가지입니다. 형식이 정의하지 않는 필드를 담은 문서를 포함해 전혀 디코딩되지 않는 내용, 정확한 ID도 패턴도 명시하지 않는 ID 항목, 발급자가 없는 ID 항목입니다. 뒤의 두 가지는 그런 항목이 어떤 서명과도 일치할 수 없어, 고정을 강화하는 것처럼 보이면서 실제로는 약화시키기 때문에 거부됩니다.

출력되는 메시지. 디코딩되지 않는 내용:

registrytrust: advertised trust config is malformed: <what the decoder reported> (registrytrust: 게시된 신뢰 구성의 형식이 잘못되었습니다: 디코더가 보고한 내용)

일치시킬 대상이 없는 ID 항목:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp (registrytrust: 게시된 신뢰 구성의 형식이 잘못되었습니다: 해당 목록 항목의 ID 항목은 identity 또는 identity_regexp를 설정해야 합니다)

그리고 발급자가 없는 항목:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer (registrytrust: 게시된 신뢰 구성의 형식이 잘못되었습니다: 해당 목록 항목의 ID 항목은 issuer를 설정해야 합니다)

각 메시지는 이를 만난 명령으로 감싸집니다:

aggrega registry add: <the message above>

해결 방법: 수정은 사용자가 아니라 레지스트리를 운영하는 사람의 몫입니다. 메시지가 정확한 항목과 그 항목에 빠진 것을 명시하므로 메시지를 그대로 전달하십시오. 그동안 진행하려면, 게시된 정책을 고정하지 않고 레지스트리를 추가한 뒤 ID나 키를 직접 제공하십시오. 명령은 이를 직접 받으며, 정책을 전혀 게시하지 않는 레지스트리에도 같은 방법을 사용합니다.

A registry publishes no trust document (레지스트리가 신뢰 문서를 게시하지 않음)

오류가 아니라 평범하고 예상된 결과이며, 아무것도 중단시키지 않습니다. 레지스트리는 예상하는 서명 ID를 게시할 수 있지만, 대부분은 게시하지 않습니다. 그런 레지스트리는 요청을 받으면 없다고 응답하고, 레지스트리 추가는 계속 진행됩니다. 이 결과는 알림으로 보고되며, 대신 ID를 수동으로 고정합니다.

이는 연결할 수 없었던 레지스트리와 의도적으로 구분됩니다. 이 레지스트리는 응답했고, 그 응답은 정책을 게시하지 않는다는 것이었습니다. 둘을 구분해 두기 때문에 의도적인 부재는 허용하면서도 연결 문제는 여전히 연결 문제로 드러납니다.

알림으로 보고되며, 레지스트리와 그 응답, 대신 해야 할 일을 명시합니다:

Notice: <host> publishes no trust policy (HTTP 404); pin its trust by hand with —identity or —key (알림: 해당 호스트는 신뢰 정책을 게시하지 않습니다(HTTP 404). —identity 또는 —key로 신뢰를 직접 고정하십시오)

이 조건이 기록되는 이름은 registrytrust: registry advertises no trust config입니다.

공식 허브는 예외입니다. 공식 허브는 내장 기준선을 가지고 있으므로, 문서를 게시하지 않으면 대신 그 기준선이 고정되며, 알림은 ID를 고정하라고 요청하는 대신 허브의 응답과 그 자리에 기준선이 사용된다는 사실을 알려 줍니다.

해결 방법: 고장 난 것은 없습니다. 이 레지스트리의 서명을 검사하려면 알림이 말하는 대로 레지스트리를 추가할 때 ID나 키를 제공하십시오. 이것이 정책을 게시하지 않는 레지스트리의 일반적인 경로입니다. 그렇지 않으면 레지스트리는 서명 방침 없이 추가되며, 그 레지스트리의 아티팩트는 서명을 지닌 경우에만 검증됩니다.

고정할 신뢰 정책 없이 오프라인으로 레지스트리를 추가함

빌드가 아니라 레지스트리 추가 시의 거부입니다. 레지스트리를 추가하는 순간은 그 신뢰가 고정되는 유일한 순간입니다. 레지스트리가 공개하는 서명 ID를 한 번 가져오고, 이후의 모든 pull은 그 고정된 사본에 대해 검증합니다. 워크스페이스가 오프라인이면 이 가져오기를 할 수 없으므로 레지스트리에 요청하지 않습니다. 아무것도 신뢰하지 않는 항목, 그리고 이후의 모든 pull이 레지스트리에 적용할 항목을 기록하는 대신, 공식 허브 이외의 레지스트리를 추가하는 것은 정책을 직접 제공하지 않는 한 거부됩니다.

세 가지 경우는 거부되지 않습니다. ID 또는 키를 제공하면 정확히 그것만 등록하고 가져오기를 전혀 하지 않으므로 오프라인에서도 온라인과 똑같이 동작합니다. 공식 허브는 가져오기 여부와 관계없이 지니고 있는 내장 기준선으로 추가됩니다. 그리고 가져오기를 하지 않도록 요청하면(--fetch-trust=false) 온라인에서와 똑같이 플래그로부터 항목을 등록합니다.

레지스트리를 추가하는 모든 곳에서 발생합니다. aggrega registry add, aggrega config init --registry <host>, 오류 메시지의 문장 앞에 짧은 코드를 붙이는 aggrega serve의 aggrega/registryAdd 및 aggrega/configInit 요청, 그리고 이 명령들을 실행하는 aggrega mcp의 등록 도구입니다. 구성 초기화는 ID나 키를 받지 않으므로 오프라인에서는 허브만 초기화할 수 있습니다. 다른 레지스트리는 대신 aggrega registry add로 추가합니다.

출력되는 메시지이며, 이 조건 자체의 문장입니다.

a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with aggrega registry add <host> --identity <identity>=<issuer> or --key <public-key-file> (공식 허브가 아닌 레지스트리는 손으로 제공한 신뢰 정책 없이 오프라인으로 등록되지 않습니다. 레지스트리가 공개하는 정책을 가져올 수 없기 때문입니다. 온라인 상태에서 한 번 등록하거나, 위의 명령 또는 키 파일 플래그로 신뢰를 직접 고정하십시오)

이를 만난 명령과 해당 레지스트리가 앞에 붙습니다:

aggrega registry add: <host>: <the message above>

해결 방법: 워크스페이스가 온라인일 때 레지스트리를 한 번 등록합니다. 그 한 번의 실행에 --offline=false를 전달하거나 offline 설정을 해제하면, 공개된 정책을 가져와 고정합니다. 이후 pull은 고정된 사본에 대해 검증하므로 다시 할 일은 없습니다. 온라인으로 전환할 수 없다면 정책을 직접 제공합니다. 키리스 레지스트리에는 하나 이상의 --identity <identity>=<issuer> 항목을, 키 기반 레지스트리에는 공개 키 파일을 가리키는 --key를 지정하며, 이는 공개된 정책에서 고정했을 내용과 같습니다.

태그가 이미 다른 내용으로 게시됨

빌드가 아니라 게시 시의 거부입니다. 게시된 바이트는 고정됩니다. 업로드하기 전에 대상 버전을 조회하고, 그 버전이 가리키는 다이제스트를 현재 내용이 만들어 낼 다이제스트와 비교합니다. 이미 다른 내용을 가리키는 버전은 거부됩니다.

바이트 단위로 동일한 내용을 다시 게시하는 것은 충돌이 아닙니다. 다이제스트가 일치하면 아무것도 업로드하지 않고 명령은 해당 버전이 이미 게시되었다고 보고합니다. 따라서 일부만 성공한 게시를 다시 실행해도 안전하며, 다시 실행하면 게시가 완료됩니다. 버전에 아직 없는 게시 날짜와, push가 서명하는 경우 서명이 첨부되며, 둘 다 갖춘 버전에는 아무것도 첨부되지 않습니다. 이는 이전 push가 부분적으로 남긴 게시 완료하기에서 설명합니다.

이를 무시하는 플래그는 없습니다. 변경된 내용은 새 버전으로 게시되며, 이렇게 해야 소비자는 자신도 모르게 바뀐 버전이 아니라 의도적으로 옮겨 갈 버전을 갖게 됩니다.

출력되는 메시지는 버전, 그 버전이 가진 다이제스트, 제시된 다이제스트를 명시합니다. 카탈로그 엔터티를 게시할 때는 버전 증가를 검증하는 검사도 명시합니다:

aggrega push: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version (aggrega lint —pre-publish verifies the bump): oci: tag already published with different content (해당 버전은 이미 기존 다이제스트로 게시되어 있어 제안된 다이제스트로 덮어쓰기를 거부합니다. 새 버전을 게시하십시오(aggrega lint —pre-publish가 버전 올림을 검증합니다): 태그가 이미 다른 내용으로 게시되어 있습니다)

데이터 아티팩트를 게시할 때는 다음과 같습니다:

aggrega push-artifact: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version: oci: tag already published with different content (해당 버전은 이미 기존 다이제스트로 게시되어 있어 제안된 다이제스트로 덮어쓰기를 거부합니다. 새 버전을 게시하십시오: 태그가 이미 다른 내용으로 게시되어 있습니다)

해결 방법: 버전을 올리고 다시 게시합니다. 카탈로그 엔터티의 경우 metadata.version과 엔터티가 위치한 버전별 디렉터리를 뜻하며, 둘은 함께 바뀝니다. 그 전에 변경이 의도한 것인지 확인합니다. 건드리지 않았다고 생각하는 버전에서 두 다이제스트가 다르다면 디스크의 내용이 게시된 내용과 다르다는 뜻이며, 그 위에 덮어 게시하기보다 원인을 찾는 것이 더 가치 있습니다. 메시지에 명시된 게시 전 검사는 버전을 이전 버전과 비교하며, 버전 증가가 올바른지 확인하는 방법입니다.

엔터티가 다른 엔터티와 디렉터리를 공유함

빌드가 아니라 고정 및 게시 시의 거부입니다. 모든 엔터티 종류는 자체 디렉터리를 가지지만, 워크스페이스 루트에 나란히 두는 세 가지, 즉 Aggregate, Release, Manifest는 예외입니다. 게시된 엔터티는 버전마다 하나의 좌표에 있는 하나의 아티팩트이며, 엔터티를 작성하는 디렉터리도 이를 반영합니다. 고정 단계는 디렉터리에 들어갈 수 있는 하나의 entity.lock을 기록하고, 게시는 디렉터리에서 엔터티를 패키징합니다. 따라서 그 밖의 종류의 엔터티 옆에 다른 엔터티가 있으면 이 두 시점 모두에서 거부됩니다. aggrega pin, 작성자를 대신해 고정하도록 요청된 pull이나 push, 그리고 고정 여부와 관계없이 aggrega push에서 거부됩니다. 아무것도 가져오기 전에 거부되며, 아무것도 기록되지 않습니다.

여러 엔터티를 담은 디렉터리도 로드, 린트, 검증, 빌드는 됩니다. 레이아웃은 디렉터리로부터 무언가를 생성할 때만 판단하며, 이때가 메시지가 방해되는 엔터티를 명시할 수 있는 시점이기도 합니다. 고정하지 않는 pull은 엔터티 옆에 아무것도 기록하지 않으므로 거부되지 않습니다.

옆에 있는 엔터티로 간주되는 것은 같은 디렉터리 바로 아래에 있으면서 kind:가 엔터티 종류인 다른 YAML 문서입니다. 차트 자체의 파일, compose 조각, Kubernetes 매니페스트, README는 엔터티가 아니며, 하위 디렉터리(로컬 차트, source/ 트리)는 무엇을 담고 있든 엔터티 옆에 있는 것이 아닙니다. 각 이웃의 종류와 이름만 읽으므로, 이웃이 선언하는 내용은 결과를 바꿀 수 없습니다.

디렉터리 이름은 판단하지 않습니다. 디렉터리에 단독으로 있는 엔터티는 그 디렉터리가 어디에 있든 선언한 버전으로 고정되고 게시됩니다. 표준 라이브러리 카탈로그가 사용하는 <name>/<version>/ 레이아웃은 검사가 아니라 관례입니다.

출력되는 메시지는 해당 엔터티, 그 옆의 모든 엔터티, 옮길 파일을 명시합니다:

the entity shares its directory with another entity, and an entity of its kind has a directory of its own (Recipe "<name>", beside it: Recipe "<name>" in <file>). remediation: give each entity a directory of its own — move <file> into a directory of its own, together with any file only that entity reads; only the Aggregate, Manifest and Release kinds may share a directory with other entities (엔터티가 다른 엔터티와 디렉터리를 공유하고 있으며, 이 종류의 엔터티는 자체 디렉터리를 가집니다. 해결 방법: 각 엔터티에 자체 디렉터리를 부여하십시오. 해당 파일을 그 엔터티만 읽는 파일과 함께 자체 디렉터리로 옮기십시오. Aggregate, Manifest, Release 종류만 다른 엔터티와 디렉터리를 공유할 수 있습니다)

해결 방법: 메시지가 명시한 각 엔터티를 그 엔터티만 읽는 파일(로컬 차트, 가져온 파일, 그리고 해당 엔터티의 고정을 기록하고 있다면 entity.lock)과 함께 자체 디렉터리로 옮깁니다. 그리고 원격 소스를 읽거나 파일을 가져오는 각 엔터티에 대해 aggrega pin을 실행하여 각 lock이 자신의 엔터티를 기록하도록 합니다. 각각을 <kind>/<provider-or-publisher>/…/<name>/<version>/로 배치하면 표준 라이브러리 카탈로그가 모든 엔터티를 두는 위치와 같아집니다. 카탈로그 디렉터리는 순회하여 찾으므로, 옮긴 후에도 카탈로그에 대한 빌드는 같은 출력을 렌더링합니다.

An entity kind has no artifact media type (엔티티 종류에 아티팩트 미디어 타입이 없음)

빌드가 아니라 게시 시점의 거부입니다. 게시 가능한 각 엔티티 종류에는 아티팩트가 취하는 두 형태(문서 단독, 또는 문서와 문서가 선언한 파일의 아카이브)마다 미디어 타입이 있으며, 엔티티를 패키징할 때 종류별로 이를 조회합니다. 이 조건은 항목이 없는 종류를 보고합니다.

어떤 빌드도 여기에 도달하지 않습니다. 같은 조회가 실행되는 유일한 다른 곳에서는 항목이 없으면 “라이브러리가 아님”으로 처리하고 계속 진행하므로, 그곳에서는 이 조건이 드러나지 않습니다.

출력되는 메시지입니다. 조건 자체의 문장을 명령과 패키징 중이던 파일이 감쌉니다:

aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch (aggrega push: 번들: oci: 미디어 타입 분기에 대한 알 수 없는 엔티티 종류)

해결 방법: 게시하려는 파일의 kind: 필드를 aggrega push --list-kinds가 출력하는 종류와 대조합니다. 철자가 틀렸거나 지원되지 않는 종류는 여기서 보고되며, 필드를 고치는 것으로 해결됩니다. 그 목록에 있는 종류라면 엔티티가 아니라 툴체인의 결함이므로, 해당 종류를 명시하여 보고할 가치가 있습니다.

A published archive carries an entry Windows cannot use (게시된 아카이브에 Windows에서 사용할 수 없는 항목이 있음)

엔티티를 게시할 때 발생하는 권고입니다. 아무것도 중단시키지 않으며, 빌드에서는 발생하지 않습니다. 문서 옆에 파일을 담는 엔티티는 아카이브로 게시되며, 아카이브가 담는 각 이름(엔티티 문서 자체의 파일 이름, 그다음 담는 각 파일)은 위의 중단 조건 “A name the operation writes holds a part Windows cannot hold (작업이 쓰는 이름에 Windows가 담을 수 없는 부분이 있음)”이 Windows에서 적용하는 규칙으로 판단됩니다. 즉 대소문자와 뒤따르는 확장자에 관계없이 Windows가 장치용으로 예약한 부분, 또는 마침표나 공백으로 끝나는 부분입니다. 따라서 aux/x.yaml은 디렉터리 aux 때문에, report.는 마지막 마침표 때문에, 스키마 파일을 가져오는 con.yaml이라는 문서는 자체 이름 때문에 이 권고가 발생합니다. 아무것도 담지 않는 엔티티는 제품이 정한 이름으로 문서 단독으로 게시되고, Plugin은 아카이브를 게시하지 않으므로 어느 쪽도 이 권고가 발생하지 않습니다.

모든 플랫폼에서 발생하며, 아무것도 거부하지 않습니다. Windows의 워크스페이스는 해당 중단 조건에 따라 그러한 항목의 배치를 거부하므로 그 버전을 사용할 수 없습니다. 이 권고는 Windows 사용자보다 먼저 게시자가 이를 알게 하는 수단입니다. 게시 또는 그 드라이 런은 권고가 없을 때와 똑같이 진행되거나 중단됩니다.

엔티티를 게시하는 모든 경로가 각자의 형태로 이를 발생시킵니다. aggrega push와 그 --dry-run은 항목마다 한 줄씩 표준 오류에 출력하며, 각 줄은 warning: 로 시작합니다. 어시스턴트의 publish-entity 도구는 항목을 windows_unusable_entries로 응답하며, 응답 텍스트에도 항목이 표시됩니다. aggrega serve는 aggrega/publishEntity에 항목을 windowsUnusableEntries로 응답하고, 보고를 요청한 요청에는 경고 줄 자체를 전달합니다. 해당 항목이 없으면 각 응답에서 이 필드가 생략됩니다.

메시지는 다음으로 시작합니다:

an entry this publication carries cannot be used on Windows (이 게시물이 담는 항목을 Windows에서 사용할 수 없음)

이어서 항목과 Windows가 담을 수 없는 첫 번째 부분, 그리고 해결 방법이 나옵니다. warnings.md의 “A published archive carries an entry Windows cannot use (게시된 아카이브에 Windows에서 사용할 수 없는 항목이 있음)”에서 설명합니다.

해결 방법: 메시지가 지목한 부분의 이름을 디스크에서, 그리고 엔티티 선언이 그 파일을 가리키는 모든 곳에서 바꾼 뒤 다시 게시합니다. 해당 버전을 Windows에서 사용할 의도가 없다면 아무것도 바꿀 필요가 없습니다.

Two catalog identities publish to one repository location (두 카탈로그 아이덴티티가 하나의 리포지토리 위치로 게시됨)

빌드가 아니라 카탈로그 전체를 검사할 때 발생하는 거부입니다. 엔티티가 게시되는 위치는 아이덴티티에서 파생되며 소문자로 변환되므로, 대소문자만 다른 두 아이덴티티는 같은 위치에 도달합니다. 둘 다 게시하면 한 엔티티의 바이트가 다른 엔티티의 바이트로 덮어써지며, 어느 엔티티에도 그 사실이 드러나지 않습니다.

충돌은 어느 한 엔티티 자체가 아니라 쌍의 속성이므로 이 검사는 카탈로그 전체에 대해 한 번에 실행됩니다. 어느 쪽도 그 자체로는 잘못되지 않았으며, 어느 하나만 따로 읽어서는 아무것도 드러나지 않습니다.

출력되는 메시지입니다. 카탈로그 검사의 틀로 시작하고, 이어서 조건 자체의 문장, 그다음 충돌하는 각 그룹이 뒤따르며, 각 그룹은 공유되는 위치와 그 위치에 도달하는 아이덴티티를 명시합니다:

catalog validation failed: oci: distinct catalog identities map to the same OCI repository location: (카탈로그 검증 실패: oci: 서로 다른 카탈로그 아이덴티티가 같은 OCI 리포지토리 위치에 매핑됩니다:)

  • <location> <- <identity>, <identity>

해결 방법: 메시지가 명시하는 엔티티 중 하나의 이름을 metadata.name과 이를 반영하는 디렉터리에서 변경합니다. 어느 쪽 이름을 바꿀지는 직접 선택합니다. 대소문자만 다른 쌍이 흔한 형태이며, 하나의 표기를 정해 일관되게 사용하면 같은 쌍이 다시 생기지 않습니다. 이름 변경은 엔티티 아이덴티티의 실제 변경이므로 이전 이름을 참조하는 모든 것도 함께 옮겨야 합니다. 그렇기 때문에 어느 이름이든 게시된 후가 아니라 게시되기 전에 충돌을 해결하는 것이 좋습니다.

Keyless signing was asked for without the services it needs (필요한 서비스 없이 키리스 서명이 요청됨)

빌드가 아니라 게시 중 서명할 때 발생하는 거부입니다. 키리스 서명에는 오프라인 형태가 없습니다. 아이덴티티를 얻고, 그에 대해 단기 인증서를 발급받고, 나중에 확인할 수 있는 곳에 서명을 기록한 다음 키를 폐기합니다. 이 모든 단계가 실행 중인 서비스와의 교환입니다. 이 조건은 흐름의 시작점인 아이덴티티를 사용할 수 없었음을 보고하며, 따라서 흐름을 시작했다가 중간에 포기하는 대신 아예 거부합니다.

두 가지 형태가 이를 보고합니다. 아이덴티티를 제공하도록 구성된 것이 전혀 없는 경우와, 구성은 되어 있지만 아무것도 내놓지 않은 경우입니다.

오프라인 워크스페이스는 다르게 보고합니다. 아이덴티티를 요청하기도 전에 거부가 일어나므로, 모든 네트워크 단계를 다루는 거부로 보고됩니다.

출력되는 메시지. 아이덴티티 소스가 없는 경우:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token source is required (signing: 키리스 서명에는 동작 중인 아이덴티티 공급자, Fulcio, Rekor가 필요합니다: 아이덴티티 토큰 소스가 필요합니다)

그리고 소스가 아무것도 생성하지 않은 경우:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token is required (signing: 키리스 서명에는 동작 중인 아이덴티티 공급자, Fulcio, Rekor가 필요합니다: 아이덴티티 토큰이 필요합니다)

해결 방법: 게시를 실행하는 방식에서 운영자가 해결해야 합니다. 자동화된 파이프라인에서는 아이덴티티가 파이프라인 자체의 자격 증명에서 오므로, 대개 작업에 이를 발급하는 권한이 부여되지 않았다는 뜻입니다. 대화형으로 실행하면 아이덴티티는 로그인에서 오며, 명령이 로그인을 요청합니다. 동작 중인 아이덴티티를 전혀 원하지 않는 경우에는 대신 보유한 키로 서명합니다. 이 경로에는 이 서비스들이 필요하지 않으며, 서비스에 접근할 수 없는 환경에서 사용할 방법입니다.

An unsigned publish targets a registry or a policy that requires a signature (서명되지 않은 게시가 서명을 요구하는 레지스트리나 정책을 대상으로 함)

빌드가 아니라 게시할 때 발생하는 거부입니다. 서명이 필요한 곳에서는 서명되지 않은 콘텐츠가 게시되지 않습니다. 이 검사는 바이트가 업로드되기 전에 실행되므로 일부만 레지스트리에 도달하는 일은 없습니다.

요구 사항의 출처가 두 가지이고 해결 방법이 다르므로 조건도 두 가지입니다. 하나는 대상 레지스트리 자체의 입장으로, 그곳에 게시되는 모든 것에 적용됩니다. 다른 하나는 워크스페이스의 서명 정책으로, 어디에 게시되든 일련의 아티팩트 종류에 적용됩니다. 둘 다 해당하면 대상을 명시하는 것이 더 유용하므로 레지스트리 쪽이 보고됩니다.

여기서 서명되지 않은 콘텐츠를 게시하는 플래그는 없습니다. 서명을 명시적으로 끄더라도 거부가 완화되지 않습니다. 이는 서명이 선택 사항인 아티팩트의 기본값만 바꿉니다.

서명은 업로드 후가 아니라 업로드 전에 생성되므로, 서명 실패도 여기에 해당하며 아무것도 게시되지 않습니다.

출력되는 메시지. 레지스트리 자체의 요구 사항:

aggrega push: registry "<host>" requires signatures; re-run signing the artifact (there is no flag to push unsigned content here): signing: registry requires signatures; refusing to push unsigned content (aggrega push: 레지스트리가 서명을 요구합니다. 아티팩트에 서명하여 다시 실행하십시오(여기서는 서명되지 않은 콘텐츠를 push하는 플래그가 없습니다): signing: 레지스트리가 서명을 요구합니다. 서명되지 않은 콘텐츠의 push를 거부합니다)

워크스페이스 정책의 요구 사항으로, 아티팩트를 적용 범위에 포함시킨 종류를 명시합니다:

aggrega push: the signing policy requires a signature for kind "<kind>"; re-run signing the artifact (there is no flag to push unsigned content here): signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content (aggrega push: 서명 정책이 해당 kind에 서명을 요구합니다. 아티팩트에 서명하여 다시 실행하십시오(여기서는 서명되지 않은 콘텐츠를 push하는 플래그가 없습니다): signing: 서명 정책이 이 아티팩트 kind에 서명을 요구합니다. 서명되지 않은 콘텐츠의 push를 거부합니다)

그리고 서명을 생성할 수 없었던 경우로, 레지스트리 조건으로 보고되며 근본 실패를 인용합니다:

aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: 참조와 버전에 대한 서명 실패, 근본 원인: signing: 레지스트리가 서명을 요구합니다. 서명되지 않은 콘텐츠의 push를 거부합니다)

서명 실패의 한 형태는 별도로 명시됩니다. 일반적인 거부 메시지는 도움이 되지 않는 자격 증명을 다시 얻도록 사람들을 유도하기 때문입니다:

aggrega push: sign <reference>:<version>: the identity token carries no verified email or subject claim — the OIDC flow/client did not return an email-scoped identity (re-exporting or re-acquiring the token will not help); configure the identity provider/client/scope to return one: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: 참조와 버전에 대한 서명 실패: ID 토큰에 검증된 email 또는 subject 클레임이 없습니다 — OIDC 흐름/클라이언트가 email 범위의 ID를 반환하지 않았습니다(토큰을 다시 내보내거나 다시 획득해도 도움이 되지 않습니다). ID 공급자/클라이언트/범위가 이를 반환하도록 구성하십시오. 근본 원인 이후: signing: 레지스트리가 서명을 요구합니다. 서명되지 않은 콘텐츠의 push를 거부합니다)

해결 방법: 운영자가 해결해야 합니다. 아티팩트에 서명하고 다시 게시합니다. 보유한 키를 사용하든 키리스 경로를 사용하든 워크스페이스가 설정된 방식을 따릅니다. 서명이 필요할 것으로 예상하지 않았다면, 메시지가 어느 출처가 서명을 요구했는지 알려 줍니다. 레지스트리 자체의 입장은 .aggrega-config.yaml에 있는 해당 레지스트리 항목에 있고, 종류 범위의 요구 사항은 워크스페이스 전체 서명 정책에 있습니다. 어느 쪽을 완화하든 서명 없이 게시해도 되는 대상에 대한 결정이므로, 대개 정책을 끄는 것보다 정책의 범위를 좁히는 편이 낫습니다.

References signed together need different signing credentials (함께 서명하는 참조에 서로 다른 서명 자격 증명이 필요함)

빌드가 아니라 서명 시의 거부입니다. 여러 참조가 주어진 aggrega sign과 배치 파일이 주어진 aggrega deprecate --from은 주어진 모든 것을 하나의 자격 증명, 즉 하나의 보유 키 또는 하나의 keyless 아이덴티티로 서명합니다. 참조에 어떤 자격 증명이 필요한지는 해당 레지스트리의 구성으로 결정됩니다. 그 레지스트리에 적용되는 signing.key_path가 있으면 그것이 지정하는 키가 선택되고, 적용되는 것이 없으면 참조는 keyless로 서명됩니다. 함께 지정된 참조에 서로 다른 자격 증명이 필요한 경우(한 레지스트리에는 키가 있고 다른 레지스트리에는 없거나, 서로 다른 두 키가 필요한 경우) 아무것도 서명되지 않으며, 메시지는 각 쪽의 레지스트리를 지정합니다.

이 검사는 아이덴티티를 요청하기 전, 그리고 어떤 레지스트리도 읽기 전에 실행되므로, 아무것도 서명되거나 첨부되지 않고 진행되지 않을 실행에 대해 누구에게도 입력을 요청하지 않습니다. 서명은 이미 가져간 사람에게서 회수할 수 없으므로, 참조 중 하나에 필요한 자격 증명으로 서명하는 대신 실행 자체를 거부합니다.

--key로 전달된 키는 모든 참조에 대해 결정합니다. 각 레지스트리에 대한 구성과 관계없이 지정된 모든 참조에 적용되므로, 이러한 실행은 여기서 거부되지 않습니다.

이 조건은 배치를 서명하는 모든 곳에서 발생합니다: aggrega sign, aggrega deprecate --from, aggrega serve의 aggrega/signArtifacts 및 aggrega/deprecateArtifact 요청(오류 메시지에서 문장 앞에 짧은 코드가 붙습니다), 그리고 aggrega mcp의 sign-artifacts 및 deprecate-artifact 도구입니다. 리스너를 통해 서버에 도달한 도구 호출은 구성이 지정한 키를 절대 사용하지 않으므로, 그 경우 모든 참조는 호출이 보낸 아이덴티티로 서명되며 호출은 여기서 거부되지 않습니다.

출력되는 메시지입니다. 조건 자체의 문장으로 시작하고, 각 자격 증명이 그것으로 서명할 레지스트리와 함께 이어지며, 해결 방법이 마지막에 옵니다:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own (함께 지정된 참조에 서로 다른 서명 자격 증명이 필요하므로 아무것도 서명되지 않았습니다. 한 레지스트리는 signing.key_path가 지정하는 보유 키로 서명하고, 다른 레지스트리는 적용되는 signing.key_path가 없어 키 없이 서명합니다. 해결 방법: 자격 증명마다 한 번씩 별도로 실행하여 서명합니다. 먼저 한 레지스트리의 참조를, 그다음 다른 레지스트리의 참조를 서명하며, 각 실행은 단독으로 실행할 때와 같이 서명합니다)

그리고 배치의 레지스트리가 서명을 요구하는 경우, 해결 방법 끝에 그 레지스트리를 지정합니다:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own, and <registry> requires signatures, so this refusal holds back signing that would otherwise have gone ahead rather than signing that cannot be done (함께 지정된 참조에 서로 다른 서명 자격 증명이 필요하므로 아무것도 서명되지 않았습니다. 한 레지스트리는 signing.key_path가 지정하는 보유 키로 서명하고, 다른 레지스트리는 적용되는 signing.key_path가 없어 키 없이 서명합니다. 해결 방법: 자격 증명마다 한 번씩 별도로 실행하여 서명합니다. 먼저 한 레지스트리의 참조를, 그다음 다른 레지스트리의 참조를 서명하며, 각 실행은 단독으로 실행할 때와 같이 서명합니다. 또한 해당 레지스트리는 서명을 요구하므로, 이 거부는 수행할 수 없는 서명이 아니라 그렇지 않았다면 진행되었을 서명을 보류하는 것입니다)

자체 키를 가진 두 번째 레지스트리는 “with a different held key”(다른 보유 키로) 서명하는 것으로 표시됩니다. 키의 경로는 절대 출력되지 않습니다. 메시지는 변경할 수 있는 대상인 설정을 지정합니다.

해결 방법: 레지스트리에 필요한 자격 증명별로 참조를 나누고 자격 증명마다 한 번씩 실행합니다. 키로 서명하는 레지스트리의 참조를 지정하는 aggrega sign 하나와 나머지를 지정하는 또 하나를 실행하고, aggrega deprecate --from의 경우 자격 증명마다 배치 파일을 하나씩 사용합니다. 그러면 각 실행은 단독으로 실행할 때와 같이 서명합니다. 대신 한 번의 실행으로 모든 참조를 하나의 키로 서명하려면 그 키를 --key로 전달합니다.

A detached signature does not verify against the key supplied (분리 서명이 제공된 키로 검증되지 않음)

페이로드에 대한 단독 서명을 공개 키로 완전히 오프라인에서 검사한 결과가 부정적인 경우입니다. 페이로드가 서명된 내용과 다르거나, 서명이 변경되었거나, 키가 서명을 생성한 키가 아닙니다.

배포된 도구 체인에서는 이 조건에 도달하지 않습니다. 이 조건이 속한 검사는 자체 테스트 외에는 호출하는 곳이 없으므로, 사용자가 실행하는 어떤 명령(빌드, pull, 게시)도 이를 보고하지 않습니다. 빌드가 이를 출력할 수 있어서가 아니라 코드가 무언가로 해석되도록 여기에 수록되어 있습니다. pull이 실제로 수행하는 검증은 전체 서명 번들에 대해 이루어지며 별도로 보고됩니다.

검증기가 보고한 내용을 인용하는 출력 메시지입니다:

signing: signature does not verify: <what the verifier reported> (서명이 검증되지 않습니다)

해결 방법: 엔터티 파일의 어떤 내용도 이를 일으키지 않으며, 카탈로그나 워크스페이스에 작성할 수 있는 어떤 것으로도 해결되지 않습니다. 배포된 명령줄 도구를 실행하는 경우 이 조건에는 도달할 수 없으며, 실제로 보고 있는 서명 문제는 위의 번들 검증 조건 중 하나가 보고하는 것입니다. 자체 소프트웨어에서 서명 패키지를 직접 사용하는 경우, 페이로드, 서명, 키는 서로 짝이 맞는 세 가지여야 합니다. 서명과 검증 사이에 페이로드를 다시 직렬화하는 것이 흔한 원인으로, 내용은 같아 보여도 바이트가 달라지기 때문입니다.

A resolved artifact is not a documentation bundle (해석된 아티팩트가 문서 번들이 아님)

다른 종류의 아티팩트(카탈로그 엔터티, 플러그인)로 해석되는 참조는 문서로 캐시되지 않고 거부됩니다. 따라서 잘못 가리킨 참조는 나중에 읽을 수 없는 번들로 실패하는 대신 가리킨 지점에서 실패합니다.

발생 위치. 문서 번들은 워크스페이스에 구성된 레지스트리의 예약된 docs 네임스페이스에서, 머신의 모든 프로젝트가 공유하는 캐시로 획득됩니다. 어시스턴트용 서버는 시작할 때 무엇에든 응답하기 전에 한 번 획득하고, aggrega explain과 편집기의 코드 설명은 처음 필요할 때 획득하며, aggrega scaffold --example도 획득합니다. 어느 경우든 워크스페이스의 서명 검사가 허용하는 사본이 머신에 없을 때만 획득합니다. 이 조건은 모든 획득이 가져온 결과에 대해 실행하는 검사입니다.

세션을 중단시키지 않습니다. 획득은 결과를 서버의 로그 스트림에 보고하며 연결은 어느 쪽이든 진행됩니다. 거부된 아티팩트로 잃는 것은 문서 리소스이며, 그 세션 동안 문서 리소스는 not-found로 응답합니다. aggrega scaffold --example은 번들 없이는 쓸 것이 없으므로, 거기서는 명령의 거부가 되며 아무것도 쓰지 않습니다.

참조와 두 미디어 타입을 지정하는 출력 메시지입니다:

docscache: <reference>@<version> has media type "<what was found>", want "<what a documentation bundle is>": docscache: artifact is not a documentation bundle (참조의 미디어 타입이 문서 번들의 미디어 타입과 다릅니다. 아티팩트가 문서 번들이 아닙니다)

해결 방법: 엔터티 파일의 어떤 내용도 이를 일으키지 않으며, 작성 내용을 바꿔도 해결되지 않습니다. 획득에 사용된 참조가 문서 번들이 아닌 것을 가리키고 있습니다. 번들 참조는 워크스페이스에 구성된 레지스트리에서 파생되므로 그 레지스트리를 확인하십시오. 올바른 형식이면서 다른 아티팩트를 가리키는 참조는 성공적으로 해석되고 여기서만 실패합니다.

A page is absent from a documentation bundle (문서 번들에 페이지가 없음)

문서 번들이 캐시되고 그 내용이 검증되었지만, 요청한 페이지 — 또는 aggrega scaffold --example의 경우 예제의 디렉터리 — 가 그 안에 없습니다. 번들이 아예 없는 경우와는 다릅니다. 번들은 존재하고 정상이지만 그 안에 항목이 없는 것입니다.

빌드에는 도달하지 않습니다. 편집기나 어시스턴트에 문서 페이지를 제공하는 표면은 이를 요청된 리소스에 대한 일반적인 not-found 응답으로 바꿉니다. aggrega scaffold --example은 아무것도 쓰지 않고, 이를 예제와 번들을 지목하는 거부로 보고한 뒤, 번들에 실제로 들어 있는 예제를 출력하는 aggrega scaffold --example --list를 안내합니다.

두 가지 not-found 응답 중 어느 것을 받았는지 구별해 둘 가치가 있습니다. 표면은 둘을 똑같이 표시하지만, 이 응답은 번들이 캐시되어 있고 정상이며 페이지가 그 안에 없다는 뜻입니다. 다른 응답, 즉 캐시된 번들이 없거나 유일한 사본을 워크스페이스의 서명 검사가 거부하여 워크스페이스가 읽을 수 있는 번들이 없다는 응답은 획득이 완료되지 않았다는 뜻이며, 그 이유는 서버의 로그 스트림에 나옵니다.

페이지와 그 페이지를 찾은 번들을 지정하는 출력 메시지입니다:

page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle (문서 번들에서 페이지를 찾을 수 없습니다)

해결 방법: 파일에는 문제가 없습니다. 번들에 페이지가 없는 것은 번들이 그 페이지보다 오래되었거나 요청한 경로가 페이지가 게시된 경로가 아니기 때문입니다. 번들은 서버가 자신의 버전으로 보고하는 버전으로 획득되므로, 그 버전 이후에 추가된 페이지는 번들에 없습니다. 페이지가 존재한 적이 없다면 요청이 문서에서 사용하지 않는 경로를 지정한 것이며, 실제 경로는 게시된 문서에서 찾을 수 있습니다.

An edit would produce a document its schema refuses (편집 결과 문서가 스키마에서 거부됨)

빌드가 아니라 문서 편집 시의 거부입니다. 하나의 구조화된 편집(컴포넌트 추가, Feature 연결, 에지 연결, 값 설정)이 구성되어 문서에 삽입된 다음, 그 결과가 해당 문서 종류의 스키마로 검사됩니다. 그 검사가 이의를 제기하면 편집은 거부되고 아무것도 기록되지 않습니다. 이 조건은 aggrega edit-document에 속하며, 편집기가 aggrega serve를 통해 또는 어시스턴트가 도달하는 같은 기능에도 속합니다. 이들은 하나의 구현으로 들어가는 얇은 진입점입니다.

종류는 문서에서 읽으며, 호출자가 제공하지 않습니다. 호출자가 종류를 지정하면 잘못된 종류를 지정할 수 있고, 그러면 결과는 문서가 따르지 않는 스키마로 검사됩니다. 이는 이 검사가 거부하기 위해 존재하는 바로 그 편집을 허용하게 됩니다.

파일은 바이트 단위로 그대로 유지되며, 쓰기는 원자적이므로 거부된 편집은 시도하지 않은 편집과 구별되지 않고, 수정한 요청을 처음 문서에 대해 다시 시도할 수 있습니다.

이 조건의 대상은 올바른 형식의 요청입니다. 요청은 이 기능이 적용하는 편집을 지정했고, 그 결과 문서는 직접 입력했더라도 작성 스키마가 거부했을 문서입니다. 그래서 이에 대해 작성 규칙을 다시 설명하지 않습니다. Release에 개발자 값을 넣도록 요청하면 어느 쪽이든 같은 스키마로 거부됩니다. 편집을 지정하지 못한 요청(문서의 어떤 것에도 도달하지 않는 노드 경로, 스칼라가 필요한 곳에 매핑으로 작성된 값, 이미 다른 것을 담고 있는 항목)은 그 자체의 이유로 거부되며, 각 표면은 이를 자체 채널로 보고합니다.

이미 유효하지 않던 문서도 이를 보고합니다. 편집이 아무것도 바꾸지 않은 경우에도 검사가 실행되므로, 제품이 읽기를 거부할 문서에 대한 편집은 성공을 보고하는 대신 그 사실을 알립니다.

이 검사는 문서를 읽을 때마다 적용되는 바로 그 검사입니다. 따라서 파이프라인이 하나의 단계 id를 두 번 선언하는 Recipe 또는 FeatureRecipe도 거부하며, 이는 어떤 스키마로도 표현할 수 없는 규칙입니다. 이때 문장 뒤의 이의 내용은 A pipeline declares one step id twice (파이프라인이 하나의 단계 id를 두 번 선언함)에 설명된 대로 그 조건 자체의 문장과 조언으로 시작합니다.

문장 뒤에 스키마 자체의 이의를 담고 조언으로 끝나는 출력 메시지입니다. 문서 종류와 파일, 그다음 위치, 문제가 된 키, 그리고 스키마가 그곳에서 말한 내용이 이어집니다:

the edit was refused because the resulting document would not be valid, and nothing was written: document envelope validation failed (<kind>, at <path>); <line>:<column>: <field-path>: … <the schema's own objection>. correct the document to match its kind’s schema (결과 문서가 유효하지 않으므로 편집이 거부되었으며 아무것도 기록되지 않았습니다. 문서를 해당 종류의 스키마에 맞게 수정하십시오)

해결 방법: 메시지가 인용하는 위치에서 문서를 열고, 스키마가 그 키에서 무엇을 원했는지 알려 주는 이의 내용을 읽습니다. 보통은 문서가 아니라 요청을 바꿔야 합니다. 그 위치에서 스키마가 허용하는 항목을 요청하면 같은 요청이 문제없이 적용됩니다. 키가 해당 문서 종류에 전혀 넣을 수 없는 것이라면, 그 키는 넣을 수 있는 작성 표면에 속하며, 해당 종류의 엔터티 페이지에 선언하는 필드가 나와 있습니다. 의미적으로 허용되는지(예: 의존성 소켓이 생산자가 선언한 것인지)는 이 시점에 결정되지 않으므로, 이 거부는 항상 문서의 형태에 관한 것이며 연결을 통해 무엇을 소비할 수 있는지에 관한 것이 아닙니다.

An annotation key uses a prefix the platform reserves (어노테이션 키가 플랫폼이 예약한 접두사를 사용함)

빌드가 아니라 엔터티를 게시 관례에 따라 검사할 때의 거부입니다. aggrega.ai/ 접두사와 Feature 외부의 feature.aggrega.ai/ 접두사는 플랫폼 소유입니다. 그 아래에 작성된 키는 플랫폼이 부여하는 의미를 가지므로, 직접 만든 엔터티가 그곳에 작성하면 자신이 보유하지 않은 네임스페이스를 주장하는 것입니다.

작성하는 동안에는 권고하고 게시 게이트에서는 거부하며, 두 경우 모두 이 하나의 조건을 지정합니다. 발견된 내용은 어느 쪽이든 같고 결과만 다릅니다. 이렇게 나뉘는 방식은 여기에 수록된 대부분의 게시 관례 규칙에 해당하므로, 한 번만 설명하고 아래 항목 중 달리 말하지 않는 항목에는 그대로 적용되는 것으로 봅니다. 이미 게시된 버전과 비교하는 두 규칙은 로컬 내용에 대해서는 전혀 실행될 수 없으므로 각자의 항목에서 그 점을 밝힙니다.

메시지는 다음으로 시작합니다:

an annotation key on the entity uses a prefix the platform reserves (엔터티의 어노테이션 키가 플랫폼이 예약한 접두사를 사용합니다)

해결 방법: 키를 자체 조직이 소유한 접두사 아래로 옮깁니다. 그래도 워크스페이스가 예약된 접두사 아래에 작성해야 할 이유가 있다면, 이 규칙은 aggrega-lint.md의 “The discipline rules”에 설명된 옵트아웃 중 하나입니다.

An entity’s name does not follow the shape its kind expects (엔터티의 이름이 해당 종류가 기대하는 형태를 따르지 않음)

빌드가 아니라 엔터티를 게시 관례에 따라 검사할 때 발생하는 거부입니다. 각 엔터티 종류에는 이름 형태에 대한 관례가 있습니다. 클라우드 네이티브 종류에는 세그먼트 수, 라이브러리 종류에는 PascalCase가 적용됩니다. 이 엔터티가 선언한 이름은 해당 종류가 기대하는 형태와 일치하지 않습니다.

메시지는 다음으로 시작합니다:

the entity’s name does not follow the documented name shape for its kind (엔터티의 이름이 해당 종류에 대해 문서화된 이름 형태를 따르지 않음)

해결 방법: 엔터티의 이름을 해당 종류가 기대하는 형태로 변경합니다. 종류별 관례는 aggrega-lint.md의 “The discipline rules” 아래에 나열되어 있으며, 의도적으로 엔터티에 자체 방식으로 이름을 붙이는 카탈로그를 위한 옵트아웃도 함께 설명되어 있습니다.

A schema uses a dynamic reference that cannot be resolved ahead of time (스키마가 사전에 해석할 수 없는 동적 참조를 사용함)

빌드가 아니라 엔터티를 게시 관례에 따라 검사할 때 발생하는 거부입니다. 엔터티가 포함한 스키마가 동적 참조 구문을 사용하는데, 이 구문의 대상은 스키마를 작성할 때 고정되는 것이 아니라 문서를 검증하는 도중에 선택됩니다. 여기서는 참조가 사전에 확장되므로, 이러한 구문이 해석 기준으로 삼을 진행 중인 검증이 없습니다.

메시지는 다음으로 시작합니다:

a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow (엔터티의 스키마가 문서 간 참조 해석이 따라갈 수 없는 동적 참조 구문을 사용함)

해결 방법: 동적 구문을 대상을 직접 지정하는 일반 참조로 바꿉니다. 스키마에 해당 구문이 실제로 필요하고 문서 간에 참조되지 않을 경우, 이 규칙에는 aggrega-lint.md의 “The discipline rules” 아래에 설명된 옵트아웃이 있습니다.

A schema declares an identifier the platform owns (스키마가 플랫폼이 소유한 식별자를 선언함)

빌드가 아니라 엔터티를 게시 관례에 따라 검사할 때 발생하는 거부입니다. 엔터티가 포함한 스키마가 자체 식별자를 선언하는데, 정규 식별자는 엔터티의 아이덴티티에서 도출됩니다. 선언된 식별자가 도출된 식별자를 대체하므로, 정규 식별자를 기준으로 작성된 참조는 더 이상 해석되지 않습니다.

메시지는 다음으로 시작합니다:

a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity (엔터티의 스키마가 자체 식별자를 선언하지만, 해당 스키마의 아이덴티티는 플랫폼이 소유함)

해결 방법: 선언된 식별자를 제거하고 도출되도록 둡니다. 의도적으로 자체 식별자로 게시되는 스키마를 위한 옵트아웃은 aggrega-lint.md의 “The discipline rules” 아래에 설명되어 있습니다.

A Component’s category label and its directory name different categories (Component의 카테고리 레이블과 디렉터리가 서로 다른 카테고리를 가리킴)

빌드가 아니라 엔터티를 게시 관례에 따라 검사할 때 발생하는 거부입니다. Component는 카테고리 레이블을 가지며 카테고리 디렉터리 아래에 배치됩니다. 관례는 두 가지가 같은 카테고리를 가리키는 것이며, 이를 통해 독자가 탐색하는 디렉터리와 셀렉터가 일치시키는 레이블이 서로 어긋나지 않게 합니다.

메시지는 다음으로 시작합니다:

the entity’s category label does not match the category directory the entity is filed under (엔터티의 카테고리 레이블이 엔터티가 배치된 카테고리 디렉터리와 일치하지 않음)

해결 방법: 둘 중 잘못된 쪽을 고쳐 서로 일치시킵니다. 레이블이 가리키는 디렉터리로 파일을 옮기거나, 디렉터리가 가리키는 카테고리로 레이블을 수정합니다. 닫힌 카테고리 집합과 옵트아웃은 aggrega-lint.md의 “The discipline rules” 아래에 있습니다.

A schema extension is written directly into schema content (스키마 확장이 스키마 내용에 직접 작성됨)

빌드가 아니라 엔터티를 게시 관례에 따라 검사할 때 발생하는 거부입니다. Component 또는 Feature가 Aggrega 스키마 확장을 스키마 내용에 직접 작성했는데, 엔터티에는 같은 내용을 선언하는 일급 표면이 있습니다. 직접 작성한 형식도 동작하지만, 관례는 선언용 표면을 선호합니다. 엔터티 페이지가 가르치는 것도, 도구가 읽는 것도 그 표면이기 때문입니다.

이 그룹에서 빌드도 보고하는 규칙은 이것 하나입니다. 빌드에서는 빌드를 중단하지 않는 권고로 보고됩니다. 게시 게이트에서 엔터티를 게시 관례에 따라 검사하면 같은 결과가 거부로 격상됩니다.

메시지는 다음으로 시작합니다:

the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema (엔터티가 Aggrega 스키마 확장을 해당 선언 위치에 선언하지 않고 스키마 내용에 직접 작성합니다)

해결 방법: 확장을 엔터티 자체의 소켓 또는 어태치먼트 표면으로 옮깁니다. component.md와 feature.md의 엔터티 페이지가 이를 선언하는 위치가 바로 그곳입니다. 옵트아웃은 aggrega-lint.md의 “The discipline rules” 아래에 있습니다.

A Plugin pins neither runtime cap, so the platform’s own apply (Plugin이 런타임 상한을 하나도 고정하지 않아 플랫폼 자체의 상한이 적용됨)

엔터티를 게시 관례에 따라 검사할 때, 작성 중이든 게시 게이트에서든 똑같이 발생하는 권고입니다. 어떤 것도 중단하지 않으며, 빌드는 이를 발생시키지 않습니다. Plugin은 호스트가 플러그인을 로드하고 실행할 때 적용하는 메모리 상한과 시간 제한을 선언합니다. 둘 다 선언하지 않은 Plugin은 플랫폼의 기본값으로 실행되며, 이는 실수가 아니라 지원되는 결과입니다. 따라서 이 권고가 알리는 것은 기본값이 적용되고 있으며 이를 명시적으로 고정할 수 있다는 사실입니다.

메시지는 다음으로 시작합니다:

the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply (Plugin 엔터티가 자체 런타임 리소스 상한을 선언하지 않아 플랫폼 기본값이 적용됨)

해결 방법: 플러그인에 실제로 필요한 상한을 고정하거나, 의도적으로 기본값을 그대로 둡니다. 이 규칙에는 옵트아웃 설정이 없습니다. 엔터티에 대한 판단이 아니라 사실을 보고하는 것이므로 완화할 것이 없기 때문입니다. 필드는 plugin.md에 설명되어 있습니다.

An attachment slot admits only secret material without saying it handles it (어태치먼트 슬롯이 시크릿 자료만 허용하면서 이를 다룬다고 밝히지 않음)

엔터티를 게시 관례에 따라 검사할 때, 작성 중이든 게시 게이트에서든 똑같이 발생하는 권고입니다. 어떤 것도 중단하지 않으며, 빌드는 이를 발생시키지 않습니다. 어태치먼트 슬롯은 셀렉터를 통해 시크릿을 담은 Feature만 자신을 채울 수 있도록 고정할 수 있고, 이와 별도로 자신을 채우는 것이 무엇이든 시크릿 자료를 다룬다고 기록할 수 있습니다. 셀렉터는 어떤 채움이 허용되는지를, 기록은 취급 방식을 나타냅니다. 전자를 고정하고 후자를 생략한 슬롯은 취급 방식을 슬롯에서 읽지 않고 셀렉터로부터 추론하게 둡니다. 엔터티가 선언한 모든 슬롯이 검사됩니다. 자체 어태치먼트 블록의 슬롯과, Component의 경우 의존성 소켓이 이를 통해 연결된 각 커넥션에 대해 선언하는 슬롯이 대상이며, 소켓의 슬롯에 대한 결과는 슬롯 옆에 소켓 이름을 함께 표시합니다.

메시지는 다음으로 시작합니다:

an attachment slot admits only secret material and does not declare that it handles it (어태치먼트 슬롯이 시크릿 자료만 허용하지만 이를 다룬다고 선언하지 않음)

해결 방법: 슬롯을 고정하는 셀렉터 옆에 슬롯의 취급 방식을 선언합니다. 이 규칙에는 Plugin 상한 규칙과 같은 이유로 옵트아웃 설정이 없습니다. 엔터티에 대한 사실을 보고하고 결정은 작성자에게 맡기기 때문입니다.

A Recipe publishes a provides key its Component does not declare, checked at publication (Recipe가 해당 Component에서 선언하지 않은 provides 키를 게시함, 게시 시점에 검사됨)

엔터티를 게시 관례에 따라 검사할 때, 작성 중이든 게시 게이트에서든 똑같이 발생하는 권고입니다. 어떤 것도 중단하지 않으며, 빌드는 이를 발생시키지 않습니다. Recipe가 provides: 아래에 키를 게시하지만, 그 Recipe가 구현하는 Component는 스키마의 provides 필러에 해당 키를 선언하지 않습니다. 커넥션을 통해 연결하는 소비자는 Recipe가 내보내는 것이 아니라 Component가 선언한 계약을 읽으므로, 그 키는 생성되지만 무언가가 소비하려는 지점에서 거부됩니다.

🔴 이를 설명하는 조건은 두 가지이며, 둘은 같은 조건이 아닙니다. 빌드가 보고하는 권고는 위의 “A Recipe publishes a provides key its Component does not declare”에 문서화되어 있습니다. 이 권고는 엔터티를 게시 관례에 따라 검사할 때 발생하며 고유한 코드를 가집니다. 결과는 두 표면에서 마주치는 같은 사실이므로, 진단의 코드를 읽고 어느 쪽인지 구별합니다.

메시지는 다음으로 시작합니다:

the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused (Recipe가 구현하는 Component가 선언하지 않은 provides 키를 게시하므로, 그 키를 연결하는 소비자가 거부됨)

해결 방법: Component에 키를 선언하여 소비자가 읽는 계약에 Recipe가 내보내는 것이 포함되도록 하거나, 아무것도 소비할 예정이 없다면 Recipe에서 게시를 중단합니다. 옵트아웃은 aggrega-lint.md의 “The discipline rules” 아래에 있습니다.

Component의 메트릭 어노테이션과 provides 키가 일치하지 않음

엔터티를 게시 관례에 비추어 검사할 때 발생하는 권고로, 작성 중이든 게시 게이트에서든 마찬가지입니다. 이 권고는 어떤 것도 중단시키지 않으며, 빌드는 이를 발생시키지 않습니다. Component는 자신의 제품 메트릭이 어떻게 인증하는지를 annotation observability.aggrega.ai/metrics-credential에 none, target-key 또는 separate-token으로 명시할 수 있고, provides 키 metrics_credential_required를 선언할 수 있습니다. 이 키는 해당 Component의 각 Recipes가 한 인스턴스의 메트릭에 자격 증명이 필요한지를 나타내기 위해 게시합니다. 두 가지는 제품에 관한 하나의 사실을 양쪽에서 본 것이므로, 메트릭에 자격 증명이 필요 없다고 명시한 Component는 그러한 키를 선언하지 않고, 자격 증명이 필요하다고 명시한 Component는 이를 선언합니다. 이 조건은 두 가지가 일치하지 않는 Component를 보고하며, 해당 Component, annotation의 값, 그리고 남거나 누락된 키를 명시합니다.

메시지는 다음으로 시작합니다:

a Component’s annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance’s metrics need a credential (메트릭의 인증 방식을 명시하는 Component의 어노테이션이, 인스턴스의 메트릭에 자격 증명이 필요하다는 provides 키의 선언 여부와 일치하지 않습니다)

해결 방법: 둘 중 잘못된 쪽을 바로잡습니다. 메트릭에 자격 증명이 필요한 경우 provides 필러에 metrics_credential_required를 선언하고 각 Recipe에서 이를 게시합니다. 필요 없는 경우 이를 제거합니다. 또는 어노테이션을 제품을 설명하는 값으로 변경합니다. Plugin 상한 규칙에 옵트아웃 설정이 없는 것과 같은 이유로 이 규칙에도 옵트아웃 설정이 없습니다. 어떤 값을 읽는지, 어떤 Components를 읽지 않는지는 aggrega-lint.md의 “The discipline rules”에 설명되어 있습니다.

연결과 그 연결이 도달하는 대상이 하나의 키를 명시하지 않음

Release를 게시 관례에 비추어 검사할 때 발생하는 권고입니다. 어떤 작업도 중단시키지 않으며 빌드에서는 발생하지 않습니다. 키를 검사하는 서버는 자신이 검증하는 키를 자체 슬롯에 보관하고, 호출자는 그 서버에 도달하는 연결에서 키를 제시합니다. 어느 쪽도 상대방의 키를 보지 못하므로, 두 키가 하나의 키가 되는 것은 작성자가 양쪽에 같은 로케이터를 쓰기 때문일 뿐입니다. 이 조건은 대상이 호출자에게 요구하는 키의 슬롯을 선언했는데 두 키가 하나가 아닌 연결을 보고합니다. 즉, 연결은 자격 증명을 가지고 있으나 대상의 키 슬롯이 채워지지 않은 경우, 대상의 키 슬롯은 채워져 있으나 연결에 자격 증명이 없는 경우, 또는 둘 다 채워져 있으나 로케이터를 서로 다르게 쓴 경우입니다.

위의 규칙들과 달리 이 규칙은 하나의 엔터티가 아니라 Release 전체를 읽습니다. 따라서 Release를 검사할 때만 발생하며, 하나의 엔터티만 단독으로 검사하는 게시 게이트에서는 절대 발생하지 않습니다. 어디서 보고되든 이는 권고입니다. 결과는 component, 연결, 대상, 두 슬롯을 명시하며 어느 로케이터도 인용하지 않습니다. 스크레이프, 즉 scrape_target 소켓의 연결은 대상이 자신의 메트릭에 관해 명시한 내용에 따라 판단됩니다. 대상의 observability.aggrega.ai/metrics-credential 어노테이션이 none이면 전혀 판단하지 않고, separate-token이면 대상의 키와 대조하지 않으며, 그 외에는 다른 연결과 똑같이 판단합니다. 다른 소켓의 연결은 대상이 무엇을 명시하든 판단됩니다.

메시지는 다음으로 시작합니다:

a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one (연결과 그 연결이 도달하는 대상이 하나의 키를 명시하지 않습니다: 서로 다른 로케이터를 쓰거나 한쪽만 키를 명시합니다)

해결 방법: 양쪽이 하나의 파라미터, 즉 연결의 credential과 대상의 api_key를 읽도록 하여 호출자가 제시하는 키와 서버가 검증하는 키가 서로 다르게 쓰일 수 없게 합니다. 또는 연결이 키를 제시하지 않도록 의도된 경우에는 연결에서 자격 증명을 제거합니다. 어떤 슬롯을 읽는지, 무엇을 비교하는지, 옵트아웃은 aggrega-lint.md의 “The discipline rules”에 설명되어 있습니다.

게시하려는 변경이 진화 기준표가 허용하는 범위를 벗어남

빌드가 아니라 게시에 앞선 검사에서의 거부입니다. 게시하려는 버전을 그 이전에 이미 게시된 버전과 비교하고, 둘 사이의 차이를 문서화된 기준표에 따라 분류합니다. 이 조건은 그 차이가 기준표가 반대하는 것임을 보고합니다.

비교 대상이 될 게시된 이전 버전이 필요하므로, 이 규칙과 아래의 버전 증가 검사는 이 그룹에서 로컬 콘텐츠만으로는 실행할 수 없는 두 규칙입니다. 레지스트리를 참조하지 않으면 비교할 대상이 없으며, 검사는 통과가 아니라 건너뛴 것으로 처리됩니다.

메시지는 다음으로 시작합니다:

the version being published changes the published predecessor in a way the documented evolution rubric objects to (게시하려는 버전이 게시된 이전 버전을 문서화된 진화 기준표가 반대하는 방식으로 변경합니다)

해결 방법: 진단에 있는 분류를 읽습니다. 분류는 기준표가 변경의 어떤 점에 반대했는지를 명시합니다. 그런 다음 변경을 호환되도록 만들거나, 그 변경을 허용하는 버전으로 게시합니다. 기준표는 aggrega-lint.md의 “The version-bump rubric”에 설명되어 있습니다.

제시된 버전 증가가 변경에 필요한 것보다 작음

빌드가 아니라 게시에 앞선 검사에서의 거부입니다. 게시하려는 변경을 진화 기준표에 따라 분류했는데, 그 변경에 제시된 버전이 분류가 요구하는 것보다 작은 단계입니다. 예를 들어 제거나 축소를 패치로 제시한 경우입니다. 과도한 버전 증가는 항상 허용되며, 여기서 중단되는 것은 부족한 버전 증가입니다.

위의 규칙들과 달리 이 규칙은 관례 플러그인이 아니라 여기서 판정됩니다. 어떤 버전 증가가 제시되었는지는 게시 시점에만 알 수 있고 그때는 컴파일이 실행되고 있지 않으므로, 분류와 제시된 버전 사이의 비교는 그 시점에 이루어집니다.

메시지는 다음으로 시작합니다:

the version bump being published is smaller than the evolution check’s classification of the change requires (게시하려는 버전 증가가 진화 검사의 변경 분류가 요구하는 것보다 작습니다)

해결 방법: 분류가 요구하는 버전으로 게시합니다. 진단에 그 버전이 명시되어 있습니다. 변경이 분류된 것보다 작다고 판단되는 경우, aggrega-lint.md의 “The version-bump rubric”에 있는 기준표가 변경을 각 등급에 넣는 기준을 설명합니다. 엔터티의 첫 게시에는 이전 버전이 없으므로 비교를 건너뛰며, 통과가 아니라 수행되지 않은 것으로 보고됩니다.

가져오기가 소스를 변환하는 도중에 중단됨

빌드가 아니라 외부 소스 기술을 초안 작성 파일로 변환할 때의 거부입니다. 임포터가 변환을 중단할 만큼 심각한 진단을 보고했으므로 생성된 결과는 부분적입니다. 소스의 일부는 초안 작성 파일이 되었고 일부는 그렇지 않았습니다.

부분적인 결과는 잔해가 아니라 의도된 것입니다. 이 조건은 원인이 아니라 결과를 명시합니다. 변환할 수 없었던 내용은 함께 보고되는 진단에 임포터 자신의 표현으로, 임포터가 옮기지 못한 구성 요소마다 하나씩 보고됩니다. 이 조건 덕분에 호출자는 “가져오기가 중단되어 답의 일부를 생성함”과 “가져오기가 완전히 실패함”을 구분할 수 있으며, 이 둘은 다음 단계가 다른 서로 다른 상황입니다.

메시지는 다음으로 시작합니다:

the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files (임포터가 가져오기를 중단시키는 진단을 보고하여 소스가 초안 작성 파일로 완전히 변환되지 않았습니다)

해결 방법: 함께 보고된 진단을 읽습니다. 각 진단은 임포터가 변환할 수 없었던 소스의 구성 요소를 명시합니다. 해결은 전달한 소스를 고치거나 초안을 직접 완성하는 것입니다. 가져오기는 편집의 출발점을 생성하므로, 변환되지 못한 구성 요소는 Aggrega 쪽에서 직접 작성하면 됩니다. aggrega-import.md에서 명령이 무엇을 생성하고 어디에 쓰는지 설명합니다.

More than one importer recognises the source (둘 이상의 임포터가 소스를 인식함)

빌드가 아니라 외부 소스 기술을 초안 작성 파일로 변환하는 단계에서의 거부입니다. 가져오기에 형식이 지정되지 않았으므로 임포터가 선언한 시그니처로 형식을 인식했습니다. 시그니처는 워크스페이스 카탈로그에 있는 것과 컴파일러의 코어 임포터에 있는 것 모두 해당하며, 각 시그니처는 소스를 읽는 구문, 적용되는 파일 이름, 파싱된 트리가 반드시 가져야 하거나 가져서는 안 되는 경로를 지정합니다. 그런데 둘 이상의 형식을 제공하는 임포터들의 시그니처가 소스와 일치했습니다. 가져오기는 그중 하나를 고르지 않습니다. 소스가 어떤 형식인지는 컴파일러가 아니라 임포터가 진술하는 것이며, 고르는 것은 소스를 맞지 않을 수도 있는 임포터에 넘기는 추측이 되기 때문입니다.

이는 위의 “A parse or import format is advertised by more than one plugin (파싱 또는 가져오기 형식을 둘 이상의 플러그인이 알림)”에서 설명한, 하나의 형식을 둘 이상의 임포터가 알리는 경우와 다릅니다. 그 경우에는 형식이 정해져 있고 그 형식을 제공하는 임포터들이 경쟁하므로 plugins.importer 항목이 그중 하나를 선택합니다. 이 경우에는 형식 자체가 다르므로 어떤 첨부도 이를 해결하지 못하며, 형식을 지정해야 해결됩니다. 소스를 인식하는 임포터는 그 소스를 자신이 알리는 모든 형식으로 인식하므로, 둘 이상의 형식을 알리는 임포터의 시그니처 중 하나가 일치하는 경우에도 여기서 거부됩니다.

메시지는 다음으로 시작합니다:

more than one importer recognises the source (둘 이상의 임포터가 소스를 인식함)

메시지의 나머지 부분은 소스와, 소스가 인식된 모든 형식을 임포터의 식별자와 버전 순서로 지정한 다음 해결 방법을 제시합니다:

more than one importer recognises the source (source "<source>", recognised as "<format>", "<format>"). Pass —format to name the one to read it as (for example —format <format> or —format <format>) (둘 이상의 importer가 소스를 인식합니다(소스와 인식된 형식이 이어서 표시됩니다). —format으로 소스를 읽을 형식 하나를 지정하십시오)

해결 방법: 형식을 지정합니다. aggrega import에서는 --format을, 어시스턴트의 가져오기 도구와 세션의 aggrega/import 메서드에서는 format을 사용합니다. 임포터 중 하나가 그러한 소스를 절대 인식해서는 안 되는 경우에는 그 임포터의 시그니처를 변경해야 합니다. 시그니처는 임포터 작성자가 describe() 자기 보고에서 선언하며, 임포터가 생성될 때 그 Plugin 엔터티에 기록됩니다. 또는 워크스페이스 카탈로그에 있는 임포터라면 워크스페이스가 읽는 카탈로그에서 제외합니다. 코어 임포터는 항상 시도 대상에 포함되므로, 코어 임포터 중 하나가 다른 임포터와 함께 인식하는 소스는 형식을 지정하여 해결합니다. aggrega-import.md에서 형식이 인식되는 방식을 설명합니다.

No importer recognises the source (소스를 인식하는 임포터가 없음)

빌드가 아니라 외부 소스 기술을 초안 작성 파일로 변환하는 단계에서의 거부입니다. 가져오기에 형식이 지정되지 않았으므로 임포터가 선언한 시그니처로 형식을 인식했습니다. 시그니처는 워크스페이스 카탈로그에 있는 것과 컴파일러의 코어 임포터에 있는 것 모두 해당합니다. 그런데 어떤 형식의 시그니처도 소스와 일치하지 않았습니다. 가져오기는 추측하지 않습니다. 그러한 형태를 읽는다고 선언한 적이 없는 임포터에 소스를 넘기면 맞지 않을 수도 있는 소스로 초안을 작성하게 되기 때문입니다.

이는 위의 “More than one importer recognises the source (둘 이상의 임포터가 소스를 인식함)”에 대응하는 경우입니다. 그 경우에는 여러 형식이 소스를 주장하고, 이 경우에는 아무 형식도 주장하지 않습니다. 두 경우 모두 형식을 지정하면 해결되며, 형식이 지정될 때까지 아무것도 기록되지 않습니다.

메시지는 다음으로 시작합니다:

no importer recognises the source (소스를 인식하는 임포터가 없음)

메시지의 나머지 부분은 소스를 지정한 다음, 해결 방법과 카탈로그의 임포터가 알리는 모든 형식을 읽힌 순서대로 제시합니다:

no importer recognises the source (source "<source>"). Pass —format to name it explicitly (for example —format <format> or —format <format>) (소스를 인식하는 importer가 없습니다. —format으로 형식을 명시적으로 지정하십시오)

형식을 알리는 임포터가 전혀 없는 경우, 해결 방법은 예시 대신 그 사실을 알립니다.

디렉터리에는 다른 해결 방법이 제시됩니다. 아무 형식이나 지정해서는 도움이 되지 않기 때문입니다. 디렉터리는 그 임포터가 선언한 파일 패턴을 통해서만 읽히며, 파일 패턴을 선언하지 않은 시그니처는 디렉터리의 어떤 파일에도 적용되지 않습니다. 따라서 예컨대 Langflow 내보내기 하나만 담은 디렉터리는 어떤 시그니처에도 인식되지 않으며, langflow 형식을 지정하면 이번에는 An importer that declares no file patterns is handed a directory (파일 패턴을 선언하지 않은 임포터가 디렉터리를 전달받음)에 따라 거부됩니다. 그러므로 디렉터리에 대한 거부는 그것을 디렉터리로 지칭하고, 그 파일 중 하나를 단독으로 가져오거나 파일 패턴을 선언하는 임포터의 형식을 지정하도록 제안합니다. 제시되는 형식은 그런 형식뿐이며, 임포터 자체의 선언에서 읽어 옵니다:

no importer recognises the source (directory "<directory>"). Import one of the directory’s files on its own, or pass —format naming a format whose importer reads a directory through the file patterns it declares (for example —format <format> or —format <format>) (어떤 임포터도 소스를 인식하지 않습니다(디렉터리). 디렉터리의 파일 중 하나를 단독으로 가져오거나, 선언한 파일 패턴을 통해 디렉터리를 읽는 임포터의 형식을 —format으로 지정하십시오(예: —format 또는 —format))

파일 패턴을 선언하는 임포터가 하나도 없으면, 거부는 디렉터리의 파일 중 하나를 단독으로 가져오도록 제안하고, 카탈로그의 어떤 임포터도 디렉터리를 읽는 데 쓰이는 파일 패턴을 선언하지 않는다고 알려 줍니다.

해결 방법: 형식을 지정합니다. aggrega import에서는 --format을, 어시스턴트의 가져오기 도구와 세션의 aggrega/import 메서드에서는 format을 사용합니다. 각각은 자신이 받는 필드에 맞추어 거부 문구를 작성하고 이 조건의 짧은 코드로 시작합니다. 세션의 응답은 데이터에 이 조건의 두 코드를 모두 담습니다. 디렉터리의 경우에는 의도한 파일 하나를 단독으로 가져오거나(파일을 지정하지 않는 시그니처는 이름이 무엇이든 단독으로 가져온 파일에 적용됩니다) 거부가 나열하는 형식 중 하나를 지정합니다. 소스가 인식되었어야 하는 경우에는 그 형식을 제공하는 임포터의 시그니처를 변경해야 합니다. 시그니처는 임포터 작성자가 describe() 자기 보고에서 선언하며, 임포터가 생성될 때 그 Plugin 엔터티에 기록됩니다. aggrega-import.md에서 형식이 인식되는 방식을 설명합니다.

An importer that declares no file patterns is handed a directory (파일 패턴을 선언하지 않은 임포터에 디렉터리가 전달됨)

빌드가 아니라 외부 소스 기술을 초안 작성 파일로 변환하는 단계에서의 거부입니다. 지정된 소스가 디렉터리이며, 디렉터리는 임포터가 선언한 파일 패턴이 선택하는 파일만 정확히 임포터에 전달됩니다. 따라서 디렉터리의 어떤 파일을 읽는지는 임포터 자신이 진술하는 것입니다. 소스의 형식을 제공하는 임포터가 파일 패턴을 선언하지 않았습니다. 이 임포터는 파일 하나를 읽으며, 디렉터리의 어떤 파일이 자신의 것인지 아무것도 말하지 않습니다.

아무것도 열리지 않습니다. 가져오기는 디렉터리의 모든 파일을 임포터에 넘기는 대신, 임포터가 확인된 직후 디렉터리의 어떤 파일도 읽기 전에 중지됩니다.

메시지는 다음으로 시작합니다:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (소스의 형식을 제공하는 임포터가 파일 패턴을 선언하지 않으므로 파일 하나만 읽으며 디렉터리를 읽을 수 없음)

메시지의 나머지 부분은 형식, 임포터, 그리고 지정한 그대로의 디렉터리를 지정한 다음 해결 방법을 제시합니다:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (format "<format>", importer "importer/<name>", directory "<directory>"). Import one of the directory’s files on its own instead; the importer reads a directory once it declares the file patterns its files are named by (소스의 형식을 처리하는 importer가 파일 패턴을 선언하지 않으므로 파일 하나만 읽으며 디렉터리는 읽을 수 없습니다. 대신 디렉터리의 파일 하나를 단독으로 가져오십시오. importer는 자신의 파일 이름에 해당하는 파일 패턴을 선언하면 디렉터리를 읽습니다)

해결 방법: 해당 형식의 파일 하나를 단독으로 가져옵니다. 임포터가 그 형식의 디렉터리를 읽게 하려면, 임포터 작성자가 파일 이름 패턴을 선언합니다. 이는 describe() 자기 보고에 있는 인식 시그니처의 files이며, 임포터가 생성될 때 그 Plugin 엔터티에 기록됩니다. aggrega-import.md에서 디렉터리 가져오기가 읽는 대상을 설명합니다.

No file in the directory matches the importer’s file patterns (디렉터리에 임포터의 파일 패턴과 일치하는 파일이 없음)

빌드가 아니라 외부 소스 기술을 초안 작성 파일로 변환하는 단계에서의 거부입니다. 지정된 소스가 디렉터리이고, 형식이 정해져 있으며, 그 형식을 제공하는 임포터가 파일 패턴을 선언하지만, 디렉터리에 있는 어떤 파일도 어느 깊이에서든 그 패턴 중 하나와 일치하지 않습니다. 임포터에 소스를 전혀 넘기지 않으면 임포터는 빈 소스에서 실패하며, 그 실패는 어떤 파일을 읽었는지가 아니라 내용에 관한 문구로 표시됩니다. 따라서 가져오기는 아무것도 읽지 않은 채 여기서 중지됩니다.

형식이 지정되지 않고 인식된 경우, 디렉터리를 인식한 시그니처의 임포터는 그 디렉터리의 파일 하나와 일치했습니다. 따라서 이 조건은 실행되는 임포터가 그 임포터가 아닐 때만 발생합니다. 즉 plugins.importer 항목이 선택한 같은 형식의 다른 임포터이거나, 그 임포터의 다른 버전인 경우입니다.

메시지는 다음으로 시작합니다:

no file in the directory matches the file patterns the importer serving the source’s format declares (디렉터리에 소스의 형식을 제공하는 임포터가 선언한 파일 패턴과 일치하는 파일이 없음)

메시지의 나머지 부분은 형식, 임포터, 지정한 그대로의 디렉터리, 그리고 임포터가 선언한 모든 패턴을 지정한 다음 해결 방법을 제시합니다:

no file in the directory matches the file patterns the importer serving the source’s format declares (format "<format>", importer "importer/<name>", directory "<directory>", file patterns "<pattern>", "<pattern>"). Name a directory holding a file one of those patterns matches, or the format of an importer whose patterns match the files this directory holds (디렉터리의 어떤 파일도 소스의 형식을 처리하는 importer가 선언한 파일 패턴과 일치하지 않습니다. 그 패턴 중 하나와 일치하는 파일이 있는 디렉터리를 지정하거나, 이 디렉터리의 파일과 패턴이 일치하는 importer의 형식을 지정하십시오)

해결 방법: 해당 형식의 파일이 있는 디렉터리를 가져옵니다. 패턴은 디렉터리 내부 파일 경로의 끝부분과 비교되므로 어느 깊이에 있는 파일이든 해당됩니다. 또는 디렉터리의 파일이 속한 형식을 지정합니다. aggrega-import.md에서 디렉터리 가져오기가 읽는 대상을 설명합니다.

A file read from the directory and a file named in the importer’s with.sources have the same name (디렉터리에서 읽은 파일과 importer의 with.sources에 지정된 파일의 이름이 같습니다)

빌드가 아니라 외부 소스 설명을 초안 작성 파일로 변환할 때의 거부입니다. 지정된 소스는 디렉터리이며, 그 파일들은 각각 디렉터리 안의 경로를 이름으로 하는 명명된 소스로 importer에 전달됩니다. importer를 연결하는 plugins.importer 항목은 with.sources 아래에 자체 파일을 지정하며, 이 파일들도 각각 기본 이름을 이름으로 하는 명명된 소스로 전달되는데, 하나의 이름이 양쪽에 모두 있습니다. 이름은 importer가 소스를 서로 구별하는 수단이므로 둘 다 전달하면 어느 쪽인지 알려 주는 것 없이 한쪽이 다른 쪽을 가리게 됩니다. 그래서 import는 아무것도 전달하지 않고 중단됩니다.

메시지는 다음으로 시작합니다:

a file read from the directory and a file named in the importer’s with.sources have the same name

메시지의 나머지 부분은 해당 이름과 with.sources 파일을 밝힌 다음 해결 방법을 제시합니다:

a file read from the directory and a file named in the importer’s with.sources have the same name (name "<name>", the with.sources file "<path>"). Each source reaches the importer under one name, so rename one of the two files, or leave the file out of the importer’s with.sources

해결 방법: 두 파일 중 하나의 이름을 바꾸거나, 디렉터리에 이미 그 파일이 있다면 항목의 with.sources에서 해당 파일을 제외합니다. with.sources 파일은 기본 이름을 유지하므로, 충돌하는 것은 디렉터리 최상위에 있는 같은 이름의 파일입니다. 하위 디렉터리에 있는 파일은 그 디렉터리를 이름에 포함합니다. 어떤 importer가 소스를 초안으로 변환하는가에서 항목의 with.sources를 설명합니다.

An import’s target names a capability no Recipe in the catalog binds to (import의 대상이 카탈로그의 어떤 Recipe도 바인딩하지 않는 capability를 지정함)

빌드가 아니라 외부 소스 설명을 초안 작성 파일로 변환할 때의 거부입니다. import에 대상이 주어졌으며(aggrega import의 --target, 또는 어시스턴트 import 도구와 세션의 aggrega/import 메서드의 target), 이는 초안으로 작성된 각 컴포넌트 타입을 해당 provider의 Recipe에 매핑하는 Manifest를 초안으로 작성하기 위한 것입니다. 대상은 provider capability로, 워크스페이스 카탈로그의 각 Recipe가 바인딩하는 spec.capability와 대조되는데, 그곳의 어떤 Recipe도 주어진 capability에 바인딩하지 않습니다. 이를 위해 초안으로 작성된 Manifest는 아무것도 매핑하지 않을 것이고, 실제로 잘못된 것은 옵션 자체(대개 철자 오류)인데도 모든 컴포넌트 타입이 카탈로그에서 누락된 것으로 읽히게 됩니다.

아무것도 실행되지 않고 아무것도 기록되지 않습니다. import는 카탈로그가 로드된 직후, 소스의 형식이 인식되기 전이자 importer가 실행되기 전에 중단되므로, dry run에서도 초안이 생성되지 않고 파일이 기록되지 않습니다.

메시지는 다음으로 시작합니다:

no Recipe in the workspace’s catalog binds to the capability the import’s target names

메시지의 나머지 부분은 주어진 그대로의 대상과 카탈로그의 Recipes가 실제로 바인딩하는 capability를 각각 한 번씩 정렬된 순서로 밝힌 다음 해결 방법을 제시합니다:

no Recipe in the workspace’s catalog binds to the capability the import’s target names (target "<target>", the catalog’s Recipes bind to "<capability>", "<capability>"). Name one of those capabilities as the target, or leave the target out and no Manifest is drafted; nothing was drafted or written

카탈로그에 Recipe가 전혀 없으면 메시지는 목록 대신 그 사실을 알리며, 해결 방법은 해당 provider의 Recipe를 카탈로그에 추가하는 것입니다.

해결 방법: 메시지가 나열하는 capability 중 하나(예: Recipe의 spec.capability에 쓰인 대로 compose 또는 helm)를 지정하거나, 대상을 생략하여 Manifest를 초안으로 작성하지 않습니다. 의도한 provider에 대한 Recipe가 아직 카탈로그에 없다면, 워크스페이스가 먼저 읽는 카탈로그 폴더에 해당 Recipes를 추가합니다. aggrega-import.md에서 대상이 주어진 import가 무엇을 초안으로 작성하는지 설명합니다.

A child Release inherits a boundary directory that resolves where its parent writes (자식 Release가 부모가 기록하는 위치로 해석되는 boundary 디렉터리를 상속함)

권고입니다. 한 Release가 다른 Release를 확장하면서 그로부터 boundary의 출력 디렉터리를 상속하는데, 그 디렉터리에 템플릿 변수가 없습니다. 따라서 두 Release 모두 같은 경로로 해석되고, 자식을 빌드하면 부모를 빌드할 때와 같은 위치에 기록됩니다.

디렉터리를 상속하는 것은 실수가 아니라 지원되는 형태입니다. 디렉터리는 템플릿이므로 부모가 한 번 작성하면, 매개변수를 채우는 자식은 아무것도 중복하지 않고 이를 다른 곳으로 해석합니다. 자식이 부모의 boundary 토폴로지를 다시 기술할 필요가 없는 이유가 바로 이것입니다. 좁지만 실제로 존재하는 것은 이 권고가 가리키는 나머지 경우로, 변수가 없으면 다르게 해석될 것이 남아 있지 않습니다.

이 권고는 빌드를 중단할 수 없으며, 이는 신중함 때문이 아니라 규칙 자체의 속성입니다. 같은 해석 경로에 기록하는 것은 작성자가 정당하게 의도할 수 있는 일입니다. 예를 들어 렌더링 Recipes만 바꿔 출력을 비교하거나 크기 설정만 변경하는 자식이 그렇습니다. 따라서 이 추론으로 중단하는 규칙은 추측에 근거해 합법적인 입력을 거부하게 됩니다.

메시지는 다음으로 시작합니다:

inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to

해결 방법: 두 Release가 서로 다른 위치에 기록하도록 의도했다면, 디렉터리에 매개변수 참조를 넣고 각 Release가 이를 채우도록 합니다. 한 경로에 기록하는 것이 의도였다면 아무것도 바꿀 필요가 없습니다. 권고는 무엇이 일어날지 알려 주었을 뿐이며, 빌드는 어느 쪽이든 출력을 생성합니다.

빌드가 출력한 짧은 코드로 중단 찾기

중단 진단의 대괄호 머리는 실패의 원인이 되는 범주를 나타내며, 실패가 여기에 정리된 조건 중 하나를 가리키는 경우 그 조건의 짧은 코드도 나타냅니다. 짧은 코드는 [CATALOG_ERROR E0209]처럼 문자 E와 네 자리 숫자로 이루어집니다. 번호는 한 번 부여되면 고정되므로, 보고서나 검색에 붙여 넣은 짧은 코드는 기록한 시점에 가리키던 조건을 계속 가리킵니다. 조건이 가진 나머지 두 식별자와, 세 가지 중 어느 것을 언제 사용해야 하는지는 sentinels.md에서 설명합니다.

조건 자체의 메시지 줄은 조건을 서술하는 고정 문장으로 시작합니다. 그 문장 뒤의 모든 내용, 즉 문제가 된 문서, 작성된 키, 문제가 된 값, 해당 발생에 대한 조언은 발생마다 달라지며, 위의 각 항목은 해당 조건의 전체 형태를 인용합니다. 고정 문장은 매번 동일한 부분이므로 일치 검사에 사용할 부분입니다.

아래 표는 이 페이지 범위에서 둘을 짝지어 줍니다. 여기에 정리된 모든 조건에 대해 빌드가 출력하는 짧은 코드와 메시지 줄이 시작하는 문장을, 작성 측 해결 방법을 설명하는 위의 항목과 대응시킵니다. 항목 제목은 정확히 그대로 인용되므로, 이 페이지에서 제목을 검색하면 해당 항목으로 이동합니다. 모든 조건의 표는 여기의 항목이 다루지 않는 조건을 포함해 컴파일러가 선언하는 모든 조건에 대해 짧은 코드를 찾아 줍니다.

하나의 항목이 두 개의 짧은 코드에 대응하는 경우, 그 항목은 서로 다른 두 조건을 다루며 각 조건은 자체 문장을 등록합니다. 빌드가 어느 쪽을 보고했는지 구별하려면 공유된 제목이 아니라 문장을 읽으십시오.

aggrega explain <code>은 터미널에서 이 조회를 대신 수행하며, 조건의 두 코드 중 어느 것이든 받아 조건과 함께 그것을 설명하는 위 항목을 출력합니다. 자세한 내용은 aggrega explain에 설명되어 있습니다.

짧은 코드시작 문장설명 위치
E0001cliplugin: no plugin resolver configuredA command-line plugin runner was built without a way to find plugins (명령줄 플러그인 실행기가 플러그인을 찾는 방법 없이 구성됨)
E0003malformed attachment requirementMalformed attachment requirement (잘못된 형식의 연결 요구 사항)
E0004annotation contribution overridden by an explicit valueAn explicit value displaced one an annotation supplied (명시적 값이 어노테이션이 제공한 값을 대체함)
E0005policy violationA governance plugin rejected the build (거버넌스 플러그인이 빌드를 거부함)
E0006required attachment slot unfilledRequired attachment slot not bound (필수 연결 슬롯이 바인딩되지 않음)
E0007selector violationCross-node type safety violation via selector: (셀렉터를 통한 노드 간 타입 안전성 위반)
E0008attachment slot selector unsatisfiedThe Feature filling an attachment slot does not satisfy the slot’s selector (attachment 슬롯을 채우는 Feature가 슬롯의 selector를 충족하지 않음)
E0009pipeline step typed-I/O contract violationA pipeline step’s typed input or output does not satisfy its declared contract (파이프라인 단계의 타입 지정 입력 또는 출력이 선언된 계약을 충족하지 않음)
E0010pipeline step failedA pipeline step failed (파이프라인 단계가 실패함)
E0011pipeline patch targets a document not present in the setA pipeline patch addresses a document the set does not hold, or one with no tree to address (파이프라인 패치가 집합에 없는 문서 또는 지정할 트리가 없는 문서를 지정함)
E0012pipeline patch targets an opaque (non-structured) unitA pipeline patch addresses a document the set does not hold, or one with no tree to address (파이프라인 패치가 집합에 없는 문서 또는 지정할 트리가 없는 문서를 지정함)
E0013feature type mismatch between Aggregate and ReleaseFeature type mismatch between Aggregate and Release (Aggregate와 Release 간 Feature 타입 불일치)
E0014inject entry carries both `value:` and `from:`; schema requires exactly oneAn inject: entry carries both a literal and a source key (inject: 항목에 리터럴과 소스 키가 모두 있음)
E0015uses-edge inject dictates a delivery mechanism the socket does not permituses 엣지가 전달 방식을 하나도 허용 목록에 두지 않은 소켓에 전달을 지정함; uses 엣지가 소켓의 허용 목록에 없는 전달 메커니즘을 지정함
E0016jsonpatch: test operation failed패치의 test 연산이 문서와 일치하지 않음
E0017annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeysAn annotation-transform plugin names a component it was not given, or injects a value no annotation takes (annotation-transform 플러그인이 전달받지 않은 컴포넌트를 지정하거나, 어떤 어노테이션도 받지 않는 값을 주입함)
E0018policy attachment settings do not satisfy the plugin's declared settings schemaA governance attachment’s settings do not match the plugin’s declared schema (거버넌스 연결의 설정이 플러그인이 선언한 스키마와 일치하지 않음)
E0019endpoint requires form: referenceworkload: 형식과 그 옆의 필드가 일치하지 않음
E0020schedule is not a valid cron expression워크로드 schedule:이 검사가 허용하는 표현식이 아님
E0021persistentTemplate volume requires form: statefulworkload: 형식과 그 옆의 필드가 일치하지 않음
E0022pipeline PATCH target is not parseable structured YAML/JSONA pipeline step addresses documents the node does not have (파이프라인 단계가 노드에 없는 문서를 지정함)
E0023form: reference requires an endpointworkload: 형식과 그 옆의 필드가 일치하지 않음
E0024schedule requires form: scheduledworkload: 형식과 그 옆의 필드가 일치하지 않음
E0025form: scheduled requires a scheduleworkload: 형식과 그 옆의 필드가 일치하지 않음
E0026imported artifact content does not match the digest recorded for it in entity.lockAn imported artifact no longer matches the digest recorded beside its Recipe (가져온 아티팩트가 Recipe 옆에 기록된 다이제스트와 더 이상 일치하지 않음)
E0027artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)라이브러리 $import:가 bare-name 형식으로 작성되지 않았습니다
E0028artifacts output filename collision: two artifact outputs carry the same filenameTwo artifact outputs of one Recipe carry the same filename (한 Recipe의 두 아티팩트 출력이 같은 파일 이름을 가짐)
E0029artifact template references a pillar the Recipe does not declareartifacts: 템플릿이 Recipe가 선언하지 않은 필러를 읽음
E0030artifact-library import references a bundle not present in the ArtifactLibraryA library $import: names a library or an entry the catalog does not hold (라이브러리 $import:가 카탈로그에 없는 라이브러리나 항목을 지정함)
E0031artifact-library import references an ArtifactLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (라이브러리 $import:가 카탈로그에 없는 라이브러리나 항목을 지정함)
E0032assembled output collision: two contributors write the same output pathTwo contributors write the same output path (두 기여자가 같은 출력 경로에 기록함)
E0033assertion failedAn assertion stopped the build (어서션이 빌드를 중단함)
E0034duplicate delivery key across attachment-inject and another inject sourceAn attachment delivers a key another inject source already claimed (attachment가 다른 inject 소스가 이미 점유한 키를 전달함)
E0035provider expected to assemble its dispatch group provides no boundary assemblerThe plugin serving a provider cannot assemble what that provider combines (provider를 제공하는 플러그인이 해당 provider가 결합하는 출력을 조립할 수 없음)
E0036merged-path assembly has conflicting assembly-name annotation valuesChart-name mismatch on a merged helm-chart umbrella (병합된 helm-chart 상위 차트의 차트 이름 불일치)
E0037cross-boundary link between endpoints rendered by different providers is not supportedA connection crosses between two different providers’ assembled outputs (연결이 서로 다른 두 프로바이더의 조립된 출력 사이를 가로지름)
E0038derived name collision: one name is derived more than once in one key spaceThe same name is derived more than once inside the output (출력 안에서 같은 이름이 두 번 이상 도출됨)
E0039FeatureRecipe template references a per-component-only field with executionScope: boundaryFeatureRecipe template references a field outside its scope’s allowlist (FeatureRecipe 템플릿이 해당 범위의 허용 목록 밖의 필드를 참조함)
E0040library $import: carries a registry host; reference the library by bare-name identityA library $import: addresses its library by registry location (라이브러리 $import:가 레지스트리 위치로 라이브러리를 지정함)
E0041multiple contributors share an instance ID at the same dispatch pathInstance-ID collision across boundaries assembling to the same path (같은 경로로 조립되는 boundary 간 인스턴스 ID 충돌)
E0042locals entry references a sibling defined later in the same blocklocals: 항목이 같은 블록에서 나중에 정의된 형제 항목을 참조함
E0043template references a key the locals block does not declarelocals: key does not exist (해당 키가 존재하지 않음)
E0044mapping-library import references an entry not present in the MappingLibraryA library $import: names a library or an entry the catalog does not hold (라이브러리 $import:가 카탈로그에 없는 라이브러리나 항목을 지정함)
E0045valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)라이브러리 $import:가 bare-name 형식으로 작성되지 않았습니다
E0046mapping-library import references a MappingLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (라이브러리 $import:가 카탈로그에 없는 라이브러리나 항목을 지정함)
E0047assembled output retains an unresolved cross-boundary link placeholderAssembled output still carries a cross-boundary placeholder (조립된 출력에 경계 간 자리 표시자가 남아 있음)
E0048dispatch path produced multiple provider outputsPath collision: two contributors emit at incompatible paths (경로 충돌: 두 기여자가 호환되지 않는 경로에 출력함)
E0049path template references a field not in the documented allowlistPath-template references a variable outside the allowlist (경로 템플릿이 허용 목록 밖의 변수를 참조함)
E0050pipeline /host operation from a step with no host componentA pipeline step addresses documents the node does not have (파이프라인 단계가 노드에 없는 문서를 지정함)
E0051pipeline PATCH targets an assembler provider's pre-assembly fragmentsA pipeline patch addresses output that has not been assembled yet (파이프라인 패치가 아직 조립되지 않은 출력을 지정함)
E0052pipeline PATCH targets a document the node did not emitA pipeline step addresses documents the node does not have (파이프라인 단계가 노드에 없는 문서를 지정함)
E0053pipeline plugin is not compatible with the rendering providerA pipeline step’s plugin does not claim the provider rendering what it addresses (파이프라인 단계의 플러그인이 지정 대상을 렌더링하는 provider를 지원한다고 선언하지 않음)
E0054provider rejected node inputA provider refused a node’s input (provider가 노드의 입력을 거부함)
E0055Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declaresA Recipe or FeatureRecipe does not publish a provides key its contract declares (Recipe 또는 FeatureRecipe가 계약이 선언한 키를 게시하지 않음)
E0056provides template evaluation failedA provides: template could not be evaluated (provides: 템플릿을 평가할 수 없음)
E0057provides block references a root outside the self-contained setprovides: 템플릿이 자기 완결적이지 않은 루트를 참조함
E0058provider render is not deterministicA provider rendered the same input twice and produced different output (provider가 같은 입력을 두 번 렌더링하여 다른 출력을 생성함)
E0059duplicate delivery key across self-inject and uses-injectDuplicate delivery key across inject sources (inject 소스 간 전달 키 중복)
E0060template references a root the render context does not defineTemplate references a root the render context does not define (템플릿이 렌더링 컨텍스트에 정의되지 않은 루트를 참조함); Self-inject value template references cross-node data (Self-inject 값 템플릿이 노드 간 데이터를 참조함)
E0061unknown providerUnknown provider (알 수 없는 provider)
E0062custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMappingA component declares an inject mechanism the attached Feature maps nothing to (컴포넌트가 부착된 Feature가 아무것도 매핑하지 않는 inject 메커니즘을 선언함)
E0063workload-library import references an entry not present in the WorkloadLibraryA library $import: names a library or an entry the catalog does not hold (라이브러리 $import:가 카탈로그에 없는 라이브러리나 항목을 지정함)
E0064workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)라이브러리 $import:가 bare-name 형식으로 작성되지 않았습니다
E0065workload-library import references a WorkloadLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (라이브러리 $import:가 카탈로그에 없는 라이브러리나 항목을 지정함)
E0066uses edge target does not existDangling uses target (존재하지 않는 대상을 가리키는 엣지)
E0067active toggle did not resolve to a booleanactive: 토글이 true 또는 false로 해석되지 않음
E0068max sub-aggregate nesting depth exceededSub-aggregate nesting depth exceeded (하위 aggregate 중첩 깊이 초과)
E0069mutator patch rejectedA label-transform plugin’s patch reaches outside node labels (레이블 변환 플러그인의 패치가 노드 레이블 밖에 도달함)
E0070re-exported component alias forms a cycle재게시된 컴포넌트 별칭이 자기 자신을 가리킴
E0071release edge retargets a developer-declared edgeRelease retargets a developer-declared edge (Release가 개발자가 선언한 엣지의 대상을 변경함)
E0072sub-aggregate load failed컴포지션이 가져오는 모듈을 로드할 수 없거나 모듈이 자기 자신을 가져옴
E0073flattened node ID collision: rename one of the colliding instances so their flattened IDs differ두 인스턴스가 하나의 식별자로 평탄화됨
E0074release per-edge configuration has no edge to apply toRelease per-edge configuration has no edge to apply to (Release 엣지별 구성을 적용할 엣지가 없음)
E0075aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem)An Aggregate reached graph building without being normalised (Aggregate가 정규화되지 않은 채 그래프 빌드에 도달함)
E0076sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`하위 모듈의 컴포넌트가 어떤 경계에도 배치되지 않음
E0077uses edge target was pruned because its active toggle resolved to falseuses 엣지가 active: 토글로 제거된 컴포넌트를 대상으로 함
E0078producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption callA plugin asks the host to parse a source while a parse is already running for it (이미 파싱이 실행 중인 상태에서 플러그인이 호스트에 소스 파싱을 요청함)
E0079wasm: recorded command mirror does not match plugin describe()A Plugin entity’s recorded command set does not match the plugin (Plugin 엔터티에 기록된 명령 집합이 플러그인과 일치하지 않음)
E0080wasm: entity contract claim does not match plugin describe()A Plugin entity’s claims disagree with the plugin’s own self-report (Plugin 엔터티의 주장이 플러그인 자체 보고와 일치하지 않음)
E0081wasm: guest plugin returned a diagnostic whose severity the contract does not declareA plugin returned a diagnostic at a severity that is not declared (플러그인이 선언되지 않은 심각도의 진단을 반환했습니다)
E0082wasm: guest plugin reported an errorA plugin failed while it was running (플러그인이 실행 중에 실패했습니다)
E0083wasm: guest plugin panicked during callA plugin failed while it was running (플러그인이 실행 중에 실패했습니다)
E0084wasm: stamped host-function record does not match .wasm importsA Plugin entity’s recorded host functions do not match the binary (Plugin 엔터티에 기록된 호스트 함수가 바이너리와 일치하지 않음)
E0085wasm: plugin rejected by the sandboxThe sandbox refused a plugin (샌드박스가 플러그인을 거부함)
E0086wasm: plugin invoked proc_exitA plugin failed while it was running (플러그인이 실행 중에 실패했습니다)
E0087wasm: declared plugin type does not match plugin describe()A plugin is not the kind of plugin the socket expects (플러그인이 소켓이 기대하는 종류가 아님)
E0088wasm: entity metadata.version does not match plugin describe()A Plugin entity’s recorded version does not match the plugin (Plugin 엔터티에 기록된 버전이 플러그인과 일치하지 않음)
E0089every published version this reference could select has been withdrawnEvery version a reference could select has been withdrawn (참조가 선택할 수 있는 모든 버전이 철회됨)
E0090format is advertised by more than one importer pluginA parse or import format is advertised by more than one plugin (parse 또는 import 형식을 둘 이상의 플러그인이 알림)
E0091format is advertised by more than one parser pluginA parse or import format is advertised by more than one plugin (parse 또는 import 형식을 둘 이상의 플러그인이 알림)
E0092capability is served by more than one provider plugin; add a plugins.providers entry to select oneA capability is served by more than one provider plugin (하나의 capability를 둘 이상의 provider 플러그인이 지원함)
E0093manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguousManifest가 버전만 다른 두 키를 한 타입에 매핑함
E0094duplicate entity identity within a single catalog directoryTwo catalog entities in one directory share an identity (한 디렉터리의 두 카탈로그 엔터티가 같은 식별자를 가짐)
E0095malformed recipe reference in a Manifest mapping valueManifest mapping value is not a shape a recipe reference accepts (Manifest 매핑 값이 레시피 참조가 허용하는 형태가 아님)
E0096manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type keyRecipe implements does not match the mapped component type (Recipe의 구현 선언이 매핑된 컴포넌트 타입과 일치하지 않음)
E0097no importer plugin advertises the requested formatNo plugin advertises a requested parse or import format (요청된 parse 또는 import 형식을 알리는 플러그인이 없음)
E0098no parser plugin advertises the requested formatNo plugin advertises a requested parse or import format (요청된 parse 또는 import 형식을 알리는 플러그인이 없음)
E0099no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type컴포넌트 또는 기능 인스턴스에 매핑된 Recipe가 없음
E0100plugins.providers entry names a plugin no provider-rendering plugin serving the capability matchesA plugins.providers binding names a plugin that does not serve the capability (바인딩이 해당 capability를 제공하지 않는 플러그인을 지정함)
E0101no provider-rendering plugin version satisfies the recipe's provider version pinNo provider plugin version satisfies a Recipe’s provider pin (Recipe의 provider 고정을 만족하는 provider 플러그인 버전이 없음)
E0102wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact pathA plugin reference carries a registry host or an artifact path (플러그인 참조에 레지스트리 호스트나 아티팩트 경로가 포함됨)
E0103no catalog version satisfies the referenced version constraintNo catalog version satisfies a version constraint (버전 제약을 만족하는 카탈로그 버전이 없음)
E0104wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI locationA plugin or recipe reference carries no scope (플러그인 또는 레시피 참조에 범위가 없음)
E0105recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI locationA plugin or recipe reference carries no scope (플러그인 또는 레시피 참조에 범위가 없음)
E0106resolve: invalid library reference URIA library reference is not written in the identity form (라이브러리 참조가 식별자 형식으로 작성되지 않음)
E0107resolve: minimal version selection conflict — incompatible library version requirementsTwo consumers of one library require incompatible versions (한 라이브러리의 두 소비자가 호환되지 않는 버전을 요구함)
E0108resolve: catalog lookup cannot load resolved sub-aggregate bodiesThe catalog view a build was given cannot load the bodies pinning needs (빌드에 주어진 카탈로그 뷰가 고정에 필요한 본문을 불러올 수 없음)
E0109resolve: catalog lookup cannot load resolved recipe and plugin bodiesThe catalog view a build was given cannot load the bodies pinning needs (빌드에 주어진 카탈로그 뷰가 고정에 필요한 본문을 불러올 수 없음)
E0110resolve: source-template evaluation failure at lock timesource: 좌표를 해석하면 더 좁은 함수 집합이 등록됩니다
E0111resolve: source-template parse errorsource: 좌표를 해석하면 더 좁은 함수 집합이 등록됩니다
E0112resolve: source-template references .provides (invalid reverse reference)source: 좌표를 해석하면 더 좁은 함수 집합이 등록됩니다
E0113resolve: sub-aggregate inclusion depth exceededThe chain of module imports is deeper than the pin walk descends (모듈 import 체인이 고정 순회가 내려가는 깊이보다 깊음)
E0114resolve: no entity in the catalog matches this URIA reference names no entity the catalog holds (참조가 카탈로그에 없는 엔터티를 가리킴)
E0115compactform: ambiguous dispatch — $mode requiredA compact-form schema declares a field literally named type (compact form 스키마가 문자 그대로 type이라는 이름의 필드를 선언함)
E0116compactform: constraint not valid for declared typeA compact-form constraint does not apply to the type it was written on (compact-form 제약 조건이 작성된 타입에 적용되지 않음)
E0117compactform: $jsonschema content invalidA $jsonschema: escape carries content that is not a schema ($jsonschema: 탈출구가 스키마가 아닌 내용을 담고 있음)
E0118compactform: cross-document $ref carries a registry host; reference the library by identity$ref:가 레지스트리 위치로 라이브러리를 지정함
E0119compactform: $ref unresolvable$ref:가 컴파일러가 해석할 수 있는 형식으로 작성되지 않음
E0120compactform: unknown keywordA compact-form schema uses a keyword the compact form does not know (compact-form 스키마가 compact form이 알지 못하는 키워드를 사용함)
E0121compactform: cross-document $ref target not found$ref:가 컴파일러가 해석할 수 있는 형식으로 작성되지 않음
E0122deprecation: build consumes a deprecated entityThe build consumes an artifact its publisher has deprecated (빌드가 게시자가 사용 중단한 아티팩트를 사용함)
E0123docscache: artifact is not a documentation bundleA resolved artifact is not a documentation bundle (해석된 아티팩트가 문서 번들이 아님)
E0124docscache: page not found in documentation bundleA page is absent from a documentation bundle (문서 번들에 페이지가 없음)
E0125egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cacheThe workspace is offline and the step needs the network (워크스페이스가 오프라인인데 단계에 네트워크가 필요함)
E0126externalinputs: acquisition is disabled for unpinned inputsA render requests an external input the lockfile does not pin (렌더링이 lockfile에 고정되지 않은 외부 입력을 요청합니다)
E0127externalinputs: fetched bytes mismatch the pinned digestFetched bytes do not match a pinned digest (가져온 바이트가 고정된 다이제스트와 일치하지 않습니다)
E0128externalinputs: URL scheme is not allowedAn external input’s URL uses a scheme that is not allowed (외부 입력의 URL이 허용되지 않는 스킴을 사용합니다)
E0129externalinputs: store blob mismatches its pinned recordA stored external input no longer matches its record (저장된 외부 입력이 더 이상 기록과 일치하지 않습니다)
E0130lockfile: out of date; it no longer matches what its Release resolves toThe lockfile no longer matches what the release resolves to (lockfile이 더 이상 릴리스가 해석되는 결과와 일치하지 않음)
E0131lockfile: file failed schema validationThe lockfile does not satisfy its schema (락파일이 스키마를 충족하지 않음)
E0132oci: manifest has multiple layers of the expected content media typeA manifest carries no layer of the expected kind, or more than one (매니페스트에 예상한 종류의 레이어가 없거나 둘 이상 있음)
E0133oci: cached manifest digest mismatchFetched or cached bytes do not match the digest committed for them (가져오거나 캐시된 바이트가 해당 바이트에 대해 확정된 다이제스트와 일치하지 않음)
E0135oci: content digest mismatchFetched or cached bytes do not match the digest committed for them (가져오거나 캐시된 바이트가 해당 바이트에 대해 확정된 다이제스트와 일치하지 않음)
E0136oci: network unreachableThe registry could not be reached (레지스트리에 도달할 수 없음)
E0137oci: artifact not found at remote sourceAn artifact is not at the source the build was told to find it (아티팩트가 빌드가 찾도록 지시받은 소스에 없음)
E0138oci: authentication required or failedThe registry will not serve an artifact without credentials it accepts (레지스트리가 수락하는 자격 증명 없이는 아티팩트를 제공하지 않음)
E0139oci: tag already published with different content태그가 이미 다른 내용으로 게시됨
E0140oci: manifest has no layer of the expected content media typeA manifest carries no layer of the expected kind, or more than one (매니페스트에 예상한 종류의 레이어가 없거나 둘 이상 있음)
E0141oci: distinct catalog identities map to the same OCI repository locationTwo catalog identities publish to one repository location (두 카탈로그 아이덴티티가 하나의 리포지토리 위치로 게시됨)
E0142oci: referrer discovery could not be completedThe registry could not answer what is attached to an artifact (레지스트리가 아티팩트에 무엇이 첨부되어 있는지 응답하지 못함)
E0143oci: unknown entity kind for mediatype dispatchAn entity kind has no artifact media type (엔티티 종류에 아티팩트 미디어 타입이 없음)
E0144cached signature bundle does not match its recorded digestA cached signature bundle does not match the digest recorded for it (캐시된 서명 번들이 해당 번들에 기록된 다이제스트와 일치하지 않음)
E0145plugin reference is not a Plugin entityA plugin reference is not a Plugin entity (플러그인 참조가 Plugin 엔터티가 아님)
E0146circular reference expansionA library reference expands into itself (라이브러리 참조가 자기 자신으로 확장됨)
E0147registrytrust: advertised trust config is malformedA registry serves a trust document that cannot be read as one (레지스트리가 신뢰 문서로 읽을 수 없는 신뢰 문서를 제공함)
E0148registrytrust: registry advertises no trust configA registry publishes no trust document (레지스트리가 신뢰 문서를 게시하지 않음)
E0149attachment name is a near miss for a declared slot어태치먼트 이름이 선언된 슬롯과 한 번의 편집 차이임
E0150attachment does not conform to its declared slot shapeAttachment does not conform to its declared slot shape (첨부가 선언된 슬롯 형태에 맞지 않음)
E0151component declared in more than one boundary: declare each component in exactly one boundaryA component is placed in more than one boundary (컴포넌트가 둘 이상의 경계에 배치됨)
E0152duplicate Aggregate/Manifest identity (metadata.name) in the Release directoryThe Release directory declares one Aggregate or Manifest twice (Release 디렉터리가 하나의 Aggregate 또는 Manifest를 두 번 선언함)
E0153feature merge conflict: reconcile the Aggregate and Release declarations for the featureA feature attached by both the Aggregate and the Release cannot be merged (Aggregate와 Release 양쪽에서 연결된 기능을 병합할 수 없음)
E0154the compiler's own views of the catalog disagreeA guard needs a catalog entity the build resolved and cannot see (가드가 빌드가 해석했지만 볼 수 없는 카탈로그 엔터티를 필요로 합니다)
E0155duplicate delivery key across inject sourcesDuplicate delivery key across inject sources (inject 소스 간 전달 키 중복)
E0156invalid inject key: the from-key must name a provides key its source publishesInject from key is not in the target’s provides (Inject 키가 대상이 제공하는 키에 없음)
E0158invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go templateA {{ .parameters.* }} reference cannot be interpolated (parameters 참조를 보간할 수 없음)
E0160manifest annotation bindings collide on same Feature path+pillarTwo Manifest annotation bindings compete for one routing slot (두 Manifest 어노테이션 바인딩이 하나의 라우팅 슬롯을 두고 경합함)
E0161manifest annotation binding uses reserved prefixA Manifest annotation binding claims the reserved aggrega.ai/ prefix (Manifest 어노테이션 바인딩이 예약된 접두사를 사용함)
E0162missing required feature: attach a Feature of the required type to the componentRequired feature not attached (필수 feature가 연결되지 않음)
E0163required uses socket not populatedRequired uses: socket not populated (필수 소켓이 채워지지 않음)
E0164parameter contract violatedParameter type mismatch / contract violation (매개변수 타입 불일치 / 계약 위반)
E0165required parameter not suppliedParameter type mismatch / contract violation (매개변수 타입 불일치 / 계약 위반)
E0167Recipe publishes a provides key its Component does not declareRecipe가 Component가 선언하지 않은 provides 키를 게시함
E0168authored pillar does not conform to its declared schemaAuthored values or infra do not conform to the declared schema (작성된 values 또는 infra가 선언된 스키마를 따르지 않음)
E0169self-inject on component without spec.inject allowlistSelf-inject on a component without an allowlist (허용 목록이 없는 컴포넌트에 대한 self-inject); Self-inject mechanism not in the component’s allowlist (컴포넌트의 허용 목록에 없는 self-inject 메커니즘)
E0170aggregate/manifest reference unresolvableA Release’s aggregate: or manifest: reference resolves to nothing (Release의 aggregate 또는 manifest 참조가 아무것으로도 해석되지 않음)
E0171unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declareuses: socket not declared in the owning entity’s usesSchema (소유 엔티티의 usesSchema에 선언되지 않은 uses: 소켓)
E0172release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)A Release reached resolution without passing through the load path (Release가 로드 경로를 거치지 않고 해석 단계에 도달함)
E0173declared parameter is read by no reference in the Aggregate선언된 파라미터를 아무것도 읽지 않음
E0174uses socket name is a near miss for a declared socketuses: 소켓 이름이 선언된 소켓과 한 번의 편집 차이임
E0175file load failed: the file could not be read, or its bytes did not parseA file cannot be read, or its bytes do not parse (파일을 읽을 수 없거나 그 바이트가 파싱되지 않음)
E0176signing: keyless signing requires a live identity provider, Fulcio, and RekorKeyless signing was asked for without the services it needs (필요한 서비스 없이 키리스 서명이 요청됨)
E0177signing: no signature found for an artifact that requires oneAn artifact that must be signed carries no signature (서명되어야 하는 아티팩트에 서명이 없음)
E0178signing: keyless verification requires at least one trusted identityA keyless trust policy names no acceptable signer (키리스 신뢰 정책이 허용 가능한 서명자를 지정하지 않음)
E0179signing: signature does not verifyA detached signature does not verify against the key supplied (분리 서명이 제공된 키로 검증되지 않음)
E0180signing: signature bundle does not verifyA signature does not verify (서명이 검증되지 않음)
E0181signing: signing policy requires a signature for this artifact kind; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature (서명되지 않은 게시가 서명을 요구하는 레지스트리나 정책을 대상으로 함)
E0182signing: cannot load pinned trust rootThe pinned trust root cannot be read (고정된 신뢰 루트를 읽을 수 없음)
E0183signing: registry requires signatures; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature (서명되지 않은 게시가 서명을 요구하는 레지스트리나 정책을 대상으로 함)
E0184signing: unsupported held-key typeA pinned verification key is not the key profile the verifier accepts (고정된 검증 키가 검증기가 허용하는 키 프로필이 아님)
E0185signing: signature identity is not trusted for this registryA signature verifies but its signer is not one the registry trusts (서명은 검증되지만 서명자가 레지스트리가 신뢰하는 대상이 아님)
E0186no source adapter serves the source kindRecipe의 source:가 획득 방법을 아는 것이 없는 kind를 지정함
E0187cacheslot: empty workspaceRootA source artifact is cached without a workspace root to anchor it (기준이 될 워크스페이스 루트 없이 소스 아티팩트가 캐시됨)
E0188artifacts entry: shape must be a string scalar or {$import: <local-path>}An inline-or-import field is written in neither shape (인라인 또는 가져오기 필드가 두 형태 중 어느 것으로도 작성되지 않음)
E0189artifactlibrary: entry must be a mapping of filename to a string bodyA library entry’s body is not the shape that library holds (라이브러리 항목의 본문이 해당 라이브러리가 담는 형태가 아님)
E0190schemalibrary: forbidden JSON Schema keywordA schema uses a JSON Schema keyword the library does not admit (스키마가 라이브러리에서 허용하지 않는 JSON Schema 키워드를 사용함)
E0191mappinglibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds (라이브러리 항목의 본문이 해당 라이브러리가 담는 형태가 아님)
E0192a document nests too many levels deepA document nests deeper than the reader will descend (문서가 리더가 내려갈 수 있는 깊이보다 깊게 중첩됨)
E0193parameters: shape must be an inline object or {$import: <local-path>}A Release’s parameters: block is written in neither of its two shapes (Release의 parameters: 블록이 두 형태 중 어느 것으로도 작성되지 않음)
E0194schemalibrary: template not found$instantiate: 참조를 해석할 수 없음
E0195schemalibrary: template parameter missing$instantiate: 참조를 해석할 수 없음
E0196schemalibrary: template parameter type mismatch$instantiate: 참조를 해석할 수 없음
E0197valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape (인라인 또는 가져오기 필드가 두 형태 중 어느 것으로도 작성되지 않음)
E0198wellKnownAnnotations: a key is declared at a scope the provider's contract does not renderA provider declares a well-known annotation at a scope it does not render (provider가 렌더링하지 않는 범위에서 잘 알려진 어노테이션을 선언함)
E0199workloadlibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds (라이브러리 항목의 본문이 해당 라이브러리가 담는 형태가 아님)
E0200workload: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape (인라인 또는 가져오기 필드가 두 형태 중 어느 것으로도 작성되지 않음)
E0201assertion name declared twice across the extends chainAn assertion name is declared twice along an extends: chain (extends 체인에서 assertion 이름이 두 번 선언됨)
E0202cyclic extends chainCyclic extends chain (순환하는 extends 체인); Cyclic extends on Components or Features (Components 또는 Features의 순환 extends)
E0204FeatureRecipe: valuesMapping requires sourceA FeatureRecipe’s valuesMapping requires source (FeatureRecipe의 valuesMapping에는 source가 필요합니다)
E0205inheritance merge failedAn extends: chain cannot be assembled (extends 체인을 구성할 수 없음)
E0207recipe output-component-labels constraint: key is also declared in outputLabelsA promoted component label is also declared literally (승격된 컴포넌트 레이블이 리터럴로도 선언되어 있습니다)
E0208recipe output-labels constraint: key uses a reserved namespaceAn output-label key uses a reserved namespace (출력 레이블 키가 예약된 네임스페이스를 사용합니다)
E0209Recipe: valuesMapping requires sourcevaluesMapping requires source (valuesMapping에는 source가 필요함)
E0210Recipe: at least one input kind requiredAt least one input kind must be present (입력 종류가 하나 이상 있어야 함)
E0211filename collision across input kinds: two input-kind blocks produced a file under one output nameEmission-time filename collision across input kinds (출력 시점에 입력 종류 간 파일 이름 충돌)
E0212workload attachment slot is not referenceableA Workload references a slot whose fill publishes no locator (Workload가 채움이 로케이터를 게시하지 않는 슬롯을 참조함)
E0213workload featuresSchema cross-check failedA Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Workload 연결이 엔터티가 선언하지 않은 슬롯이나 슬롯이 금지하는 전달 방식을 지정함)
E0214workload validation failedA Workload does not satisfy the Workload schema (Workload가 Workload 스키마를 충족하지 않음)
E0215document envelope validation failedYAML anchor aliased inside its own content (YAML 앵커가 자체 내용 안에서 별칭으로 참조됨); Divergent Release (extends + aggregate pointer) (분기된 Release(extends + aggregate 포인터))
E0216validator/jsonschema: x-aggrega extension evaluation failedAn x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (두 확장 키워드 중 하나의 술어를 평가할 수 없음)
E0218validator/jsonschema: schema resolution failedA declared schema cannot be resolved (선언된 스키마를 해석할 수 없음)
E0220extends chain exceeds maximum depthAn extends: chain runs past the depth bound (extends 체인이 깊이 한도를 넘음)
E0221merger: invalid merge input스키마 병합 단계 자체의 입력 보호 장치
E0222registry alias matches more than one hostA registry alias matches more than one host (레지스트리 별칭이 둘 이상의 호스트와 일치함)
E0223a cross-cutting socket is bound by capability but attaches by uriA plugin binding sets a key the socket it attaches to does not read (플러그인 바인딩이 연결된 소켓이 읽지 않는 키를 설정함)
E0224workspace configuration is invalidThe workspace configuration is invalid (워크스페이스 구성이 유효하지 않습니다)
E0225capability is bound to more than one provider pluginA capability is bound to more than one provider plugin (capability가 둘 이상의 프로바이더 플러그인에 바인딩됨)
E0226registry alias is already used by another hostA registry alias is already bound to another host (레지스트리 별칭이 이미 다른 호스트에 바인딩됨)
E0227a governance attachment declares no role or an unknown roleA governance attachment declares no role, or one that is not a known role (거버넌스 연결이 역할을 선언하지 않았거나 알려지지 않은 역할을 선언함)
E0228a provider socket binding sets a field with no referent on that socketA plugin binding sets a key the socket it attaches to does not read (플러그인 바인딩이 연결된 소켓이 읽지 않는 키를 설정함)
E0229position out of rangeAn editor position falls outside the document (편집기 위치가 문서 범위를 벗어남)
E0246the digest recorded as trusted for this plugin does not match the digest its cached manifest reportsA trusted plugin’s recorded digest disagrees with the cached artifact (신뢰된 플러그인의 기록된 다이제스트가 캐시된 아티팩트와 일치하지 않음)
E0247a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict roleA plugin recorded as a trusted gate is no longer attached (신뢰된 게이트로 기록된 플러그인이 더 이상 연결되어 있지 않음)
E0248wasm: guest plugin returned an output that is not the shape the socket readsA plugin returned something that is not the shape the socket reads (플러그인이 소켓이 읽는 형태가 아닌 것을 반환했습니다)
E0250provider named a directory for each contributor's own sub-directory that is not a single directory nameA provider named a directory for a contributor that is not one directory (provider가 기여자에 대해 단일 디렉터리가 아닌 디렉터리를 지정함)
E0251recipe source is an empty string, which names neither sourceless mode nor sourced modeRecipe source:가 빈 문자열임
E0252artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested underAn ArtifactLibrary bundle file names no file of its own under the key it was imported at (ArtifactLibrary 번들 파일이 가져온 키 아래에 자체 파일을 지정하지 않음)
E0253annotation binding does not resolve against its target FeatureAnnotation binding does not resolve against its target Feature (어노테이션 바인딩이 대상 Feature에 대해 해석되지 않음)
E0254annotation subkey does not conform to the target Feature's schema at the routed pillarA bound annotation value does not conform to the target Feature’s schema (바인딩된 어노테이션 값이 대상 Feature의 스키마를 따르지 않음)
E0255annotation routes through a pillar its authoring side may not useAn annotation routes through a pillar its authoring side may not use (어노테이션이 작성 측에서 사용할 수 없는 필러를 통해 라우팅됨)
E0256annotation binding declares one path in both pillar lists어노테이션 바인딩이 하나의 경로를 두 pillar 목록 모두에 선언함
E0257declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validationA declared schema contract cannot be read as a schema (선언된 스키마 계약을 스키마로 읽을 수 없음)
E0259attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares itA boundary-scope Feature is attached only to a component (경계 범위 Feature가 컴포넌트에만 연결됨)
E0260component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`A component the composition holds is placed in no boundary (컴포지션이 보유한 component가 어떤 경계에도 배치되지 않음)
E0261boundary names a component the composition does not hold: correct the name, or remove the entry경계가 구성에 없는 컴포넌트를 지정함
E0262component identity cannot be the name its emitted resources are stamped with: rename the componentComponent identity cannot be stamped on what it emits (컴포넌트 식별자를 그 컴포넌트가 내보내는 리소스에 새길 수 없음)
E0263the target will not accept a name derived from this component's authored identity: rename the componentThe target will not accept a name derived from an authored identity (대상이 작성된 식별자에서 파생된 이름을 받아들이지 않음)
E0264provider guest never accepted a component identity the compiler composed for itA provider never accepted a name the compiler composed (provider가 컴파일러가 구성한 이름을 끝내 받아들이지 않음)
E0265provider does not support the node's input kindworkload: requires a provider that can synthesize (workload:에는 합성할 수 있는 provider가 필요함)
E0266a schema `$import:` could not be appliedA schema $import: cannot be applied (스키마 가져오기 지시문을 적용할 수 없음)
E0267a schema block declares a key that names no data pillarA schema block names a key that is not a data pillar (스키마 블록이 데이터 필러가 아닌 키를 지정함)
E0268reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokensA provider’s reassembly is handed a unit its own carve never produced (provider의 재조립에 자체 분할이 만든 적 없는 단위가 전달됨)
E0269provider guest returned two output files under one path; a conforming guest returns each output path at most onceA provider returned two output files under one path (provider가 하나의 경로에 두 개의 출력 파일을 반환했습니다)
E0270link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returnedA provider’s link wiring names an output file that was never emitted (프로바이더의 링크 연결이 출력된 적 없는 출력 파일을 지정함)
E0271emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and contentA pipeline step’s file emission carries no file (파이프라인 단계의 파일 출력에 파일이 없음)
E0272side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crdA pipeline step declares an emission kind the contract does not define (파이프라인 단계가 계약에 정의되지 않은 출력 종류를 선언함)
E0273template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider supplies템플릿이 노드의 provider가 보고하지 않는 렌더링된 이름을 읽음
E0274the plugin identity recorded as trusted no longer matches what this resolution reportsA gate recorded as trusted resolves to a different identity (신뢰된 것으로 기록된 게이트가 다른 동일성으로 해석됨)
E0275the edit was refused because the resulting document would not be valid, and nothing was writtenAn edit would produce a document its schema refuses (편집 결과 문서가 스키마에서 거부됨)
E0276the version being published changes the published predecessor in a way the documented evolution rubric objects to게시하려는 변경이 진화 기준표가 허용하는 범위를 벗어남
E0277an annotation key on the entity uses a prefix the platform reservesAn annotation key uses a prefix the platform reserves (어노테이션 키가 플랫폼이 예약한 접두사를 사용함)
E0278the entity's name does not follow the documented name shape for its kindAn entity’s name does not follow the shape its kind expects (엔터티의 이름이 해당 종류가 기대하는 형태를 따르지 않음)
E0279a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot followA schema uses a dynamic reference that cannot be resolved ahead of time (스키마가 사전에 해석할 수 없는 동적 참조를 사용함)
E0280a schema in the entity declares an identifier of its own, where the platform owns that schema's identityA schema declares an identifier the platform owns (스키마가 플랫폼이 소유한 식별자를 선언함)
E0281the entity's category label does not match the category directory the entity is filed underA Component’s category label and its directory name different categories (Component의 카테고리 레이블과 디렉터리가 서로 다른 카테고리를 가리킴)
E0282the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchemaA schema extension is written directly into schema content (스키마 확장이 스키마 내용에 직접 작성됨)
E0283the Plugin entity declares no runtime resource cap of its own, so the platform defaults applyA Plugin pins neither runtime cap, so the platform’s own apply (Plugin이 런타임 상한을 하나도 고정하지 않아 플랫폼 자체의 상한이 적용됨)
E0284an attachment slot admits only secret material and does not declare that it handles itAn attachment slot admits only secret material without saying it handles it (어태치먼트 슬롯이 시크릿 자료만 허용하면서 이를 다룬다고 밝히지 않음)
E0285the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refusedA Recipe publishes a provides key its Component does not declare, checked at publication (Recipe가 해당 Component에서 선언하지 않은 provides 키를 게시함, 게시 시점에 검사됨)
E0286the version bump being published is smaller than the evolution check's classification of the change requires제시된 버전 증가가 변경에 필요한 것보다 작음
E0287the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files가져오기가 소스를 변환하는 도중에 중단됨
E0288a plugin has no expression for a construct this build declaresA workload declares a form compose cannot express (workload가 compose로 표현할 수 없는 형태를 선언함); A container declares a field compose has no primitive for (컨테이너가 compose에 해당 기본 요소가 없는 필드를 선언함); An omits entry names a kind or a namespace a compose file does not have (omits 항목이 compose 파일에 없는 종류나 네임스페이스를 지정함); An omits entry names a namespace a CloudFormation template does not have (omits 항목이 CloudFormation 템플릿에 없는 네임스페이스를 지정함); A rule reads a bound CloudFormation parameter by name (규칙이 바인딩된 CloudFormation 파라미터를 이름으로 읽음); The assembled CloudFormation stack cannot carry a transform (조립된 CloudFormation 스택이 transform을 담을 수 없음)
E0289a plugin could not resolve something it requires to exactly one valueA health probe cannot be turned into a compose healthcheck (헬스 프로브를 compose healthcheck로 변환할 수 없음); A configmap volume has no file behind it (configmap 볼륨에 대응하는 파일이 없음); What an omits entry left out is still named by the compose file (omits 항목이 제외한 것을 compose 파일이 여전히 지정함); What an omits entry left out is still named by a CloudFormation template (omits 항목이 제외한 것을 CloudFormation 템플릿이 여전히 지정함); A valuesMapping key names no parameter of a sourced CloudFormation template (valuesMapping 키가 소스로 가져온 CloudFormation 템플릿의 어떤 파라미터도 지정하지 않음); Another component references a CloudFormation parameter a sourced template’s binding filled (다른 컴포넌트가 소스로 가져온 템플릿의 바인딩이 채운 CloudFormation 파라미터를 참조함); Two components order one pair of transforms oppositely (두 컴포넌트가 한 쌍의 transform을 반대 순서로 지정함); A cross-boundary reference has no consuming stack to be written into (경계 간 참조를 기록할 소비 스택이 없음); A synthesized StatefulSet has no single service to govern it (합성된 StatefulSet을 관리할 단일 서비스가 없음)
E0290two things a plugin produced occupy one name in its outputAn authored export name is one the build derives for a cross-stack reference (작성된 export 이름이 빌드가 스택 간 참조용으로 파생하는 이름과 같음); The output a cross-stack reference publishes on already carries an Export (스택 간 참조가 게시되는 출력에 이미 Export가 있음); Two entries reach one stack output name (두 항목이 하나의 스택 출력 이름에 도달함); A CloudFormation fragment writes one key twice (CloudFormation 조각이 하나의 키를 두 번 작성함); Two rendered resources land at one output file (렌더링된 두 리소스가 하나의 출력 파일에 놓임)
E0291a plugin has no representation for a value it was givenA published port declares a transport compose cannot spell (게시된 포트가 compose로 표기할 수 없는 전송 방식을 선언함); A resources quantity cannot be converted to a compose value (resources 수량을 compose 값으로 변환할 수 없음); A resource quantity the helm provider emits is not a quantity (helm provider가 내보내는 리소스 수량이 수량이 아님); A service type the helm provider cannot render (helm provider가 렌더링할 수 없는 서비스 타입); A Kubernetes version the helm provider cannot render a chart for (helm provider가 차트를 렌더링할 수 없는 Kubernetes 버전); A value bound to a CloudFormation parameter cannot take the parameter’s type (CloudFormation 파라미터에 바인딩된 값이 파라미터의 타입을 가질 수 없음); A value bound to a CloudFormation parameter is one its constraints refuse (CloudFormation 파라미터에 바인딩된 값을 제약 조건이 거부함); A secret bound to a CloudFormation parameter would be written into the template (CloudFormation 파라미터에 바인딩된 시크릿이 템플릿에 기록됨); A dynamic reference is bound where CloudFormation does not resolve it (CloudFormation이 해석하지 않는 위치에 동적 참조가 바인딩됨); A cross-boundary reference was spliced into a longer string (경계 간 참조가 더 긴 문자열에 이어 붙여짐)
E0292a plugin reported a failure that none of the declared kinds namesA plugin reported a failure it did not classify (플러그인이 분류하지 않은 실패를 보고함)
E0293wasm: guest plugin named a condition the socket does not declareA plugin named a condition the socket does not declare (플러그인이 소켓이 선언하지 않은 조건을 지정함)
E0294components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identity두 서브시스템이 하나의 이름으로 컴포넌트를 선언함
E0295library reference: a reference to a library entry carries no whitespace or line breakA reference to a library entry carries whitespace (라이브러리 항목에 대한 참조에 공백이 포함됨)
E0296release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never bothA Release chain’s links disagree about the routing shape (Release 체인의 링크가 라우팅 형태에 대해 일치하지 않음)
E0297inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes toA child Release inherits a boundary directory that resolves where its parent writes (자식 Release가 부모가 기록하는 위치로 해석되는 boundary 디렉터리를 상속함)
E0298oci: published bundle carries no entity documentA published bundle holds no entity, or holds two (게시된 번들에 엔터티가 없거나 두 개 있음)
E0299oci: published bundle carries more than one entity documentA published bundle holds no entity, or holds two (게시된 번들에 엔터티가 없거나 두 개 있음)
E0300oci: published bundle cannot be unpackedA published artifact cannot be read as an entity (게시된 아티팩트를 엔터티로 읽을 수 없음)
E0301oci: published artifact is not an entity documentA published artifact cannot be read as an entity (게시된 아티팩트를 엔터티로 읽을 수 없음)
E0302an input the entity reads has no pin recorded for it in the entity.lock beside itAn entity reads an input the lock beside it records no pin for (엔터티가 옆의 lock에 pin이 기록되지 않은 입력을 읽음)
E0303the entity shares its directory with another entity, and an entity of its kind has a directory of its own엔터티가 다른 엔터티와 디렉터리를 공유함
E0304a path names content outside the entity's own directoryA path names content outside the entity’s own directory (경로가 엔티티 자체 디렉터리 밖의 콘텐츠를 가리킴)
E0305the files of the entity's local source do not match the pins recorded for them in entity.lockA local source no longer matches the pins recorded beside its Recipe (로컬 소스가 Recipe 옆에 기록된 핀과 더 이상 일치하지 않음)
E0306plugin artifact not found on this machineA plugin’s .wasm is not on this machine (플러그인의 모듈 파일이 이 머신에 없음)
E0307a value a cache location is built from would place cached files outside the place it names in the cacheA value would place a cached file outside the cache (값이 캐시된 파일을 캐시 밖에 둠)
E0308a Feature reaches a component alongside a Feature it declares a conflict withTwo Features declared to conflict reach one component (충돌하도록 선언된 두 Features가 하나의 컴포넌트에 도달함)
E0309a symbolic link sits among the files an entity carriesA symbolic link sits among the files an entity carries (엔터티가 포함하는 파일 중에 심볼릭 링크가 있음)
E0310a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>`고정할 신뢰 정책 없이 오프라인으로 레지스트리를 추가함
E0311reference carries a malformed version pinA version pin is none of the forms a pin takes (버전 고정이 고정이 취하는 어떤 형태에도 해당하지 않음)
E0312a provider socket binding names a capability containing a colon, which no Recipe can selectA provider binding names a capability containing a colon (프로바이더 바인딩이 콜론을 포함한 capability를 지정함)
E0313plugins.providers entry names a capability no provider-rendering plugin the build reads servesprovider 바인딩이 빌드가 읽는 어떤 플러그인도 제공하지 않는 기능을 지정함
E0314plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reportsA plugin was built from a working tree with uncommitted changes (커밋되지 않은 변경 사항이 있는 작업 트리에서 플러그인이 빌드됨)
E0315a connection carries an attachment under a name its socket declares no slot forA connection carries an attachment under a name its socket declares no slot for (연결이 소켓에 슬롯이 선언되지 않은 이름으로 첨부를 가짐)
E0316a Release attachment takes the name of an attachment one of a component's connections carriesA Release attachment takes the name of a connection’s attachment (Release 첨부가 연결 첨부의 이름을 사용함)
E0317a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makesA Release connection attachment names no Feature type (Release 연결 첨부가 Feature 유형을 지정하지 않음)
E0318duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already deliveredTwo attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (부착된 두 Features가 하나의 키를 전달하며, 나중 것이 FeatureRecipe의 injectMapping을 통해 전달함)
E0319connection alias is already used by another connection of the same componentTwo connections of one component under one alias (한 컴포넌트의 두 연결이 하나의 별칭을 사용함)
E0320a path this operation writes or deletes leads through a link out of the directory it must stay insideA path the operation writes leads through a link out of the directory it must stay inside (작업이 쓰는 경로가 링크를 거쳐 머물러야 할 디렉터리 밖으로 이어짐)
E0321a file this operation reads leads through a link out of the directory it must stay insideA file the operation reads leads through a link out of the directory it must stay inside (작업이 읽는 파일이 링크를 통해 머물러야 하는 디렉터리 밖으로 이어짐)
E0323template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFacts템플릿이 선언 없이 호출자의 렌더 팩트를 읽음
E0324a reference a document makes to another file leads out of the directory it must stay insideA reference to another file leads out of the directory it must stay inside (다른 파일에 대한 참조가 머물러야 하는 디렉터리 밖으로 이어짐)
E0325provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entryA provider reported a render fact whose value is not a list (프로바이더가 값이 리스트가 아닌 렌더 사실을 보고함)
E0326pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render factsA pipeline step reads its callers’ render facts (파이프라인 단계가 호출자의 렌더 사실을 읽음)
E0327template indexes a map with a key the map does not holdA template indexes a map with a key the map does not hold (템플릿이 맵에 없는 키로 맵을 인덱싱함)
E0328attachment written under a name no slot declares fits a slot its component leaves emptyAn attachment written under another name fits a slot its component leaves empty (다른 이름으로 작성된 attachment가 컴포넌트가 비워 둔 슬롯에 맞음)
E0329a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one연결과 그 연결이 도달하는 대상이 하나의 키를 명시하지 않음
E0330signing: the references named together need different signing credentials, so nothing was signedReferences signed together need different signing credentials (함께 서명하는 참조에 서로 다른 서명 자격 증명이 필요함)
E0331signing: no verified signature is recorded for an artifact that requires oneNo verified signature is recorded for an artifact that requires one (서명이 필요한 아티팩트에 검증된 서명이 기록되어 있지 않음)
E0332signing: the recorded signature was made for a different artifactA recorded signature was made for a different artifact (기록된 서명이 다른 아티팩트에 대해 만들어졌습니다)
E0333signing: a recorded signature is not the one a pull would recordA recorded signature is not the one a pull would record (기록된 서명이 pull이 기록할 서명과 다름)
E0334an omits entry left out nothing the source renderedAn omits entry left out nothing the source rendered (omits 항목이 소스가 렌더링한 것을 아무것도 제외하지 않음)
E0335provider does not support omitsThe provider does not support omits (provider가 omits를 지원하지 않음)
E0336a provider's omitted counts do not match the omits entries it was handedA provider’s omitted counts do not match the omits entries it was handed (provider의 제외 개수가 전달받은 omits 항목과 일치하지 않음)
E0337no importer plugin version satisfies the plugins.importer entry's version pinA plugins.importer entry pins a version of its importer the catalog does not hold (이 항목이 카탈로그에 없는 임포터 버전을 고정합니다)
E0338importer is attached by more than one plugins.importer entryAn importer is attached by more than one plugins.importer entry (하나의 임포터가 둘 이상의 항목으로 연결됨)
E0339more than one importer recognises the sourceMore than one importer recognises the source (둘 이상의 임포터가 소스를 인식함)
E0340a name this operation writes holds a path segment Windows cannot hold as written작업이 쓰는 이름에 Windows가 담을 수 없는 부분이 있음
E0341the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directoryAn importer that declares no file patterns is handed a directory (파일 패턴을 선언하지 않은 임포터에 디렉터리가 전달됨)
E0342no file in the directory matches the file patterns the importer serving the source's format declaresNo file in the directory matches the importer’s file patterns (디렉터리에 임포터의 파일 패턴과 일치하는 파일이 없음)
E0343a file read from the directory and a file named in the importer's `with.sources` have the same nameA file read from the directory and a file named in the importer’s with.sources have the same name (디렉터리에서 읽은 파일과 importer의 with.sources에 지정된 파일의 이름이 같습니다)
E0344an entry this publication carries cannot be used on WindowsA published archive carries an entry Windows cannot use (게시된 아카이브에 Windows에서 사용할 수 없는 항목이 있음)
E0345a container declares one environment variable twiceA container gives one environment variable two values (컨테이너가 하나의 환경 변수에 두 값을 지정함)
E0346a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credentialComponent의 메트릭 어노테이션과 provides 키가 일치하지 않음
E0347template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFactsA template reads its targets’ render facts without declaring it (템플릿이 선언 없이 대상의 렌더 사실을 읽음)
E0348pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render factsA pipeline step reads its targets’ render facts (파이프라인 단계가 대상의 렌더 사실을 읽음)
E0349no Recipe in the workspace's catalog binds to the capability the import's target namesAn import’s target names a capability no Recipe in the catalog binds to (import의 대상이 카탈로그의 어떤 Recipe도 바인딩하지 않는 capability를 지정함)
E0350no importer recognises the sourceNo importer recognises the source (소스를 인식하는 임포터가 없음)
E0351provider does not support boundary artifactsThe provider does not support boundary artifacts (provider가 boundary artifacts를 지원하지 않음)
E0352boundary output directory does not name a directory beneath the output rootA boundary’s output directory is not a directory beneath the output root (boundary의 출력 디렉터리가 출력 루트 아래의 디렉터리가 아님)
E0353boundary-level Feature instance name is not a directory nameboundary 수준 Feature의 이름이 . 또는 ..입니다
E0354a template does more than copy a value it reads off a cross-boundary linkA template did more than copy a value it read off a cross-boundary link (템플릿이 경계 간 링크에서 읽은 값을 복사하는 것 이상으로 다루었습니다)
E0355inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`An inject: delivery is not a list of entries (주입 전달이 항목 목록이 아님)
E0356suspend requires form: scheduledA workload suspend: is set on a form other than scheduled (workload의 일시 중지 필드가 예약 실행 이외의 형식에 설정됨)
E0357a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothingA Manifest name mapping names nothing in the build (Manifest의 name 매핑이 빌드의 아무것도 지정하지 않음)
E0358uses edge target names a component its module does not exportA uses target names a module’s component the module does not export (uses 대상이 모듈이 내보내지 않는 그 모듈의 컴포넌트를 지정함)
E0359no source adapter is registered in this program for the source kindNo source adapter is registered in this program for a source kind (이 프로그램에 소스 종류에 대한 소스 어댑터가 등록되어 있지 않음)
E0360the netrc file could not be readThe netrc file cannot be read (netrc 파일을 읽을 수 없음)
E0361the source URL carries a credentialA source URL carries a credential (소스 URL에 자격 증명이 포함됨)
E0362inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`An inject: entry on a connection carries a literal (연결의 주입 항목에 리터럴이 있음)
E0363annotation subkey is not routed by the annotation's bindingAn annotation subkey is not routed by its binding (어노테이션 하위 키가 해당 바인딩으로 라우팅되지 않음)
E0364a value template failed while it ranA value template failed while it ran (값 템플릿이 실행 중에 실패함)
E0365boundary-level Feature's output is routed to a dispatch path nothing assemblesA boundary-level Feature’s output reaches no assembled file (경계 수준 Feature의 출력이 어떤 조립된 파일에도 도달하지 않음)
E0366FeatureRecipe injectMapping output could not be read as a dictionary of deliveriesAn attached Feature’s injectMapping output cannot be read (첨부된 Feature의 injectMapping 출력을 읽을 수 없음)
E0367a scalar annotation value does not route to exactly one path of its bindingA bare annotation value does not route to exactly one path of its binding (단독 값으로 쓴 어노테이션이 바인딩의 정확히 한 경로로 라우팅되지 않음)
E0368FeatureRecipe injectMapping output writes a key no delivery mechanism of the host readsAn attached Feature’s injectMapping output writes deliveries under a key nothing delivers (첨부된 Feature의 injectMapping 출력이 아무것도 전달하지 않는 키 아래에 전달을 작성함)
E0369template reads a path as a value and iterates it, and the data holds nothing at that pathA template reads and iterates a path that holds nothing (템플릿이 아무것도 담고 있지 않은 경로를 읽고 반복함)
E0370a pipeline declares one step id twiceA pipeline declares one step id twice (파이프라인이 하나의 단계 id를 두 번 선언함)
E0371catalog document declares a kind a catalog does not holdA catalog document declares a kind a catalog does not hold (카탈로그 문서가 카탈로그에 없는 종류를 선언함)
E0372inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject blockAn inject: entry on an attached Feature carries a literal (첨부된 Feature의 주입 항목에 리터럴이 있음)
E0373a document declares an API version this compiler no longer readsA document declares an API version this compiler no longer reads (문서가 이 컴파일러가 더 이상 읽지 않는 API 버전을 선언함)
E0374a plugin declares a plugin ABI version this compiler no longer speaksA plugin declares a plugin ABI version this compiler no longer speaks (플러그인이 이 컴파일러가 더 이상 지원하지 않는 플러그인 ABI 버전을 선언함)
E0375oci: artifact carries a media type this compiler no longer readsAn artifact carries a media type this compiler no longer reads (아티팩트가 이 컴파일러가 더 이상 읽지 않는 미디어 유형을 지님)
E0376egress: the server did not answer in timeA server did not answer in time (서버가 제시간에 응답하지 않았습니다)
E0377registry: the repository listing did not end in timeA registry’s repository listing did not end in time (레지스트리의 리포지토리 목록이 제시간에 끝나지 않았습니다)
E0378oci: the registry kept asking to slow downA registry kept asking to slow down (레지스트리가 계속 속도를 늦추라고 요청함)

린터 영역(치명적이지 않음)

컴파일러는 실행에 대해 철저히 주관이 없는 입장을 취합니다. 단지 의심스러울 뿐인 패턴, 즉 사용되지 않는 값, 고아가 된 시크릿, 연결되지 않은 대상 때문에 빌드를 중단하는 일은 없습니다. 이러한 패턴은 기껏해야 권고를 낳습니다. 위의 “빌드를 중단하지 않는 조건”에 정리된 몇 가지(아무것도 읽지 않는 선언된 매개변수 등)는 빌드 자체의 권고이고, 나머지는 린터 영역에 속하며, 기업은 이 영역에서 자체 관례를 적용하는 Wasm 플러그인을 선택적으로 사용합니다.

고아가 된 자격 증명

inject: 전달 계약 없이 연결된 자격 증명 Feature는 컴파일 오류가 아닙니다. 코어 컴파일러는 IR 그래프에 해당 선언을 보존하며 경고를 출력하지 않습니다. 기업용 린터 플러그인은 이 패턴을 감지하고 경고할 수 있으며, 기업용 렌더러는 자체 Black-Box 관례에 따라 고아가 된 시크릿을 암묵적으로 마운트하도록 선택할 수도 있습니다. 두 해석 모두 타당하므로 코어 컴파일러는 어느 쪽도 택하지 않습니다.