Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Фатальные остановки

Фатальная остановка — это ошибка времени компиляции, которая прерывает сборку до того, как будет создан какой-либо вывод. Каждая остановка указывает файл, сущность и поле, в которых допущена ошибка, объясняет, что компилятор не смог разрешить, и указывает на конкретное изменение в исходных файлах, которое её устраняет. Компилятор никогда молча не исправляет и не переписывает ваши входные данные: если что-то не так, сборка останавливается и сообщает вам, где именно.

Этот каталог упорядочен по этапам компиляции, на которых срабатывает каждая остановка.

Каждая запись ниже приводит сообщение, которое сборка выводит для описываемого в ней условия: фиксированное предложение, формулирующее условие, а затем то, что подставил данный конкретный случай. В терминале это сообщение выводится внутри рамки — заголовка в квадратных скобках с категорией и коротким кодом условия, указателя на файл и ключ, в которых допущена ошибка, за которым следует экземпляр, к которому относится сбой, в виде (instance <name>) (или, если файл неприменим, только этот экземпляр в виде instance <name>), и сообщения на строке под ними, — поэтому целая строка, скопированная из вывода сборки, не совпадёт с записью на этой странице, а сообщение внутри неё совпадёт; рамка полностью описана в error-translation.md.

Если вы пришли из сборки с коротким кодом — буквой E и четырьмя цифрами в заголовке диагностики в квадратных скобках, — начните с раздела Поиск остановки по короткому коду, выведенному сборкой в конце этой страницы: в нём каждое описанное здесь условие сопоставлено с коротким кодом, который сборка для него выводит.

При загрузке ваших файлов

Компилятор читает каждую сущность Aggregate, Manifest, Component, Feature, Recipe, FeatureRecipe, Plugin и Release, на которую ссылается ваша сборка, проверяет каждую по её схеме и подставляет типизированные параметры из сущности Release в сущность Aggregate.

Якорь YAML, на который ссылается псевдоним внутри его собственного содержимого

Документ ставит на узел якорь &name, а затем ссылается на него псевдонимом *name где-то внутри содержимого, которое охватывает этот якорь. Раскрытие псевдонима воспроизводит якорь, содержимое которого снова несёт этот псевдоним, поэтому документ описывает бесконечную структуру. Читать нечего — тем более проверять, — и сборка останавливается, вместо того чтобы начать обход, который не может завершиться.

При чтении YAML в дерево псевдонимы не раскрываются, поэтому документ такой формы читается без замечаний и даёт сбой только тогда, когда его что-то обходит. Поэтому отказ находится между чтением и обходом — а сборка читает написанный YAML в нескольких местах, так что одно и то же условие может встретиться в нескольких из них. О нём сообщают четыре места, и каждое обрамляет одно и то же объяснение тем, что указывает на документ в данном месте:

  • Файл сущности при его чтении. Сборка останавливается до проверки сущности по её схеме, поэтому эта остановка называет якорь, а не поле, и не содержит строки и столбца: на этом этапе у документа нет позиции, на которую диагностика могла бы с пользой указать.
  • Тело схемы при его компиляции. Раздел spec.schema: компилируется из компактной формы в документ JSON Schema после того, как его файл прочитан, поэтому эта остановка возникает во время компиляции, а не до неё, и содержит строку. Форма, которую не может поймать предшествующее чтение, — тело запасного выхода $jsonschema:: при чтении окружающего файла тело запасного выхода является блочным скаляром — простым текстом без якорей, — и его якоря становятся якорями только тогда, когда сам этот текст разбирается уровнем ниже. Если цикл находился внутри такого блока, остановка также называет $jsonschema как ключевое слово, тело которого его содержало.
  • Схема workload провайдерского Plugin при загрузке Plugin. spec.provider.workloadSchema записывается как блочный скаляр: при чтении самого файла Plugin это простой текст без якорей, и его якоря становятся якорями только тогда, когда этот текст разбирается как отдельный документ уровнем ниже. Этот разбор и последующая компиляция выполняются при загрузке Plugin, поэтому эта остановка возникает именно там, а не при чтении файла, и содержит строку. Если цикл находился внутри запасного выхода $jsonschema: в теле схемы, остановка также называет $jsonschema как ключевое слово, тело которого его содержало. Описание этого поля см. в ../entities/plugin.md.
  • Отрисованный фрагмент CloudFormation при его чтении провайдером. Recipe для cloudformation задаёт фрагмент, а тело artifacts: является шаблоном — поэтому провайдер читает текст, в который отрисовался этот шаблон, то есть содержимое, которого не существовало, пока читались ваши файлы. Поэтому эта остановка возникает во время отрисовки вывода, когда все проверки схем уже пройдены. Описание написания фрагментов см. в ../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>

Схема workload провайдерского Plugin имеет то же обрамление компактной формы; отличается окружающий его тег CATALOG_ERROR, который называет Plugin и spec.provider.workloadSchema вместо сущности и её раздела.

Отрисованный фрагмент обрамляется провайдером, который его прочитал:

cloudformation-provider: parse fragment: <the explanation above>

Как исправить: направьте псевдоним на содержимое, объявленное вне якоря, внутри которого он сейчас находится, или запишите повторяющееся содержимое полностью в месте использования. В сущности Aggregate или Manifest естественное место для общих якорей — блок defs: корневого уровня: он находится вне всех блоков, которые на него ссылаются, поэтому объявленный там якорь недостижим изнутри самого себя. В сущностях других видов, где нет блока defs:, поставьте якорь на общее содержимое там, где ссылающийся блок не является его потомком. На якорь можно ссылаться из любого числа мест и с любой глубины; единственная недопустимая форма — ссылка, которая попадает обратно внутрь содержимого, охватываемого якорем.

Одно и то же исправление применимо, где бы ни встретилась остановка, а обрамление подсказывает, какой документ открыть: сам файл сущности, блок $jsonschema: внутри раздела схемы, тело workloadSchema внутри провайдерского Plugin или тело 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>) (контракт параметра нарушен (Aggregate, в .spec.parameters.<parameter>, для параметра “<parameter>” ожидался тип <declared type>; получен <received type>))

Для параметра, объявленного с required: true без default: и без значения от Release, отчёт содержит другое условие и другой короткий код:

required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release) (обязательный параметр не передан (Aggregate, в .spec.parameters.<parameter>, параметр “<parameter>” обязателен, но Release его не передал))

С невыполненным ограничением меняется только подробность после пути к полю. Предложение и рамка в скобках вокруг него всегда одинаковы, поэтому сопоставлять следует по предложению, а читать — подробность. Подробности, которые выводит сборка, по одной на каждый вид ограничения:

parameter "<parameter>" value <value> not in enum [<members>] (значение <value> параметра “<parameter>” не входит в enum [<members>]) parameter "<parameter>" value "<value>" does not match pattern "<pattern>" (значение “<value>” параметра “<parameter>” не соответствует шаблону “<pattern>”) parameter "<parameter>" value "<value>" is not a valid <format>: <reason> (значение “<value>” параметра “<parameter>” не является допустимым <format>: <reason>) parameter "<parameter>" value <value> above max <max> (значение <value> параметра “<parameter>” больше максимума <max>) parameter "<parameter>" failed validate predicate (параметр “<parameter>” не прошёл предикат validate) parameter "<parameter>" validate predicate error: <detail> (ошибка предиката validate для параметра “<parameter>”: <detail>)

<reason> при ошибке формата объясняет, что не так со значением, в терминах самого этого формата. Значение внутри вложенного контракта называется по своему пути, поэтому format, объявленный контрактом items:, проверяется на каждом элементе, а отчёт называет тот, что не прошёл: второй элемент параметра 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> (шаблон “<pattern>” параметра “<parameter>” не компилируется: <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)

В собственном объявлении параметра то же имя отклоняется на шаг раньше — схемой Aggregate, чей format допускает только поддерживаемые имена. Этот отказ означает, что документ не соответствует схеме своего вида, — это другое условие со своим коротким кодом, E0215, и aggrega pull и aggrega validate --release выводят его после сообщения о том, что ссылка aggregate: в Release не разрешается (E0170), поскольку Aggregate с этим именем не загрузился:

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 (проверка оболочки документа не пройдена (Aggregate, в <path>); <line>:<column>: spec.parameters.<parameter>.format: enum: <format> не равно ни одному из: [email uri hostname ipv4 ipv6 uuid date-time date]. исправьте документ в соответствии со схемой его вида)

Подробность об ошибке предиката охватывает оба случая, когда предикат validate: не может вынести вердикт: функцию, которую поверхность не регистрирует, и ссылку на что-либо, кроме .value. Каждый случай сообщается относительно предиката, а не значения, и каждый называет то, что не удалось разрешить.

Предикат validate: читает проверяемое значение как .value, и это единственное имя, которое он определяет. Предикат, называющий что-либо другое, отклоняется до выполнения, поэтому опечатка в ссылке сообщается как ошибка именования, которой она и является, а не разрешается в ничто и не проявляется как значение, не прошедшее проверку.

Как исправить: приведите значение в Release в соответствие с объявленными ограничениями параметра type / enum / min / max / pattern / format, передайте отсутствующий обязательный параметр, исправьте некомпилирующийся pattern:, замените format: с неподдерживаемым форматом одним из именованных форматов или удалите его, исправьте предикат validate:, который называет что-либо кроме .value или выдаёт что-либо кроме true или false, либо расширьте объявление в Aggregate, чтобы оно принимало действительно нужную вам форму.

Правила формы Recipe

Recipe составляет свой вывод из трёх видов входных данных — sourced, synthesized и artifacts, — описанных в ../../architecture/16-recipe-input-composition.md. Форма допустимого Recipe ограничена приведёнными ниже правилами композиции. Они различаются моментом проверки — при загрузке Recipe, при рендеринге узла или при выводе результата, — поэтому в каждой записи смотрите, в какой момент проверяется её собственное условие.

Каждое правило названо по тому, что оно ограничивает. Нумерации нет, и ни один номер не зарезервирован: имя говорит, какую часть Recipe открыть, и продолжает говорить это, как бы ни рос или ни переупорядочивался список ниже. Если условие нужно зафиксировать надёжно — в проверке CI, задаче, runbook, — используйте его код: идентификатор, который 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, который означает, что сбой относится к сущности каталога (Recipe или провайдеру, к которому он привязан), а не к Aggregate или Release. Файл, из которого загружен 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) (Recipe: для valuesMapping требуется source; объявите указатель source: рядом с valuesMapping или удалите valuesMapping, если наложение не предполагается)

Как исправить: добавьте указатель source: (ссылку на chart, модуль или compose-файл) рядом с valuesMapping либо удалите valuesMapping и используйте другой вид входных данных (workload: для синтезируемого вывода, artifacts: для прямого вывода манифестов).

workload: requires a provider that can synthesize (workload: требует провайдера, способного к синтезу)

Recipe объявляет workload: (синтезируемый режим) для провайдера, который не реализует синтез Workload. Поддержка синтезируемого режима — свойство провайдера: каталог стандартной библиотеки по соглашению объявляет workloadSchema у провайдеров, способных к синтезу, но проверка опирается на возможности провайдера, а не на наличие этого поля.

Об этом сообщают две поверхности, и только одна из них определяет исход сборки. Остановка возникает во время рендеринга, после привязки провайдера узла и после чтения видов входных данных, объявленных его Recipe, поэтому это сообщение называет узел. aggrega validate сообщает о том же раньше, до привязки какого-либо узла, читая Recipe отдельно, — поэтому его сообщение называет Recipe и его версию. Они читают не один и тот же набор Recipes: раннее сообщение возникает для любого Recipe, который вообще объявляет workload:, а остановка — для каждого объявленного узлом вида входных данных, который его провайдер не может обработать. Поэтому Recipe, сочетающий workload: с source:, всё равно останавливает сборку, и останавливает из-за workload: объявление вида входных данных, который провайдер может отрендерить, не проводит неподдерживаемый вид через проверку.

Единственное ограничение: artifacts: проверяется на поддержку самостоятельных artifacts только тогда, когда это единственный объявленный вид узла. Рядом с source: или workload: его файлы проходят как составной вывод, на который эта возможность не распространяется.

Выводимое сообщение во время рендеринга. Категория, к которой отнесён сбой, приходит в заголовке диагностики в квадратных скобках, а не внутри сообщения. Сообщение начинается с фиксированного предложения, описывающего условие, затем называет узел, провайдер, отклонённый объявленный вид и виды, которые этот провайдер поддерживает. Если узел объявляет два вида, которые его провайдер не может обработать, сообщается первый в порядке 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, — идентификатор, который следует записывать, когда эту остановку нужно назвать надёжно: в проверке непрерывной интеграции, задаче или runbook. Номер выдаётся один раз и затем фиксируется, поэтому он остаётся прежним, как бы ни улучшалась формулировка вокруг него; таблица всех условий его расшифровывает, а начальное предложение выше — то, по чему следует сопоставлять, если вы работаете с текстом, а не с идентификатором.

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 (input-kind: провайдер не поддерживает синтезируемые рецепты; объявите один из поддерживаемых типов входных данных или выберите провайдер, поддерживающий синтез)

При проверке всего каталога это одна строка; с --release заголовок располагается на отдельной строке над формулировкой. Диагностика редактора для того же замечания имеет код E0265.

Как исправить: либо привяжите Recipe к провайдеру, выполняющему синтез (чаще всего helm или compose), либо переведите Recipe на другой вид входных данных (artifacts: для прямого вывода манифестов или source: + valuesMapping:, если существует chart/модуль).

Проверка содержимого Workload для каждого провайдера. Сейчас workloadSchema провайдера служит только документацией и не проверяет тело Workload; тела проверяются по встроенной схеме Workload, принадлежащей платформе. Когда появится синтезатор Workload на основе Wasm, workloadSchema станет контрактом конкретного провайдера, по которому синтезатор проверяет тело Workload (отдельная остановка на уровне содержимого).

The provider does not support omits (Провайдер не поддерживает omits)

Сущность Recipe или FeatureRecipe объявляет omits:, а провайдер, который её рендерит, не объявляет, что исключает отрендеренные документы. Исключить документ из того, что рендерит источник, может только провайдер — только он знает, какие документы рендерит источник и как называется каждый, — поэтому провайдер, который этого не делает, отрендерил бы все документы, названные в записях, и сообщил бы об успехе. Вместо этого сборка отклоняется до начала рендеринга, чтобы ключ никогда не оставался молча без эффекта.

Исключает ли провайдер документы, определяется по собственному объявлению провайдера о том, что он поддерживает, а не по списку провайдеров, который ведёт компилятор. Учитывается каждая запись, что бы ни рендерил её when:, поскольку способность провайдера соблюдать ключ не зависит от того, какие записи оставляет сборка. Провайдеры helm, compose и cloudformation соблюдают ключ. helm-chart и terraform передают свой источник на рендеринг во время развёртывания, поэтому во время сборки нет отрендеренного документа, который можно исключить, и оба отклоняются.

Решение об отказе принимается, когда привязаны Recipe каждого компонента и FeatureRecipe каждого подключения и каждый провайдер описал себя, — до рендеринга первого компонента и до вычисления какой-либо записи, поэтому отклонённая здесь сборка ничего не рендерит. Проверке подлежит каждый документ, рендерящий источник: Recipe компонента; FeatureRecipe, которую подключение привязывает к компоненту, — по разу для каждого компонента с этим подключением; и FeatureRecipe, генерируемая один раз для границы, — один раз, на границе, которая её объявляет. Все ошибочные документы сообщаются в одной сборке; если их несколько, находки группируются под documents declaring omits whose provider does not honour them. Документ, привязанный к провайдеру, который сборка не может разрешить, здесь не сообщается: такая сборка останавливается в момент выбора провайдера с указанием привязки.

Выводимое сообщение; для записей Recipe оно позиционируется на собственном ключе компонента в components: (для компонента, записанного внутри подсистемы, сначала указывается ключ этой подсистемы), для FeatureRecipe на компоненте — на ключе подключения в блоке features:, где оно записано, а для FeatureRecipe, генерируемой один раз для своей границы, — на .spec.boundaries.<boundary>.features.<attachment> в Release. Категория передаётся в заголовке в квадратных скобках; сообщение называет сначала провайдер, затем компонент, для которого рендерится документ:

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 (провайдер не поддерживает omits (имя провайдера, узел с указанным идентификатором). контракт этого провайдера не объявляет, что он исключает отрендеренные документы; удалите ключ omits или рендерите источник через провайдер, контракт которого это объявляет)

Находка для FeatureRecipe называет подключение после компонента — node "<node-id>", attachment "<attachment>", — а для генерируемой один раз для своей границы вместо компонента называет границу и подключение: boundary "<boundary>", attachment "<attachment>".

Заголовок содержит короткий код этого условия, E0335.

Как исправить: удалите ключ omits: или рендерьте источник через провайдер, который его соблюдает. Если Recipe для helm-chart или terraform использует локальный чарт или модуль, строка в .aggregaignore рядом с Recipe вместо этого исключает файл этого источника, начиная со следующего закрепления Recipe, — см. aggrega pin.

The provider does not support boundary artifacts (Провайдер не поддерживает артефакты границы)

Сущность Recipe объявляет spec.boundary.artifacts — файлы для общего вывода границы, в которой она рендерится, — а провайдер, который её рендерит, не объявляет, что принимает такие файлы. Компилятор записывает эти файлы сам, рядом с тем, что провайдер собирает для границы, и не передаёт провайдеру ни одного из них, поэтому имеет ли смысл размещённый там файл — свойство цели провайдера. Цель, которая его не читает, поставила бы его и проигнорировала, и содержащаяся в нём конфигурация никогда не вступила бы в силу; вместо этого сборка отклоняется до начала рендеринга.

Принимает ли провайдер эти файлы, определяется по собственному объявлению провайдера о том, что он поддерживает, а не по списку провайдеров, который ведёт компилятор. Учитывается любая запись, во что бы она ни рендерилась. Провайдер terraform их принимает и записывает каждый рядом с корневой конфигурацией границы; helm, compose, helm-chart и cloudformation — нет и отклоняются.

Решение об отказе принимается, когда привязана Recipe каждого компонента и каждый провайдер описал себя, — до рендеринга первого компонента и до вычисления какой-либо записи, поэтому отклонённая здесь сборка ничего не рендерит. Все ошибочные сущности Recipe сообщаются в одной сборке, по разу для каждого компонента, который они рендерят; если находок несколько, они группируются под Recipes declaring boundary artifacts whose provider does not accept them. Recipe, привязанная к провайдеру, который сборка не может разрешить, здесь не сообщается: такая сборка останавливается в момент выбора провайдера с указанием привязки.

Выводимое сообщение, позиционированное на .spec.boundary в Recipe, где нужна правка. Категория передаётся в заголовке в квадратных скобках; сообщение называет сначала провайдер, затем компонент, для которого рендерится Recipe:

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 (провайдер не поддерживает артефакты границы (имя провайдера, узел с указанным идентификатором). контракт этого провайдера не объявляет, что он принимает файлы, записанные в общий вывод границы; удалите блок boundary или рендерите сущность Recipe через провайдер, контракт которого это объявляет)

Заголовок содержит короткий код этого условия, E0351.

Как исправить: удалите блок boundary: или рендерьте Recipe через провайдер, который его принимает. Файл, относящийся к компоненту, а не к границе, вместо этого оформляется как запись artifacts:.

At least one input kind must be present (Должен присутствовать хотя бы один вид входных данных)

Сущность Recipe не объявляет ни одного вида входных данных: ни source в паре с valuesMapping, ни 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. Recipe для сервиса, который сборка не развёртывает, — базы данных или API, уже работающих где-то ещё, — объявляет workload: с form: reference и его endpoint (и, при необходимости, port) и публикует свои значения подключения в provides:, как любой Recipe: helm рендерит его как ExternalName Service, compose ничего для него не рендерит, и на обоих его потребители читают опубликованные значения.

Ключи записей artifacts: должны быть уникальными

Сущность Recipe объявляет в artifacts: две или более записей с одинаковым ключом. Ключ определяет имя выводимого файла (независимо от того, задано ли тело записи встроенно или загружено через $import: отдельной записи); дублирующиеся ключи привели бы к выводу файла с тем же именем в тот же каталог границы.

Сборка отклоняет Recipe при декодировании документа в типизированную форму, называя повторяющийся ключ и строку, где он повторяется. Этот шаг выполняется после проверки схемы оболочки и до правил формы, поэтому Recipe с дублирующимся ключом artifacts: сообщает о корректной схеме, а затем об этой остановке, и остальные правила формы по ней не сообщают.

Как исправить: переименуйте один из конфликтующих ключей записей, чтобы у каждой записи 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, следуют соглашениям провайдера о трансляции (например, <release-name>-deployment.yaml для helm, где имя релиза — {{ .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) (ограничение output-labels для рецепта: ключ использует зарезервированное пространство имён; ключ в outputLabels использует зарезервированное пространство имён — “aggrega.ai/” и “app.kubernetes.io/” зарезервированы для сведений о происхождении, которые проставляет платформа)

Ключ, записанный в блоке переноса, сообщается под именем правила этого блока и называет его в совете:

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) (ограничение output-labels для рецепта: ключ использует зарезервированное пространство имён; ключ в outputComponentLabels использует зарезервированное пространство имён — “aggrega.ai/” и “app.kubernetes.io/” зарезервированы для сведений о происхождении, которые проставляет платформа)

Ключи литерального блока проверяются в отсортированном порядке, а ключи блока переноса — в том порядке, в котором вы их написали, поэтому 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 (ограничение output-component-labels для рецепта: ключ также объявлен в outputLabels; ключ продвигается через outputComponentLabels и одновременно объявлен буквально в outputLabels — оставьте тот источник, из которого должна браться метка, и удалите другой)

Как исправить: решите, откуда берётся значение метки, и удалите другое объявление. Оставьте запись outputComponentLabels:, если значение должно следовать тому, что несёт компонент, чтобы два компонента, привязанные к одному Recipe, проставляли собственные значения; оставьте запись outputLabels:, если значение принадлежит самому Recipe и одинаково везде, где Recipe привязан.

Правила формы FeatureRecipe

FeatureRecipe составляет свой вывод из тех же видов входных данных, что и Recipe, и приведённое ниже правило композиции ограничивает его так же, как ограничивает Recipe. Оно проверяется при загрузке FeatureRecipe и сообщает в той же форме, что и остановка по форме Recipe, — фраза правила, затем документ с ошибкой, имя правила и совет для этого случая — под тегом CATALOG_ERROR.

Здесь намеренно нет правила «хотя бы один вид входных данных», и в этом отличие от Recipe. FeatureRecipe, который объявляет только провайдер и то, что он реализует, — это правомерное вложение чистого связывания: оно ничего не рендерит, а его эффект — соединение, которое несёт реализуемая им Feature. FeatureRecipe, объявляющий только injectMapping:, правомерен точно так же.

A FeatureRecipe’s valuesMapping requires source (Поле valuesMapping сущности FeatureRecipe требует source)

Сущность FeatureRecipe объявляет valuesMapping, но не объявляет source. Сопоставление значений — это наложение, поэтому без чарта, модуля или файла, на который оно накладывается, сопоставленным значениям некуда попасть.

Выводимое сообщение:

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; объявите указатель source: рядом с valuesMapping или удалите valuesMapping, если наложение не предполагается)

Как исправить: добавьте указатель source:, для которого было написано наложение, или удалите valuesMapping и позвольте вложению выполнить свою работу иначе — через artifacts:, чтобы выпускать собственные файлы, через injectMapping:, чтобы изменить форму того, что оно доставляет, или без того и другого, если это вложение только для связывания.

A pipeline declares one step id twice (Конвейер объявляет один идентификатор шага дважды)

Сущность Recipe или FeatureRecipe объявляет один и тот же id в двух шагах своего spec.pipeline. Шаг публикует возвращаемые им выходные данные под своим идентификатором, а более поздний шаг того же конвейера читает их как .steps.<id>.outputs, поэтому два шага с общим идентификатором заставили бы этот более поздний шаг читать данные того из двух, который опубликовал их последним, а не того, который вы имели в виду.

Правило охватывает собственный конвейер одного документа. Сущность Recipe компонента и присоединённые к нему сущности FeatureRecipes запускают свои конвейеры отдельно, и каждый конвейер начинается без выходных данных шагов, поэтому шаг сущности Recipe и шаг присоединённой сущности FeatureRecipe могут иметь один и тот же идентификатор.

Ни одна схема не может выразить это правило — в JSON Schema нет ключевого слова для списка, элементы которого уникальны по одному из своих полей, — поэтому редактор, поддерживающий схемы, принимает такой документ, а проверка выполняется при чтении документа, сразу после проверки схемы. Об этом сообщает каждая поверхность, читающая сущность Recipe или FeatureRecipe: aggrega validate для файла или для всего каталога, сборка, загружающая каталог, pull, принимающий полученную сущность, диагностика редактора и редактирование документа, которое отклоняется, а не записывается. Документ, который к тому же не соответствует своей схеме, сначала сообщает результаты проверки схемы, а этот отказ — после того, как они исправлены.

Каждое повторение — отдельный результат проверки, привязанный к повторённому 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 (конвейер объявляет один идентификатор шага дважды; идентификатор шага spec.pipeline[1].id уже объявлен в spec.pipeline[0].id. дайте каждому шагу конвейера собственный идентификатор и направьте каждую ссылку на шаг, которую делает более поздний шаг, на тот шаг, который она имеет в виду)

Как исправить: переименуйте один из двух шагов, чтобы каждый идентификатор был объявлен один раз. Затем просмотрите шаблоны with: и when: каждого более позднего шага на предмет ссылок .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(), который его гостевой модуль возвращает при загрузке, и поле spec.abiVersion его сущности Plugin, отклоняемое при чтении сущности, до какой-либо другой проверки. Плагин, объявляющий версию 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)

Как исправить: пересоберите плагин под текущую версию его набора для разработки плагинов, которая записывает v1beta1 в отчёт describe() гостевого модуля, и опубликуйте его снова, чтобы сущность, сгенерированная рядом с ним, тоже объявляла abiVersion: v1beta1. Отредактировать только строку сущности недостаточно: сам гостевой модуль по-прежнему сообщает более ранний ABI и отклоняется при загрузке.

An artifact carries a media type this compiler no longer reads (Артефакт имеет тип медиаданных, который этот компилятор больше не читает)

Артефакт, полученный из реестра, имеет тип медиаданных, под которым публиковала более ранняя версия, — application/vnd.aggrega.<kind>.v1alpha1 со своим суффиксом, в типе артефакта манифеста, в его конфигурации или в одном из его слоёв. Этот компилятор публикует и читает типы медиаданных v1beta1, поэтому артефакт отклоняется с указанием имени при чтении его манифеста, до того как будет взята какая-либо часть его содержимого: будь то сущность каталога, плагин и его исполняемый файл или пакет документации. Индексирование реестра пропускает такой артефакт, указывая причину. Тип медиаданных вне собственного пространства имён application/vnd.aggrega. продукта 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; тела workload, values-mapping и артефактов сущности Recipe читаются как исходный текст шаблона 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>) (загрузка файла не удалась: файл не удалось прочитать, или его байты не разобрались (Aggregate, в <path>, не удалось прочитать файл: <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>) (загрузка файла не удалась: файл не удалось прочитать, или его байты не разобрались (Aggregate, в <path>, не удалось десериализовать YAML: <underlying reason>))

Release и Manifest появляются вместо Aggregate, когда читается один из этих документов. То же условие охватывает и контракт параметров, считываемый из объявленного блока parameters: сущности Aggregate, который читается из собственного текста Aggregate до того, как в него что-либо подставляется.

Блок parameters: { $import: … } сущности Release, указывающий на файл, который сборка не может получить, тоже сообщается здесь, причём в обоих случаях: путь не указывает на файл, который сборка может прочитать, или файл прочитан, но его байты не разбираются. Субъектом является 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>) (не удалось загрузить файл: файл не удалось прочитать, или его байты не прошли разбор (Release, в .spec.parameters.$import: <path>, не удалось прочитать файл: <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>) (не удалось загрузить файл: файл не удалось прочитать, или его байты не прошли разбор (Release, в .spec.parameters.$import: <path>, не удалось десериализовать YAML: <underlying reason>))

Относительный путь разрешается от каталога, в котором находится записавшая его сущность 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, или valueSchema сокета usesSchema, — а указатель на исходный код ведёт на строку, в которой написана директива:

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> (загрузка файла не удалась: файл не удалось прочитать, или его байты не разобрались. <surface>: чтение импортированной схемы <value>: <the operating system's reason>)

с resolve imported schema path вместо read для более редкого случая, когда вообще не удаётся установить собственный каталог сущности, и parse imported schema, если файл прочитан, но его текст не является корректным YAML. Ошибка в написанной вами директиве — соседний ключ рядом с ней, значение, не являющееся путём, или импортированное содержимое, которое разобралось, но не является отображением, — это другое условие, и оно сообщается в разделе «A schema $import: cannot be applied (Схемный $import: не удаётся применить)» ниже.

Импорт valuesMapping:, workload: или artifacts.<name>: сущности Recipe или FeatureRecipe тоже сообщается здесь — по той же причине и с тем же способом исправления: директива корректна, а названный ею файл не дал содержимого. Эти три тела — исходный текст шаблона 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 для Recipe <name>, <the operating system's reason>). если вы имели в виду запись библиотеки, а не файл, ссылке нужен фрагмент — $import: без него читается как путь к файлу, а значение без кавычек заканчивается там, где пробел перед # начинает комментарий, поэтому заключите всю ссылку в кавычки) 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 для Recipe <name>, <the operating system's reason>). если вы имели в виду запись библиотеки, а не файл, ссылке нужен фрагмент — $import: без него читается как путь к файлу, а значение без кавычек заканчивается там, где пробел перед # начинает комментарий, поэтому заключите всю ссылку в кавычки) 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 (загрузка файла не удалась: файл не удалось прочитать, или его байты не разобрались (импорт файла артефакта <key> для Recipe <name>, <the operating system's reason>). если вы имели в виду запись библиотеки, а не файл, ссылке нужен фрагмент — $import: без него читается как путь к файлу, а значение без кавычек заканчивается там, где пробел перед # начинает комментарий, поэтому заключите всю ссылку в кавычки)

Именно фрагмент отличает ссылку на библиотеку от пути: <Library>#/mappings/<entry> разрешается по библиотекам, а тот же текст без фрагмента — обычный относительный путь. Его легко потерять незаметно, потому что простое значение YAML заканчивается там, где пробел перед # открывает комментарий, — так $import: LibBeta:1.0.0 #/workloads/Web доходит до сборки как LibBeta:1.0.0, и сборка затем ищет файл с таким именем рядом с Recipe. Заключите всю ссылку в кавычки, чтобы сохранить фрагмент.

Те же три ключа в FeatureRecipe сообщают то же условие и читаются так же. Импорт артефактов читается дважды за жизнь сущности Release — один раз, когда aggrega pull фиксирует закрепление его содержимого, и ещё раз, когда запись отрисовывается, — поэтому один и тот же отсутствующий файл сообщает это условие на том из двух этапов, до которого вы дойдёте первым. Ошибка формы в самой директиве, например соседний ключ рядом с $import: или ссылка oci:// с указанием хоста, — это другое условие, и оно сообщается в собственной записи.

Проверки всего каталога aggrega lint и aggrega validate тоже сообщают здесь — о документе в каталоговых директориях, который объявляет apiVersion Aggrega (строку, начинающуюся без отступа с apiVersion: и значения, начинающегося с aggrega.ai/) и который не удаётся прочитать, не удаётся разобрать или не удаётся декодировать в конверт, читаемый проверкой, например metadata, записанный как список. Путь к нему не писал ни один автор: проверка прочитала его потому, что он лежит в каталоговой директории. Каждая проверка читает все файлы, прежде чем остановиться, поэтому один запуск называет все такие документы, ничего больше не проверяет и не выводит сводку. YAML, не объявляющий apiVersion Aggrega, — в том числе шаблоны Helm chart — пропускается. Заголовок указывает число документов и называет их файлы, а под ним перечислен каждый документ с причиной, которую дало чтение или сам парсер:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (документы в каталоговых директориях объявляют apiVersion Aggrega, но не могут быть загружены, поэтому ничего не было проверено) 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:, строкой и тем, что декодер там нашёл, — line 4 (metadata): a list is written where a map is expected для metadata, записанного как список, — для документа, который разбирается, но не декодируется, и с 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 (Документ каталога объявляет вид, которого каталог не содержит)

Документ в директориях каталога объявляет apiVersion Aggrega — строку, начинающуюся без отступа с apiVersion: и значения, начинающегося с aggrega.ai/, — и kind, которого нет ни в одном каталоге: опечатку, например Componnent, вид в неправильном регистре, например component, или вовсе отсутствующий kind. Каталог раскладывает каждый документ по виду, который тот объявляет, поэтому такой документ не попадает ни в один каталог: сборка, inspect и любая другая команда, загружающая каталог, пропускают его, а ссылка на сущность, которую он должен был объявить, ни во что не разрешается.

Каталог содержит документы Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate и Plugin. Три других вида правомерно находятся в его директориях и здесь никогда не сообщаются: документы Manifest и Release, хранящиеся рядом с сущностями, и документ Workload в директории сущности Recipe или FeatureRecipe, которая его импортирует.

Об этом сообщают aggrega validate и aggrega lint для всего каталога, а также lint в области сущности Release, который обходит те же директории. Каждая из этих команд читает все файлы, прежде чем остановиться, поэтому один запуск называет каждый такой документ вместе с любым документом, который вообще не удаётся загрузить, под одним заголовком, который их подсчитывает и называет их файлы; ничего не проверяется, и сводка не выводится. Каждый документ перечисляется с видом, который он объявляет, а строка завершается видами, которые содержит каталог:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (документы в директориях каталога объявляют apiVersion Aggrega, и их не удалось загрузить, поэтому ничего не проверено) 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; исправьте вид или переместите файл за пределы директорий каталога)

с no kind вместо kind "<kind>" для документа, который не объявляет никакого вида.

Сборка не останавливается на таком документе: она пропускает его, как и любая загрузка, а документ, до которого не доходит ни одна сущность Release, никогда не приводит к сбою сборки. Когда сущность Release всё же доходит до этой сущности, сборка останавливается на ссылке, в рамках «A reference names no entity the catalog holds (Ссылка не указывает ни на одну сущность, которую содержит каталог)» ниже, а примечание под этим сбоем называет файл, если он объявляет имя, которое запрашивает ссылка, — см. эту запись.

Как исправить: откройте файл, который называет сообщение, и исправьте его kind на вид, которым документ является на самом деле, — значение имеют и написание, и регистр. Файлу, который вообще не является сущностью каталога, не место в директориях каталога; переместите его или, если это документ другого инструмента, дайте ему apiVersion, не принадлежащий Aggrega.

Путь указывает на содержимое вне собственного каталога сущности

Содержимое сущности находится в её собственном каталоге, потому что каждый файл, который несёт публикация сущности, берётся оттуда. Путь, выходящий за его пределы, указывает на файл, который не будет перемещаться вместе с сущностью, поэтому этого файла нет у тех, кто получает сущность, а закрепление, записанное по нему, ручается за байты, которые они не могут получить.

Поэтому каждый путь, который сущность записывает для переносимого ею содержимого, читается относительно каталога, содержащего файл сущности, и должен оставаться внутри него. Это касается source: у сущностей Recipe и FeatureRecipe — простого пути или url: структурированной формы, — файла, который каждая запись valuesMapping:, workload: и artifacts: импортирует через $import:, и каждой схемы, которую импортирует сущность Component или Feature, — целиком, по отдельному столпу или для valueSchema и infraSchema сокета usesSchema. Из каталога выводят три формы: путь, поднимающийся выше него; абсолютный путь, который указывает на место на машине, где он был написан; и путь, записанный внутри каталога, который выводит наружу символическая ссылка на пути, — каталог на пути, как и файл в его конце, являющийся ссылкой за пределы каталога сущности. Путь, который поднимается и возвращается внутрь, — ./charts/../values.tmpl, — обычный путь внутри каталога, как и путь через ссылку, ведущую в другое место внутри него. Подъём, который возвращается в каталог по его собственному имени, — ../1.0.0/values.tmpl, записанный в каталоге с именем 1.0.0, — отклоняется, потому что имя каталога не входит в то, что переносится: опубликованная сущность читается из каталога, имя которому даёт кэш потребителя, и там это имя ничего не находит. Путь через ссылку, ведущую наружу, отклоняется, потому что иначе публикация несла бы байты, на которые указывает ссылка, откуда бы она ни указывала, под именем внутри сущности.

Это отклоняется везде, где читается сущность. aggrega validate по всему каталогу, aggrega validate для собственного файла сущности, aggrega pull и aggrega build отклоняют это при чтении файла сущности, как и aggrega pin для Recipe или FeatureRecipe и aggrega push для любого из четырёх видов — до того, как что-либо загружается, записывается или публикуется. source:, записанный как шаблон, ничего не указывает, пока сборка его не вычислит, поэтому шаблон, дающий путь вне каталога, отклоняется сборкой в момент, когда значение появляется.

Иначе обстоит дело с Release, а также со ссылкой на сущность. Release указывает на другие сущности — свой Aggregate, свой Manifest, Release, который он расширяет, — и никогда не публикуется, поэтому ничто из прочитанного им никуда не переносится: эти пути, а также файл, который импортируют parameters: сущности Release, читаются так, как записаны. Поле type сущности Aggregate указывает на другую сущность по её идентификатору, а не на содержимое, которое несёт 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 … или, для шаблонного источника, node "<name>" source.

Как исправить: переместите файл в каталог сущности или в каталог под ним и запишите его путь относительно этого каталога. Если путь выводит наружу ссылка, замените ссылку копией того, на что она ведёт, внутри каталога сущности. Chart, общий для нескольких Recipes, копируется в каталог каждой Recipe, поскольку каждая публикуется отдельно; схема, общая для нескольких Components, помещается в SchemaLibrary, на которую затем ссылается по идентичности каждый Component, а тело mapping, workload или artifact, общее для нескольких Recipes, помещается в библиотеку соответствующего вида.

Ключ source: в Recipe называет вид, который ничто не умеет получать

source: сущности Recipe указывает, на какой вид объекта он ссылается — chart, модуль, проект compose, — и каждый вид получает адаптер источника, обслуживающий этот вид. Это условие сообщает о виде, который не обслуживает ни один адаптер источника, так что ничто из входящего в эту программу не может получить источник. На source: сущности FeatureRecipe распространяется то же правило.

Отказ происходит при чтении документа, до того как что-либо получено: его отвергает проверка самой сущности 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 указывает вид, который ничто не умеет получать)» выше), поэтому ничто из написанного автором сюда не доходит: условие сообщает о программе, собранной без адаптера для обслуживаемого ею вида, или о программе на основе Go-пакетов Aggrega, которая направляет запрос на вид, собранный ею самой.

Выводимое сообщение с указанием вида:

kind "<kind>": no source adapter is registered in this program for the source kind (в этой программе не зарегистрирован адаптер источника для этого вида источника)

Как исправить: ничто в ваших файлах сущностей этого не вызывает. Сообщите об этом тому, кто собрал запускаемый вами двоичный файл.

A source URL carries a credential (URL источника содержит учётные данные)

url источника записывается так, как вы его написали, — в lock-файл Release, в entity.lock рядом с Recipe и в кэш источников, — а сама сущность Recipe является файлом, который вы фиксируете в репозитории и можете опубликовать. Поэтому учётные данные, записанные в URL, попадут всюду, куда попадает URL. Это условие сообщает о source: сущности Recipe, в котором url содержит пользователя перед хостом: https://user:token@host/… или токен, записанный отдельно как https://token@host/…, поскольку сервис, доступный по HTTP, обычно принимает токен на месте пользователя. Для http и https учитывается любой записанный там пользователь; для другой схемы — только пароль, поскольку записанный там отдельно пользователь называет учётную запись: ssh://git@github.com/… принимается, а ключ предоставляет SSH-агент. На source: сущности FeatureRecipe распространяется то же правило.

Отказ происходит при чтении документа, до того как что-либо получено: его отвергает проверка самой сущности Recipe, а также каждая сущность Release, которая до неё доходит, — при проверке, pull, pin или сборке. Сообщение называет хост и никогда — учётные данные. Проверка читает только часть 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 в домашней директории или _netrc в %USERPROFILE% в Windows))

и для другой схемы, где решение — удалить пароль:

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, который записывается в lock-файл и кэш так, как написан)

Как исправить: удалите пользователя и пароль из url, оставив URL, указывающий хост. Для источника, получаемого по http или https, поместите учётные данные в запись machine для этого хоста в файле netrc, который читается при каждом получении классического репозитория Helm chart, фрагмента compose или Git-репозитория по HTTP или HTTPS; какой файл и какая запись, описано в разделе Аутентификация. Для Git-репозитория по SSH ключ предоставляет SSH-агент, и пользователь может остаться. Если сущность Recipe уже была зафиксирована или опубликована с учётными данными, они остались в этой истории: смените их также на сервере.

A {{ .parameters.* }} reference cannot be interpolated (Ссылку {{ .parameters.* }} невозможно интерполировать)

Текст сущности Aggregate вычисляется как шаблон до того, как он читается как документ, чтобы ссылка {{ .parameters.<key> }} заменялась значением, которое для неё предоставила сущность Release. Эта остановка срабатывает, когда такое вычисление не удаётся завершить: текст не разбирается как шаблон или разбирается, но завершается ошибкой при выполнении.

Интерполяция выполняется до разбора сущности Aggregate как YAML, поэтому ошибка здесь сообщается для Aggregate в целом, а не для ключа внутри него: на этом этапе у документа ещё нет ключей. По этой же причине ссылку можно оставить без кавычек: подстановка происходит в исходных байтах, а затем тип значения определяет собственное правило кавычек YAML, так что ссылка без кавычек даёт естественный тип значения, а ссылка в кавычках — строку.

Ссылка на ключ, который Release не передал, — это не данная остановка. Отсутствующий ключ здесь разрешается в пустое значение и перехватывается вместе со своим типом и контрактом проверками параметров, описанными выше в разделе «Parameter type mismatch / contract violation (Несоответствие типа параметра / нарушение контракта)». Эта остановка сообщает о тексте, который шаблонизатор вообще не смог обработать: незакрытая {{, опечатка в имени функции, конвейер, стадии которого не согласуются между собой. Чтение параметра через index — {{ index .parameters "db_size" }} — когда Release не передал такой параметр, является сбоем во время выполнения, и эта остановка сообщает о нём, называя ключ: index останавливается на ключе, которого нет в карте, на любой поверхности шаблонов, как описано ниже в разделе «A template indexes a map with a key the map does not hold (Шаблон обращается к карте по ключу, которого в ней нет)».

Текст, который вообще не разбирается, отклоняется с указанием собственного пути сущности Aggregate, поскольку этот файл уже имеется до того, как что-либо его читает. Модуль, импортируемый композицией, вычисляется так же, уровнем глубже, и его текст читается из каталога, а не передаётся сборке. Остановка — это то же самое условие с тем же кодом в обоих случаях; для модуля она также называет импорт, по которому шла сборка, и файл, из которого был прочитан текст модуля, а передаваемое ею сообщение называет только вид, поэтому указанная в нём позиция — это позиция в собственном тексте модуля, а не в сущности 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>”) (недопустимая ссылка на параметр: убедитесь, что выражение {{ .parameters.* }} называет объявленный параметр и разбирается как шаблон Go) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) (недопустимая ссылка на параметр: убедитесь, что выражение {{ .parameters.* }} называет объявленный параметр и разбирается как шаблон Go) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>) (недопустимая ссылка на параметр: убедитесь, что выражение {{ .parameters.* }} называет объявленный параметр и разбирается как шаблон Go)

У текста 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> }}. Если она называет то, что вы вовсе не задумывали как шаблон, — undefined variable "$json" из выражения n8n или функцию, названную по узлу Flowise, — значит, текст содержит собственные двойные фигурные скобки, в том числе в комментарии: запишите каждую {{ в нём как {{"{{"}}, как описано в разделе Текст, содержащий собственные двойные фигурные скобки.

The Release directory declares one Aggregate or Manifest twice (Каталог Release дважды объявляет один Aggregate или Manifest)

Сущность Release, у которой ссылка aggregate: или manifest: является простой идентичностью, разрешается сначала сканированием собственного каталога Release, и это сканирование обнаружило две сущности Aggregates — или две Manifests — с одинаковым metadata.name. Ссылка по простой идентичности называет сущность по этому имени, поэтому имя, заявленное дважды, каталог разрешить не может.

Сканирование отклоняет каталог целиком, а не только имя, запрошенное ссылкой. Оно читает каждый Aggregate и каждый Manifest рядом с Release, поэтому конфликтующая пара, которую не называет ни одна ссылка, тоже останавливает сборку: каталог неоднозначен независимо от того, собиралась ли именно эта Release прочитать данную сущность. Ссылка, записанная как путь (./aggregate.yaml, ../shared/manifest.yaml), адресует файл, а не сущность, и разрешается без сканирования, поэтому у Release, где и aggregate:, и manifest: являются путями, сканирование никогда не выполняется.

Это аналог отказа каталога из-за дублирующейся идентичности для одного каталога файлов, и они сообщаются по отдельности, чтобы сообщение называло каталог, в котором вы находитесь, а не уровень каталога, о котором вы могли не думать.

Выводимое сообщение:

duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory> (повторяющаяся идентичность Aggregate/Manifest (metadata.name) в каталоге Release: сущность Aggregate с этим именем объявлена в этом каталоге более одного раза)

где вместо Aggregate стоит Manifest, если конфликтуют две сущности Manifests.

Как исправить: задайте одной из двух сущностей другое metadata.name или перенесите её из каталога Release. Две сущности Releases, которые действительно развёртывают разные Aggregates с одинаковым именем, должны находиться в собственных каталогах; обычно эта ситуация возникает, когда Release копируют в соседний файл, не переименовав то, что он содержит.

A Release’s aggregate: or manifest: reference resolves to nothing (Ссылка aggregate: или manifest: сущности Release ни во что не разрешается)

Сущность Release называет Aggregate или Manifest по простой идентичности, но сущность с таким именем не найдена ни на одной из поверхностей, где ищется простая идентичность: в собственном каталоге Release, в каталоге сущностей и в реестре.

Выводимое сообщение, если нигде ничего не совпало:

aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry (ссылку aggregate/manifest невозможно разрешить: сущности Aggregate с этим именем нет ни в каталоге Release, ни в каталоге сущностей, ни в реестре)

Файл в каталоге Release, который не удалось проиндексировать, меняет сообщение, поскольку меняет то, что можно честно утверждать. Такой файл мог быть искомой сущностью, поэтому сообщение говорит об этом, а не утверждает отсутствие, которое не может установить, и передаёт ошибку разбора, помешавшую его прочитать:

aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure> (ссылку aggregate/manifest невозможно разрешить: сущность Aggregate не найдена; файл, который не удалось разобрать, не был проиндексирован и может оказаться ею)

а если неразбираемый файл — именно тот, который ссылка называет напрямую:

aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure> (ссылку aggregate/manifest невозможно разрешить: нужная сущность Aggregate — это файл, который не удалось разобрать)

Как исправить: если сущность действительно отсутствует, исправьте написание ссылки — идентичность есть metadata.name сущности, а не имя её файла, — или добавьте сущность в каталог Release либо в каталог сущностей, который читает сборка. Если сообщение называет неразбираемый файл, сначала исправьте этот файл: его ошибка разбора приведена в сообщении, и её исправление часто разрешает ссылку той же правкой. Ссылка ./ или ../ — это путь, а не идентичность, и разрешается как путь, поэтому начальная точка меняет то, какую из двух ошибок следует искать.

A component is placed in more than one boundary (Компонент размещён более чем в одной границе)

Дерево границ сущности Release размещает один компонент в двух разных границах. Два размещения не объединяются и не ранжируются, и это невозможно: граница компонента определяет, куда записывается его вывод, в какой подкаталог он попадает, к какой волне синхронизации присоединяется и какие аннотации границы и инфраструктуру границы наследует, — тогда как его поверхность uses: для каждого ребра читается отдельным обходом. Компонент, названный дважды, взял бы расположение вывода из одного размещения, а конфигурацию рёбер — из другого.

Граница размещает компоненты тремя способами, и учитываются все три. Указание компонента непосредственно под components: по идентификатору, который он получает после завершения композиции, размещает его. Указание компонента внутри собственного components: записи маршрутизации по локальному имени, которое он носит в этом подмодуле, тоже размещает его. А маршрутизация целого подмодуля под aggregates: размещает каждый компонент, содержащийся в этом модуле. Поэтому эта остановка охватывает также один подмодуль, направленный в две границы; модуль, направленный в одну границу, когда вложенный в него модуль направлен в другую; и компонент, названный в одной границе, когда содержащий его модуль направлен в другую.

Маршрутизация модуля в границу с одновременным указанием одного из его компонентов в той же границе не является конфликтом — оба размещения согласны в том, где находится компонент, — и сборка проходит. Один идентификатор, записанный дважды в одной границе, — конфликт даже там: запись в 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>" — карта components: записи маршрутизации под aggregates: этой границы;
  • 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 содержит то, к чему обращалось более раннее размещение: идентификатор компонента или префикс подмодуля, если его разместил направленный подмодуль.

Когда ошибочная запись сама является записью маршрутизации, она обращается к подмодулю, а не к отдельному компоненту, и сообщение говорит об этом, а не выдаёт префикс модуля за имя компонента, — здесь при встрече с более ранним подмодулем, направленным в другую границу:

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 заявляет зарезервированный префикс aggrega.ai/)

Сущность 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>/")

Как исправить: переименуйте ключ привязки в пространство имён, которым вы управляете. Ключ с подпрефиксом — поддерживаемая форма, и он не зарезервирован: feature.aggrega.ai/… для сокращения стандартной библиотеки или ваш собственный домен — acme.aggrega.ai/…, compliance.example.com/… — для корпоративного. Переименование ключа меняет то, что автор пишет на компоненте, чтобы задействовать привязку, поэтому обновите использующие его аннотации в той же правке. Собственные ключи платформы под голым префиксом перечислены в ../providers/well-known-annotations.md.

Две привязки аннотаций Manifest претендуют на один слот маршрутизации

Две привязки аннотаций в одном Manifest направляют значение в одну и ту же Feature, через один и тот же столп, по одному и тому же пути. Задача привязки — указать, куда попадает значение аннотации, а две привязки, указывающие одно место назначения, оставляют значению два маршрута и ничего, что позволило бы выбрать между ними во время раскрытия.

Только одна привязка может объявить заданную пару «путь и столп» для каждой целевой Feature. Две привязки, нацеленные на одну и ту же 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) (привязки аннотаций в Manifest конфликтуют по одной паре «путь + столп» для одной сущности Feature; только одна привязка может объявлять данную пару (путь, столп) для каждой сущности Feature)

Как исправить: решите, какой привязке принадлежит место назначения, и удалите путь из списка maps.infra или maps.values другой привязки либо полностью удалите вторую привязку. Если две привязки появились потому, что вы хотели, чтобы два ключа аннотаций достигали одного поля Feature, оставьте одну привязку и направьте через неё оба ключа аннотаций; если они появились потому, что два разных значения должны были попасть в два места, исправьте путь, написанный по ошибке.

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 достиг разрешения ненормализованным (непустые корневые components наряду с синтезированной границей default): создавайте releases через ядро нормализации (types.NormalizeRelease через путь загрузки), а не вручную собранным литералом)

Как исправить: ничего, если вы пишете YAML: если эта остановка возникает в aggrega build, aggrega validate или в редакторе, значит, в компиляторе есть дефект, о котором стоит сообщить, а собираемый вами Release ни при чём. Если вы встраиваете компилятор и строите значение Release в собственном коде, создавайте его через путь загрузки, а не собирайте структуру напрямую, чтобы выполнилась нормализация, сворачивающая корневые компоненты в границу по умолчанию.

Ссылка на библиотеку раскрывается сама в себя

Цепочка межд документных ссылок возвращается к документу, которого уже достигла, поэтому её раскрытие никогда бы не завершилось. К одному и тому же условию ведут две поверхности авторинга, и обе представляют собой цепочки между библиотечными сущностями, а не что-то внутри одного файла: $ref: из столпа схемы в запись SchemaLibrary, которая ссылками возвращается обратно, и $import: в запись MappingLibrary или WorkloadLibrary, которая делает то же самое.

Цепочка сравнивается по каноническому ключу — идентичности библиотеки и имени записи, без хоста реестра и написания версии, — поэтому цикл не может обойти проверку, называя одну и ту же запись по пути двумя разными способами. Ссылка, которая раскрывается и завершается, допустима сколько бы раз она ни встречалась и какой бы глубокой ни была цепочка; сама по себе глубина никогда не вызывает эту остановку, а повторное использование одной библиотечной записи из многих мест — именно то, ради чего существуют библиотеки.

Выводимое сообщение для цепочки $import:, в котором весь цикл назван в порядке обхода, чтобы было видно, какой шаг его замыкает:

circular reference expansion: <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> (циклическое раскрытие ссылок)

О цепочке $ref: вместо этого сообщает компилятор компактной формы, который дополняет её документом и ключевым словом, которые он читал:

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». Тот случай — цикл внутри собственного текста одного документа; этот — цикл между документами. Цепочка в сообщении позволяет сразу их различить: цикл между документами называет библиотечные записи, а цикл внутри одного документа называет якорь.

Объявленная схема не может быть разрешена

Схема дошла до момента, когда ею нужно что-то проверить, и её вообще не удалось собрать в схему. Самая частая причина — $ref:, который не указывает ни на что разрешимое; к той же остановке приводит схема, не удовлетворяющая метасхеме JSON Schema, а также ветвь then: или else: под условным ключевым словом, которую невозможно разрешить саму по себе.

Отказ происходит до того, как что-либо проверяется по схеме, и в этом порядке весь смысл. Пропуск нечитаемой схемы оставил бы всё, что она охватывает, непроверенным, в то время как сборка сообщила бы об успехе, — проверка перестала бы выполняться, и ничто не сообщило бы об этом.

Выводимое сообщение, в котором названы позиция внутри схемы, ключевое слово, которое не удалось разрешить, и то, что сообщило разрешение:

validator/jsonschema: schema resolution failed (at <path-inside-the-schema>, keyword "<keyword>", <what resolution reported>) (validator/jsonschema: не удалось разрешить схему (в <path-inside-the-schema>, ключевое слово “<keyword>”, <what resolution reported>))

Если сбой произошёл в корне схемы, а не на ключевом слове внутри неё, позиция и ключевое слово опускаются, и предложение содержит только сообщённую причину.

Как исправить: откройте схему в позиции, которую называет сообщение. Обычно виноват $ref:: убедитесь, что цель существует, что внутридокументная ссылка точно пишет свой путь #/$defs/… и что междокументная ссылка называет запись SchemaLibrary, которая действительно есть в замыкании зависимостей сборки. Если сообщение называет ветвь then: или else:, эта ветвь сама является схемой и должна быть разрешима сама по себе.

Предикат x-aggrega-when: или x-aggrega-validate: не удаётся вычислить

Схема объявляет одно из двух ключевых слов расширения со значением-шаблоном, и шаблон не удалось использовать: он не является строкой, не разбирается как шаблон, завершился ошибкой при выполнении или отрисовал что-то, отличное от 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 (в <path-inside-the-schema>, ключевое слово “x-aggrega-validate”, <what evaluation reported>))

с "x-aggrega-when" на месте ключевого слова, если ошибка в предикате условной конструкции, и с указанной причиной, называющей ошибку шаблона: позицию разбора, отсутствующую функцию или небулево значение, которое выдал шаблон.

Как исправить: откройте схему в позиции, указанной в сообщении, и прочитайте указанную причину. Убедитесь, что значение ключевого слова — строка, что шаблон разбирается и что каждый путь, по которому он проходит, действительно есть у проверяемого значения: предикат читает значение как .value, и обращение к чему-либо другому — самая частая ошибка. Если причина называет ключ, который не нашёл index, проверяйте наличие ключа с помощью hasKey или читайте его через get: index останавливает сборку на ключе, которого нет в отображении, как описано ниже в разделе «A template indexes a map with a key the map does not hold». Убедитесь, что шаблон в итоге выдаёт true или false: сравнение это делает, а шаблон, который просто отрисовывает значение, — нет.

A Workload does not satisfy the Workload schema (Workload не удовлетворяет схеме Workload)

Блок workload: сущности Recipe или FeatureRecipe был прочитан и проверен по схеме Workload, и одно или несколько полей ей не удовлетворяют: ключ с опечаткой, значение неверного типа, пропущенное обязательное поле, значение вне объявленного диапазона или перечисления.

Отчёт сгруппирован: одна остановка содержит все ошибочные поля, поэтому о Workload с четырьмя ошибками вы узнаете обо всех четырёх за одну сборку, а не по одной за сборку. Заголовок называет Workload, объявляющий его Recipe и файл; каждая находка под ним называет путь к полю внутри Workload, что там требовала схема и исправление, если его можно указать.

Выводимое сообщение:

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): (сбой проверки workload: сущность Workload в сущности Recipe, по указанному пути, этап проверки по схеме) .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 «Что отказ сообщает об объявленном значении».

Сборка сообщает об остановке с тегом CATALOG_ERROR, поскольку блок workload: пишет автор Recipe, а не автор Aggregate или Release.

Как исправить: откройте Recipe по перечисленным путям полей и исправьте каждое. Пути отсчитываются от собственного корня Workload, поэтому .containers.main.health.ready — это блок ready под ключом health контейнера main. Именованный контейнер адресуется по ключу, а 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 называет слот, который сущность не объявляет, или способ доставки, который слот запрещает)

Запись attachments: контейнера внутри блока workload: ссылается на слот вложения, и эта ссылка не согласуется со слотами, которые сущность 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. Для слота, который сокет не объявляет, назовите один из перечисленных в сообщении слотов или объявите слот в featuresSchema сокета на Component. Для составного имени запишите соединение и слот по отдельности, как показано в сообщении.

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

Как исправить: есть два пути, и правильный зависит от того, что вы имели в виду. Если ссылка верна, менять нужно вложение, заполняющее слот: подключите Feature, чей schema.provides объявляет name — и key, если запись не называет собственного, — чтобы появился локатор, на который можно указать. Если материал никогда не предполагалось адресовать по имени в выводе, удалите ссылку и доставьте его через канал inject: слота: он передаёт само значение, а не указатель на место, где оно находится.

A container gives one environment variable two values (Контейнер задаёт одной переменной окружения два значения)

Один контейнер блока workload: называет одну и ту же переменную окружения дважды: один раз как ключ своего variables и один раз как ключ записи attachments, доставляемой as: env. Проверяются и основной контейнер, и init-контейнер — как в Workload, который отрисовывает Recipe компонента, так и в Workload, который отрисовывает FeatureRecipe (как прикреплённый к компоненту, так и объявленный на границе), — и проверка читает Workload в том виде, в каком его отрисовал шаблон.

Почему сборка останавливается, а не выбирает одно из значений. Окружение контейнера записывается из этих двух коллекций в фиксированном порядке: провайдеры helm и compose сначала записывают все записи, читаемые из прикреплений, а обычные variables — после них. Поэтому имя, записанное обоими способами, дойдёт до процесса с тем значением, которое позволит победить этот порядок, а это следствие того, куда попадают два вида записей, а не того, что вы написали, поэтому сборка отклоняет такую пару вместо того, чтобы её отрисовать. Проверка выполняется один раз, какой бы провайдер ни отрисовывал Workload, после остальных проверок Workload и до того, как будут вычислены записи artifacts: или Workload будет передан какому-либо провайдеру, поэтому отклонённая пара никогда не отрисовывается. Запись attachments, доставляемая as: file, монтируется как файл, а не задаётся в окружении, поэтому она никогда не образует пару.

Проверка сравнивает только имена; она никогда не читает значение, поэтому ни одна находка его не цитирует. Два вида записей окружения не входят в то, что она сравнивает: запись envFrom задаёт ключи ConfigMap или Secret, которые она называет, а они неизвестны во время сборки; а запись, которую шаг конвейера записывает в отрисованный документ, не является частью Workload, который читает проверка.

Каждая пара — отдельная находка, привязанная к ключу workload: сущности Recipe или FeatureRecipe, которая объявляет Workload, и называющая переменную и контейнер: основной контейнер — по его ключу, init-контейнер — по его месту в списке initContainers. Находки идут так: сначала основные контейнеры в порядке их написания, затем init-контейнеры по позиции, а внутри одного контейнера — в порядке написания его записей attachments.

Выводимое сообщение для пары в основном контейнере Workload сущности Recipe. Категория и короткий код этого условия, 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>", потому что компонент может нести несколько прикреплений, чьи FeatureRecipes — отдельные документы.

Если один Workload содержит несколько пар, находки группируются под строкой, называющей документ: containers of the Workload this Recipe renders name one environment variable twice (контейнеры Workload, который отрисовывает этот Recipe, называют одну переменную окружения дважды) или, для FeatureRecipe, containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice (контейнеры Workload, отрисованного FeatureRecipe, который связывает прикрепление, называют одну переменную окружения дважды).

Сборка сообщает об остановке с тегом CATALOG_ERROR, потому что блок workload: пишет автор Recipe или FeatureRecipe, а не Aggregate или Release.

Как исправить: решите, какое из двух значений должен получить контейнер. Если нужны оба, переименуйте одно из них, чтобы процесс видел две переменные. Если это альтернативы — например, обычное запасное значение на случай, когда учётные данные не прикреплены, — защитите их взаимодополняющими условиями, чтобы отрисовывалось ровно одно: запишите переменную под {{ 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 (Блок parameters: сущности Release не записан ни в одной из двух форм)

Release выполняет параметры, объявленные в Aggregate, одним из двух способов, и блок читается по своей форме. Либо это отображение имён параметров на значения, записанные на месте, либо отображение ровно с одним ключом, $import:, значение которого — путь к YAML-файлу с этими значениями. Блок, который не является ни тем, ни другим, отклоняется при чтении, до того как что-либо сверит значения с объявлениями 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> (parameters: форма должна быть встроенным объектом или {$import: локальный путь}: $import: должен быть единственным ключом (получено указанное число ключей) в указанной строке) parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line> (parameters: форма должна быть встроенным объектом или {$import: локальный путь}: значение $import должно быть строковым скаляром в указанной строке)

Как исправить: откройте сущность Release на строке, указанной в сообщении. Запишите значения на месте под parameters: или замените весь блок одной записью $import:, значение которой — путь в кавычках. Если вам нужны и записанные значения, и импортируемый файл с общими значениями по умолчанию, перенесите записанные значения в сущность Release, которая через extends: расширяет ту, что содержит импорт: наслаивание нескольких источников параметров — это как раз назначение цепочки extends:, а этот ключ по замыслу читается из одного источника.

Поле «встроенное или импорт» не записано ни в одной из двух форм

Три поля, которые пишет 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: локальный путь}: получено n ключей в строке line) valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> (valuesmapping: форма должна быть строковым скаляром или {$import: путь или идентификатор библиотеки}: получен ключ key в строке line) workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line> (workload: форма должна быть строковым скаляром или {$import: путь или идентификатор библиотеки}: значение $import должно быть строковым скаляром в строке line)

Любое из трёх полей может сообщить любое из этих окончаний; значение, не имеющее ни одной из форм, завершается текстом line <line>: <shape> is written where text or a map is expected, который называет записанное — чаще всего a list.

Как исправить: откройте сущность на строке, указанной в сообщении. Запишите тело на месте как блочный скаляр или замените всё значение одной записью $import:. Отображение, содержащее $import: и что-либо ещё, не является ни одной из двух форм — перенесите лишние ключи в импортируемый файл или запишите тело на месте. Ошибка в написании $import — чаще всего пропущенный $ — читается как обычный ключ и сообщается как единственный ключ, не являющийся $import.

Ссылка на запись библиотеки содержит пробельные символы

Ссылка, указывающая на запись внутри библиотеки, записывается одним неразрывным токеном: библиотека, необязательная нижняя граница версии :<version>, затем # и путь к записи — BaseWorkloads:1.0.0#/workloads/StatelessService. Ни одна её часть не допускает пробельных символов. Имена библиотек и имена записей ограничены схемами библиотек написанием идентификаторов, а версия — это версия, поэтому пробел, табуляция или перевод строки в любом месте ссылки не принадлежат ни одной из трёх частей.

Отказ распространяется на все места, где запись библиотеки указывается по идентификатору: valuesMapping:, workload: и запись artifacts.<name>:, записанные как $import:, а также $ref: схемы. Локальный путь, записанный как $import:, не содержит # и не является ссылкой на запись библиотеки, поэтому путь с пробелом не затрагивается.

Отказывать, а не исправлять, стоит потому, что начальная часть такого значения обычно сама является ссылкой. Обрезка по пробельному символу разрешила бы эту ссылку и незаметно отбросила бы остальное, что написал автор, — а две половины сборки не обязаны отбрасывать одинаковое количество, так что одна могла бы записать зависимость, которую другая никогда не видела. Отказ сохраняет за значением единственный смысл.

Отказ сообщается в строке документа, из которого была прочитана ссылка:

library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line> (ссылка на библиотеку: ссылка на запись библиотеки не содержит пробелов и переносов строк: цель $import reference в строке line)

Ссылка попадает в сборку ещё из одного места: из тела записи библиотеки, уже разрешённой сборкой, где $import: в корне поля на первой строке указывает на запись другой библиотеки. Эта ссылка никогда не читалась из документа, открытого сборкой, поэтому сообщается без строки:

library reference: a reference to a library entry carries no whitespace or line break: "<reference>" (ссылка на библиотеку: ссылка на запись библиотеки не содержит пробелов и переносов строк: reference)

Как исправить: откройте сущность в строке, указанной в сообщении, и сомкните ссылку в один токен. Обычная причина — перевод строки перед #: ссылка, перенесённая на две строки, чтобы уложиться в ширину колонки, читается YAML как одно значение, а здесь — как сломанная ссылка, поэтому записывайте её в одну строку, какой бы длинной она ни была. Другая причина — пробел в конце перед закрывающей кавычкой: он попадает в нижнюю границу версии, где обозначает версию, которой нет ни у одного опубликованного артефакта. Во второй форме ссылка находится внутри библиотеки, названной в сообщении непосредственно перед ней; исправьте её там, где эта библиотека объявляет запись.

Тело записи библиотеки не имеет формы, которую хранит эта библиотека

Библиотека публикует именованные тела для импорта другими сущностями, и каждый вид библиотеки хранит одну форму. Запись 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-name>” не объявлен в spec.templates) schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>") (schemalibrary: отсутствует параметр шаблона: “<parameter-name>” (шаблон “<template-name>”)) schemalibrary: template parameter type mismatch: <what the type check found> (schemalibrary: несоответствие типа параметра шаблона: <what the type check found>) schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params (schemalibrary: несоответствие типа параметра шаблона: аргумент “<argument-name>” не объявлен в $params шаблона “<template-name>”)

Как исправить: если шаблон не найден, исправьте имя на одно из объявленных в библиотеке в spec.templates — и проверьте, что импортируете нужную библиотеку. Если параметр отсутствует, добавьте его в $args: или задайте параметру default: в шаблоне, чтобы вызывающие стороны могли его опускать. При несоответствии типа приведите аргумент к объявленному типу или расширьте type: параметра; если сообщение называет необъявленный аргумент, исправьте его написание или удалите его.

Схема использует ключевое слово JSON Schema, которое библиотека не допускает

$dynamicAnchor и $dynamicRef не допускаются в содержимом SchemaLibrary. Они откладывают выбор схемы, на которую разрешается ссылка, до момента валидации значения, из-за чего смысл записи библиотеки зависит от того, откуда она импортирована, а не от того, что в ней написано, — а компилятор разрешает формы библиотеки до любой валидации, поэтому отложенной ссылке не на что разрешаться.

Отказ применяется в трёх точках, которые вместе перекрывают оба пути, которыми может прийти это ключевое слово. Запись схемы проверяется при загрузке библиотеки. Тело шаблона проверяется при загрузке библиотеки, поэтому шаблон, буквально содержащий ключевое слово, отклоняется именно тогда, а не при той сборке, которая первой создаст его экземпляр. И тело после подстановки проверяется повторно после создания экземпляра, поэтому передача ключевого слова как значения аргумента не позволяет обойти первые две проверки.

Выводимое сообщение:

schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line> (schemalibrary: запрещённое ключевое слово JSON Schema: “$dynamicRef” в строке <line>)

Как исправить: замените отложенную ссылку на $ref, напрямую указывающий на запись $defs. Если форма действительно меняется от использования к использованию, выразите эту вариативность шаблоном с $params и создавайте его экземпляр для каждого использования — это и есть подстановка, которую предлагает этот механизм, и она выполняется до того, как что-либо будет валидироваться по результату.

Документ вложен глубже, чем спускается читатель

Каждое написанное автором отображение считывается в структуру, сохраняющую порядок, в котором были записаны ключи, потому что этот порядок попадает в отрисованный вывод и входит в то, что делает сборку побайтно идентичной между запусками. Этот читатель спускается на ограниченное число уровней — сто — и отказывается идти глубже, поэтому входные данные, которые иначе исчерпали бы собственный стек читателя, сообщаются как отказ, которым они и являются.

Выводимое сообщение:

a document nests too many levels deep: it is read at most 100 levels deep (документ имеет слишком глубокую вложенность: читается не более 100 уровней)

Как исправить: реальные документы, написанные авторами, вложены на несколько уровней, поэтому документ, достигающий сотни, сгенерирован, переведён машиной или случайно ссылается сам на себя. Найдите значение, развернувшееся само в себя: YAML-якорь, ссылающийся на содержимое, внутри которого он находится, отклоняется собственной остановкой выше, а генератор, многократно выдающий одну и ту же форму, — нет. Если глубина настоящая, вынесите глубокую ветвь в отдельную сущность и ссылайтесь на неё по имени.

Провайдер объявляет общеизвестную аннотацию в области, которую он не отрисовывает

Сущность Plugin, обслуживающая провайдер, сообщает о себе две вещи, которые должны согласовываться. В spec.provider.wellKnownAnnotations она перечисляет аннотации, на которые реагирует, каждую с областями, в которых их читает. В contract.inputKinds она указывает, какие виды входных данных вообще отрисовывает. Ключ, объявленный в области, вид входных данных которой та же сущность не заявляет, означает, что эти два утверждения противоречат друг другу в одном файле, поэтому сущность отклоняется при загрузке.

Проверка — это сравнение сущности с самой собой, поэтому ей не нужен бинарный файл плагина и она срабатывает везде, где читается сущность, — в том числе при обходе каталога на машине, которая ни разу не загружала артефакт.

Две записи намеренно не сравниваются. Запись с областью границы не называет вида входных данных, потому что она разрешается один раз для всей границы, а не на пути отрисовки какого-либо одного узла. Запись, вообще не объявляющая области, не делает утверждений о путях: она лишь говорит, что плагин где-то читает этот ключ.

Чего отказ не устанавливает, так это истинности оставшегося объявления. Ничто не может доказать, что плагин, обслуживающий провайдер, читает ключ, который он заявляет; сравнение двух написанных полей может лишь отклонить пару, которая не может быть истинной одновременно. Ключ, объявленный в области, которую провайдер отрисовывает, но плагин которого там ничего не читает, здесь проходит.

Выводимое сообщение:

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 (провайдер “<plugin-name>” объявляет общеизвестную аннотацию “<key>” в области “<scope>”, но его contract.inputKinds.<field> не заявлен; объявляйте ключ только в области, которую провайдер отрисовывает, или заявите этот тип входных данных: wellKnownAnnotations: ключ объявлен в области, которую контракт провайдера не отрисовывает)

Как исправить: сообщение называет обе половины. Либо уберите эту область из списка scope: аннотации, оставив области, которые провайдер отрисовывает, либо заявите вид входных данных в contract.inputKinds, если провайдер действительно его отрисовывает.

A compact-form schema uses a keyword the compact form does not know (Схема в компактной форме использует ключевое слово, неизвестное компактной форме)

Схема, записанная в компактной форме, содержит ключ, который не является ни ключевым словом компактной формы, ни одним из ключевых слов JSON Schema, которые форма пропускает без изменений, ни одним из трёх маркеров, зарезервированных формой, — $jsonschema:, $mode: и $ref:. Неизвестные ключи отклоняются при чтении схемы, а не отбрасываются, потому что опечатка в ограничении, которая игнорируется, превращается в отсутствие ограничения, а схема, которая выглядит действующей и ничего не проверяет, хуже схемы, которая завершается ошибкой.

Этот отказ возникает везде, где компилируется схема. Записи сущности SchemaLibrary компилируются при загрузке каталога; spec.schema сущности Component, её valueSchema и infraSchema для каждого сокета, а также схемы, которые объявляют сущность Feature и сущность Plugin провайдера, компилируются при чтении каталога. spec.schema сущности Component или Feature сообщает об этом условии сама, называя сущность и поле; valueSchema или infraSchema сокета сообщает внутри «A declared schema contract cannot be read as a schema (Объявленный контракт схемы невозможно прочитать как схему)» ниже, а приведённое здесь предложение становится её подробностью.

Собственное сообщение компилятора компактной формы называет позицию внутри схемы, строку исходного файла и ключ, который он не распознал:

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) (соседний ключ рядом с межд документной ссылкой $ref не допускается; допускаются: 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 (соседний ключ рядом с междокументной ссылкой $ref не допускается; допускаются: properties, required, description; используйте $jsonschema:, чтобы встроить схему открытого объекта, если объединённая структура должна принимать произвольные свойства)

Условие, под которым это регистрируется, — compactform: unknown keyword; именно к нему разрешается его короткий код.

Как исправить: исправьте ключ в позиции, которую называет предложение, сверившись со словарём ключевых слов в compact-form-authoring.md — самая частая причина — опечатка. Если форме действительно нужно ключевое слово JSON Schema, которого нет в компактной форме, запишите этот фрагмент под $jsonschema:, который встраивает JSON Schema дословно. Рядом с межд документной ссылкой оставляйте только properties:, required: и description:; всё остальное должно находиться в записи библиотеки, на которую указывает ссылка.

A compact-form schema declares a field literally named type (Схема в компактной форме объявляет поле, буквально названное type)

Компактная форма определяет смысл отображения по форме его содержимого: ключ type: обозначает лист-ограничение, структурные ключевые слова JSON Schema обозначают фрагмент, передаваемый без изменений, а отображение простых имён обозначает объект, дочерние элементы которого являются схемами. Схема, объявляющая поле с именем type, — единственная форма, которую эти прочтения не могут различить: она выглядит как лист-ограничение, а задумана как объект с одним полем, — поэтому форма просит автора указать, что имеется в виду, ключом $mode: со значением compact или jsonschema.

Об этом условии сообщает $mode:, записанный с любым другим значением. Маркер существует, чтобы разрешить неоднозначность, поэтому значение, которое ничего не разрешает, отклоняется, а не угадывается.

Собственное сообщение компилятора компактной формы:

compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema (значение должно быть compact или jsonschema)

Условие, под которым это регистрируется, — compactform: ambiguous dispatch — $mode required; именно к нему разрешается его короткий код.

Как исправить: задайте $mode: compact, если отображение — объект компактной формы, среди полей которого оказалось поле с именем type, или $mode: jsonschema, если отображение — фрагмент JSON Schema, который следует принять как написан. Если ни одно из прочтений не подразумевалось, переименование поля устраняет неоднозначность вообще без маркера.

A $jsonschema: escape carries content that is not a schema (Запасной выход $jsonschema: содержит содержимое, не являющееся схемой)

Ключ $jsonschema: дословно встраивает фрагмент JSON Schema для форм, которые компактная форма не выражает. Встраиваемое принимается как написано и никогда не преобразуется, поэтому оно обязано быть схемой: блочным скаляром, который разбирается как YAML, или вложенным отображением. Содержимое, не являющееся ни тем, ни другим, отклоняется здесь, а не передаётся дальше для проверки по нему, где ошибка была бы сообщена против потребителя схемы, а не против самой схемы.

Под этим условием сообщается о четырёх формах, и предложение указывает, какая из них у вас. Тело запасного выхода не разбирается как YAML. Значение запасного выхода не является ни блочным скаляром, ни отображением. Ключ properties: содержит что-то, что не является отображением имён на схемы. И на самом внешнем уровне документ, переданный компилятору, пуст или содержит узел, для которого у читателя нет правила.

Собственные сообщения компилятора компактной формы:

compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> (содержимое запасного выхода не разбирается как YAML) 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: неподдерживаемый вид узла YAML)

Условие, под которым это регистрируется, — compactform: $jsonschema content invalid; именно к нему разрешается его короткий код.

Как исправить: запишите тело запасного выхода как блочный скаляр под $jsonschema: — иначе тело, первая строка которого читается как ключ YAML, поглощается окружающим отображением, что и является частой причиной, — и проверьте, что его содержимое само по себе является корректной JSON Schema. Если фрагмент достаточно мал, чтобы выразить его в компактной форме, проще отказаться от запасного выхода.

A compact-form constraint does not apply to the type it was written on (Ограничение компактной формы неприменимо к типу, для которого оно записано)

Ограничения компактной формы распределяются по объявленному типу поля: min: и max: становятся числовой границей для числа, границей длины для строки и границей количества для массива. Поэтому ограничение должно стоять на поле, тип которого его принимает, а тип должен быть единственным значением, чтобы у распределения вообще был ответ.

Под этим условием сообщается о четырёх формах. Ограничение записано там, где type: отсутствует или называет объединение, так что ничто не определяет, какая граница имелась в виду. Ограничение записано на типе, который не принимает границы такого вида, — объекте или логическом значении. type:, значение которого не является ни скалярным именем, ни последовательностью имён. И valuesType:, которому задано что-то, кроме скалярного имени.

Собственные сообщения компилятора компактной формы:

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 (ограничение применяется к одному объявленному типу; тип не определён — сузьте type: до одного значения или удалите это ограничение) compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> (ограничение применяется к integer/number/string/array; объявлен другой тип) 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: библиотека, от которой ничто не объявляет зависимость, не загружается, поэтому даже корректная ссылка на неё ни во что не разрешается.

Когда библиотека находится только в кэше артефактов. Кэш хранит то, что туда поместила загрузка, и кэшированная библиотека считается содержимым каталога, только если запись в lockfile сущности Release подтверждает её дайджест. Когда кэш содержит SchemaLibrary, которую не закрепляет ни одна запись lockfile и не предоставляет ни одна директория каталога, за сообщением следует строка remediation:, называющая каждую такую библиотеку и действие, которое работает для сообщившей команды:

  • aggrega build и aggrega validate --release читают lockfile сущности Release, поэтому их строка называет aggrega pull --release <release>, который разрешает библиотеку и фиксирует её запись, либо создание библиотеки в директории каталога.
  • aggrega validate без аргументов, а также aggrega validate с путём к сущности, независимо от того, указан ли --release, читают библиотеки только из директорий каталога и не читают lockfile, поэтому зафиксированная запись не изменила бы их вердикт. Их строка сообщает об этом и указывает на создание библиотеки в директории каталога либо на aggrega pull --release <release> с последующим aggrega validate --release <release>, который проверяет Release по библиотекам, закреплённым в его lockfile.

Если 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>

а если не разбирается, сообщение заканчивается после значения:

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity: <the value as written>

Условие, под которым это регистрируется, — compactform: cross-document $ref carries a registry host; reference the library by identity; именно в него разрешается его короткий код.

Как исправить: удалите хост и всё, что стоит перед именем библиотеки, оставив <Library>#/schemas/<Entry>. Если нужна нижняя граница версии, укажите её после имени библиотеки как :<version>. То же правило действует для полей $import: в сущностях Recipe и FeatureRecipe, о которых сообщается отдельно в разделе «A library $import: addresses its library by registry location (Импорт библиотеки адресует библиотеку по расположению в реестре)» ниже.

A schema $import: cannot be applied (Не удаётся применить $import: схемы)

Поле spec.schema сущности Component или Feature — весь блок или один его столп — а также valueSchema: или infraSchema: сокета usesSchema можно записать как $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: заменяет значение целиком, поэтому соседнему ключу не с чем объединяться.
  • $import: value must be a path to a file (значение $import: должно быть путём к файлу). Значение пустое или не является одной строкой.
  • $import: takes a file path beside this entity, not a registry location <value> ($import: принимает путь к файлу рядом с этой сущностью, а не расположение в реестре <value>). Значение адресует реестр. Через какой реестр разрешается имя, определяется конфигурацией рабочего пространства, поэтому поверхность схемы никогда его не содержит; сообщение называет форму ссылки, которую следует использовать.
  • $import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead ($import: принимает путь к файлу рядом с этой сущностью; вместо этого сошлитесь на запись SchemaLibrary <value> через $ref:). Значение адресует запись библиотеки. На запись библиотеки ссылаются, а не импортируют её — $ref: и есть ключевое слово, которое её разрешает.
  • imported schema <value> must be a YAML map of schema content; it is not (импортированная схема <value> должна быть 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 (Блок схемы называет ключ, не являющийся столпом данных)

Блок spec.schema сущности Component или Feature содержит столпы данных сущности, и допускает он ровно три ключа: 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: с именем файла рядом с сущностью заменяется содержимым этого файла до чтения блока, поэтому это условие проверяет верхний уровень самого импортированного документа — лишний ключ внутри импортированного файла сообщается здесь, а сама директива — никогда. А сущность Component, объявляющая extends, записывает вместо блока голую строку inherited — скаляр, не содержащий ключей вовсе.

Как исправить: предложение называет встреченный ключ и три допустимых, поэтому самая частая причина — опечатка или единственное число там, где имя столпа во множественном, — видна из одной диагностики. Если содержимое под лишним ключом относится к какому-либо столпу, перенесите его под values:, infra: или provides: в соответствии с принадлежностью; data-pillars.md указывает, какой столп чем владеет. Если оно задумывалось как самостоятельное содержимое схемы, его место на уровень глубже — внутри столпа, а не рядом со столпами. Форма, опубликованная SchemaLibrary, подключается через $ref: <Library>#/schemas/<Entry>, записанный внутри столпа, а не на уровне блока.

Плагин просит хост разобрать источник, когда для него уже выполняется разбор

Плагин может попросить хост разобрать источник и вернуть результат, чтобы плагину, которому нужен документ в каком-либо формате, не приходилось нести собственный парсер для него. Хост запускает плагин, выполняющий разбор, и возвращает то, что тот выдал. Это условие возникает, когда плагин, вызванный таким образом, сам запрашивает разбор: запрос повторно вошёл бы в тот же механизм, внутри которого он уже выполняется, и хост отказывает вместо того, чтобы спускаться глубже. Механизм предоставляет ровно один уровень такой вложенности, и именно отказ ограничивает его одним уровнем.

Отказ получает плагин, а не сборка. Хост не останавливается на этом и не сворачивает выполнение; он отвечает на вызов конвертом ошибки, содержащим приведённое ниже сообщение и код, обозначающий отказ, и запросивший плагин получает его как ответ на свой запрос. Что затем произойдёт со сборкой, зависит от того, как этот плагин поступит с ответом: плагин, считающий его фатальным, завершает сборку, а плагин, который сообщает об ошибке и продолжает работу, — нет. Сам отказ в обоих случаях одинаков.

Это не вина какого-то конкретного из двух плагинов: защита распространяется на любую пару плагинов, через которую прошёл запрос, а не на одну определённую пару, поэтому один и тот же отказ возникает везде, где происходит повторный вход в механизм.

Выдаваемое сообщение в том виде, в каком его получает плагин:

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: повторный вход в producer-consumption запрещён: производитель, вызванный через хост, не может выполнять дальнейший вызов producer-consumption)

Как исправить: ничто в ваших собственных файлах не вызывает это условие, и никакое изменение в них его не устранит — это свойство плагинов, с которыми настроена сборка. Исправлять нужно плагин, который запрашивает разбор изнутри разбора, поэтому сообщите об условии тому, кто его публикует, приведя текст сообщения. Если этот плагин ваш, пусть он читает переданный ему источник напрямую, а не просит хост разобрать другой, пока сам обслуживает разбор.

The workspace configuration is invalid (Конфигурация рабочего пространства недействительна)

Рабочее пространство описывается файлом .aggrega-config.yaml в его корне: в какой реестр оно публикует и из какого получает, где находится кэш артефактов, какие плагины подключены к каким сокетам и какова политика подписи каждого реестра. Этот файл читается и проверяется по своей схеме до того, как открывается любой файл сущности, потому что всё последующее читается из него.

Отсутствие файла — не ошибка. Рабочее пространство без файла конфигурации получает задокументированные значения по умолчанию, поэтому эта остановка никогда не называет отсутствующий файл. Она называет файл, в котором было значение, — или, для настройки, которую переопределяет переменная окружения и которую схема никогда не видит, саму переменную.

Проверка выполняется до того, как документ превращается в типизированные настройки. Именно такой порядок позволяет сообщению назвать путь к полю, против которого возразила схема, а не сообщать о несоответствии типов откуда-то дальше, без поля, на которое можно указать.

Помимо обычного возражения схемы, здесь сообщается о следующих формах — о каждой потому, что сама схема может сказать лишь нечто слишком общее, чтобы по этому действовать: ключ workspace:, под которым ничего не написано; ключ, место которого на верхнем уровне, но написанный под workspace:; блок cache:, записанный под именем, которое файл не использует; хост реестра, записанный не так, как записывается хост реестра; и три настройки, значения которых схема допускает, но рабочее пространство использовать не может, — artifact_cache_dir, который является абсолютным или называет сам корень рабочего пространства, запись signing.kinds, называющая то, что не является публикуемым видом артефакта, и запись plugins.providers или providers_append, чей uri является расположением в реестре, записанным с oci://. Привязка провайдера называет свой плагин по его идентификатору, provider/<name> с необязательным :<version>, потому что именно с этим идентификатором сопоставляется привязка при разрешении возможности; расположение в реестре говорит, где плагин опубликован, а не какой это плагин, поэтому запись в такой форме никогда не смогла бы ничего выбрать. Запись, которая называет функцию входа через function: без uri:, также сообщается здесь, если это запись plugins.linter или linter_append либо запись plugins.governance или governance_append в роли вердикта, ir-verdict или render-verdict: эти подключения выбирают свой плагин по uri, поэтому такая запись не подключает никакого плагина, и функция, которую она называет, никогда не была бы вызвана, — линт продолжал бы работать так, будто записи нет, а сборка остановилась бы лишь позже, когда дошла бы до разрешения плагина, который запись так и не назвала.

Директория каталога, которую перечисляет конфигурация, — в workspace.catalog_dirs или catalog_dirs_append либо в собственной записи сущности Release в workspace.releases, в любом файле, из которого читается конфигурация, — также сообщается здесь, если она не является директорией: по этому пути ничего не существует либо там находится файл или ссылка, ведущая в никуда. Это оценивается в тот момент, когда через неё должен быть прочитан каталог, поэтому каждая команда, читающая каталог, отклоняет её, прежде чем что-либо прочитать или записать, а команда, которая не читает каталог, по-прежнему выполняется. Продолжение чтения без неё означало бы сборку с меньшим числом каталогов, чем вы перечислили, и ничто не указывало бы, каких именно не хватает. Директория, перечисленная в AGGREGA_CATALOG_DIRS, подчиняется тому же правилу, и отказ называет переменную вместо файла.

Хост реестра — host записи registries или хост, с которого начинается default_registry, если он не называет одну из этих записей по её name: (в этом случае он обозначает хост этой записи), — записывается как сам хост: в нижнем регистре, с точкой, либо localhost, либо одно имя с портом, либо IP-адрес (IPv6 — в квадратных скобках), каждый с необязательным :port, без схемы и учётных данных. Хост записи registries не содержит пути; в default_registry за хостом может следовать / и путь к репозиторию — сегменты в нижнем регистре, соединённые /, без тега, дайджеста и завершающего /. Значение, называющее хост в другом написании, отклоняется с указанием написания, которое следует использовать (для default_registry — всего расположения, включая путь), чтобы к нему применялась политика доверия, хранимая для этого хоста; это относится и к порту 443 на хосте, доступном по HTTPS, поскольку это порт этого хоста по умолчанию. Путь, не являющийся путём к репозиторию, отклоняется с указанием хоста, за которым он следует, а name: записи, за которым следует путь, отклоняется с указанием двух написаний, которые следует использовать вместо него: только имя или хост записи с последующим путём, поскольку имя обозначает хост своей записи, а не расположение под ним. Значение, не называющее никакого хоста, — одно имя без порта, которое не носит ни одна запись, или текст с пробелами или фигурными скобками, — отклоняется как не являющееся хостом, а для default_registry в отказе говорится, что подойдёт и имя записи. AGGREGA_DEFAULT_REGISTRY читается так же и отклоняется так же, с указанием переменной.

Выводимые сообщения. Возражение схемы называет файл, путь к полю и то, что сказала схема:

workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid (workspaceconfig: конфигурация рабочего пространства недействительна)

Формы с подсказкой по исправлению начинаются с файла и вместо пути к полю и возражения схемы содержат предложение о конкретной форме. 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 указывает на сам корень рабочего пространства; тогда каталог каталога в корне рабочего пространства был бы пропущен как кеш и загружать было бы нечего — выделите кешу собственный подкаталог (например, .aggrega/cache): конфигурация рабочего пространства недействительна)

непригодная запись 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” для всех видов: конфигурация рабочего пространства недействительна)

привязка провайдера, записанная как расположение в реестре, с указанием записи, возможности и формы, которую следует написать:

<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 привязывает возможность к расположению в реестре — это место, где плагин опубликован, а не то, какой это плагин; привязка провайдера называет свой плагин по его идентификатору — укажите в 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 “HUB.AGGREGA.AI” записан не так, как называемый им хост реестра; напишите “hub.aggrega.ai” — в нижнем регистре, без схемы, пути, учётных данных и порта по умолчанию, — именно под таким написанием хранится политика доверия этого хоста: конфигурация рабочего пространства недействительна)

реестр по умолчанию, хост которого перед путём к репозиторию записан в другом написании, здесь 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 “GHCR.io/acme” записан не так, как называемое им расположение реестра; напишите “ghcr.io/acme” — хост реестра в нижнем регистре, без схемы, учётных данных и порта по умолчанию, с последующим путём к репозиторию, — тогда к нему продолжит применяться политика доверия этого хоста: конфигурация рабочего пространства недействительна)

имя записи с последующим путём, здесь 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 “local/acme” — это имя записи registries “local” с последующим путём, а имя записи обозначает только хост этой записи; напишите “local”, чтобы использовать запись, или её хост с последующим путём, “127.0.0.1:5000/acme”: конфигурация рабочего пространства недействительна)

значение, не называющее хоста, — предложение в сообщении перечисляет формы, которые принимает хост:

<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 не является хостом реестра; укажите имя хоста в нижнем регистре, содержащее точку (registry.example.com), localhost, одно имя с портом (registry:5000) или IP-адрес, IPv6-адрес — в квадратных скобках, каждый с необязательным :port и ничем больше: конфигурация рабочего пространства недействительна)

перечисленная директория каталога, по пути которой ничего не существует; сообщение называет файл и строку, список, запись в том виде, как она написана, и путь, в который она разрешилась, — списком является workspace.catalog_dirs, workspace.catalog_dirs_append или список записи сущности Release, например `catalog_dirs` of the `workspace.releases` entry "release.yaml":

<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 (workspaceconfig: workspace должен быть отображением; напишите 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 действительно объявляет форматы, которые он обрабатывает, но какой формат нужен, решает импорт, а не подключение: подключение importer называет свой importer через uri:, и именно это выбирает его среди importer, объявляющих формат, который запрашивает импорт.
  • Сокет провайдера, задающий ключ без объекта ссылки. Привязка провайдера называет возможность и обслуживающий её плагин, а плагин управляет фиксированным набором экспортов, а не одной выбираемой точкой входа, поэтому function: в нём ничего не называет. with: отклоняется по другой причине: конфигурация рендеринга для провайдера записывается в Recipe, поэтому, помещая её в привязку рабочего пространства, вы оказываетесь не на той стороне разделения между разработчиком и оператором.

Выводимые сообщения. Возможность на сквозном сокете:

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 (workspaceconfig: сокет <socket> привязан по capability «<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 (workspaceconfig: привязка сокета провайдера для capability «<capability>» задаёт function:, но провайдер использует фиксированный набор экспортов по фазам, а не одну выбираемую точку входа, поэтому function: там ни на что не указывает; удалите его: привязка сокета провайдера задаёт поле, которому на этом сокете ничего не соответствует)

и бесполезный 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 (workspaceconfig: привязка сокета провайдера для capability «<capability>» задаёт with:, но конфигурация рендеринга провайдера относится к Recipe, а не к привязке провайдера в рабочем пространстве; удалите его: привязка сокета провайдера задаёт поле, которому на этом сокете ничего не соответствует)

function:, записанный в .aggrega-config.yaml, не доходит до приведённого выше предложения: схема конфигурации рабочего пространства не объявляет такого ключа у привязки провайдера, поэтому файл отвергается раньше, под E0224, а решение то же — удалить ключ:

workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid (workspaceconfig: function записи plugins.providers: по /$defs/FixedEntryPluginRef: неожиданное свойство “function”: конфигурация рабочего пространства недействительна)

Как исправить: исправление вносится в .aggrega-config.yaml, и каждое сообщение называет точную правку. В подключении governance, linter или importer замените capability: на uri: плагина, который вы собирались подключить. В привязке провайдера удалите названный ключ, а если это был with:, перенесите эту конфигурацию в Recipe, который выполняет рендеринг через этот провайдер, — именно он её читает.

A capability is bound to more than one provider plugin (Возможность привязана более чем к одному плагину провайдера)

Возможность называет один способ превращения рабочей нагрузки в артефакты, и в разрешённом рабочем пространстве её обслуживает ровно один плагин. Две привязки для одной возможности не оставляют ответа на вопрос, какая из них выполняет рендеринг, а конфигурация рабочего пространства собирается из нескольких слоёв — общего файла, файла рабочего пространства и дополняющих файлов, которые может добавить каждый из них, — поэтому вторую привязку часто добавляет слой, автор которого не мог видеть первую.

Именно отказ делает это видимым. Если бы одна привязка молча побеждала, результат рендеринга зависел бы от того, какой слой оказался прочитан последним.

Выводимое сообщение, называющее возможность и правило:

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 (workspaceconfig: capability «<capability>» привязана более чем к одному плагину провайдера; оставьте ровно одну запись plugins.providers на каждую capability: capability привязана более чем к одному плагину провайдера)

Как исправить: оставьте одну запись plugins.providers для возможности, названной в сообщении, и удалите другую. Если они происходят из разных слоёв конфигурации, редактировать следует слой, которым управляете вы: удалив свою запись, вы принимаете запись общего слоя, а сохранив свою, должны удалить запись общего слоя. Два плагина, которые действительно оба обслуживают рабочее пространство, обслуживают две разные возможности, поэтому, если нужны оба, дайте каждому собственную возможность, а не привязывайте одну дважды.

An importer is attached by more than one plugins.importer entry (Импортёр подключён более чем одной записью plugins.importer)

Запись plugins.importer подключает импортёр, названный её uri: если этот импортёр объявляет формат, запрошенный импортом, запись определяет, какая его версия запускается, и передаёт ему with.sources и with.settings записи. Одна запись делает это для одного импортёра, поэтому вторую запись, называющую тот же импортёр — с той же идентичностью, в той же или другой версии, — ничто бы не прочитало, и её with не дошёл бы ни до какого импортёра без единого сообщения. Вместо этого конфигурация отклоняется при загрузке, какая бы команда её ни читала.

Конфигурация рабочего пространства собирается из нескольких файлов — глобального файла, каждого .aggrega-config.yaml от корня проекта до каталога, в котором запускается команда, дополняющего файла importer_append, который может иметь каждый из них, и файла конвейера .aggrega-config-append-ci.yaml, — поэтому вторая запись часто написана в другом файле, чем первая. Сообщение называет импортёр и обе записи, сначала более раннюю, каждую — по ключу и позиции, под которыми она записана, файлу, в котором она записана, и её uri в том виде, в каком он там записан.

Проверяется только список импортёров: списки governance и linter допускают подключение одного плагина более одного раза, причём каждое подключение несёт собственный with. Запись, чей uri является путём в файловой системе, не называет импортёр, поэтому не сравнивается.

Выводимое сообщение:

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 (importer «<identity>» подключён записью <key>[<position>] в <file> (uri «<uri>») и повторно записью <key>[<position>] в <file> (uri «<uri>»); оставьте ровно одну запись plugins.importer на каждый importer, чей uri указывает нужную вам версию: importer подключён более чем одной записью plugins.importer)

Как исправить: оставьте одну запись для импортёра, названного в сообщении, — ту, чей uri называет нужную вам версию и которая несёт with, который вы хотите передать этому импортёру, — и удалите другую. Если записи находятся в разных файлах, редактировать следует файл, которым управляете вы: удалив свою запись, вы принимаете запись другого файла, а сохранив свою, должны удалить запись другого файла.

A provider binding names a capability containing a colon (Привязка провайдера называет возможность, содержащую двоеточие)

capability: сущности Recipe читается как имя возможности до последнего двоеточия и закрепление версии после него: helm:1.0.0 запрашивает возможность helm версии 1.0.0. Запись plugins.providers ищется по этому имени, поэтому возможность, которую называет привязка, никогда не содержит двоеточия, а запись, чья возможность его содержит, недостижима ни для одного Recipe. Вместо того чтобы позволить ей непрочитанной оставаться в конфигурации, конфигурация отклоняется при загрузке, какая бы команда её ни читала.

Проверяется только список провайдеров. Список importer использует ту же форму записи, но его плагины подключаются через uri: и называют свои форматы import:<format>, где двоеточие является частью имени. uri: привязки по-прежнему может заканчиваться на :<version>; это не та часть, которую читает это правило.

Выводимое сообщение, называющее возможность:

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 «<capability>»: ссылка на capability в Recipe читается как capability до последнего двоеточия и закрепление версии после него, поэтому capability, которую называет привязка, не содержит двоеточия; привяжите только имя capability и позвольте каждому Recipe закрепить нужную ему версию: привязка сокета провайдера называет capability, содержащую двоеточие, которую не может выбрать ни один Recipe)

Как исправить: запишите в записи только имя возможности — capability: helm — и закрепляйте версии там, где им место: Recipe закрепляет нужную ему версию провайдера в собственном capability:, а привязка, которая должна выбирать определённую версию своего плагина, записывает её в идентичности плагина: uri: provider/helm:1.0.0.

A governance attachment declares no role, or one that is not a known role (Подключение governance не объявляет роль или объявляет неизвестную роль)

Подключение governance несёт роль, и именно роль, а не собственный объявленный тип плагина, определяет, где выполняется подключение и что ему разрешено: принимает ли оно сборку или отклоняет её и читает ли оно граф или отрендеренные артефакты. Подключения распределяются по этой роли, поэтому подключение без роли или с ролью, которую никто не распознаёт, ни к чему бы не подключилось и было бы молча пропущено.

Именно такое молчание и предотвращает отказ. Плагин governance, который настроен, но ни разу не вызван, даёт ровно тот же результат, что и сборка, к которой governance вообще не применялся, и ничто в результате не говорит, какой из двух случаев перед вами.

Выводимые сообщения; оба называют подключение и перечисляют существующие роли. Отсутствующая роль:

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 не объявляет роль или объявляет неизвестную роль)

Как исправить: задайте role: для подключения в plugins.governance, выбрав одну из ролей, перечисленных в сообщении. Какую именно — это решение о том, что вы хотите от плагина, а не о самом плагине: роль, которая принимает или отклоняет, читает сборку и возвращает вердикт, а роль, которая преобразует, — это явное указание позволить плагину изменять то, что он получает. Сообщение перечисляет полный набор, поэтому нужное написание есть в самом сообщении.

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 (Lock-файл не соответствует своей схеме)

Lock-файл релиза фиксирует результат разрешения сборки: для каждой сущности, библиотеки и плагина, до которых она доходит, — выбранную версию и дайджест байтов этой версии. Он читается и проверяется по своей схеме до превращения в типизированные пины, поэтому неподходящий документ отклоняется с путём поля, на котором проверка не прошла, а не порождает молча пины с пробелами.

Lock-файл пишется машиной. Его создаёт pull, разрешающий релиз, и он коммитится, чтобы та же сборка позже разрешалась так же. Поэтому ошибка схемы почти всегда означает ручную правку, слияние, оставившее документ наполовину разрешённым, или lock-файл, записанный для более ранней формы файла — например, такой, у которого entities не содержат kind, — а не что-то написанное намеренно.

Отсутствующий lock-файл — другое условие, и сообщается о нём иначе: lock-файл обязателен, поэтому о его отсутствии сообщается там, где сборка его ищет, с указанием запустить pull, который его создаёт.

Выводимое сообщение, называющее файл, путь поля и собственное возражение схемы:

lockfile: <path>: <field-path>: <the schema's own objection>: lockfile: file failed schema validation (lockfile: файл не прошёл проверку по схеме)

Сборка, а также aggrega pull --verify, добавляют команду, которая заново записывает lock-файл:

…: 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: документ пуст)

Как исправить: не исправляйте lock-файл вручную. Повторно запустите pull для релиза — он перепишет документ по результатам выполненного разрешения — и закоммитьте результат: именно повторное разрешение даёт документ, пины которого согласуются с тем, до чего релиз действительно доходит. Если ошибка возникла после слияния, разрешение конфликта повторным pull, а не правкой, позволяет избежать документа, который разбирается, но закрепляет неверные версии. Путь поля в сообщении стоит прочитать первым: он показывает, находится ли повреждение в одной записи или в общей структуре документа.

При разрешении каталога

После загрузки компилятор обходит два уровня Manifest (карту типов, затем карту имён), чтобы выбрать Recipe для каждого Component, и обходит все цепочки extends у Manifests, Components и Features. Собственная цепочка extends у Release проходится тем же обходом, на шаг раньше: она проходится при разрешении Release, до того как ищется Manifest или Aggregate, на который он указывает, поэтому описанные ниже условия сообщаются относительно Release, а не относительно соседнего указателя, который цепочка должна была предоставить.

Циклическая цепочка 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 (<kind> <name>, правило extends). <entity> расширяет <reference>, которая уже есть в цепочке; удалите extends у <entity> или направьте его на сущность вне цепочки)

Сущность, названная первой, и сущность, названная в ребре, обычно различаются, и в этом весь смысл: цикл сообщается относительно каждой сущности на нём, а редактировать нужно ту строку extends:, которую называет ребро. Следуйте ребру, а не заголовку.

Для Manifest <kind> имеет значение Manifest, каждая сущность называется по своему metadata.name, а <reference> — это значение extends: в точности так, как оно написано: относительный путь, например ./base.yaml, или просто metadata.name сущности Manifest, расположенной рядом с Release. Какую из двух форм вы написали, не влияет на то, что сообщается: звено Manifest — это файл, в который оно разрешается, поэтому два файла Manifest, которые случайно объявляют одно и то же metadata.name, — это два звена, и цепочка через оба не является циклом.

Для сущности Release всё читается так же, и тождество по файлу там важнее, потому что защищаемая им структура вполне обычна: <kind> имеет значение Release, <reference> — относительный путь, который называет extends:, а звено Release — это файл, в который оно разрешается. Два файла Release, названные по развёртываемой системе, а не по окружению, — оба с metadata.name: shared-release, один расширяет другой, — являются двумя звеньями, и цепочка через оба не является циклом.

Цикл сообщается как цикл, какой бы длины он ни был. Обход цепочки применяет ограничение глубины только к цепочке, у которой есть конец, поэтому цикл, охватывающий больше сущностей, чем допускает ограничение, всё равно сообщается здесь, а не как слишком глубокая цепочка: укорачивание цикла никогда не является решением.

Как исправить: откройте сущность, которую называет ребро, и либо удалите её extends:, либо направьте его на сущность, которой ещё нет в цепочке. Если несколько уровней должны были совместно использовать содержимое, объединение дублирующегося содержимого в одну базовую сущность устраняет и цикл, и дублирование.

implements сущности Recipe не совпадает с сопоставленным типом компонента

Запись сопоставления в Manifest указывает на Recipe, чьё объявление spec.implements: не совпадает с ключом типа компонента для этой записи. spec.implements — это якорь согласованности, а не механизм диспетчеризации: значение сопоставления напрямую называет Recipe, а эта проверка подтверждает, что названный автором Recipe объявляет тот тип, который автор сопоставил.

Проверка читает скомпонованный Manifest до разрешения какого-либо Recipe, поэтому она сообщает о записи сопоставления, которую написал автор, а не о её последствии ниже по цепочке.

Выводимое сообщение:

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) (spec.implements рецепта из записи сопоставления в Manifest не совпадает с сопоставленным ключом типа компонента или типа функции)

Эту проверку выполняет каждая команда, читающая зависимости Release; различается лишь то, что каждая из них делает с результатом. aggrega build и aggrega pull останавливаются, потому что обе создают то, чем вы затем будете пользоваться, — отрисованные артефакты и lockfile. aggrega validate и aggrega lint сообщают о находке вместе со всеми остальными найденными диагностиками, а затем завершаются с ненулевым кодом: их задача — сообщить обо всём, что не так в рабочем пространстве, поэтому одна ошибка не обрывает отчёт. В редакторе находка публикуется как диагностика рядом с остальными, и всё прочее, что нужно было сообщить по этому документу, не затрагивается. Обратите внимание, где она появляется: редактор публикует находку в сущности Manifest, в которой записано сопоставление, на ключе записи сопоставления, которую она называет, а не в Aggregate, — на первой строке сущности Manifest, если её открытый текст не содержит этой записи, как для записи, унаследованной через extends. Остальные находки уровня зависимостей Release, которые не называют ни одного документа вашего рабочего пространства, остаются на Aggregate. Запуск aggrega validate сообщает о ней независимо от того, какой документ у вас открыт.

Запись сопоставления, называющая Recipe, которого нет в каталоге, не относится к этому условию: проверке не с чем сравнивать, и она пропускает запись, а о неразрешимом Recipe сообщается при разрешении рецептов.

Записи FeatureRecipe устроены так же; проверка сопоставления features.type выводит manifest feature mapping ... featurerecipe spec.implements is ... (expected ...), а ветвь для фич сопоставляет по самому ключу сопоставления, поэтому не называет альтернативы через extends.

Ключ components.type оценивается также для каждого экземпляра, когда он доходит до экземпляра другой версии. Ключ, не называющий точный тип экземпляра, доходит до него через базу типа, если ни один ключ не называет этот точный тип и для той же базы не записан другой ключ, — поэтому до него может дойти ключ, записанный без версии, или ключ, называющий другую версию. Поэтому одна запись не может сказать, подходит ли её Recipe, и сборка заново оценивает Recipe для каждого экземпляра компонента, до которого ключ доходит таким образом, ставя на место ключа собственный тип экземпляра в той версии, в которой сборка его компилирует: версию, которую называет экземпляр, или, для экземпляра без версии, наивысшую версию этой сущности Component в каталоге. Экземпляр, версии которого не удовлетворяет spec.implements: сущности Recipe — ни точно, ни по диапазону caret, ни как неверсионированный, ни через базу, которую extends тип экземпляра, — вызывает это условие, о котором сообщается по пути .spec.components.<instance> экземпляра, а не в файле Manifest:

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 (spec.implements рецепта из записи сопоставления Manifest не совпадает с сопоставленным ключом типа компонента или типа функции (Manifest; тип экземпляра и версия компиляции, ключ сопоставления, через который он достигнут, сопоставленный рецепт и его spec.implements). сопоставьте этот тип в этой версии с рецептом, который его реализует, с помощью ключа сопоставления, называющего версию)

Значение compiled as появляется только для экземпляра, тип которого не называет версию; экземпляр, называющий версию, показывает её в of type. Ключ, называющий собственную версию экземпляра, не требует второй оценки, поскольку проверка записи уже её выполнила, а запись, уже отвергнутая по своему ключу, сообщается один раз, как выше, а не ещё раз для каждого экземпляра. aggrega build и aggrega pull на этом останавливаются, а aggrega validate --release сообщает об этом и завершается с ненулевым кодом. aggrega lint оценивает записи сопоставления Manifest, а не экземпляры, до которых они доходят, поэтому об этом не сообщает.

Как исправить: либо исправьте объявление spec.implements: в Recipe, чтобы оно совпадало с ключом типа компонента в Manifest, либо измените запись Manifest так, чтобы она указывала на Recipe, чей spec.implements: совпадает с ключом типа компонента. Для экземпляра, до которого ключ доходит в другой версии, добавьте ключ сопоставления, называющий версию экземпляра и сопоставленный с реализующей его сущностью Recipe, или направьте доходящий ключ на такую сущность Recipe.

Manifest mapping value is not a shape a recipe reference accepts (Значение сопоставления в Manifest имеет форму, которую не допускает ссылка на рецепт)

Значение сопоставления в Manifest называет Recipe или FeatureRecipe в форме, которую грамматика ссылок не может выразить. Ссылка на рецепт допускает простое имя, имя с версией, имя с указанием возможности или имя с указанием возможности и версией — не более одного /. Значение, содержащее больше (путь в стиле типа компонента, например core/helm/eso-aws-fetcher:1.0.0), никогда не может назвать сущность каталога, что бы в каталоге ни находилось.

Форма оценивается при компоновке 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: spec.mappings.components.type.<key> сопоставлен с <value>, содержащим <n> сегментов, разделённых косой чертой; ссылка на рецепт допускает “name”, “name:version”, “capability/name” или “capability/name:version”; исправьте значение сопоставления в Manifest)

Раздел features выводит то же сообщение для своей координаты, а ссылка на рецепт фичи называется соответственно.

Значение, сегмент возможности которого содержит закрепление версии, — compose:1.2.3/svc:1.0.0, — отвергается так же, до какого-либо поиска, поэтому из реестра ничего не получается. Закрепление относится к capability, которую объявляет Recipe, где оно выбирает, какая версия плагина, обслуживающего эту возможность, выполняет отрисовку; ссылка называет Recipe по голой возможности (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, которую объявляет рецепт, а ссылка на рецепт называет рецепт по голой возможности; исправьте значение сопоставления в Manifest)

Как исправить: сократите значение сопоставления до формы, которую допускает грамматика. Рецепт идентифицируется своим metadata.name — с необязательным префиксом spec.capability и суффиксом версии — и никогда не путём типа компонента, который он реализует. Ключ сопоставления — это тип компонента; значение сопоставления — это рецепт.

Не путайте с корректно оформленным значением, называющим рецепт, которого нет в каталоге: это действительно отсутствующая сущность, и о ней по-прежнему сообщается как о таковой, с указанием URI и записи сопоставления, которая на неё ссылалась.

Несколько сущностей Recipes реализуют один тип Component

Две или более сущности Recipes объявляют один и тот же тип Component в spec.implements: — две сущности Recipes с точной версией для одного типа или Recipe без версии наряду с закреплённой.

Это не вызывает собственной остановки и не является неоднозначностью, которую сборка должна разрешать. Выбор Recipe выполняется только через сопоставление: ничто не читает spec.implements: и не выбирает среди кандидатов, поэтому сколько бы сущностей Recipes ни реализовывали тип, экземпляр отрисовывает та, с которой его сопоставляет Manifest. Поле spec.implements: читается как якорь согласованности — оно подтверждает, что Recipe, сопоставленная автором, объявляет тип, под которым он её сопоставил, — и как источник кандидатов для закрепления, которые предлагает остановка. Оно никогда не выбирает.

Вместо этого вы встретите остановку для экземпляра, который Manifest ни с чем не сопоставляет, и эта остановка перечисляет все сущности Recipe, реализующие тип, чтобы вы могли закрепить одну из них, — см. ниже «No Recipe is mapped for a component or feature instance (Для экземпляра компонента или функциональности не сопоставлена Recipe)». Она сообщается одинаково, реализует ли тип одна Recipe или пять, поэтому отдельного условия неоднозначности, которое нужно искать, нет.

Как исправить: добавьте сопоставление. Запись с ключом по типу направляет все экземпляры типа; запись с ключом по имени направляет один именованный экземпляр и читается первой, поэтому так же можно назначить одному экземпляру Recipe, отличную от его соседей.

Расходящаяся Release (extends + указатель aggregate)

Release использует extends: для наследования от базовой Release, но также объявляет собственный указатель aggregate:. JSON Schema сущности Release отвергает такую форму при проверке по схеме (уровень 1, проверка конверта) с помощью ограничения allOf: если extends: присутствует, aggregate: запрещён; если extends: отсутствует, обязательны и aggregate:, и manifest:.

Остановка происходит как обычное нарушение конверта, поэтому диагностика принимает форму этого класса — см. «The document-envelope failure class» в error-translation.md, — а находка указывает на ключ, который здесь не разрешён:

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 (проверка конверта документа не пройдена (Release, в <path>); <line>:<column>: spec.aggregate: значение соответствует форме, которая здесь не разрешена. исправьте документ в соответствии со схемой его вида)

Как исправить: удалите поле aggregate: из дочерней Release. Наследование намеренно заставляет дочернюю сущность развёртывать то же намерение разработчика (Developer Intent), что и родительская; если нужно развернуть другой Aggregate, создайте новую Release без extends:.

A feature attached by both the Aggregate and the Release cannot be merged (Функцию, подключённую и в Aggregate, и в Release, невозможно объединить)

Когда локальный Manifest расширяет (extends) базовый Manifest, два уровня (карта 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 <release-name>, по пути .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, Aggregate указывает <aggregate-declared-type>, Release указывает <release-declared-type>, для слота <slot>, на соединении <alias>, через сокет <socket>, компонента <component>). Удалите тип из записи Release, чтобы она задавала размеры подключения, объявленного в Aggregate, или укажите одну и ту же Feature в обоих документах.)

Как исправить: согласуйте два объявления. Объявления одного экземпляра функциональности на стороне Aggregate и на стороне Release объединяются по столпам — Aggregate вносит values, Release вносит infra. Если обе стороны задают одно и то же поле вне столпов (например, type:), значения должны совпадать; исправьте одну сторону в соответствии с другой или удалите избыточное объявление.

Annotation binding does not resolve against its target Feature (Привязка аннотации не разрешается относительно целевой Feature)

Поле feature: привязки аннотации в Manifest называет Feature, которую каталог не загружает, либо списки maps.infra / maps.values привязки объявляют пути через точку, которых spec.schema названной Feature на самом деле не содержит. Любое из условий останавливает загрузку рабочей области — привязка синтезировала бы присоединения Feature, направляющие значения в пути, которые среда выполнения не может разрешить.

Одно условие охватывает три способа, которыми маршрут привязки не разрешается, и диагностика называет, какой из них встретился:

  • Feature не найдена. Значение feature: ссылается на URI сущности Feature, отсутствующий в загруженном каталоге.
  • Схема Feature не разрешается. Названная Feature загружается, но её spec.schema: не разрешается в представление JSON Schema 2020-12 — содержимое некорректно или называет межДокументную ссылку, по которой невозможно перейти. Этот вариант несёт за собой собственную диагностику сбоя разрешения, так что причину, по которой схема не разрешилась, можно прочитать из той же остановки.
  • Путь привязки отсутствует в целевой схеме. Запись maps.infra или maps.values привязки называет путь через точку, который spec.schema.<pillar>.<path> сущности Feature не объявляет.

Выводимое сообщение (вариант «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") (привязка аннотации не разрешается относительно целевой Feature (Manifest, по пути .spec.mappings.features.annotations.<key>, <key> направляет к Feature <feature-uri>, которой нет в каталоге этой сборки; исправьте или опубликуйте 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>) (привязка аннотации не разрешается относительно целевой Feature (Manifest, привязка аннотации направляет к Feature <feature-uri>, объявленная схема которой не разрешается: <resolution failure>))

Этот вариант называет Feature и сбой разрешения и не содержит ни ключа привязки, ни позиции в исходном тексте — ошибка находится в собственном spec.schema: сущности Feature, которую привязка лишь называет. Найдите проблемную привязку, выполнив поиск в mappings.features.annotations по URI сущности Feature, приведённому в сообщении.

Выводимое сообщение (вариант «путь не найден»):

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") (привязка аннотации не разрешается относительно целевой Feature (Manifest, по пути .spec.mappings.features.annotations.<key>, <key> направляет к Feature <feature-uri>, в столп <pillar> и путь <path>, для которого эта Feature не объявляет свойство в schema))

Как исправить: убедитесь, что URI feature: привязки существует в каталоге и совпадает с регистрозависимым URI, который реализует Recipe (implements:). Если вариант «путь не найден» срабатывает на путь, который схема 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 по этому пути (тип, enum, pattern, числовой диапазон, форма вложенного объекта/массива): терминальный $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> (подключ аннотации не соответствует схеме целевой сущности Feature в столпе маршрутизации: значение <value> подключа аннотации <subkey> не соответствует spec.schema.<pillar>.<subkey> сущности Feature <feature-uri>: <constraint failure>)

Выводимое сообщение (вариант с необъявленным подключом):

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> (подключ аннотации не соответствует схеме целевой сущности Feature в столпе маршрутизации: подключ аннотации <subkey> не объявлен в spec.schema.<pillar>.<subkey> сущности Feature <feature-uri>)

Остановка происходит для аннотации в том виде, как она написана, до её раскрытия в подключение Feature, поэтому диагностика называет документ и область, в которой было написано значение, — границу и компонент для аннотации на стороне Release, путь компонента для аннотации на стороне Aggregate, — а также ключ аннотации, из которого оно пришло.

Аннотация, внедрённая плагином управления, оценивается так же, и диагностика сообщает, кто её написал. Плагин, подключённый для внедрения аннотаций, задаёт значение на компоненте 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, привязка должна его направлять: добавьте путь в maps.infra или maps.values привязки в Manifest — путь, который объявляет схема Feature, — или удалите подключ из аннотации.

A bare annotation value does not route to exactly one path of its binding (Простое значение аннотации не направляется ровно в один путь её привязки)

Аннотация, которую вы записали как простое значение — feature.aggrega.ai/monitoring: "30s", а не как map подключей, — не называет ни одного подключа, поэтому ничто в ней не говорит, какой путь 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>") (скалярное значение аннотации не направляется ровно в один путь её привязки: ключ содержит простое значение, а его привязка направляет в несколько путей)

Пустое значение ничего не записывает, поэтому оно помещается туда, где один из двух списков содержит единственный путь, и отклоняется только там, где ни один из них его не содержит. Привязка, не объявляющая ни одного пути, отклоняется при загрузке Manifest, поскольку схема Manifest требует его наличия, поэтому сборка не доходит до этого условия таким образом.

Аннотация, внедрённая плагином управления, оценивается так же, и её диагностика добавляет, какой плагин внедрил значение и в какой роли управления он присоединён, как и у соседних условий.

Как исправить: запишите аннотацию как map, называющую подключ для каждого значения, — 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> (аннотация направляется через столп, который её авторской стороне использовать нельзя: аннотация <key> в <source> направляется через столп <pillar> по пути <path>, но аннотации стороны <side> могут направляться только через столп <permitted-pillar>)

Аннотация, внедрённая плагином управления, находится на компоненте Release, поэтому это аннотация на стороне Release, и к ней применяется то же разделение. Её диагностика добавляет, какой плагин её внедрил и к какой роли управления он подключён, потому что ключ Release, на который она указывает, никто не писал.

Как исправить: направляйте аннотацию со стороны, на столп которой нацелена привязка, или добавьте привязку — под собственным ключом аннотации, — пути которой нацелены на столп, разрешённый авторской стороне. Если одна привязка объявляет один и тот же путь в обоих списках столпов, разделите её на две привязки, чтобы у каждой стороны был доступный ей путь. Если диагностика называет внедривший плагин, аннотация происходит из решения этого плагина: исправьте плагин или привязку, под которой он внедряет.

Authored values or infra do not conform to the declared schema (Написанные values или infra не соответствуют объявленной схеме)

Разрешённые values: или infra: экземпляра компонента — или присоединённой сущности Feature — не соответствуют объявленной схеме каталога. Сборка проверяет каждый столп по его объявленной схеме до рендеринга, поэтому опечатка в ключе, значение неверного типа, число вне диапазона или отсутствующее обязательное поле обнаруживаются в источнике, а не превращаются в сломанный манифест при развёртывании.

Проверка охватывает стандартные ограничения схемы: значение неверного типа (строка там, где схема объявляет целое число), значение вне объявленного диапазона или 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: ключ, который Component не объявляет, отклоняется как опечатка, а для объявленного ключа проверяются его тип и диапазон. Компонент, которому нужна проверка ключа, наслаиваемого провайдером, например replicas, объявляет этот ключ в собственном schema.infra; принимаемый провайдером словарь доступен через valuesMapping его сущности Recipe, а не наслаивается на авторскую поверхность infra.

Проверка измеряет размеры каждого компонента, который Release разместил, и запись, в которой вообще нет блока infra:, тоже измеряется: отсутствующий блок считается пустым, поэтому ключ required: без default: сообщается как отсутствующий — именно для этого такой ключ и существует. Учитываются оба способа размещения компонента. Его размещает указание под components границы, и так же размещает маршрутизация под aggregates подмодуля, который его вносит; запись маршрутизации размещает компоненты, ничего не говоря ни об одном из них, поэтому компонент, размещённый так, начинает с пустого блока размеров, и ключ required: без значения по умолчанию в его типе сообщается как отсутствующий. Компонент, который Release не размещает ни одним из этих способов, по этому контракту вообще не измеряется. У него другая ошибка, и сборка сообщает именно о ней: компонент не размещён ни в одной границе, с указанием двух способов его разместить.

Контракт распространяется на компонент, где бы он ни был написан: компонент, вносимый подмодулем, измеряется точно так же, как компонент, объявленный собственной сущностью Aggregate сущности Release. Глубина вложенности компонента не меняет того, какие ограничения его типа применяются.

Подключения Feature проверяются так же — по объявленным schema.values / schema.infra подключённой сущности Feature. Подключения используют одну поверхность, поэтому сущность Feature для учётных данных — помеченная feature.aggrega.ai/kind: secret — проверяется по собственной объявленной схеме точно так же, как любое другое подключение. Проверяется итоговый объединённый результат после каскадного распространения значений подключения по областям (компонент, подсистема, граница и область конкретного компонента), поэтому значение, допустимо заданное в одной области, но переопределённое недопустимым значением в более конкретной области, обнаруживается в объединённом результате, а не во фрагменте. Подключение, тип которого не объявляет схему, не проверяется; infra подключения проверяется по собственной schema.infra подключения (подключение является наложением и не несёт объединения провайдеров).

Находка по вложению сообщается в том документе, который написал непрошедший столп, под именем этого документа, и относится к его автору. Его values сообщаются в блоке сущности Aggregate, который их написал, — в собственной записи features: компонента, .spec.components.<component>.features.<attachment>.values.<field>, раньше блока подсистемы, который достигает компонента, — как ошибка разработчика. Его infra сообщается в блоке сущности Release, который его написал, — в записи Release для компонента, под границей, которая его называет, раньше собственного блока features: границы, — как ошибка оператора. Столп, который не написал владеющий им документ, сообщается там, где было написано само вложение, то есть там, где названо его type. Поэтому вложение, которое создаёт только Release и которое не несёт values, сообщает о поле, требуемом values его сущности Feature, в записи Release и как ошибку оператора, по пути, который содержит Release, — в записи компонента или в блоке 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, сообщает [DEVELOPER_ERROR E0168] по пути .spec.components.app.features.check.values.schema, под именем сущности Aggregate. Редактор показывает каждое из них в документе, который его записал, на самом глубоком ключе этого пути, который содержит документ.

Вложение, которое несёт соединение, проверяется так же и сообщается в записи соединения того документа, который написал непрошедший столп, а не в собственном блоке features: компонента, который его не содержит. Его values сообщаются в записи соединения в сущности Aggregate, .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, — в собственном документе подмодуля для компонента, который вносит подмодуль, — а его infra — в записи Release для этого соединения, под границей, которая называет компонент, если Release называет границы. Вложение, которое создаёт только Release, сообщается в записи Release для обоих столпов: такое вложение не несёт values, поэтому сущность Feature, чьи values требуют поле, сообщает о его отсутствии там, в записи, которую написал оператор.

Конфигурация соединения на уровне ребра проверяется так же, по контракту сокета для ребра: написанные разработчиком values ребра — по valueSchema сокета, а написанное оператором infra ребра (из Release) — по infraSchema сокета. Сокет, не объявляющий схему ребра для столпа, не принимает для него проверяемой конфигурации (отсутствие = нет контракта, проверять нечего). Диагностика называет ребро по потребителю, сокету и псевдониму. Для компонента, который объявляет собственная сущность Aggregate данного Release, infra оператора проверяется для каждой записи, которую Release пишет для одного из его соединений, — включая запись без infra, благодаря чему ключ required: без значения по умолчанию сообщается как отсутствующий, — и сообщается в этой записи в Release, под границей, которая называет компонент, если Release называет границы, то есть там, где её правит оператор; values разработчика сообщаются в записи соединения в сущности Aggregate.

Для листа, объявленного как sensitive: true, описание нарушения ограничения скрывается. Текст нарушения цитирует ошибочное значение, а диагностику сборки читает любой, кто наблюдает за сборкой, поэтому для листа, объявленного чувствительным, — или в любом месте внутри объекта, объявленного чувствительным, — <constraint failure> ниже заменяется на <redacted>. То же действует для позиции, под которой находится лист, объявленный чувствительным, включая сам столп: $ref, записанный рядом с другими ключевыми словами, проверяется целиком там, где он записан, поэтому нарушение внутри определения, на которое он ссылается, сообщается в этой позиции и иначе цитировало бы значение листа. Сущность, путь к полю, столп и имя контракта по-прежнему называются, так что диагностика всё так же сообщает, где находится нарушение; отбрасывается только текст, который воспроизвёл бы значение. Чувствительность определяется для каждого столпа отдельно, поэтому лист с одним и тем же именем в values и infra скрывается только в том столпе, который его так объявляет.

Выводимое сообщение:

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>”) (написанный столп не соответствует своей объявленной схеме)

Как исправить: исправьте ошибочное значение, чтобы оно удовлетворяло объявленной схеме, или — если значение допустимо — расширьте объявляющую схему (schema.values/schema.infra сущности Component или схему подключённой сущности Feature), чтобы она его объявляла. Просмотрите объявленную схему сущности Component с помощью aggrega inspect <component-type>, чтобы увидеть точные типы, диапазоны, значения по умолчанию и обязательные поля, которые ожидает каждый столп.

A declared schema contract cannot be read as a schema (Объявленный контракт схемы невозможно прочитать как схему)

Сущность Component или Feature объявляет контракт схемы, который не даёт ничего, по чему можно выполнять проверку, поэтому покрываемая им конфигурация ни с чем не сверяется. Ошибку могут содержать три контракта, каждый из которых задаётся в собственном поле: собственный spec.schema сущности и два контракта для отдельных рёбер, которые объявляет сокет зависимости, — valueSchema для стороны соединения, принадлежащей разработчику, и infraSchema для стороны оператора. Запись SchemaLibrary, на которую эти контракты могут ссылаться, также может содержать третью из описанных ниже ошибок; как сообщается о таком случае, описано далее.

К этой остановке приводят три ошибки, и две из них легко пропустить, потому что контракт выглядит корректным. Контракт сокета может вообще не компилироваться в JSON Schema 2020-12 — чаще всего причиной служит опечатка в ключевом слове; собственная spec.schema сущности, которая не компилируется, вместо этого сообщается под тем условием компактной формы, с которым столкнулась её компиляция (E0120 для неизвестного ключевого слова, E0116 для ограничения, которое её тип не принимает). Или он может скомпилироваться без ошибок и всё же не построить валидатор: тело читается как компактная форма, но не является схемой, по которой что-либо можно проверить, например голый скаляр там, где должна стоять схема свойства (items: nonsense). Или он может быть корректным во всех остальных отношениях, но называть формат вне поддерживаемого набора — format: password или опечатку вроде format: emial; такой формат отклоняется, а не читается как ограничение, которое ничего не проверяет, независимо от того, доходит ли до поля какое-либо значение; имена, которые может принимать format, перечислены в разделе Именованные форматы. Все три случая — одно условие, потому что способ исправления одинаков, а пропуск любого из них ведёт к одним и тем же последствиям.

Отсутствие объявленного контракта и объявление контракта, который невозможно прочитать, — разные ситуации, и сборка обрабатывает их по-разному. Поле, которое ничего не объявляет, пропускается: проверка соответствия по столпам и по рёбрам включается по желанию, поэтому сокет, не ограничивающий ни один столп, — обычный вариант написания и не вызывает диагностики. Поле, объявляющее нечто нечитаемое, отклоняется. Если пропустить его, все покрываемые им данные остались бы непроверенными, а сборка сообщила бы об успехе — проверка перестала бы выполняться, и ничто не сообщило бы об этом. Поэтому именно отказ разделяет эти два случая: отсутствие сообщений означает, что проверять было нечего, а остановка — что было что проверять, но прочитать это не удалось.

Отказ называет сущность, которая объявила контракт, а не документ, в котором написана конфигурация, потому что исправление вносится именно туда. Автору сущности Aggregate, получившему тип компонента с нечитаемым контрактом, нечего менять в собственном файле. Отказ возникает при чтении каталога, когда известны объявляющая сущность, столп, заданное поле и строка исходного кода, — поэтому одна и та же ошибка сообщается одинаково, независимо от того, получаете ли вы её при сборке, из aggrega validate или из инструмента сборки, который предоставляет aggrega mcp. Контракт, который сущность читает через $import: — весь её spec.schema, один его столп или контракт сокета, — сообщается по импортированному файлу: местоположение называет этот файл и строку в нём, где записан фрагмент, а сообщение по-прежнему называет сущность и поле, объявившие контракт. Остановки компактной формы, с которыми сталкивается собственный spec.schema сущности, локализуются так же.

Запись SchemaLibrary, называющая формат вне поддерживаемого набора, приводит к этой остановке при чтении её библиотеки, и отказ называет библиотеку и запись и указывает на запись в файле библиотеки. aggrega validate по всему каталогу читает каждую библиотеку, поэтому сообщает о записи независимо от того, ссылается ли на неё какая-либо схема, тогда как сущность Release, разрешение зависимостей которой никогда не доходит до библиотеки, её не читает. Сущность Release, схемы которой доходят до записи через $ref:, также отклоняется, но отказ не называет формат: 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, поэтому библиотека, отсутствующая в каталоге, останавливает pull раньше, как описано в разделе «A reference names no entity the catalog holds (Ссылка называет сущность, которой нет в каталоге)» (E0114), какое бы из двух мест на неё ни ссылалось, — а библиотека, имеющаяся в каталоге, закрепляется в lock-файле для любого из них.

Корректное ограничение рядом с нечитаемым не применяется. Контракт читается как единый документ, поэтому один нечитаемый фрагмент отключает все ограничения, объявленные вместе с ним. Именно поэтому остановка ценнее ограничений, которыми она жертвует: альтернатива — контракт, который выглядит применяемым, читается как применяемый и не применяет ничего.

Выводимое сообщение называет сущность с её версией и поле, объявляющее контракт, затем столп, который этот контракт ограничивает, затем сбой — здесь это контракт сокета с опечаткой в ключевом слове:

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: valueSchema сокета в spec.usesSchema объявляет схему, по которой нельзя построить валидатор, поэтому ограничиваемые ею значения остались бы непроверенными: compactform в указанных ключе и строке (указанное ключевое слово): неизвестное ключевое слово)

и имя формата вне поддерживаемого набора в столпе values сущности Component:

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) (объявленный контракт схемы не удалось скомпилировать в пригодную схему, поэтому по нему ничего не проверялось: исправьте контракт там, где он объявлен, или удалите его, если покрываемая им конфигурация не нуждается в проверке. Component “<type>:<version>”: spec.schema.values объявляет схему, из которой невозможно построить валидатор, поэтому ограничиваемые ею значения остались бы непроверенными: validator/jsonschema: не удалось разрешить схему (в values.<field>, ключевое слово “format”, формат “<format>” не поддерживается; поддерживаемые форматы: email, uri, hostname, ipv4, ipv6, uuid, date-time, date))

Сущность 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) (объявленный контракт схемы не удалось скомпилировать в пригодную схему, поэтому по нему ничего не проверялось: исправьте контракт там, где он объявлен, или удалите его, если покрываемая им конфигурация не нуждается в проверке. SchemaLibrary “<library>”: схема “<entry>” называет формат, который не может проверить ни один валидатор, поэтому ограничиваемые ею значения остались бы непроверенными: validator/jsonschema: не удалось разрешить схему (в <field>, ключевое слово “format”, формат “<format>” не поддерживается; поддерживаемые форматы: 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: "" — пустую строку. Поле source: сущности Recipe выбирает между двумя режимами написания: режимом sourceless, в котором внешнего артефакта нет и вывод целиком строится из других видов входных данных Recipe, и режимом sourced, в котором source: называет внешний чарт, модуль или файл для рендеринга. Отсутствие поля выбирает первый режим, непустое значение — второй, а пустая строка не выбирает ни один, поэтому это неоднозначность, а не значение со смыслом. Поле source:, записанное как null, равнозначно его отсутствию.

Сущность Recipe отклоняется — компилятор не выбирает за вас одно из двух толкований. Чаще всего пустое source: появляется, когда удаляют URI и оставляют ключ: подразумевался режим с источником, и если принять пустую строку как режим без источника, компонент ушёл бы без артефакта, так и не сообщив, какое из двух толкований выбрано.

Это правило проверяется при загрузке сущности Recipe, и значение читается ровно так, как вы его написали, поэтому каждая команда, загружающая сущность Recipe, называет это условие прежде, чем что-либо попытается использовать пустое значение. aggrega validate для файла Recipe отклоняет его; aggrega pull, сборка, aggrega validate --release и инструмент сборки, который предоставляет aggrega mcp, сообщают о нём для сущности Release, достигающей этой сущности Recipe, раньше, чем о ссылке на Recipe, которую из-за этого уже не удалось разрешить. Поэтому pull называет это условие, а не сообщает о пустой ссылке как о ссылке, вид источника которой он не может определить. Проверка выполняется раньше правил, которые читают, объявлен ли источник, поэтому сущности Recipe с пустым source: сообщается именно о source:, а не о valuesMapping, которому нечего накладывать, или об отсутствующем виде входных данных.

Выводимое сообщение указывает на файл Recipe, в котором записано пустое source:, и на ключ внутри него — .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 (источник рецепта — пустая строка, которая не называет ни режим без источника, ни режим с источником. Опустите поле source для режима без источника или укажите непустой путь или URI для режима с источником)

Сборка выводит эту строку под тегом CATALOG_ERROR с коротким кодом этого условия, E0251, и файлом Recipe рядом.

Как исправить: полностью опустите поле source: (или задайте null), если Recipe без источника, либо укажите непустой путь / URI / структурированный объект источника, если Recipe с источником.

Для экземпляра компонента или функции не сопоставлен Recipe

Для типа экземпляра нет сопоставления в Manifest, которое разрешается в Recipe, имеющийся в каталоге. Выбор Recipe — только через сопоставление: компилятор никогда не выбирает Recipe, читая spec.implements: и выбирая среди кандидатов, поэтому несопоставленный тип вызывает остановку, сколько бы Recipes его ни реализовывали. implements информирует выбор; автор его делает; Manifest его фиксирует.

То же условие охватывает сопоставление, которое существует, но никуда не ведёт: значение допустимой формы ссылки, называющее Recipe, которого нет в каталоге, включая Recipe, присутствующий в другой версии, чем закрепляет значение, и Recipe, чьё простое имя предлагают сразу две возможности. Ни одно из них не разрешается в 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 (для экземпляра компонента/функции не разрешён рецепт: добавьте явное сопоставление в Manifest для его типа. Исправьте значение сопоставления в Manifest или опубликуйте названный им рецепт)

Когда сопоставления нет, а 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 (для экземпляра компонента/функции не разрешён рецепт: добавьте явное сопоставление в 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 (для экземпляра компонента/функции не разрешён рецепт: добавьте явное сопоставление в Manifest для его типа. Ни один рецепт в каталоге не реализует этот тип; напишите его, затем сопоставьте с ним тип)

В рабочем пространстве, которое не указывает ни одной папки каталога, ищутся только сущности Recipes, закреплённые в lock-файле: сущности из реестра не перечисляются, а сущность 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, в указанном месте, для указанных экземпляра и типа). ни один рецепт, закреплённый в lock-файле, не реализует этот тип; без папки каталога ищутся только рецепты, закреплённые в lock-файле, а не рецепты реестра; закрепите в Manifest рецепт, опубликованный реестром, или напишите свой, а затем сопоставьте тип с ним)

Типу, который Aggregate записывает без версии, предлагаются Recipes, реализующие ту версию, в которой сборка его компилирует, — наивысшую версию этого Component, которая есть в каталоге. Экземпляру core/datastore/postgres, когда каталог содержит этот Component в версии 1.0.0, предлагается каждый Recipe, объявляющий spec.implements: core/datastore/postgres:1.0.0, а также любой, объявляющий тип без версии или диапазон с символом каре, который допускает 1.0.0. Типу, для которого в каталоге нет ни одной сущности 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, закреплённые в lock-файле: сущности из реестра не перечисляются, а сущность 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 the lockfile pins implements вместо no feature recipe in the catalog implements, с тем же придаточным после возможности.

Как исправить: добавьте сопоставление, которое запрашивает сообщение, в spec.mappings.components.type в Manifest, с ключом — типом компонента и значением — Recipe. Если сообщение перечисляет кандидатов, выберите одного из них: этот список — ровно те Recipes, которые объявляют, что реализуют тип в версии, в которую его разрешает сборка. Если оно называет Recipe, которого нет в каталоге, исправьте значение или добавьте Recipe в каталог, который читает сборка; версия в значении должна совпадать с версией, имеющейся в каталоге. Если тип никто не реализует, недостаёт самого Recipe. Если сообщение говорит, что ищутся только рецепты или рецепты функций, закреплённые в lock-файле, рабочее пространство не читает ни одной папки каталога, поэтому реестр всё же может публиковать Recipe или FeatureRecipe, реализующий тип: именно сопоставление типа с ним в Manifest заставляет pull получить и закрепить его.

A Manifest name mapping names nothing in the build (Сопоставление name в сущности Manifest не называет ничего в сборке)

Ключ в spec.mappings.components.name или spec.mappings.features.name не называет ни одного экземпляра компонента или присоединения, имеющегося в сборке. Уровень name сопоставляется по точному имени реализуемого объекта: ключ components.name — с именем экземпляра компонента в том виде, как его пишет Aggregate, а ключ features.name — с собственным именем присоединения, то есть ключом, под которым оно записано в features: компонента, или <alias>.<slot> для присоединения, записанного на соединении, — и никогда с именем компонента, к которому присоединение прикреплено. К ключу, который ничего не называет, никогда бы не обращались: каждый экземпляр, для которого он предназначался, разрешался бы через уровень type, и сборка завершилась бы, ни словом не упомянув проигнорированную запись. Поэтому сборка останавливается, прежде чем что-либо отрисовать.

Сообщение называет сущность Manifest, ключ и раздел, в котором он записан, имена этого вида, которые в сборке есть, — сужая их до типа, который реализует Recipe или FeatureRecipe записи, если этот тип известен и в сборке есть его экземпляр, — и, где это можно определить, имя, которое вы, вероятно, имели в виду: для ключа features.name, являющегося именем компонента, — присоединения этого типа, которые несёт компонент; для ключа components.name, являющегося именем присоединения, — компонент, который его несёт; в остальных случаях — имя на расстоянии одной правки.

Выводимое сообщение для ключа 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>"? (ключ сопоставления name в Manifest не называет ни одного экземпляра компонента или присоединения в этой сборке, поэтому запись ничего не связывает: ключ в mappings.features.name сущности Manifest: ни одно присоединение в этой сборке так не называется; ключ features.name называет присоединение по его собственному имени — ключу, под которым оно записано в features компонента, или псевдониму со слотом для присоединения на соединении, — и никогда не называет компонент, к которому оно прикреплено; присоединения указанного типа в этой сборке перечислены; указанное имя — это компонент, а ключ features.name называет присоединение, а не компонент, к которому оно прикреплено, — возможно, имелось в виду указанное присоединение?)

И для ключа 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>"? (ключ сопоставления name в Manifest не называет ни одного экземпляра компонента или присоединения в этой сборке, поэтому запись ничего не связывает: ключ в mappings.components.name сущности Manifest: ни один экземпляр компонента в этой сборке так не называется; ключ components.name называет экземпляр компонента точно так, как его пишет Aggregate; экземпляры компонентов указанного типа в этой сборке перечислены; возможно, имелся в виду указанный экземпляр?)

Обо всех ключах, которые ничего не называют, сообщается в одной сборке в том порядке, в котором они записаны в Manifest.

Как исправить: переименуйте ключ в имя, которое предлагает сообщение, или в одно из перечисленных им имён — для присоединения это имя, под которым оно записано, а не имя его компонента. Если запись больше не нужна, удалите её; экземпляры этого типа тогда будут разрешаться через уровень 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 сопоставляет один базовый тип с несколькими ключами, различающимися версией; поиск рецепта по типу неоднозначен: тип совпадает с ключами, различающимися версией, — закрепите версию написанного типа или удалите дублирующиеся ключи сопоставления)

Как исправить: есть два пути, и сообщение называет оба. Удалите дублирующиеся ключи сопоставления, оставив тот, который должен отвечать за тип, — это верно, когда лишние ключи остались после повышения версии. Или закрепите версию на стороне автора, чтобы тип, объявленный компонентом, называл именно тот ключ, который вы имели в виду, — это верно, когда несколько ключей заданы намеренно и разным компонентам действительно нужны разные Recipes.

Две сущности каталога в одном каталоге имеют общую идентичность

Две сущности одного вида, загруженные из одного каталога, несут одну и ту же идентичность. Идентичность — это то, что называет ссылка, поэтому два файла, претендующие на одну идентичность, оставляют каждой ссылке на неё два ответа.

Внутри одного каталога это останавливает сборку; между каталогами — нет. Одна и та же идентичность в двух разных каталогах разрешается как затенение по принципу «первый выигрывает» — побеждает каталог, указанный раньше, — и именно это позволяет локальному каталогу намеренно переопределить опубликованную сущность. Только коллизия внутри одного каталога является ошибкой автора, у которой нет прочтения, делающего её намеренной.

Правило одинаково для всех индексируемых видов: Component, Feature, Recipe, FeatureRecipe, Plugin, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary и Aggregate. Остановка привязана ко второму файлу и называет вид и идентичность, вызвавшие коллизию.

Выводимое сообщение:

duplicate entity identity within a single catalog directory (Component identity "<identity>") (дублирующийся идентификатор сущности в пределах одного каталога (идентификатор Component))

где вместо Component стоит собственное слово вида — recipe identity, feature recipe identity, Plugin identity, SchemaLibrary identity и так далее.

Как исправить: переименуйте одну из двух сущностей или переместите её в отдельный каталог. Для сущности Recipe или FeatureRecipe идентичность включает область провайдера и версию, поэтому два файла, различающиеся только версией, не конфликтуют — настоящая коллизия здесь означает, что одна и та же версия была опубликована дважды. Обычная причина — файл сущности скопировали, чтобы начать новую, и забыли изменить metadata.name.

Два места читаются целиком, а не по одному файлу: каталог сущностей, из любого документа которого может ответить поиск по имени, и каталог, содержащий сущность Release, относительно которого разрешаются его Aggregates и Manifests, если Release называет их по идентичности. Символическая ссылка среди этих файлов может вести куда угодно на машине, поэтому у каждого такого каталога есть каталог, внутри которого должны оставаться его чтения, и ссылка, ведущая за его пределы, не читается. Граница рабочего пространства описывает правило, которое здесь применяется, и другие пути, на которые оно распространяется.

Какой это каталог, зависит от того, где находится читаемый каталог:

  • Рабочее пространство — для каталога сущностей или каталога сущности Release внутри него. Это относится и к каталогу catalog рабочего пространства по соглашению, если его никто не назвал, — когда он читается лишь потому, что существует: тогда он принадлежит самому рабочему пространству, поэтому catalog, который сам является ссылкой за пределы рабочего пространства, не читается.
  • Названный вами каталог вне рабочего пространства — для того, что лежит под ним: каталог сущностей, переданный через --catalog или перечисленный в конфигурации рабочего пространства в catalog_dirs — для рабочего пространства или для одной сущности Release, — а также каталог сущности 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, который сам является ссылкой за пределы, читается там, куда она указывает, а то, что он называет, ищется рядом со ссылкой, в каталоге, где вы его назвали (A Release or a Manifest named through a link).

Перечисление, напротив, пропускает такую ссылку и ничего за ней не перечисляет. Индекс сущностей редактора, его автодополнения и предлагаемые им кандидаты не перечисляют сущность, которую представляет ссылка за пределы, а индекс сущностей называет такую ссылку внутри рабочего пространства среди ссылок, которые он не прочитал.

Файлы конфигурации рабочего пространства так же привязаны к рабочему пространству. Каждый .aggrega-config.yaml от корня рабочего пространства до каталога, в котором запускается команда, и .aggrega-config-append-ci.yaml, который конвейер хранит рядом с любым из них, — собственное содержимое рабочего пространства. Файл, являющийся ссылкой за пределы рабочего пространства — или достижимый через ссылку на каталог, ведущую за пределы, — не читается, и поскольку каждая команда, языковой сервер редактора и инструменты ассистента читают конфигурацию прежде всего остального, каждый из них останавливается на этом, называя ссылку, а не работает с конфигурацией, собранной из оставшегося. Языковой сервер и сервер ассистента, работающий через собственные потоки, всё же запускаются в таком рабочем пространстве: перечисления его сущностей Release и других сущностей отвечают, читаясь без какой-либо конфигурации, и называют файл среди непрочитанных ссылок, а любой другой запрос, который определяет конфигурация, отклоняется с этим условием, называя ссылку. Средство, которое называет это сообщение, относится к самой конфигурации: глобальный файл конфигурации — единственная конфигурация, читаемая откуда угодно; она задаётся через --config или AGGREGA_CONFIG.

Lockfile сущности Release привязан так же — при чтении так же, как при записи. Lockfile рядом с Release читается ради закреплений, относительно которых выполняют разрешение сборка, pull, проверка, линтинг, инспекция, aggrega cache prune и запросы редактора и ассистента, и он привязан к тому же каталогу, что и его запись: к рабочему пространству или к собственному каталогу сущности Release, названной вне его. Lockfile, являющийся ссылкой за пределы, не читается, и каждая из этих операций останавливается, называя ссылку, а не выполняет разрешение по закреплениям, хранящимся где-то ещё на машине, или без них. Средство, которое называет это сообщение, относится к самому lockfile: у него одно место — рядом с Release, где его записывает pull.

Файл, читаемый рядом с сущностью, ограничивается так же. Две операции читают файл, который лежит рядом с собственным документом сущности, а не тот, на который указывает ссылка. Закрепление сущности или её публикация читает все остальные YAML-документы в каталоге сущности, чтобы определить, не разделяет ли его другая сущность. Загрузка сущности Plugin, созданной в каталоге каталога сущностей, читает собранный .wasm, размещённый рядом с ней. Каждый такой файл ограничивается каталогом, в котором был прочитан собственный документ сущности, — рабочей областью, указанным вами каталогом каталога вне её или, для сущности, которую вы закрепляете или публикуете, указывая её документ вне рабочей области, собственным каталогом этого документа, — и файл, являющийся ссылкой, ведущей за его пределы, не читается. aggrega pin, aggrega push с --dry-run или без него, получение, выполняющее закрепление, а также закрепление и публикация в редакторе и в ассистенте останавливаются с указанием ссылки, поскольку непрочитанный документ может оказаться той самой мешающей сущностью. Сборка или получение, загружающие плагин, тоже останавливаются с указанием ссылки, а не запускают байты, хранящиеся в другом месте машины, и не ищут плагин где-то ещё. Способ устранения, который называет это сообщение, относится к файлу рядом с сущностью: храните там сам файл.

Кэш артефактов рабочей области ограничивается так же — как при чтении, так и при записи. Всё, что читается из кэша в artifact_cache_dir, — кэшированная сущность, плагин или библиотека и манифест рядом с ними, архив исходников и его метаданные, закреплённый внешний вход, пакет подписи, локальный поисковый индекс реестра, — и каждая запись рабочей области, которую перечисляют aggrega cache status, aggrega cache prune и aggrega cache clear, ограничивается каталогом, которым ограничивается запись в кэш: самим каталогом кэша, будь то каталог по умолчанию .aggrega/cache или указанный в конфигурации каталог, выходящий за пределы корня рабочей области. Всё в нём, что является ссылкой, ведущей за пределы каталога кэша, — как в другое место внутри рабочей области, так и куда угодно ещё, — не читается; не читается и ничего за каталогом кэша, записанным внутри корня рабочей области, который сам является ссылкой, ведущей за пределы рабочей области: сборка, получение, проверка, поиск, три команды кэша, а также запросы редактора и ассистента, читающие кэш, останавливаются с указанием ссылки — включая содержимое, которое кэш хранит под записанным дайджестом, поскольку дайджест говорит, что представляют собой байты, а не откуда их можно читать. Каталог кэша, записанный внутри корня рабочей области и являющийся ссылкой на другое место внутри рабочей области, читается там, куда он ведёт. Уведомление об устаревании, которое печатает aggrega inspect и которое ничего не решает, исключено. Очистка или удаление, встретив один из собственных каталогов кэша, являющийся ссылкой за пределы каталога кэша, или каталог кэша, который сам является ссылкой за пределы рабочей области, рассматривают его как удаление, которым оно было бы, в рамках условия «A path the operation writes leads through a link out of the directory it must stay inside (Путь, в который записывает операция, ведёт по ссылке за пределы каталога, внутри которого он должен оставаться)», ещё до того, как что-либо перечислить. Способ устранения, который называет это сообщение, относится к кэшу: после удаления ссылки получение снова заполнит кэш, а кэш, хранящийся в другом месте, указывается через artifact_cache_dir относительно корня рабочей области, а не достигается через ссылку.

Репозиторий, который получает источник, ограничивается собственной рабочей копией. Когда получение — aggrega pull либо сборка или запрос редактора или ассистента, разрешающие зависимости сущности Release, — загружает источник git-repository, оно извлекает репозиторий и архивирует каталог, который называет источник, и рабочая копия является отдельным каталогом: каждая ссылка в репозитории, включая сам module_subdir, ограничивается ею. Ссылка на файл или каталог внутри репозитория архивируется как то, на что она указывает, под именем ссылки. Ссылка, ведущая за пределы репозитория, — которая может указывать на любой файл на машине, выполняющей получение, — не читается: получение останавливается с указанием ссылки и того, куда она ведёт, и ничего не кэшируется. Рабочая копия — временный каталог, удаляемый после остановки получения, поэтому сообщение называет ссылку по её месту в репозитории — chart/secret.txt, в первой строке командной строки и в предложении, — а каталог, внутри которого она должна оставаться, как репозиторий и ревизию, которые называет источник: which must stay inside the repository <url> at <ref> (commit <commit>) или at commit <commit>, если источник не указывает ref или указывает сам коммит. Место, куда ведёт ссылка, называется так, как оно расположено на вашей машине. Способ устранения, который называет это сообщение, относится к репозиторию: ссылка закоммичена там, поэтому и изменять её следует там — направить внутрь репозитория или заменить самим файлом, — после чего источник должен указывать ревизию, содержащую это изменение. Ссылка на каталог, ведущая обратно в каталог, который архив уже читает через неё, тоже останавливает получение, поскольку дерево, которое она представляет, не имеет конца; этот отказ — обычная ошибка, а не данное условие.

Оверлеи, которые читает генерация каталога, ограничиваются так же. 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, поскольку указанный вами каталог читается там, куда он указывает. Если ссылкой является lock-файл сущности Release, удалите его и снова выполните pull для этой сущности Release — рядом будет записан новый lock-файл. У сущности Manifest нет уровня каталога, поэтому Manifest, который читает Release, хранится рядом с самой сущностью Release. Если ссылкой является файл конфигурации, замените его копией, хранящейся в рабочей области; конфигурация, которую вы хотите разделять между рабочими областями, читается, если указать её как глобальный файл конфигурации с помощью --config или AGGREGA_CONFIG, под собственными файлами каждой рабочей области. Если ссылка находится рядом с сущностью, которую закрепляют или публикуют, замените её самим файлом или переместите документ, являющийся сущностью, в отдельный каталог; если это .wasm рядом с сущностью Plugin, поместите туда сам собранный .wasm. Если ссылкой является каталог кэша артефактов или что-то в нём, удалите её — pull снова заполнит кэш — либо, чтобы хранить кэш в другом месте, задайте в artifact_cache_dir этот каталог, записанный относительно корня рабочей области (../shared-cache). Если ссылка зафиксирована в репозитории, который загружает источник git-repository, измените её в этом репозитории — направьте внутрь репозитория или зафиксируйте сам файл — и укажите ревизию, содержащую изменение. Если ссылкой является оверлей в каталоге оверлеев при генерации каталога, замените её самим оверлеем или укажите в качестве каталога оверлеев каталог, содержащий все оверлеи. Если ссылка находится в импортируемом вами каталоге, храните в каталоге сам файл, а не ссылку на него, или импортируйте каталог, на который ведёт ссылка.

A reference to another file leads out of the directory it must stay inside (Ссылка на другой файл ведёт за пределы каталога, внутри которого она должна оставаться)

Сущности Release и Manifest могут ссылаться на другой файл по пути: aggregate: и manifest: сущности Release, записанные как ./… или ../…, её extends:, extends: сущности Manifest, записанный как путь, и parameters: { $import: … } сущности Release. Документ в рабочем пространстве таким образом достигает только файлов внутри рабочего пространства. Сущность Release, лежащая вне рабочего пространства, — указанная вами в командной строке или указанная конфигурацией рабочего пространства, — и сущность Manifest, указанная вами отдельно в командной строке вне рабочего пространства, достигают только файлов внутри собственного каталога: этот каталог является отдельным корнем, как и каталог, указанный вами вне рабочего пространства, и каждая сущность Release, к которой ведёт её цепочка extends:, ограничена тем же каталогом. Путь, который в записанном виде выходит за пределы этого каталога, и путь, который в записанном виде остаётся внутри, но встречает по пути символическую ссылку, ведущую наружу, отклоняются оба, и из указанного ими файла ничего не читается. Путь, ведущий к файлу, которого ещё нет внутри каталога, здесь не отклоняется; о нём сообщается как о файле, который не удалось прочитать. В разделе Граница рабочего пространства объясняется, почему ограничивается не только указанный вами путь, но и ссылка.

Откуда разрешается путь, определяется тем же правилом, которое справочник по языку описывает для каждого ключа: aggregate: и manifest: сущности Release, а также extends: сущности Manifest — рядом с сущностью Release, которую называет команда или запрос, или, для сущности Manifest, названной отдельно, рядом с этой сущностью Manifest; extends: сущности Release и $import: в parameters — рядом с сущностью 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, aggrega inspect для сущности Release или Manifest, линтинг одной сущности Release, а также запросы редактора и ассистента, которые собирают, просматривают, строят граф, проверяют или описывают сущность Release. В редакторе диагностика размещается на ключе сущности Release, который привёл к файлу.

Выводимое сообщение. Оно начинается с собственного предложения условия, затем следуют ссылка в записанном виде, документ, в котором она записана (для extends: и $import: параметров), каталог, от которого она разрешена, место, куда она ведёт, каталог, внутри которого она должна оставаться, и ссылка, если наружу её выводит ссылка; затем способ исправления. Для документа в рабочем пространстве:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../shared/app.yaml, resolved from <workspace>, which leads to <elsewhere>/shared/app.yaml, outside the workspace <workspace>). nothing was read from that file. A document in the workspace reaches only files inside <workspace>: move the file there — or, where a link carries the reference out, make the link lead there — or open the workspace at a directory holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (ссылка документа на другой файл выводит за пределы директории, внутри которой она должна оставаться (.spec.aggregate: ../shared/app.yaml, разрешена от <workspace>, ведёт к <elsewhere>/shared/app.yaml, за пределами рабочей области <workspace>). из этого файла ничего не прочитано. Документ в рабочей области обращается только к файлам внутри <workspace>: переместите файл туда — или, если ссылку выводит наружу символическая ссылка, сделайте так, чтобы она вела туда, — или откройте рабочую область в директории, содержащей оба документа. К сущности Aggregate, хранящейся вне этой директории, обращаются по её имени, а не по пути, из директории каталога, которую перечисляет конфигурация рабочей области)

а для сущности Release или Manifest, указанной вне рабочего пространства, собственный каталог которой и есть тот, внутри которого она должна оставаться:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../aggregates/app.yaml, resolved from <directory>, which leads to <parent>/aggregates/app.yaml, outside <directory>, the directory of a document named outside the workspace <workspace>). nothing was read from that file. A Release or a Manifest named outside the workspace — on the command line, or by the workspace configuration — reaches only files inside its own directory <directory>: move the file there — or, where a link carries the reference out, make the link lead there — or name the document from a workspace holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (ссылка документа на другой файл выводит за пределы директории, внутри которой она должна оставаться (.spec.aggregate: ../aggregates/app.yaml, разрешена от <directory>, ведёт к <parent>/aggregates/app.yaml, за пределами <directory> — директории документа, названного вне рабочей области <workspace>). из этого файла ничего не прочитано. Сущность Release или Manifest, названная вне рабочей области — в командной строке или конфигурацией рабочей области, — обращается только к файлам внутри своей директории <directory>: переместите файл туда — или, если ссылку выводит наружу символическая ссылка, сделайте так, чтобы она вела туда, — или назовите документ из рабочей области, содержащей оба документа. К сущности Aggregate, хранящейся вне этой директории, обращаются по её имени, а не по пути, из директории каталога, которую перечисляет конфигурация рабочей области)

с written in <document> после ссылки для extends: или $import: параметров и с the link <link> leads to <place> в конце, если путь наружу выводит символическая ссылка. Ссылка aggregate: или manifest: не указывает документ: сущность Release, расширяющая другую, могла унаследовать её от сущности Release выше по цепочке, и в любом случае она разрешается рядом с сущностью Release, указанной командой.

Категория диагностики — [OPS_ERROR]: ссылка записана в сущности Release или Manifest.

Как исправить: для сущности Aggregate, хранящейся вне рабочего пространства, укажите её metadata.name вместо пути и перечислите содержащий её каталог в catalog_dirs в конфигурации рабочего пространства или передайте его с --catalog — каталог каталога является способом, которым рабочее пространство достигает сущностей, хранящихся вне его. Сущность Manifest, сущность Release, указанная в extends:, и файл параметров читаются рядом с сущностью Release и никогда не ищутся по имени, поэтому храните их внутри рабочего пространства или откройте рабочее пространство в каталоге, содержащем и сущность Release, и файл. Для сущности Release или Manifest, указанной вами вне рабочего пространства, храните то, на что она ссылается, в её собственном каталоге или собирайте её в рабочем пространстве, содержащем и её, и то, на что она ссылается. Если путь наружу выводит символическая ссылка, замените её копией того, на что она ведёт, или направьте её внутрь каталога.

No catalog version satisfies a version constraint (Ни одна версия в каталоге не удовлетворяет ограничению версии)

Ссылка указывает сущность, которая есть в каталоге, и закрепляет версию, которой в каталоге нет: отсутствующую точную версию или диапазон с кареткой, которому не соответствует ничего из доступного. Это отличается от простого промаха, когда неизвестно само имя: здесь сущность существует и неудовлетворима только версия, поэтому сообщение говорит именно об этом, а не сообщает об отсутствии сущности, заставляя вас искать опечатку в имени.

Все виды сущностей приходят к этому через один и тот же выбор, поэтому неудовлетворимое закрепление ведёт себя одинаково, где бы оно ни было записано: опечатка в версии в сопоставлении Recipe в сущности Manifest отклоняется точно так же, как та же опечатка в типе компонента.

Это условие восстановимо, поэтому редактор может показывать его как диагностику, пока вы продолжаете печатать, не отказываясь от документа. В командной строке оно объединяется в остановку.

Выводимое сообщение для ссылки, до которой доходят зависимости сущности 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>") (ни одна версия в каталоге не удовлетворяет указанному ограничению версии (Component <name>, в .extends, ни одна версия в каталоге не удовлетворяет родителю extends “<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, — не называет никакой версии, поэтому ни один каталог не может содержать то, что оно запрашивает.

О таком закреплении сообщается как о некорректном, а не как о сущности или версии, которой нет в каталоге, поэтому диагностика отсылает вас к набранному тексту, а не к поиску того, чего не существует. Это одно и то же условие, где бы ни было записано закрепление: type компонента или функции, extends: сущности Component или Feature, ключ или значение сопоставления в Manifest, spec.aggregate сущности Release, implements: сущности Recipe или FeatureRecipe, версия, которую закрепляет capability: сущности Recipe при выборе обслуживающего её плагина, и plugin: шага конвейера.

О нём сообщается там же, где сообщается о ссылке, которую не удалось разрешить, поэтому некорректное закрепление никогда не меняет того, какие ссылки разрешаются, — оно меняет то, что говорит сообщение об ошибке. Для корректного закрепления, которому не удовлетворяет ни одна доступная версия, сохраняется условие, о котором сообщает соответствующая поверхность: «No catalog version satisfies a version constraint (Ни одна версия в каталоге не удовлетворяет ограничению версии)» выше или условие «не найдено» той поверхности, на которой оно записано.

Закреплением считается только текст после последнего двоеточия и только если в нём нет /. Поэтому ссылка на хост реестра с портом, например localhost:5000/core/api-server, не содержит закрепления — текст после двоеточия порта продолжает ссылку, — и о ней никогда не сообщается как о некорректной.

Выводимое сообщение для закрепления с кареткой у типа компонента:

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 (ссылка содержит некорректную привязку версии (ссылка <reference>, привязка <pin>, текст после ^ не является диапазоном версий, ссылка из <authored location>). запишите ссылку как имя, как имя:версия с семантической версией, например 1.0.0, или как имя:^версия для наивысшей совместимой с ней версии)

Для точной привязки вместо фразы о каретке выводится an exact pin must be a semantic version (точная привязка должна быть семантической версией). Значение после неё указывает, где была записана ссылка, словами той поверхности, которая о ней сообщает: referenced from (ссылка из) и место в исходном документе, in the Release's spec.aggregate (в spec.aggregate сущности Release) или in the recipe's spec.implements (в spec.implements рецепта). Там, где сопоставление Manifest проверяется по implements: его Recipe, вместо этого перед ссылкой идут запись сопоставления и то, какая её сторона содержит привязку, — in the mapping key (в ключе сопоставления) или in the recipe's spec.implements (в spec.implements рецепта), а для extends: сущности Component или Feature перед ссылкой указываются расширяющая сущность и поле.

Как исправить: перепишите закрепление в одной из двух форм или удалите его, чтобы выбрать наибольшую доступную версию. Подстановочный знак, например 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>) (все опубликованные версии, которые могла бы выбрать эта ссылка, отозваны: <reference>: отозваны: <version> (<recorded reason>), <version> (<recorded reason>))

Как исправить: прочитайте записанные причины — обычно они называют, на что перейти. Перейдите на то, что заменяет отозванную сущность, — именно этого и добивается отзыв. Если пока нужно сохранить старую, закрепите в ссылке точную версию: указание версии означает, что вы её принимаете, и тогда сборка каждый раз сообщает об отзыве, а не отказывает.

A plugins.providers binding names a plugin that does not serve the capability (Привязка в plugins.providers называет плагин, который не обслуживает эту возможность)

Блок plugins.providers рабочего пространства выбирает идентичность плагина для возможности, и ни один Plugin, выполняющий рендеринг провайдера и обслуживающий эту возможность, не имеет такой идентичности. Привязка — явный выбор, который каталог не может выполнить, поэтому сборка останавливается, а не откатывается тихо к другому плагину: откат отрендерил бы ваш результат через плагин, который вы сказали не использовать, и ничего бы не сообщил.

Привязка выбирает по координатной идентичности плагина — типу плагина и его имени, которые также закрепляет lock-файл, — и после неё может быть указана версия.

Она проверяется независимо от того, запрашивает ли эту возможность какой-либо Recipe. В остальных случаях привязка читается, только когда её называет capability: сущности Recipe, поэтому привязку с опечаткой в возможности никто бы не прочитал и о ней никто бы не сообщил. Поэтому каждая сборка и каждый запуск aggrega validate --release проверяет каждую привязку, которая называет плагин: pull разрешает такую привязку независимо от того, использует ли её Recipe, поэтому сборка располагает плагином и знает, что он обслуживает, а возможность, которую этот плагин не обслуживает, заведомо ошибочна. Проверка читает привязки в конфигурации рабочего пространства, а не в lock-файле, и ничего не меняет в том, какой плагин рендерит Recipe, — это по-прежнему определяет lock-файл. Привязка, называющая плагин, которого у сборки нет, — плагин из реестра, ещё не загруженный ни одним pull, — не проверяется, пока pull его не загрузит. Привязка, не называющая плагина, проверяется иначе, как рекомендация: см. «A provider binding names a capability no plugin the build reads serves (Привязка провайдера называет возможность, которую не обслуживает ни один плагин, читаемый сборкой)» в разделе «Условия, которые не останавливают сборку» ниже.

Выводимое сообщение, в которое добавляется то, что названный плагин действительно обслуживает, и написание, отличающееся на одну правку, если возможность привязки такова:

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 называет плагин, которому не соответствует ни один плагин рендеринга провайдера, обслуживающий эту возможность: возможность <capability> привязана к плагину <plugin-identity>, но ни один плагин рендеринга провайдера, обслуживающий её, не соответствует этой идентичности; названный плагин обслуживает <served capability>, и указанная возможность отличается от неё на одну правку)

Если плагина, названного привязкой, нет в каталоге, который читает сборка, сообщение заканчивается после «matches that identity», потому что о том, что он обслуживает, сказать нечего.

Как исправить: сначала сверьте написание привязки с координатой самого плагина — частая ошибка состоит в том, что привязка называет возможность там, где должна называть плагин. Если сообщение называет возможность, отличающуюся на одну правку от написанной вами, опечатка в capability: привязки. Затем убедитесь, что плагин есть в каталоге, который читает сборка, и что он указывает эту возможность в spec.provider.capabilities; плагин, который когда-то обслуживал возможность и больше её не объявляет, приводит именно к этому сообщению. Удаление привязки — правильное исправление, если возможность обслуживает только один плагин: тогда привязке нечего различать.

Ни одна версия плагина provider не удовлетворяет закреплению provider в сущности Recipe

Сущность Recipe привязывает provider с закреплённой версией — helm:1.0.0 или helm:^1.0.0, — и ни одна версия сущности Plugin, выполняющей рендеринг provider, не удовлетворяет закреплению. Закрепление — явный запрос, поэтому сборка останавливается, а не игнорирует его и не выполняет рендеринг через ту версию, которая случайно обслуживает provider; молчаливое переопределение закрепления дало бы вывод, который собственное объявление автора запрещает.

К этому приводят две ситуации, и сообщение их различает: возможность не обслуживает вообще ничто, либо что-то её обслуживает, но ни одна из его версий не удовлетворяет ограничению.

Это отличается от неудовлетворимой версии сущности, описанной выше. Та касается сущности каталога, названной в версии, которой в каталоге нет; эта — выбора плагина, выполняющего рендеринг возможности.

Выдаваемые сообщения:

no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it (ни одна версия плагина рендеринга провайдера не удовлетворяет закреплению версии провайдера в рецепте: возможность <capability> закрепляет <version>, но её не обслуживает ни один плагин рендеринга провайдера) no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it (ни одна версия плагина рендеринга провайдера не удовлетворяет закреплению версии провайдера в рецепте: возможность <capability> закрепляет <version>, но ей не удовлетворяет ни одна версия обслуживающего плагина)

Как исправить: расширьте или исправьте закрепление в поле capability: сущности Recipe либо добавьте в каталог запрошенную версию плагина. Закрепление с кареткой соответствует версиям не ниже нижней границы в пределах той же старшей версии, поэтому закреплению ^2.0.0 не удовлетворяет плагин 1.x, сколь бы свежим он ни был. Если сообщение говорит, что возможность ничто не обслуживает, проблема не в закреплении: плагин отсутствует полностью, и удаление закрепления не поможет.

Ни один плагин не объявляет запрошенный формат разбора или импорта

Запрошен формат, и ни один плагин его не объявляет. У каждого из двух сокетов, маршрутизирующих по формату, своё условие, и они различаются лишь тем, какая работа запрошена: плагин parser читает внешний исходный формат, а плагин importer вносит внешнее содержимое в виде сущностей Aggrega.

Пространство форматов открыто и целиком принадлежит плагинам. Ни один сокет не хранит списка известных компилятору форматов: плагин объявляет обрабатываемые им форматы как возможности, а новый формат поставляется как новый плагин без изменения компилятора. Поэтому эта остановка сообщает объявленный набор в его текущем виде, а не фиксированное перечисление, и каждый промах явен: у запроса либо есть объявляющий плагин, либо его нельзя выполнить. Отсутствующий плагин ничем не подменяется, за единственным исключением — парсеров, встроенных в компилятор; оно описано ниже.

Выдаваемые сообщения:

no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" (ни один плагин-парсер не объявляет запрошенный формат: ни один плагин-парсер не объявляет parse:<format>) no importer plugin advertises the requested format: no importer plugin advertises "import:<format>" (ни один плагин-импортёр не объявляет запрошенный формат: ни один плагин-импортёр не объявляет import:<format>)

Единственный плагин-парсер, который объявляет формат, но имеет неразрешимую форму версии, считается отсутствием объявляющего плагина, а не молчаливым пропуском, и сообщение говорит об этом:

no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>" (ни один плагин-парсер не объявляет запрошенный формат: для parse:<format> не разрешается ни одна версия плагина-парсера)

Разбор откатывается к парсерам, встроенным в компилятор. Сборка разбирает каждый файл, который она передаёт политике render-verdict и формат которого эта политика не читает нативно, импортёр читает свой источник через парсер синтаксиса, который он называет, а импорт, не называющий формата, разбирает источник в синтаксисе, названном каждой применимой сигнатурой. Для каждого синтаксиса используется парсер, обслуживаемый каталогом рабочего пространства, а если каталог не обслуживает ни одного — парсер, встроенный для него в сам компилятор; среди них парсер HCL, через который сборка читает вывод Terraform, и парсер JSON, через который читают базовые импортёры компилятора, поэтому ни политика над выводом Terraform, ни импорт через базовый импортёр не требуют парсера в каталоге. Если каталог обслуживает парсер для синтаксиса, собственный парсер компилятора не участвует, а два парсера с разными именами в каталоге отклоняются, как описывает A parse or import format is advertised by more than one plugin (Формат разбора или импорта объявлен более чем одним плагином). Поэтому эта остановка называет синтаксис, для которого парсер не обслуживают ни каталог, ни компилятор.

Как исправить: убедитесь, что формат написан так, как его объявляет плагин, — возможность состоит из префикса сокета и имени формата, поэтому плагин, объявляющий parse:hcl, обслуживает формат hcl и ничего больше. Затем убедитесь, что плагин присутствует в каталоге, который читает сборка. Если плагина для формата не существует, недостающее звено — именно этот плагин; компилятор не может читать формат, который никто не объявляет.

Формат разбора или импорта объявлен более чем одним плагином

Два или более различных плагина объявляют один и тот же формат, и запрос нельзя маршрутизировать, не угадывая, какой из них использовать.

Каталог, содержащий оба, допустим и загружается без замечаний. Два издателя могут каждый поставлять парсер или импортёр для одного формата, и объединение их каталогов — поддерживаемое действие. Неоднозначность — условие места использования: остановка происходит, когда спорный формат действительно запрошен, поэтому конкурирующая пара вне досягаемости сборки никогда её не блокирует.

Называется каждый кандидат, в отсортированном порядке, поэтому сообщение одинаково при каждом запуске.

Выдаваемые сообщения:

format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] (формат объявлен более чем одним плагином-парсером: формат <format> объявлен плагинами-парсерами [<plugin-names>]) format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>] (формат объявлен более чем одним плагином-импортёром: формат <format> объявлен плагинами-импортёрами [<plugin-names>])

Для импортёра остановка возникает ещё в одной форме: записи plugins.importer рабочего пространства подключают более одного из импортёров, объявляющих формат, и тогда называются подключённые импортёры.

Импортёры, из которых выбирает импорт, — это импортёры в каталоге рабочего пространства и базовые импортёры компилятора, которые объявляют свои форматы в каждом рабочем пространстве. Поэтому каталог, содержащий собственный импортёр с другим именем для формата, обслуживаемого базовым импортёром, — import:langflow или import:flowise, — встречает эту остановку при импорте, который не подключает ни один из них, и сообщение называет базовый импортёр рядом с импортёром каталога. Импортёр, который каталог содержит под собственным именем базового импортёра, не является вторым объявляющим: в пределах одного имени выбирается наивысшая версия, а импортёр той же версии, что и базовый, с модулем рядом, запускается вместо него. Импортёр без модуля рядом не является кандидатом там, где формат объявляет импортёр с этим именем, способный запуститься, как описано в разделе Какой из них выполняется рядом с вашими собственными импортёрами.

Как исправить: для импортёра оставьте оба в каталоге — или оставьте свой рядом с базовым импортёром — и подключите нужный: запись plugins.importer, чей uri называет его по идентичности и версии, uri: importer/<name>:<version>, в том виде, в каком её записывает aggrega plugin add importer. Подключённый импортёр выбирается среди объявляющих формат так же, как запись plugins.providers выбирает среди плагинов, обслуживающих возможность на сокете provider; это описано ниже в разделе «A capability is served by more than one provider plugin (Возможность обслуживается более чем одним плагином provider)». Если названные импортёры подключены вашими записями, оставьте запись для нужного и удалите другую. У сокета разбора такого выбора нет, поэтому для парсера решение — сузить каталог, который читает сборка, чтобы в нём был только нужный плагин; прямой способ — указать в --catalog каталог, содержащий ваш выбор.

A plugins.importer entry pins a version of its importer the catalog does not hold (Запись plugins.importer закрепляет версию своего импортёра, которой нет в каталоге)

Запись 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 (Закрепление версии не имеет ни одной из форм закрепления)».

Выдаваемое сообщение, называющее возможность формата и закреплённую записью версию:

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: возможность закрепляет версию, но ни одна обслуживающая её версия плагина этому закреплению не удовлетворяет)

Как исправить: замените версию в uri записи на ту, что есть в каталоге (для базового импортёра подходит и собственная версия компилятора), либо расширьте диапазон, либо добавьте в каталог версию, названную записью. Диапазон с кареткой соответствует версиям не ниже нижней границы в пределах той же старшей версии, поэтому ^2.0.0 не удовлетворяет импортёр 1.x, сколь бы свежим он ни был.

A plugin reference carries a registry host or an artifact path (Ссылка на плагин содержит хост реестра или путь артефакта)

Ссылка на сущность Plugin начинается с сегмента в форме хоста реестра — содержащего точку или двоеточие, как DNS-имя или пара «хост и порт», — или с пути артефакта. Сущность Plugin адресуется по своей координатной идентичности: тип плагина, косая черта, имя и необязательно версия. Загрузка привязывает эту идентичность к физическому расположению, сама добавляя в начало настроенный реестр и путь плагина, поэтому ссылка, уже содержащая их, получила бы префикс дважды и указала бы на расположение, которое нельзя загрузить.

Ссылка отклоняется там, где формируется расположение, а не при загрузке, поэтому сообщение называет то, что вы написали, а не проявляется позже как непонятная ошибка тега.

Выдаваемое сообщение в обрамлении загрузки, формировавшей расположение, с решением на строке ниже:

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>" (каталог: загрузка уровня 3 <uri>: ссылка на 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 (решение: удалите хост реестра и путь артефакта, оставив только координату; загрузка сама добавляет настроенный реестр, поэтому ссылка, уже содержащая его, получает префикс дважды)

Как исправить: удалите всё, что стоит перед типом плагина, оставив только координату — provider/helm:1.0.0, а не hub.example.com/plugin/provider/helm:1.0.0. Реестр, из которого загружает сборка, — это конфигурация рабочего пространства, а не часть идентичности; именно это позволяет обслуживать один каталог из нескольких реестров без правки его сущностей.

A plugin or recipe reference carries no scope (Ссылка на плагин или рецепт не содержит области)

У ссылки на сущность Plugin или Recipe нет начального сегмента области — косой черты нет вовсе или перед ней пусто, как в /name. Оба вида идентифицируются двумя частями, и первая различает две одноимённые сущности: Plugin — по типу плагина и имени, Recipe — по provider и имени. Два сокета могут каждый содержать плагин redact, а два provider могут каждый поставлять рецепт postgres, поэтому область — часть идентичности, а не украшение.

Расположение, построенное из пустой области, содержит пустой сегмент пути — двойную косую черту, — который не разрешается, поэтому ссылка отклоняется там, где формируется расположение, а не оставляется, чтобы позже завершиться непонятной ошибкой загрузки.

Два решения противоположны случаю квалифицированного плагина выше и друг другу, поэтому каждое сформулировано отдельно: здесь ссылке не хватает сегмента, и вы его добавляете, а квалифицированная ссылка содержит лишний, и вы его удаляете.

Выдаваемые сообщения, каждое в обрамлении загрузки и с собственным решением ниже:

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>" (каталог: загрузка уровня 3 <uri>: ссылка на 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, который сущность плагина объявляет в metadata.pluginType)

catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" (каталог: загрузка уровня 3 <uri>: ссылка на рецепт должна иметь область 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 обязателен; перезапустите команду так, чтобы сначала искался каталог, содержащий её; флаг —catalog можно повторять)

Как исправить: для плагина добавьте в начало тип плагина, который сущность Plugin объявляет в metadata.pluginType. Для рецепта добавьте в начало provider, который сущность Recipe объявляет в spec.capability. Решение для рецепта называет вторую возможность, на которую стоит обратить внимание: обращение к реестру вообще означает, что локальные каталоги были просмотрены первыми и ни один не содержал ссылку, поэтому если рецепт должен браться из локального каталога, укажите сборке этот каталог, а не добавляйте область.

The build consumes an artifact its publisher has deprecated (Сборка использует артефакт, который его издатель объявил устаревшим)

Ссылка, которую разрешает эта сборка, несёт маркер устаревания, записанный её издателем, и серьёзность этого маркера не ниже серьёзности, которую рабочее пространство настроило как порог остановки. Маркер прикрепляется к опубликованному артефакту задним числом, поэтому артефакт, который вчера собирался без ошибок, сегодня может нести маркер, хотя в ваших собственных файлах ничего не изменилось.

Сообщение и остановка — разные вещи, и настраивается только остановка. О каждом записанном маркере сообщается при любой серьёзности, и никакая настройка этого не отключает. Останавливает ли маркер сборку также, решает halt_on_deprecated_severity, сравнивая записанную серьёзность с настроенным порогом в порядке warning < error < retracted. Если порог не настроен, ничто не останавливает сборку и каждый маркер является предупреждением. Серьёзность вне этих трёх значений, как и порог вне их, никогда не достигает порога: некорректное значение не может ни вызвать остановку, ни подавить её.

Перед остановкой сборки выводится каждое уведомление, а не только то, что её остановило, поэтому повышение порога никогда не лишает вас находки — сама остановка называет единственную ссылку, на которой она произошла. Находки сортируются по ссылке, поэтому один и тот же lockfile при каждом запуске выдаёт одну и ту же последовательность, и останавливающая находка всегда одна и та же.

Проверяются два хранилища, и оба сообщают одинаково: ссылки, закреплённые в lockfile, и плагины, записанные как доверенные для вердикта «принять или отклонить». Ни одна из проверок не обращается к реестру — обе читают уже записанное, — поэтому сборка остаётся 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"

Маркер одной из двух предупредительных серьёзностей указывается как deprecated (warning) или deprecated (error) вместо retracted. Различие сохраняется, потому что они означают разное — «не рекомендуется, но по-прежнему может быть выбран» против «исключён из выбора», — и сообщение о более сильном как о более слабом преуменьшило бы случившееся.

Как исправить: прочитайте записанное сообщение — это собственное описание издателя того, на что следует перейти, — и выполните миграцию. Если мигрировать пока нельзя, повышение halt_on_deprecated_severity — или его сброс — снова превращает остановку в предупреждение, которое вы продолжаете видеть; это осознанное принятие, а не обходной путь, и уведомление продолжает выводиться. Маркер, записанный для версии, которую вы больше не используете, исчезает, когда lockfile обновляется командой aggrega pull.

A trusted plugin’s recorded digest disagrees with the cached artifact (Записанный дайджест доверенного плагина не совпадает с кэшированным артефактом)

Для плагина, подключённого в роли, которая принимает или отклоняет сборку, записан доверенный дайджест, а кэшированный манифест плагина сообщает другой. Они сравниваются до чтения исполняемого файла плагина, и расхождение останавливает разрешение на этом месте.

Именно это сравнение делает записанный дайджест авторитетным источником, а не повторением. Без него байты плагина проверяются лишь по закреплению, выведенному из того самого манифеста, байты которого затем проверяются, — самосогласованно по построению и неспособно заметить, что весь артефакт был заменён. Сравнение записанного с тем, что манифест сообщает сейчас, и даёт этой проверке внешнее мнение.

Это отличается от несовпадения дайджеста содержимого, при котором сообщается, что разрешённые байты расходятся с заявленным для них дайджестом. Здесь ничего не прочитано, и байты вполне могут совпадать с манифестом; расходится то, какой артефакт вообще разрешается. Разделять эти случаи важно, потому что способы исправления противоположны: в одном случае это повреждённый или подменённый артефакт, в другом — законно изменённый плагин, новая идентичность которого ещё не проверена.

Выводимое сообщение:

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

Как исправить: прежде чем что-либо перезаписывать, выясните, что изменилось: это плагин, который может отклонять ваши сборки, а записанный дайджест — свидетельство того, что кто-то его проверил. Если изменение ожидаемо, потому что вы намеренно обновили плагин, проверьте новый артефакт и перезапишите для него доверенный дайджест. Если нет — восстановите артефакт, указанный в записи; расхождение сообщает, что идентичность изменилась без чьего-либо решения.

Цепочку extends: невозможно собрать

Цепочка extends: сущности Component, Feature, Manifest или Release называет родителя, которого невозможно разрешить, поэтому цепочку нельзя превратить в одну разрешённую сущность.

Это условие отличается от цикла, у которого своё условие и своё решение (см. «Cyclic extends chain» выше); от цепочки, превышающей ограничение глубины, у которой своё условие ниже; и от невыполнимой фиксации версии, когда родитель существует и отсутствует только версия.

Выводимое сообщение, называющее сущность с неразрешимым 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 (слияние наследования не удалось (Component <name>, в .spec.extends, <entity> расширяет <reference>, который не предоставляет ни одна сущность каталога). Убедитесь, что ссылка extends называет сущность, присутствующую в каталоге)

Когда проверка, сообщающая об этом, читает родителя из кэша артефактов по закреплению lockfile — проверка extends при сборке и в aggrega validate --release, 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: которой следует открыть; в многоуровневой цепочке это разные сущности.

extends: сущности Manifest разрешается в другом месте, поэтому и совет даётся другой. Manifest — это конфигурация оператора, создаваемая рядом с Release, а не содержимое каталога, и его extends: называет файл по относительному пути или metadata.name сущности Manifest в собственном каталоге Release — но никогда не сущность каталога. Поэтому его сообщение завершается тем, во что не удалось разрешить ссылку, и указанием, где искать вместо этого:

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 (слияние наследования не удалось (Manifest <name>, в .spec.extends, <entity> расширяет <reference>, который не удалось разрешить: <what looking produced>). Убедитесь, что ссылка extends — относительный путь или имя Manifest в каталоге Release)

Эта завершающая деталь — ошибка, о которой сообщил сам поиск: файл, который не удалось прочитать, или сканирование, не нашедшее Manifest с таким именем, — поэтому обычно по ней видно, какая из двух форм была опробована и почему результат оказался пустым.

extends: сущности Release разрешается относительно каталога и принимает одну форму. 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 (слияние наследования не удалось (Release <name>, в .spec.extends, <entity> расширяет <reference>, который не удалось разрешить: <what looking produced>). Убедитесь, что ссылка extends — относительный путь к файлу Release, например ./base-release.yaml, разрешаемый от каталога, содержащего этот Release)

Как исправить: для Component или Feature убедитесь, что значение extends: называет сущность, имеющуюся в каталоге, записанную как собственное metadata.name этой сущности — с учётом регистра. Базовая сущность, опубликованная в реестре, читается из кэша артефактов по закреплению, записанному для неё в lockfile сущности Release, поэтому, если база находится в реестре, выполните aggrega pull --release <release>: pull проходит по цепочке, загружает базу и закрепляет её. Для Manifest убедитесь, что файл находится там, куда указывает относительный путь, или что Manifest с этим metadata.name находится в каталоге Release и разбирается. Для Release убедитесь, что значение начинается с ./ или ../ и что файл, на который оно указывает, существует и разбирается как Release.

Цепочка extends: превышает ограничение глубины

Цепочка extends: сущности Component, Feature, Manifest или Release завершается корректно, но проходит через больше сущностей, чем допускает ограничение в десять.

У неё собственное условие, а не общее с предыдущим, потому что у двух решений нет ничего общего: отсутствующий родитель — это ссылка, которую нужно исправить, а слишком глубокая цепочка — это структура, которую нужно уплостить. Ограничение — защита от случайной ошибки при создании, а не структурный предел: архитекторы обычно расширяют базовую конфигурацию на один-два уровня, а цепочка глубиной в десять обычно означает разросшееся базовое дерево, а не продуманный замысел.

Его достигает только цепочка, которая ЗАВЕРШАЕТСЯ. О цепочке, замыкающейся на себя, сообщается как о цикле независимо от её длины, поэтому это условие никогда не подменяет цикл, и его совет — сократить цепочку — для цикла никогда не даётся.

Выводимое сообщение, называющее ограничение и достигнутую цепочкой длину:

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 превышает максимальную глубину (Component <name>, правило extends). ограничение — 10, а эта цепочка достигает <length>; сократите цепочку или расширяйте базу, расположенную ближе к корню)

Feature, Manifest или Release появляется вместо Component, когда сбой произошёл в одной из этих цепочек. Ограничение одинаково — десять — для каждого вида, объявляющего extends, и считает сущности в цепочке, а не связи между ними: цепочка ровно из десяти сущностей собирается, а одиннадцатая сущность — это то, о чём сообщает данное условие. Так, сущность, расширяющая базу, которая расширяет базу, — три сущности, две связи — достигла трёх.

Как исправить: сверните середину цепочки. Столь глубокая цепочка обычно означает, что каждый уровень добавляет немного, и объединение нескольких уровней в одну базовую сущность — это и исправление, и более ясная структура. Если уровни действительно различны, сущность ниже по цепочке может напрямую расширять базу ближе к корню вместо наследования через все промежуточные уровни. Столь глубокая цепочка Manifest обычно представляет собой стек наложений для разных окружений — объедините уровни, которые никто не меняет, с базой, на которую они накладываются.

Имя утверждения объявлено дважды вдоль цепочки extends:

Сущность и то, что она расширяет, объявляют утверждение с одинаковым именем, причём с разными правилами. Утверждения расширяющей сущности добавляются к утверждениям базы и никогда не заменяют их. Поэтому имя, объявленное дважды с двумя разными правилами, незаметно отменило бы инвариант базы, что противоположно назначению расширения сущности.

Объявление того же имени с идентичным правилом не является конфликтом, и сборка проходит. Именно это делает проверку идемпотентной вдоль цепочки: без этого цепочка глубиной в три каждый раз конфликтовала бы со своим средним уровнем.

Порядок — часть контракта, а не случайность. Утверждения вычисляются в объединённом порядке, и первое неудачное останавливает сборку, поэтому инвариант базы проверяется раньше инварианта потомка, а вдоль цепочки набор накапливается от корня вниз.

Выводимое сообщение:

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 (Component <name>:<version>, правило assertions, в .spec.assertions.<key>). утверждение “<key>” уже объявлено базовым Component “<base>” с другим правилом; переименуйте утверждение расширяющей сущности; утверждения расширяющей сущности добавляются к утверждениям базы и никогда их не заменяют)

Как исправить: переименуйте утверждение расширяющей сущности; сообщение называет его вместе с базой, которая уже его объявляет. Если вы хотели заменить правило базы, расширение этого не поддерживает — сузьте утверждение базы, чтобы оно выполнялось для каждой расширяющей её сущности, или перенесите правило вниз, в сущности, которым оно действительно нужно. Если два правила должны быть одинаковыми, сделайте их текстуально идентичными, и конфликт исчезнет.

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>") (цепочка extends для release компонует и именованные границы, и компоненты верхнего уровня: объявите одну форму маршрутизации для всей цепочки, никогда обе; указываются файл Release, файл, объявляющий границы, и файл, объявляющий компоненты)

Как исправить: выберите форму маршрутизации для цепочки и используйте её на всём протяжении. Если базовый документ объявляет именованные границы, дочерний, которому нужно настроить компоненты, обращается к ним внутри содержащей их границы, а не в корне Release, — это же позволяет изменить размер одного компонента, не повторяя топологию. Если базовый документ объявляет компоненты верхнего уровня, дочерний, которому нужны именованные границы, описывает иную форму маршрутизации, чем его база, и его лучше написать как самостоятельный Release, а не как дочерний к нему.

An external input’s URL uses a scheme that is not allowed (URL внешнего входа использует недопустимую схему)

URL, на который указывает сущность, использует схему вне допустимого набора. Допустимы три схемы: https; http, но только к loopback-хосту, так что открытый текст может достичь лишь локальной машины; и oci — для содержимого, получаемого из реестра.

Выводимые сообщения — для URL http к хосту, не являющемуся loopback, и для любой другой схемы:

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 (externalinputs: <url>: обычный http разрешён только для loopback-хостов (разрешённые схемы: https, http к loopback-хосту, oci): externalinputs: схема URL не разрешена) externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: <url>: схема <scheme> не разрешена (разрешённые схемы: https, http к loopback-хосту, oci): externalinputs: схема URL не разрешена)

Как исправить: переключите URL на https или на oci, если содержимое опубликовано в реестре. Простой URL http к удалённому хосту отклоняется, а не понижается, поэтому исправление — указать защищённую схему; локальный сервер разработки продолжает работать по http, поскольку loopback-хост разрешён.

A render requests an external input the lockfile does not pin (Рендеринг запрашивает внешний вход, не закреплённый в lockfile)

Нечто, необходимое сборке, загружается с URL, который lockfile не закрепляет. Сборка рендерит замыкание, записанное в её lockfile, и ничего не загружает, поэтому не существует настройки, которая позволила бы этому запуску получить URL: замороженное замыкание делает сборку воспроизводимой, а тихое расширение набора входов — единственное, чего она делать не должна.

Поэтому эта остановка информативна, а не является ошибкой конфигурации. Закрепления были полными, когда разрешалась сущность Release, так что незакреплённый URL теперь означает, что с тех пор что-то изменилось: значение, управляющее тем, какие ссылки запрашивает рендеринг, chart, начавший указывать на новое место, или lockfile, разрешённый для другой сущности Release.

Выводимое сообщение:

"<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; выполните aggrega pull —release <release>, чтобы закрепить все внешние входные данные, которые потребляет рендеринг этой сущности Release, затем повторите сборку: externalinputs: получение незакреплённых входных данных отключено)

Как исправить: закрепите вход. aggrega pull --release <path> рендерит сущность Release, чтобы выяснить, какие внешние входы она потребляет, загружает каждый и записывает его дайджест в lockfile рядом с закреплениями зависимостей — после чего каждая последующая сборка берёт его из закреплённой записи и вовсе не нуждается в сети. Если URL новый, потому что что-то написанное вами начало на него указывать, пропущенный шаг — повторное разрешение сущности Release; если он неожиданный, стоит найти ссылку, которая его добавила, прежде чем закреплять.

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 (externalinputs: <url>: дайджест повторно загруженного манифеста — <digest>, закреплённый дайджест — <digest>: externalinputs: полученные байты не соответствуют закреплённому дайджесту) externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: <url>: хеш повторно полученных байтов — <digest>, закреплённый дайджест — <digest>: externalinputs: полученные байты не соответствуют закреплённому дайджесту)

Как исправить: сначала рассматривайте это как вопрос цепочки поставок, а не как lockfile, который нужно обновить: закрепление — это утверждение, что сборка выполнялась именно с этими байтами, а отказ означает, что это утверждение соблюдается. Убедитесь, что источник по-прежнему публикует содержимое, на которое указывает дайджест, и проверьте, не переписывает ли ответы что-либо между вами и источником; частая причина — прокси или зеркало, отдающее подмену. Только когда вы знаете, что изменилось, и принимаете это, выполните повторное закрепление с помощью aggrega pull, которая запишет новый дайджест.

A stored external input no longer matches its record (Сохранённый внешний вход больше не совпадает со своей записью)

Закреплённый вход был прочитан из локального хранилища и не совпадает с закреплённой для него записью. Проверка выполняется при каждом чтении, до выдачи байтов, поэтому повреждённое или подделанное хранилище обнаруживается в момент использования, а не молча подаётся в сборку.

Что сравнивается, зависит от способа закрепления входа. Содержимое, загружаемое по HTTPS, закрепляется хешированием полезной нагрузки, поэтому оно повторно хешируется при каждом чтении, и в сообщении приводятся оба дайджеста. Содержимое, получаемое из реестра, закрепляется дайджестом манифеста, который фиксирует полезную нагрузку через собственный манифест реестра, а не прямым хешированием, поэтому сохранённая копия проверяется по записанному размеру — полная проверка дайджеста привязана к моменту получения и к каждому повторному заполнению по дайджесту.

Выдаваемые сообщения:

externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record (externalinputs: <url>: sha256 блоба в хранилище — <digest>, закреплённый дайджест — <digest>: externalinputs: блоб в хранилище не соответствует своей закреплённой записи) externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record (externalinputs: <url>: блоб в хранилище sha256/<digest> имеет размер <n> байт, но закреплённая запись указывает <n>: externalinputs: блоб в хранилище не соответствует своей закреплённой записи)

Как исправить: удалите проблемный блоб из хранилища и позвольте следующему запуску заново заполнить его из источника — перед записью он проверяется по записанному дайджесту. Если повторное заполнение затем тоже сообщит о несовпадении дайджеста, расхождение находится выше по цепочке, а не локально, и читать следует раздел выше. Обычная локальная причина — хранилище, общее для нескольких машин, или восстановленное из резервной копии, сделанной во время записи.

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 или каталоге исправлять нечего. Сообщите о ней, указав команду, создавшую эту сборку, и тип, по которому расходятся представления: <type>))

Как исправить: в ваших файлах ничего — это сообщение о несогласованности внутри компилятора, а не об ошибке в написанном вами, и о нём стоит сообщить как о дефекте, указав тип из сообщения. Тип компонента почти наверняка в порядке.

A reference names no entity the catalog holds (Ссылка указывает на сущность, которой нет в каталоге)

Прежде чем сборка что-либо отрисует, обходится весь набор сущностей, от которых зависит сущность Release, и каждая из них закрепляется, чтобы lock-файл фиксировал ровно то, что сборка будет читать. Ссылка, на которую каталог не может ответить, останавливает этот обход: для неё нечего закрепить, а продолжение записало бы lock-файл без записи, которая понадобится сборке позже, и ничто бы об этом не сообщило.

Отказ называет ссылку и место, где она была собрана, поскольку одна сущность достижима из многих мест, а исправление вносится там, где её называют. Ссылка на библиотеку сообщается отдельно, без пути сбора: библиотека достижима из сущностей, которые ссылаются на неё через $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>"

и для плагина, привязанного к сокету провайдера, который называется по ключу конфигурации рабочего пространства, содержавшему его, а не по документу каталога:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers)

Когда файл в директориях каталога объявляет имя, которое запрашивает ссылка, под видом, которого нет ни в одном каталоге, — например, с опечаткой в kind, — примечание под этим сбоем называет этот файл, вид, который он объявляет, и виды, которые содержит каталог, и опускает совет о том, откуда читаются локальные сущности, как в сборке, которая заполняет свой lock-файл, так и в сборке, которая его читает, а также на любой другой поверхности, сообщающей об этом сбое; см. Отклонённый файл каталога и сбой, который он объясняет.

Как исправить: прочитайте ссылку в точности так, как её приводит сообщение. Несуществующее имя, никогда не публиковавшаяся версия и голое имя, на реестр которого рабочее пространство не настроено, приводят сюда одинаково, поэтому проверьте все три в таком порядке: исправьте написание; убедитесь, что версия существует; убедитесь, что содержащий её реестр настроен и доступен. Если сущность создаётся вами локально, убедитесь, что файл находится внутри каталога, который обходит сборка.

Когда aggrega pull или aggrega build --auto-pull останавливается на ссылке на библиотеку, а кэш артефактов содержит SchemaLibrary, которую не закрепляет ни одна запись lockfile и не предоставляет ни одна директория каталога, за сообщением следует строка remediation:, называющая каждую такую библиотеку. Кэшированная библиотека считается содержимым каталога, только если запись lockfile подтверждает её дайджест, а pull фиксирует эту запись по реестру, который предоставляет библиотеку. В автономном режиме pull не может ни загрузить библиотеку, ни зафиксировать для неё запись, поэтому строка предлагает запустить aggrega pull --release <release> там, где доступен реестр, или создать библиотеку в директории каталога. При подключении ни одна директория каталога и ни один реестр, которые читает pull, не предоставляют библиотеку, поэтому фиксировать нечего, и строка указывает на создание библиотеки в директории каталога.

A library reference is not written in the identity form (Ссылка на библиотеку записана не в форме идентичности)

Межбиблиотечный $ref: или $import: называет библиотеку по идентичности, а затем запись внутри неё: голое имя библиотеки, при необходимости : и нижнюю границу версии, затем # и путь записи на поверхности, которую читает поле. Хоста реестра в этой форме нет. Через какой реестр разрешается имя — это конфигурация рабочего пространства, а какую версию использует сборка — решает lock-файл, поэтому ссылка, содержащая что-либо из этого, фиксировала бы в документе то, что должна решать сборка.

Здесь отклоняются: значение, содержащее хост реестра; якорь внутри документа, записанный там, где ожидалась межбиблиотечная ссылка; пустое имя библиотеки; и @, использованный как разделитель версии, — о нём сообщается с исправленным написанием, а не общей жалобой на форму, поскольку это самая частая ошибка в этой форме.

Выводимое сообщение:

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 (Цепочка импортов модулей глубже, чем спускается обход закрепления)

Закрепление обходит каждый модуль, который импортирует сущность Aggregate, затем каждый модуль, который импортируют они, так что в lock-файл попадает весь набор, а не только первый уровень. Уже записанный модуль повторно не обходится, и это завершает обычный цикл: сущность Aggregate, импортирующая модуль, который импортирует её обратно, завершается без ошибок, записав каждый по одному разу.

Ограничение глубины в десять уровней страхует от цепочки, которую обнаружение повторов не видит: такой, что на каждом уровне предъявляет новую идентичность, как модуль, заново публикуемый под новой версией на каждом шаге. Это то же ограничение, что применяет построитель графа, поэтому композиция, которая закрепляется, также и собирается.

Выводимое сообщение:

resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth>

Как исправить: сократите цепочку. Столь глубокая цепочка обычно отражает устройство организации, а не развёртывания, поэтому найдите уровни, не вносящие собственных компонентов, и сверните их в родительские. Если каждый уровень существует лишь для того, чтобы заново опубликовать нижележащий под новой версией, то цепочку образуют версии: импортируйте нужный модуль напрямую, в нужной версии.

Это ограничение обхода закрепления. Построитель графа применяет собственное, о котором сообщается ниже в разделе «Sub-aggregate nesting depth exceeded (Превышена глубина вложенности подагрегатов)», и это два отдельных сообщения об одном и том же пределе, достигнутом в двух местах: первое — при заполнении lock-файла, второе — при построении графа.

The catalog view a build was given cannot load the bodies pinning needs (Представление каталога, переданное сборке, не может загрузить тела, нужные для закрепления)

Двум из осей, которые обходит закрепление, нужен от каталога не только ответ о версии, но и сами документы. Модули, которые импортирует сущность Aggregate, нужно прочитать, чтобы узнать, что импортируют они. Сущности Recipes, FeatureRecipes и Plugins, которые привязывает сборка, нужно прочитать, чтобы найти артефакты и библиотеки, которые называют они. Представление каталога, которое может разрешить версию, но не может вернуть эти тела, оставляет обеим осям нечего читать.

Оба случая отклоняются заранее, а не пропускаются, и причина — в том, к чему привёл бы пропуск: к lock-файлу без целого класса записей, записанному без ошибок, который последующая сборка точно воспроизводит и находит неполным. Ни одно из сообщений не содержит собственных значений, поскольку ни одно не относится к написанному вами документу, — каждое указывает, какую ось невозможно вычислить:

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 (Плагин преобразования аннотаций называет компонент, который ему не передавался, или внедряет значение, которое не принимает ни одна аннотация)

Оператор может подключить плагин управления в роли, добавляющей аннотации, и такое подключение является объявлением: оператор сам запросил преобразование, поэтому то, что добавляет плагин, явно, а не внедрено втайне. Роль ограничена соответствующим образом. Плагину передаются координаты компонентов, объявленные в ваших документах, и он может добавлять к ним аннотации, каждая из которых несёт значение, которое вы могли бы сами написать в этой аннотации: строку или объект из подключей. Возвращаемая им структура не допускает других полей, поэтому при применении его вывода остаётся проверить, называет ли каждая инъекция переданную ему координату и является ли каждое значение таким, какое принимает аннотация.

Инъекция, называющая пару «граница — компонент» вне этого набора, останавливает сборку. Плагин, добравшийся до компонента, который ваши документы не открывали, настраивал бы инфраструктуру, которую никто не объявлял, а добавленные им аннотации разворачиваются в подключения 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 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 (вывод плагина преобразования аннотаций отклонён: инъекция нацелена на координату компонента, которую хост не передавал, или несёт значение, не являющееся строкой или объектом из подключей: инъекция для указанного компонента указанной границы (указанная аннотация) несёт список; внедряемое значение аннотации — строка или объект из подключей)

Как исправить: ошибка в плагине, а не в ваших документах — исправьте его так, чтобы он внедрял аннотации только в переданные ему координаты, каждая из которых поступает в его входных данных, и только со значением-строкой или объектом из подключей. Если компонент из сообщения — тот, который плагин, по вашим ожиданиям, должен был видеть, проверьте, что 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, поэтому не с чем сверить бинарный файл, и сборка останавливается, а не загружает байты по непроверенной ссылке.

Здесь сообщается о двух видах ссылок, и проверяются они в разные моменты. Ссылка, форма которой не может быть сущностью, — путь в файловой системе или ссылка на артефакт, например URL oci://, голый .wasm или дайджест @sha256:, — отклоняется сразу на тех поверхностях, которые принимают только ссылки на сущности. Ссылка, не называющая ни одной сущности, которая где-либо хранится, отклоняется после поиска, и содержание сообщения зависит от того, как она записана: URI сущности Plugin — <pluginType>/<name>, при необходимости с версией, — описывается как сущность, которой нет ни в одном каталоге, нет в бинарном файле и которую не загрузил ни один pull, а для любой другой ссылки указывается, что она должна принять эту форму. Оба вида сообщают об одном и том же условии, поэтому реакция сборки на них одинакова.

Pull отклоняет второй вид ещё до сборки. Каждый Plugin, который называет pipeline сущности Recipe или FeatureRecipe, разрешается вместе с остальными зависимостями 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: “<reference>” — путь в файловой системе, но плагин конвейера должен быть URI сущности Plugin с областью типа плагина (<pluginType>/<name>, при необходимости с версией, например parser/yaml или parser/yaml:1.0.0))

ссылка на артефакт:

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: “<reference>” — ссылка на артефакт (схема oci://, голый .wasm или дайджест @sha256:), но плагин конвейера должен быть URI сущности Plugin с областью типа плагина (<pluginType>/<name>, при необходимости с версией, например parser/yaml или parser/yaml:1.0.0))

URI сущности Plugin, которой нигде нет:

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: “<reference>” — URI сущности Plugin, но ни один каталог не содержит названную им сущность, бинарный файл её не включает, и ни одна операция pull не загрузила её в кэш содержимого; поместите сущность Plugin в каталог или опубликуйте её в реестре и выполните aggrega 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: “<reference>” должна быть URI сущности Plugin с областью типа плагина (<pluginType>/<name>, при необходимости с версией, например parser/yaml или parser/yaml:1.0.0); голая ссылка на .wasm или ссылка на артефакт не называет сущность Plugin)

Как исправить: запишите ссылку как идентичность сущности Plugin с областью по типу сокета, при необходимости с версией — <pluginType>/<name> или <pluginType>/<name>:<version>. Если вы указывали на файл или артефакт напрямую, опубликуйте или напишите для него сущность Plugin и ссылайтесь на неё — именно в сущности находятся заявления, которые проверяются при загрузке, поэтому равноценной формы в обход неё нет. Если сообщение говорит, что ссылка является URI сущности Plugin, её форма верна, а отсутствует сама сущность: поместите сущность Plugin в каталог, указанный в рабочем пространстве, рядом с собранным .wasm, или опубликуйте плагин в реестре, который читает рабочее пространство, и выполните aggrega pull, чтобы загрузить его в кэш содержимого, — и проверьте, что указанная вами версия существует.

A cached signature bundle does not match the digest recorded for it (Кэшированный пакет подписи не совпадает с записанным для него дайджестом)

Артефакт, подпись которого была проверена при загрузке, переносит этот факт в свою запись в файле блокировки (или, для плагина, подключённого в роли вердикта, в свою запись в plugins-trust.yaml) в виде записанного дайджеста материала подписи, кэшируемого рядом с артефактом. Прежде чем что-либо будет отрисовано, сборка заново читает этот кэшированный материал для каждой читаемой ею записи, в которой он записан (сущности каталога любого вида, библиотеки, плагина), и заново вычисляет его хеш, который должен совпасть с записанным. У плагина, закреплённого в файле блокировки, и у плагина, подключённого в роли вердикта, материал проверяется повторно при загрузке его байтов; именно эта проверка затрагивает команды, загружающие плагин вне сборки, в том числе aggrega lint --release и aggrega validate --release. Отсутствующий, нечитаемый пакет или пакет с другим хешем означает, что проверенный материал не совпадает с тем, что сейчас находится на диске, и выполнение останавливается, чтобы не использовать артефакт, свидетельства подписи которого изменились в обход записи.

Повторная проверка — это сравнение хешей и ничего более. Она не перепроверяет подписи, не обращается к сети и не использует материал доверия, поэтому работает и в сборке совсем без доступа к сети; именно это позволяет однажды проверенному артефакту оставаться проверенным в последующих автономных сборках.

Следующий pull это исправляет. Pull применяет ту же проверку к каждой записи, выданной кэшем содержимого, и если проверка отклоняет запись, снова запрашивает подпись у реестра артефакта (независимо от требования к подписи, через ту же проверку, что проходит загружаемый им артефакт), записывает в запись то, что эта проверка подтверждает, и кэширует названный ею пакет, перезаписывая кэшированную копию, которая больше не совпадает со своим дайджестом. Плагин, подключённый в роли вердикта, проверяется заново при каждом pull, что бы ни было записано в его записи, и его пакет кэшируется так же. Поэтому сообщение для записи, выданной кэшем содержимого, называет этот pull. Запись, прочитанная из каталога, из копии внутри бинарного файла компилятора или из файлов рядом с сущностью Release, никогда не запрашивается у реестра, поэтому 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 (артефакт: кэшированный пакет подписи не читается: кэшированный пакет подписи не совпадает с записанным для него дайджестом. Исправление: выполните aggrega pull —release для этого релиза, чтобы заново проверить подпись артефакта в его реестре, записать её в указанный файл и закэшировать пакет, который она называет)

и изменившийся:

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 (артефакт: дайджест кэшированного пакета подписи отличается от записанного: кэшированный пакет подписи не совпадает с записанным для него дайджестом. Исправление: выполните aggrega pull —release для этого релиза, чтобы заново проверить подпись артефакта в его реестре, записать её в указанный файл и закэшировать пакет, который она называет)

и, когда байты плагина загружаются из кэша содержимого, с указанием также их источника:

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 (плагин, разрешённый из указанного источника: кэшированный пакет подписи не читается: кэшированный пакет подписи не совпадает с записанным для него дайджестом. Исправление: выполните aggrega pull —release для этого релиза, чтобы заново проверить подпись артефакта в его реестре, записать её в указанный файл и закэшировать пакет, который она называет)

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 (плагин, разрешённый из указанного источника: дайджест кэшированного пакета подписи отличается от записанного: кэшированный пакет подписи не совпадает с записанным для него дайджестом. Исправление: выполните aggrega pull —release для этого релиза, чтобы заново проверить подпись артефакта в его реестре, записать её в указанный файл и закэшировать пакет, который она называет)

<file> — это файл блокировки сущности Release или plugins-trust.yaml в каталоге сущности Release. Для записи, о которой pull не запрашивает, сообщение заканчивается перед remediation:.

Pull, которому не к какому реестру обратиться, вместо этого останавливается. Сущность каталога или библиотека указывается без реестра и привязывается к нему через default_registry рабочего пространства. Если рабочее пространство его не задаёт (задавало, когда подпись была записана, но больше не задаёт), то нет настроенного реестра, у которого можно снова запросить запись, поэтому pull останавливается с этим условием, а не записывает файл блокировки, который следующая сборка отклонит, и оставляет файл блокировки без изменений. Его сообщение содержит, после шага, который выполнял 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 останавливается — с отказом автономного режима, поскольку восстановление требует обращения к реестру, или, для плагина, подключённого в роли вердикта, ещё раньше, называя .wasm плагина как тот, который не удалось разрешить, поскольку pull разрешает этот .wasm из реестра плагина; разрешение сети на этот один запуск восстанавливает пакет. Если pull останавливается с сообщением, что не настроен реестр, к которому можно обратиться за записью, задайте в default_registry реестр, из которого был получен артефакт, и выполните pull снова. Если рабочее пространство пропускает проверку подписи для артефакта, pull вместо этого не записывает подпись в запись, и сборка принимает это при той же настройке. Если подпись, которую отдаёт реестр, не проходит проверку, pull останавливается с собственным отказом этой проверки: записанная подпись и материал, который отдаёт издатель, действительно расходятся, и это вопрос к тому, кто публикует артефакт. Для записи, сообщение о которой не называет pull, — прочитанной из каталога, из копии внутри бинарного файла компилятора или из файлов рядом с Release — удалите signature из её записи: к такой записи никогда не применяется требование подписи, поэтому после этого сборка продолжается.

A recorded signature was made for a different artifact (Записанная подпись была создана для другого артефакта)

Подпись указывает, для какого артефакта она создана. Когда pull проверяет подпись артефакта, он записывает этот факт в запись артефакта в lock-файле — или, для плагина, подключённого в роли вердикта, в его запись в plugins-trust.yaml — и кэширует проверенную подпись. Прежде чем что-либо будет отрендерено, сборка считывает из кэшированной подписи каждой записи, обслуженной кэшем содержимого, для какого артефакта она создана, и это должен быть тот артефакт, который сама сборка прочитала для записи: тот, чей манифест хранится рядом с его байтами в кэше содержимого, а не что-либо, записанное в записи. Подпись, созданная для другого артефакта, останавливает сборку. Так выглядит signature, скопированная из одной записи в другую: кэшированная подпись, на которую она указывает, цела — она по-прежнему соответствует записанному для неё дайджесту, — но создана для артефакта другой записи.

Это не зависит от требования подписи. Записанная подпись проверяется на соответствие тому, что она утверждает, независимо от того, требуется ли подпись, — так же, как и проверка того, что кэшированная подпись соответствует записанному дайджесту.

Плагин проверяется так же, где бы он ни загружался. Для плагина, закреплённого в lock-файле, и для плагина, подключённого в роли вердикта, записанная подпись сверяется с артефактом, как который были прочитаны его байты, при загрузке этих байтов из кэша содержимого; это затрагивает команды, загружающие плагин вне сборки, — среди них aggrega lint --release и aggrega validate --release, а также те же операции, вызываемые через aggrega serve и aggrega mcp.

Что читает проверка и чего она не может определить. Она читает кэшированную подпись и манифест рядом с артефактом и сравнивает хэши: она не проверяет ни одной подписи, не обращается к сети и не использует материалы доверия, поэтому работает в сборке вообще без доступа к сети. Она определяет, для какого артефакта создана подпись, в обеих формах, которые принимает pull, — подпись над самим артефактом (такие создают собственные подписывающие средства инструментария) и подписанное утверждение, называющее артефакт, — поэтому подпись, скопированная из одной записи в другую, отклоняется в любой форме. Это то же чтение, которое pull применяет к каждой принимаемой подписи: pull отклоняет подпись, которая проходит проверку, но для которой чтение не находит, что она создана для этого артефакта, или из которой вообще нельзя прочитать артефакт, поэтому ни одна записанная pull подпись не окажется нечитаемой для проверки. Запись, прочитанная из каталога, из копии внутри бинарного файла компилятора или из файла рядом с Release, не имеет манифеста, поэтому её записанная подпись сверяется только с записанным дайджестом; то же относится к подписи, помещённой в кэш вручную в форме, отличной от этих двух. И поскольку подписи не проверяются, подпись, вручную записанная в кэш и выписанная на собственный артефакт записи, не отличается от подписи, проверенной pull.

Следующий pull это исправляет. Pull применяет ту же проверку к каждой записи, обслуженной кэшем содержимого, и там, где проверка отклоняет запись, снова запрашивает подпись у реестра артефакта — что бы ни говорило требование подписи — и записывает проверенный результат в запись вместо скопированной подписи. Плагин, подключённый в роли вердикта, проверяется заново при каждом pull, что бы ни содержала его запись. Только для записи, обслуженной кэшем содержимого, проверяется, для какого артефакта создана её подпись, поэтому каждый отказ по этому условию при сборке или загрузке плагина называет этот pull.

Выдаваемые сообщения называют запись, файл, в котором записана подпись, кэшированную подпись, манифест, прочитанный сборкой для записи, и 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 (артефакт “<reference>”: подписание: записанная подпись была создана для другого артефакта (её записывает <file>, кэшированный пакет подписи <path>, у прочитанного артефакта манифест <manifest-digest>). исправление: выполните aggrega pull —release <release>, чтобы снова проверить подпись артефакта в его реестре, записать её в <file> и закэшировать указанный в ней пакет)

и там, где загружаются байты плагина, с указанием также их источника:

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 (плагин “<reference>”, разрешённый из <source>: подписание: записанная подпись была создана для другого артефакта (её записывает <file>, кэшированный пакет подписи <path>, у прочитанного артефакта манифест <manifest-digest>). исправление: выполните aggrega pull —release <release>, чтобы снова проверить подпись артефакта в его реестре, записать её в <file> и закэшировать указанный в ней пакет)

<file> — это lock-файл сущности Release или plugins-trust.yaml в каталоге сущности Release.

Pull, которому не у какого реестра спросить, вместо этого останавливается, как и в случае кэшированного пакета подписи, который больше не соответствует своему дайджесту: если сущность каталога или библиотека несёт скопированную подпись, а рабочее пространство больше не указывает default_registry, к которому её можно привязать, pull останавливается с этим условием и оставляет lock-файл без изменений. Его сообщение содержит после шага, который выполнял 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>) (проверка: “<reference>” записывает подпись, которую сборка не принимает, и не настроен реестр, к которому можно снова обратиться за ней: подписание: записанная подпись была создана для другого артефакта (кэшированный пакет подписи <path>, у прочитанного артефакта манифест <manifest-digest>))

Как исправить: ничто в ваших файлах сущностей не вызывает эту ошибку — подпись, записанная в записи, принадлежит другому артефакту. Выполните aggrega pull --release <release> — команду, которую называет сообщение: она проверяет собственную подпись записи в её реестре и записывает её вместо скопированной, как для записи lock-файла, так и для плагина, подключённого в роли вердикта. Восстановление собственной записанной подписи записи из системы контроля версий, если файл закоммичен, тоже работает. В автономном режиме pull останавливается — с отказом автономного режима, поскольку исправление требует обращения к реестру, или, для плагина, подключённого в роли вердикта, ещё раньше, называя .wasm плагина как тот, который не удалось разрешить, поскольку pull разрешает этот .wasm из реестра плагина; разрешение сети на этот один запуск это исправляет. Если pull останавливается с сообщением, что не настроен реестр, к которому можно обратиться за записью, задайте в default_registry реестр, из которого был получен артефакт, и выполните pull снова. Если рабочее пространство пропускает проверку подписи для артефакта, pull вместо этого не записывает подпись в запись, и сборка принимает это при той же настройке.

No verified signature is recorded for an artifact that requires one (Для артефакта, требующего подписи, не записана проверенная подпись)

Pull, загружающий артефакт из реестра, проверяет его подпись по политике доверия этого реестра и записывает факт проверки в запись артефакта в lock-файле. Сборка не обращается ни к какому реестру, поэтому она читает записанный факт, а не проверяет подпись заново, — и прежде чем что-либо будет отрендерено, она сверяет каждую читаемую запись с требованием, которое pull применил при загрузке артефакта. Запись, выданная кешем содержимого, для артефакта, подпись которого обязательна, без записанной проверенной подписи останавливает сборку: ничто из того, чем располагает сборка, не говорит, что артефакт, из которого она собирается рендерить, когда-либо проверялся.

Требование — то же, что у pull, настройка в настройку. Подпись обязательна, если общая для рабочего пространства политика подписи охватывает вид артефакта или если собственная запись реестра в .aggrega-config.yaml — либо, для hub.aggrega.ai без собственной записи, встроенная политика официального хаба — требует её; артефакт, вид которого не удалось определить, при активной политике считается требующим подписи. То, что позволяет pull принять артефакт без подписи, позволяет и сборке принять его запись: skip_signature_verification на верхнем уровне, тот же переключатель в собственной записи реестра, кроме вида, который требует общая политика рабочего пространства, и реестр, помеченный как advisory.

Откуда пришла запись, определяется по сборке, а не по lock-файлу. Проверяется каждая запись, выданная кешем содержимого, что бы ещё в ней ни было записано, поэтому удаление дайджеста манифеста записи вместе с её подписью не освобождает её от проверки. Запись, прочитанная из каталога, из копии внутри бинарного файла компилятора или из файлов рядом с Release, никогда не проверяется, поскольку для байтов, пришедших не из реестра, подписи реестра не существует. Записи всех разделов проверяются одинаково — сущности каталога, библиотеки и артефакты плагинов, — и каждая отклонённая проверкой запись называется в том же запуске.

Плагин, подключённый в роли вердикта, проверяется той же проверкой — через plugins-trust.yaml. Подключение plugins.governance в роли ir-verdict или render-verdict и любое подключение plugins.linter не формируют ни одного отрендеренного байта, поэтому у них нет записи в lock-файле; вместо этого проверенную подпись хранит запись рядом с lock-файлом. Каждый такой плагин, который сборка читает из кеша содержимого, сверяется с тем же требованием через те же настройки: запись в этом файле без подписи останавливает сборку, как и полное отсутствие записи для плагина, — удаление файла записей не освобождает от проверки. Плагин, выданный из каталога или из копии внутри бинарного файла компилятора, не проверяется. Требование действует для такого плагина везде, где он загружается для Release, а не только при сборке: aggrega lint --release и aggrega validate --release, а также те же операции, вызываемые через aggrega serve и aggrega mcp, завершаются с ошибкой по этому условию, когда загружают его.

Выводимые сообщения называют запись, файл, в котором для неё не записана подпись, настройки, требующие её подписи, и команду, которая записывает подпись в этот файл. Для записи lock-файла, с указанием lock-файла:

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> (подпись: для артефакта, которому требуется подпись, не записана проверенная подпись (<reference>, <lockfile-path> не содержит для него подписи, требуется согласно <the settings that require it>). Исправление: выполните aggrega pull —release <release>, чтобы проверить подпись артефакта в его реестре и записать её в <lockfile-path>)

и для плагина, подключённого в роли вердикта, с указанием его файла записей:

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> (подпись: для артефакта, которому требуется подпись, не записана проверенная подпись (<plugin>, <record-path> не содержит для него подписи, требуется согласно <the settings that require it>). Исправление: выполните aggrega pull —release <release>, чтобы проверить подпись плагина в его реестре и записать её в <record-path>)

Оба файла называются по их пути рядом с Release, переданным команде: <lockfile-path> — lock-файл Release, а <record-path> — plugins-trust.yaml в каталоге Release.

Настройки называются словами самого файла конфигурации: `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 запрашивает у реестра артефакта его подпись по дайджесту манифеста, записанному в записи, точно так же, как для загружаемого артефакта, и записывает проверенную подпись в запись — так что следующая сборка её прочитает. О плагине, подключённом в роли вердикта, реестр в любом случае запрашивается при каждом pull, и pull записывает проверенное в запись плагина в plugins-trust.yaml, создавая запись, если её нет. Реестр, который не прикрепляет подпись, или подпись, которую конфигурация доверия не принимает, вместо этого останавливает этот pull с указанием артефакта, и это вопрос к тому, кто его публикует. В автономном режиме pull не может выполнить запрос: для записи lockfile он отказывает, указывая, как разрешить сеть на один запуск, а для плагина, подключённого в роли вердикта, останавливается до запроса, называя .wasm плагина неразрешимым, поскольку pull получает этот .wasm из реестра плагина. Восстановление записанной подписи записи из системы контроля версий устраняет проблему без сети, если кеш всё ещё содержит материал подписи, на который ссылается эта запись. Если артефакт не предполагается подписывать, менять следует требование, и сообщение указывает, какой это параметр, — но его ослабление означает, что артефакты этого реестра больше не проверяются и при pull, поэтому лучше сузить список видов в общей политике рабочего пространства, чем отключать требование.

A recorded signature is not the one a pull would record (Записанная подпись не та, которую записал бы pull)

aggrega pull --verify сообщает, изменит ли запуск aggrega pull сейчас файлы, которые фиксирует pull, а подпись, проверенная pull для артефакта, входит в то, что он записывает: signature в записи lockfile-файла и в записи plugins-trust.yaml для плагина, подключённого в роли вердикта. Это условие — то, что verify сообщает для каждой записанной подписи, которую обычный pull записал бы иначе: записал бы там, где подпись не записана, заменил бы или очистил бы. Verify не записывает ни один из файлов и называет каждую такую запись в любом из них за один запуск.

Две записи lockfile сообщаются без обращения к реестру, поскольку pull перезаписывает их независимо от ответа реестра, поэтому они сообщаются и в автономном режиме: запись, выданная кешем содержимого, в которой не записана подпись там, где конфигурация доверия её требует, — pull записывает подпись артефакта или останавливается, если не может её установить, — и запись, чья записанная подпись сделана для другого артефакта, которую pull заменяет собственной подписью артефакта.

О каждой другой записи, которую pull снова запросил бы, спрашивается реестр, поскольку только ответ реестра говорит, изменил бы её pull: запись, байты которой verify загрузил, потому что их не было в кеше содержимого, и запись, чей кешированный пакет подписи удалён, нечитаем или изменён. Verify спрашивает реестр так же, как pull, сообщает запись, если ответ записывает, заменяет или очищает её подпись, и кеширует проверенный пакет так же, как pull. В автономном режиме о такой записи не спрашивают и её не сообщают: verify выводит строку, называющую её и сообщающую, что её подпись не проверялась.

Для записи доверия плагинов каждый pull проверяет в реестре подпись каждого плагина, подключённого в роли вердикта, и 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 (записанная подпись не совпадает с той, которую записал бы pull (<reference>, <file> содержит <signature>, pull записал бы <signature>). Исправление: выполните aggrega pull —release <release>, чтобы обновить <file>)

для записи без подписи там, где она требуется, — записи 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 (записанная подпись не совпадает с той, которую записал бы pull (<reference>, <file> не содержит подписи, pull запросил бы у реестра подпись, которой требует требование, и записал бы её). Исправление: выполните aggrega pull —release <release>, чтобы обновить <file>)

для записи, чья записанная подпись сделана для другого артефакта, — записи 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 (записанная подпись не совпадает с той, которую записал бы pull (<reference>, <file> содержит <signature>, созданную для другого артефакта, pull запросил бы у реестра собственную подпись этого артефакта и записал бы её). Исправление: выполните aggrega pull —release <release>, чтобы обновить <file>)

и для плагина, для которого в записи нет элемента, если сборка отклоняет его из-за отсутствия записанной подписи, — вторая форма выводится в автономном режиме, когда 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 (записанная подпись не совпадает с той, которую записал бы pull (<plugin>, в <record-path> нет записи для него, а подпись для него требуется, pull записал бы <signature>). Исправление: выполните aggrega pull —release <release>, чтобы обновить <record-path>)

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 (записанная подпись не совпадает с той, которую записал бы pull (<plugin>, в <record-path> нет записи для него, а подпись для него требуется, pull запросил бы у реестра подпись, которой требует требование, и записал бы её). Исправление: выполните aggrega pull —release <release>, чтобы обновить <record-path>)

<signature> описывает подпись её режимом, подписантом и дайджестом её пакета — a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>, с issued by <issuer> после подписанта для бесключевой подписи — либо имеет вид no signature. <file> — это lockfile сущности Release, <lockfile-path>, или plugins-trust.yaml в каталоге сущности Release, <record-path>.

Как исправить: выполните pull, который называет сообщение. Он записывает в названный файл ту подпись, о которой говорит сообщение, и кэширует её пакет, поэтому следующий verify проходит. Где сообщение говорит, что pull обратился бы к реестру, pull записывает то, что проверяет реестр, — и вместо этого останавливается, называя артефакт, если реестр прикрепляет подпись, которую конфигурация доверия не принимает, или не прикрепляет никакой там, где она требуется; это вопрос к тому, кто публикует артефакт. В автономном режиме такой pull останавливается: для записи lockfile-файла — с отказом автономного режима, поскольку ему нужно обратиться к реестру, а для плагина, подключённого в роли вердикта, — ещё раньше, называя .wasm плагина как не разрешённый, поскольку pull разрешает этот файл из реестра плагина. Разрешение сети на этот один запуск обновляет файл. Где сообщение говорит, что pull не записал бы подписи, реестр больше не прикрепляет её и ничто её не требует: pull очищает подпись записи, и сборка допускает это при тех же настройках; если вы не ожидали, что реестр перестанет подписывать артефакт, это тоже вопрос к его издателю. Повторно: недостающий модуль — это .wasm плагина.

Файла .wasm плагина нет на этой машине

Файл .wasm плагина читается из одного из четырёх мест в следующем порядке: плагины, встроенные в бинарный файл компилятора; файл рядом с сущностью Plugin плагина в каталоге; явный путь в файловой системе, который указывает ссылка; кэш содержимого рабочего пространства, который заполняет aggrega pull. Разрешение плагина только читает то, что уже есть на машине, и ничего не загружает, поэтому это условие сообщает, что ни в одном из четырёх мест нет байтов, а не что загрузка не удалась. Исключение — один плагин: базовый импортёр, нужный импорту. Его модуль читается только из бинарного файла или кэша содержимого, но никогда не рядом с сущностью каталога, и если ни там, ни там его нет, импорт один раз загружает его из реестра по умолчанию рабочего пространства; тогда условие сообщает также, что загрузка была невозможна: рабочее пространство работает офлайн, его реестр недоступен или не содержит модуля, либо рабочее пространство не указывает реестр по умолчанию. Модуль, который был загружен и не прошёл проверку, отклоняется по собственному условию — несовпадение дайджеста или отказ подписи, — и ничего не сохраняется.

Имя файла рядом с сущностью образуется из типа и имени плагина сущности, и приведённый ниже отказ pull сообщает это имя: для pipeline-step/patch это pipeline-step--patch.wasm в каталоге, где находится документ сущности.

Сущность Plugin, написанная в одном из ваших каталогов, отклоняется, когда pull её разрешает. Pull никогда не загружает .wasm такой сущности: он ищет в четырёх перечисленных выше местах, ровно там же, где ищет сборка. Шаг конвейера, провайдер или плагин, подключённый в роли вердикта, вообще не закрепляется, и сборка каждый раз читает его сущность из каталога. Плагин, подключённый в роли преобразования, закрепляется, поскольку его байты формируют отрисованный вывод: pull записывает его сущность и дайджест содержимого найденного там .wasm, а сборка отклоняет .wasm, который больше ему не соответствует. Поэтому pull, не нашедший артефакт ни в одном из четырёх мест, останавливается сразу, до записи lock-файла или какого-либо 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 “<reference>” написана в каталоге, ожидался <file> в <directory>). Поместите собранный .wasm рядом с сущностью под этим именем или опубликуйте плагин и ссылайтесь на опубликованную сущность Plugin вместо сущности из каталога)

плагин, который загружает сборка или импорт, но ни один источник не содержит его байтов, — а также плагин, подключённый в роли вердикта, который aggrega pull --verify в офлайн-режиме читает из кэша содержимого, как сборка. Если сущность 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 (плагин “<reference>” не разрешается: URI плагина OCI требует предварительного запуска aggrega pull —release <release> (чтобы его байты были в кэше) или явного локального пути; разрешение плагинов не загружает из реестра: артефакт плагина не найден на этой машине)

базовый импортёр, который импорт не смог ни прочитать, ни загрузить, с указанием импортёра, его версии и причины — здесь офлайн-режима рабочего пространства, — а затем того, что поместит его модуль на машину:

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 (базового импортёра <importer> версии <version> нет на этой машине, а рабочее пространство работает офлайн, поэтому его реестр <host> не запрашивается; выполните импорт один раз с доступной сетью — он загрузит импортёр из реестра по умолчанию рабочего пространства, проверит его и сохранит в кэше содержимого для всех последующих импортов — или поместите его модуль с именем <file> рядом с сущностью Plugin для <importer> версии <version> в папке каталога: артефакт плагина не найден на этой машине)

Другие причины звучат как 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 сущности из вашего каталога. Если плагин потребляется из реестра, выполните aggrega pull для релиза — это поместит его в кэш. Если вы ожидали, что плагин содержится в самом компиляторе, проверьте, так ли это для запускаемого бинарного файла: aggrega plugin list перечисляет встроенные плагины. Если это базовый импортёр, выполните импорт один раз там, где рабочее пространство может обратиться к своему реестру по умолчанию, — этот запуск загрузит, проверит и закэширует его, и все последующие импорты пройдут офлайн — или, если этот реестр его не содержит, поместите его модуль рядом с сущностью Plugin этого импортёра этой версии в папке каталога под именем, указанным в сообщении; тогда эта сущность работает вместо базового импортёра.

A plugin recorded as a trusted gate is no longer attached (Плагин, записанный как доверенный шлюз, больше не подключён)

Плагин, который выносит вердикт «принять или отклонить» по сборке, записывается после того, как он разрешён, поэтому рабочее пространство хранит запись о том, какие шлюзы были проверены. Это условие сообщает записанный шлюз, который больше ничто не подключает. Сборка останавливается, а не проходит молча, потому что иначе её вывод было бы невозможно отличить от вывода, одобренного шлюзом: сборка с молча отсутствующим шлюзом и сборка, пропущенная шлюзом, дают одни и те же файлы, и никто, проверяя результат, не смог бы сказать, какой из них перед ним.

Это другой вопрос, чем плагин, байты которого изменились. В том случае отказывается запуск плагина, который не является проверенным, — это вопрос идентичности. В этом случае отказывается сборка, в которой проверенный шлюз вовсе отсутствует, — это вопрос присутствия. Соответственно различаются и способы исправления: восстановить артефакт или восстановить подключение.

Что это гарантирует и чего не гарантирует. Сверка конфигурации с записью устанавливает, что каждый записанный шлюз по-прежнему подключён и что артефакт каждого из них — записанный. Она ничего не устанавливает о том, выносит ли подключённый шлюз вердикт вообще: подключение, чья функция входа указывает на объявленный экспорт, не возвращающий вердикта, выполняется, ничего не сообщает и пропускает сборку, и никакое сравнение с записью этого не замечает — выполненный плагин в точности записанный, просто он ничего не выполнил. Два соседних случая сборку останавливают, и они названы, чтобы эту границу не считали шире, чем она есть: функция входа, указывающая на экспорт, который плагин не объявляет, отклоняется при загрузке плагина, а вывод с ключом, который форма вердикта не объявляет, отклоняется, а не читается как пустой список вердиктов.

Выводимое сообщение, называющее запись, исключённые шлюзы и оба способа исправления:

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 (плагин, записанный как доверенный для вердикта «принять или отклонить», больше не подключён ни в одной роли вердикта: <record-path> записывает <plugin> как доверенный, но ни одно подключение вердикта в конфигурации рабочего пространства его не называет; шлюз, который был проверен и теперь отсутствует, оставляет вывод, неотличимый от вывода, одобренного этим шлюзом. Подключите плагин снова в plugins.governance в роли ir-verdict или render-verdict либо в plugins.linter; или, если его предполагалось убрать, выполните aggrega pull —upgrade —release <release> <plugin>, чтобы удалить его из записи, — обычный aggrega pull оставляет запись как есть, поэтому запись удаляет только явное обновление)

Если исключено несколько шлюзов, они перечисляются вместе в одной команде обновления, а не каждый в своей: целевое обновление принимает несколько целей и не трогает ни одну закрепляющую запись, которую оно не назвало, поэтому перечислить их вместе и короче, и уже, чем полное обновление, которое потребовалось бы иначе.

Как исправить: сообщение предлагает два способа, потому что только вы знаете, какой из них подходит. Если шлюз удалён по ошибке, подключите плагин снова в plugins.governance в роли вердикта или в plugins.linter. Если его предполагалось убрать, скажите об этом явно с помощью целевого обновления, которое приводит сообщение: именно оно удаляет его запись. Не редактируйте и не удаляйте запись, чтобы устранить это условие, — это зафиксированная запись того, что было проверено, и обычный pull намеренно её не трогает, потому что молчаливое принятие удаления — именно то, что этот отказ призван предотвратить.

A gate recorded as trusted resolves to a different identity (Шлюз, записанный как доверенный, разрешается в другую идентичность)

Плагин, который выносит вердикт «принять или отклонить» по сборке, записывается после того, как он разрешён, вместе с версией и дайджестом артефакта, в которые он разрешился. Это условие сообщает последующее разрешение, когда оно приходит к другой версии или другим байтам для шлюза, который запись уже хранит, а запуск не запрашивал принятия этой идентичности.

Одно условие охватывает и сменившуюся версию, и сменившиеся байты, потому что запись адресуется идентичностью плагина и хранит версию и дайджест как поля одной записи: сравнение разрешения с ней — одно сравнение с одним результатом. Повторная публикация, изменившая не все байты, и повторный push той же версии для проверяющего — одно и то же событие: идентичность больше не та, что была проверена.

Это другой вопрос, чем записанный шлюз, который больше ничто не подключает: там вопрос присутствия, а не идентичности. Это также отличается от плагина, чьи кэшированные байты расходятся с записанным дайджестом: в том случае отказывается запуск плагина, который не является проверенным, и исправление — восстановить или заново записать артефакт, а в этом случае отказывается принятие новой идентичности без запроса, и исправление — назвать плагин в обновлении. Два способа исправления — два условия.

Запросить новую идентичность 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 (плагин “<plugin-identity>”: <record-path> записывает для него как доверенную версию <recorded-version> с дайджестом <recorded-digest>, но это разрешение сообщает версию <resolved-version> с дайджестом <resolved-digest>; проверьте, что изменилось, и примите это с помощью aggrega pull —upgrade —release <release> <plugin> либо восстановите записанную идентичность: идентичность плагина, записанная как доверенная, больше не совпадает с тем, что сообщает это разрешение)

Как исправить: решите, какая из двух идентичностей вам нужна, потому что это можете сделать только вы. Если смена ожидаемая — шлюз был опубликован заново, и вы проверили, что изменилось, — примите её с помощью целевого обновления, которое приводит сообщение: оно заново разрешает этот плагин и перезаписывает его запись. Если вы этого не ожидали, проверенной является записанная идентичность: восстановите версию или артефакт, названные в записи, и выясните, почему ссылка теперь разрешается в другое место. Не редактируйте запись, чтобы устранить это условие, — это зафиксированное утверждение о том, что было проверено, и обычный pull намеренно её не трогает, потому что молчаливое принятие изменённого шлюза — именно то, что этот отказ призван предотвратить.

Заявления сущности Plugin расходятся с собственным отчётом плагина

Сущность Plugin описывает, что предлагает плагин, на который она указывает: какие у него экспорты, с чем работает каждый из них и в какой области, а также — для плагина, обслуживающего провайдер, — как он ведёт себя при рендеринге. Плагин сообщает о себе то же самое при загрузке. Это условие сообщает о расхождении между ними.

Сравнение выполняется по каждому экспорту с ключом по имени и только в одном направлении: всё, что заявляет сущность, должно совпадать, а плагин может предлагать больше. Сущность, описывающая часть поверхности плагина, не обязана перечислять остальное, поэтому экспорт, который плагин объявляет, а сущность опускает, расхождением не считается. Расхождение — это заявленный экспорт, который плагин не объявляет, или заявленный экспорт, у которого operates или scope отличается от того, что сообщает плагин. Селектор в свободной форме не сравнивается.

Если сущность также задаёт блок поведения при рендеринге, его поля сравниваются по одному — виды входных данных, режим сборки, пара разделителей шаблона артефакта, аннотация имени сборки, заявление о повторно используемых экземплярах, заявление о связывании через границы, заявление об omit-записях и каталог вложения, — и называется первое расходящееся поле. Если сущность такого блока не задаёт, это сравнение полностью пропускается.

Та же проверка выполняется при публикации, поэтому несоответствие обычно обнаруживается до публикации сущности, а не при её загрузке сборкой.

Выводимые сообщения. Заявленный экспорт, которого у плагина нет:

entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe() (сущность заявляет экспорт, который describe() плагина не объявляет: wasm: заявление контракта сущности не совпадает с describe() плагина)

поле заявленного экспорта:

entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (экспорт сущности объявляет одно значение operates, но describe() плагина сообщает другое: wasm: заявление контракта сущности не совпадает с describe() плагина)

и поле поведения при рендеринге, о котором сообщается в том же виде с указанием расходящегося поля:

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() плагина)

Как исправить: исправлять нужно заявление сущности Plugin, а не ваш Aggregate или Release. Приведите заявление в соответствие с тем, что сообщает плагин, — в сообщении названы оба значения, поэтому направление исправления видно из самого сообщения. Если сущность публикуете вы, надёжный способ согласовать их — заново сгенерировать её из бинарного файла; если вы используете опубликованную сущность, выберите версию, заявление которой совпадает с бинарным файлом, на который она указывает, и сообщите о расхождении тому, кто её опубликовал.

Записанный набор команд сущности Plugin не совпадает с плагином

Если плагин добавляет команды терминала, эти команды записываются в его сущность Plugin. Эта запись создаётся машиной, а не автором: она считывается из плагина и записывается, поэтому в точности отражает бинарный файл. Это условие сообщает о записи, которая перестала его отражать, — о различии в имени команды, в её краткой справке или в порядке объявления команд.

Сравнение требует полного равенства, и это сделано намеренно. Заявления о возможностях и экспортах в других местах сущности курируются: автор вправе описать часть поверхности и опустить остальное, поэтому они проверяются как подмножество. Запись команд не курируется, поэтому всё, что меньше точного совпадения, означает, что запись отошла от того, что плагин действительно предлагает, а близкий, но неверный список команд как раз и направил бы вызов не туда.

Плагин, загруженный без сущности, здесь не проверяется. Запись хранится в сущности, поэтому у напрямую загруженных байтов её нет, и сравнивать не с чем.

Выводимое сообщение с указанием обоих наборов и способа перезаписать их:

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() плагина; повторно запустите aggrega plugin sync и зафиксируйте результат: wasm: записанное зеркало команд не совпадает с describe() плагина)

То же сравнение при публикации сообщает наборы без указания перезаписать их:

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() плагина)

Как исправить: перезапишите набор из бинарного файла и зафиксируйте результат — сообщение называет команду, которая это делает. Не правьте запись вручную, чтобы добиться совпадения: она принадлежит машине, и ручная правка, которая совпадает сегодня, будет заново выведена и перезаписана при следующей записи. Если вы используете опубликованную сущность, а не публикуете её, сущность была опубликована с записью, которую её собственный бинарный файл не подтверждает, и это вопрос к её издателю.

Записанная версия сущности 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() плагина)

При публикации отказ также называет файл сущности, .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() (metadata.version в файле сущности не совпадает с версией из describe() файла .wasm — укажите в 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 отклоняет плагин, собственная версия которого несёт эту метку, до публикации каких-либо байтов и до обращения к реестру; пробный запуск (dry run) тоже его отклоняет.

Отклоняется только метка. Версия разработки, собранная из коммита, например 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")

Как исправить: соберите плагин из чистой выгрузки коммита, который называет тег выпуска, чтобы он сообщал версию выпуска, записанную в сущности. Чтобы выпустить само изменение, задайте в 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

То же сравнение, выполняемое при проверке плагина, сообщает оба набора без артефакта:

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

Как исправить: ничто в ваших файлах сущностей не вызывает эту ошибку, и никакое изменение в них её не устранит. Опубликуйте плагин заново обычным путём публикации, который выводит запись из бинарного файла и записывает их вместе. Если вы используете опубликованный плагин, сущность и бинарный файл, на который она указывает, были опубликованы несогласованно, поэтому сообщите о расхождении тому, кто его публикует, приведя оба набора из сообщения, — и не правьте запись вручную, чтобы она совпала: она выводится, а не пишется автором, и следующий вывод отбросит правку.

The lockfile no longer matches what the release resolves to (Lockfile больше не соответствует тому, во что разрешается выпуск)

Lockfile выпуска закрепляет каждую сущность, библиотеку и плагин, которых достигает выпуск, каждый с выбранной версией и дайджестом, и записывает сами файлы выпуска — выпуск и каждый выпуск, который он расширяет, — по дайджесту их содержимого. Дайджест сущности охватывает то, что несёт её публикация: её документ и каждый файл, который она называет рядом с собой, каждый по пути и байтам. Дайджест библиотеки и плагина охватывает их байты. Повторное разрешение выпуска даёт тот же набор, и оба сравниваются. Это условие сообщает о расхождении.

Все расхождения собираются до того, как о любом из них будет сообщено, по всему, что закрепляет lockfile, поэтому один запуск показывает всю картину, а не по одной записи за раз.

Сообщается о следующих видах расхождений, и их стоит различать, поскольку способы исправления различаются:

  • Ссылка, которую lockfile не закрепляет. Выпуск теперь достигает того, для чего в lockfile нет записи, — зависимости, добавленной после pull, который его записал. Запись называет место, где выпуск её запрашивает, поэтому о сущности Recipe или FeatureRecipe, которую привязывает сущность Manifest, сообщается вместе с записью сопоставления, которая её привязывает, а для привязанной уровнем name называется экземпляр или присоединение, для которого она выбрана.
  • Закреплённая ссылка, пара которой сдвинулась. Lockfile закрепляет одну пару версии и дайджеста, а разрешение дало другую. Это вендорное содержимое, байты которого изменились, или что-то изменившееся в рабочем пространстве: отредактирован документ сущности или библиотеки; отредактирован, добавлен или удалён файл, который называет сущность, — chart в её источнике, импортируемый ею файл, entity.lock рядом с ней; или заменён .wasm рядом с сущностью плагина. Запись называет сущность, а не файл; простой aggrega pull --release <release> называет файл, сдвинувшийся под lock сущности Recipe или FeatureRecipe, как описано в An entity reads an input the lock beside it records no pin for (Сущность читает вход, для которого lock рядом с ней не записывает закрепления). Реестр, отдающий другие байты под закреплённой версией, здесь не сообщается: pull, который их загружает, отклоняет их, как описано в Fetched or cached bytes do not match the digest committed for them (Загруженные или кэшированные байты не совпадают с зафиксированным для них дайджестом).
  • Закреплённая ссылка, которой выпуск больше не достигает. Lockfile всё ещё закрепляет то, от чего в выпуске больше ничего не зависит.
  • Файл выпуска, отредактированный после pull. Выпуск или расширяемый им выпуск больше не содержит байтов, записанных для него в lockfile. Всё, что запрашивает выпуск, — какую версию источника загрузить, какие компоненты где разместить, — разрешается из содержимого файла, поэтому записанные закрепления могут больше не описывать то, что он теперь запрашивает. Об этом сообщается здесь, до любого рендеринга, а не как о том, на чём рендеринг завершился бы ошибкой: иначе отредактированная версия источника проявилась бы позже как загрузка, не находящая закрепления. Lockfile, вообще не записывающий файла выпуска, сообщает о выпуске как о незаписанном, а о файле выпуска, который выпуск больше не расширяет, сообщается как о больше не читаемом.
  • Ссылка на источник, сдвинувшаяся в удалённом репозитории. Источник, заданный в git через ref:, записывается по коммиту, в который разрешилась ссылка. Каждый pull, не являющийся обновлением, спрашивает удалённый репозиторий, куда ссылка указывает сейчас, так же поступает и aggrega pull --verify, если сеть доступна; ссылка, разрешающаяся в другой коммит, сообщается здесь, а не принимается. Сообщают об этом только эти два: сборка читает записанный коммит и не спрашивает.

Сравнение ведётся по содержимому, поэтому идентичное содержимое, полученное другим путём, не считается расхождением: чтобы условие сработало, должны отличаться байты. Для файла выпуска сюда входят изменения комментария или пробелов — точно так же, как для сущностей Aggregate и Manifest, которые называет выпуск. Для сущности это содержимое того, что она несёт, поэтому одна и та же сущность, прочитанная из каталога и загруженная из реестра, не расходится, как и выгрузка, файлы которой отличаются только битами прав, включая бит выполнения, и публикация, архив которой сжат иначе.

Выводимое сообщение. Оно начинается с собственного предложения условия, за которым следуют все собранные расхождения, каждое с названием своей оси — а для сущности также её вида, поскольку сущность идентифицируется видом и URI вместе, так что у сущности Release, у которой сущности Aggregate и Manifest имеют общее имя, две записи, и правка любой из них сообщается для той, которую правили:

lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>) (lockfile: устарел; он больше не соответствует тому, во что разрешается его Release: сущности указанного вида нет в lockfile, с местом, откуда на неё ссылаются) <axis> "<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (указанная ссылка на указанной оси изменилась: версия и дайджест в lockfile отличаются от текущих) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (указанная сущность указанного вида изменилась: версия и дайджест в lockfile отличаются от текущих) <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 записывает читаемые им файлы в их текущем состоянии)

<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>

Сборка выводит способ исправления после записей:

run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile

Какие команды требуют от релиза соответствия его lockfile. aggrega build выполняет сравнение перед рендерингом и останавливается. aggrega validate --release и каждый выбор aggrega inspect, который разрешает релиз, — представление по умолчанию, --resolved, --ir-graph и --closure, — выполняют то же сравнение, как только разрешены зависимости релиза, и останавливаются с тем же сообщением и способом исправления, ничего не записывая в стандартный вывод; поэтому ни одна из них не пропускает lockfile, который сборка отклоняет как рассогласованный. Инструменты ассистента build, validate с release и describe с release отказывают на тех же условиях. aggrega pull выполняет это сравнение для lockfile, который собирается записать, а aggrega pull --verify — для того, что на диске. Команда, которая не разрешает ни одного релиза, — aggrega validate без аргумента, которая в этом случае читает закрепления lockfile лишь для того, чтобы найти родителя extends, или с путём к сущности, а также aggrega inspect --raw или --output yaml без --ir-graph, — не обязана соответствовать lockfile, как и релиз, рядом с которым нет lockfile. Языковой сервер редактора останавливает на этом свои сборки, а на запрос графа сообщает об этом как о предупреждении на lockfile, продолжая при этом рисовать граф.

Как исправить: заново разрешите выпуск и зафиксируйте перезаписанный lockfile. Для всего, о чём сообщает сборка, простой aggrega pull --release <release> — команда, которую выводит сборка, — и есть полное исправление: он разрешает выпуск в текущем виде, перезаписывает сдвинувшиеся закрепления и сохраняет все остальные, поэтому не меняется ничего, чего вы не трогали. Если сдвинулся файл в локальном источнике сущности Recipe или FeatureRecipe, этот pull сначала останавливается с указанием aggrega pin для сущности, поскольку запись нового закрепления рядом с ней — шаг автора; выполните его или передайте pull флаг --pin-sources, и pull устранит расхождение. Единственная запись, которую простой pull не устраняет, — ссылка на источник, сдвинувшаяся в удалённом репозитории, поскольку её устранение означает принятие коммита, который ссылка называет сейчас: это делает aggrega pull --upgrade --release <release>, и запись об этом говорит; если entity.lock сущности Recipe записывает этот источник, обновление так же останавливается, пока новый коммит не будет закреплён рядом с ней. Прочитайте записи до этого, поскольку на третьем виде стоит задержаться: ссылка, которой выпуск больше не достигает, обычно означает зависимость, удалённую намеренно, но если вы её не удаляли, изменилось что-то другое, сделавшее её недостижимой. Сдвинувшаяся пара у ссылки, которую вы не трогали, означает, что содержимое этой версии — не то содержимое, которое проверялось, и это вопрос к тому, кто его поставляет, а не то, что следует принимать не глядя.

Pull выполняет то же сравнение с lockfile, который собирается записать, и не записывает lockfile, отклонённый сравнением, поэтому только что записанный pull lockfile проходит его для сборки с теми же входными данными. Если это условие возникает сразу после успешно завершённого pull, двум запускам были даны разные входные данные: каталог, переданный одному и не переданный другому, или конфигурация рабочего пространства, отредактированная между ними. Выполняйте pull и сборку с одними и теми же входными данными.

An artifact is not at the source the build was told to find it (Артефакта нет в источнике, где сборке было указано его искать)

Ссылка каталога называет артефакт и версию. Это условие сообщает, что этой паре ничего не соответствует — ни в реестре, на который разрешается ссылка, ни в локальном кэше артефактов, из которого читает сборка.

Сборка читает кэш; сама она во внешние источники не обращается. Получение — отдельный шаг: pull, разрешающий релиз, загружает то, что нужно релизу, и записывает это в кэш, а сборка затем читает то, что там есть. Поэтому для сборки это условие выглядит как промах кэша, а для pull — как реестр, в котором нет такого артефакта. Если сборка настроена заполнять lockfile при запуске, получение, которое она выполняет, — это тот же pull.

Выводимые сообщения. Реестр без такого тега и загрузка, разрешившая манифест, blob содержимого которого отсутствует:

oci: "<reference>:<version>": oci: artifact not found at remote source (oci: reference:version: oci: артефакт не найден в удалённом источнике)

oci: content for "<reference>:<version>": oci: artifact not found at remote source (oci: содержимое для reference:version: oci: артефакт не найден в удалённом источнике)

чтение кэша, не нашедшее записи, — именно такой вид встречает сборка:

oci: cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: промах кэша для reference@version: oci: артефакт не найден в удалённом источнике)

и то же самое для кэшированного артефакта, рядом с которым отсутствует его манифест:

oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: промах кэша манифеста для reference@version: oci: артефакт не найден в удалённом источнике)

Как исправить: сначала проверьте ссылку и версию — версия, которой больше не существует, и имя с опечаткой дают один и тот же ответ, а сообщение приводит оба, чтобы их можно было сверить с каталогом. Если ссылка верна, артефакт не был получен: выполните pull для релиза, который загрузит то, что достигает релиз, и заполнит кэш. Если рабочее пространство офлайн, этот pull нужно выполнить там, где есть доступ к сети; офлайн-сборка читает только то, что уже есть в кэше, и именно это она сообщает, когда в кэше нужного нет.

The registry will not serve an artifact without credentials it accepts (Реестр не отдаёт артефакт без принимаемых им учётных данных)

Реестр ответил и отказал: либо учётные данные не были предъявлены, либо предъявленные не были приняты. Это отличается от реестра, до которого вообще не удалось достучаться, — здесь диалог состоялся, и ответ был «нет».

Об этом сообщают четыре момента, все — во время получения или публикации артефактов: разрешение ссылки, загрузка её содержимого, получение списка версий, которые содержит репозиторий, и проверка учётных данных в момент их сохранения.

Выводимые сообщения, каждое из которых называет, что запрашивалось, и приводит ответ реестра:

oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed (oci: разрешение reference:version: <what the registry replied>: oci: требуется аутентификация или она не пройдена)

получение списка версий репозитория, где вместо этого указывается статус:

oci: tags/list "<repository>": status <code>: oci: authentication required or failed (oci: tags/list repository: статус code: oci: требуется аутентификация или она не пройдена)

и проверка учётных данных при их сохранении:

oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed (oci: проверка учётных данных для host: ответ реестра: oci: требуется аутентификация или она не пройдена)

Если сбой выявляет шаг, предоставляющий способ устранения, строка заканчивается командой входа для выведенного им хоста:

remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release> (исправление: выполните aggrega login (или docker login) для указанного хоста перед повторным запуском aggrega pull —release)

а если импорт загружал один из базовых импортёров компилятора, — тем же входом перед повторным запуском импорта:

remediation: aggrega login <host> (or docker login <host>) before re-running the import (исправление: выполните aggrega login (или docker login) перед повторным запуском импорта)

Классический репозиторий чартов Helm или архив чарта, фрагмент compose и репозиторий Git, получаемые по http или https, тоже сообщают об этом условии, когда сервер отклоняет запрос как неавторизованный, и их способ исправления называет запись 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 и Git-репозиторий, получаемый по http или https, берут учётные данные из файла netrc, который читается при получении такого источника — командой pull, pin или сборкой, заполняющей свой lock-файл. Какой файл читается и какая запись отвечает на запрос, описано в разделе 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 (sourceresolver: kind=kind url=url version=version: oci: сеть недоступна (причина: сбой транспорта); устранение: проверьте сетевое подключение к <host>; для корпоративных прокси обычно нужно экспортировать HTTPS_PROXY)

Как исправить: исправление — задача оператора, и оно находится за пределами вашего каталога. Проверьте, что хост из сообщения доступен оттуда, где выполняется команда. Если окружение выходит в сеть через прокси, прокси нужно экспортировать в окружение, как указывает способ устранения, — прокси, настроенный только для браузера или менеджера пакетов, подхвачен не будет. Если хост доступен вручную, но не отсюда, разница обычно в учётных данных на прокси или в сертификате перехвата, который рукопожатие не приняло. Как только артефакты окажутся в кэше, последующие сборки читают кэш, и сеть им вообще не нужна.

A server did not answer in time (Сервер не ответил вовремя)

Запрос ожидал сервер, которому был адресован, — реестр или любой другой сервер, к которому обращается команда, например журнал прозрачности, в котором фиксируется подпись, — и был отозван. Запрос ждёт не более 30 секунд, пока сервер начнёт ответ после того, как запрос отправлен полностью, и не более 30 секунд следующую часть уже поступающего ответа; после превышения любого из этих пределов он отклоняется по этому условию с указанием сервера и времени ожидания. Именно такой результат даёт сервер, который принимает соединение и никогда не отвечает, а также адрес, который никогда не принимает соединений, вместо команды, ждущей без конца. Обход всего списка репозиториев реестра, напротив, ждёт на каждой странице столько, сколько может длиться обход, и ограничен собственным условием, E0377.

Ограничено только ожидание. Загрузка или выгрузка, которая продолжает идти, занимает столько времени, сколько потребуется, поскольку ожидание измеряется только пока ничего не поступает. Helm-чарт, который source: сущности Recipe получает по HTTPS, ограничен только ожиданием начала ответа, и истечение этого времени сообщается собственными словами сетевой библиотеки, а не по этому условию. Запрос, который команда и так повторяет при тайм-ауте, — чтение во время 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 (Список репозиториев реестра не завершился вовремя)

Обход всего списка репозиториев реестра длился пять минут, так и не дойдя до конца списка, и был остановлен. Список обходят две команды: 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: ни один cli-плагин не называется «mo», а поиск во всех репозиториях имени, содержащего его, не завершился; укажите точное имя плагина, например aggrega plugin add cli с именем плагина: обход остановлен через 5m0s, до конца списка (названо репозиториев на данный момент: 146): registry: список репозиториев не завершился вовремя)

Как исправить: для aggrega plugin add укажите точное имя плагина — aggrega plugin add cli moo вместо aggrega plugin add cli mo, — тогда плагин будет найден по этому имени одним запросом, а список никогда не будет обходиться. Для aggrega registry update причина — список реестра: уточните у того, кто управляет реестром, что его список завершается, и запустите обновление снова, когда это так. Пятиминутный предел фиксирован; нет настройки, которая его увеличивает.

A registry kept asking to slow down (Реестр продолжал просить замедлиться)

Слишком загруженный реестр отвечает 429 Too Many Requests или 503 Service Unavailable с заголовком Retry-After, который сообщает, сколько ждать. Каждый запрос, который команда отправляет в реестр, ждёт столько, сколько просит реестр, — десять секунд, если он этого не указывает, — и отправляется снова; вместе с ним ждёт каждый запрос к этому реестру, и одновременно ему отправляется меньше запросов, пока он снова не ответит. Реестр, который в течение пяти минут не отвечает ничем, кроме «помедленнее», отклоняется по этому условию с указанием реестра, его последнего ответа и того, как долго он не отвечал ничем другим; так же отклоняется и запрос, собственный лимит времени которого истекает во время ожидания. Затем aggrega registry update сообщает об этом реестре как о непроиндексированном, и он сохраняет индекс, который был у него до запуска.

Выводимое сообщение для реестра, который просил замедлиться в течение пяти минут:

<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: реестр продолжал просить замедлиться)

Как исправить: причина — ограничение частоты запросов в реестре, а не что-либо из написанного вами. Реестр, который ограничивает, как часто клиент может отправлять запросы, обычно ограничивает всё, что приходит с одного и того же адреса, поэтому проверьте, не отправляют ли ему запросы в то же время другие команды или машины за этим адресом, и запустите команду снова, когда они завершатся. Если реестр обслуживаете вы, проверьте его ограничение частоты запросов. Пятиминутное ограничение фиксировано; нет настройки, которая бы его увеличивала.

Fetched or cached bytes do not match the digest committed for them (Полученные или кэшированные байты не совпадают с зафиксированным для них дайджестом)

Каждый артефакт несёт манифест, фиксирующий дайджест его содержимого, а lock-файл независимо закрепляет дайджест этого манифеста. Обе фиксации проверяются повторным хешированием имеющихся байтов и сравнением. Именно об этом сообщает неудачное сравнение, и срабатывает оно одинаково как на только что полученных байтах, так и на байтах, прочитанных из кэша.

Два условия, и то, какое из них срабатывает, показывает, на каком уровне возникло расхождение. Одно указывает на содержимое, не совпадающее с дайджестом, который фиксирует его собственный манифест. Другое указывает на кэшированный манифест, не совпадающий с дайджестом, закреплённым для него в lock-файле, — эта проверка не даёт подменённому манифесту стать источником истины, которому доверяет последующая проверка содержимого. Именно закрепление делает вторую проверку осмысленной: дайджест берётся из lock-файла, а не выводится заново из кэшированных байтов манифеста, поэтому эти две проверки действительно независимы.

Затем сущность сверяется с собственной строкой, а не с тем, что несут байты. Когда байты кэшированной сущности совпали с её манифестом, они сравниваются с дайджестом, записанным для сущности в lock-файле; он охватывает файлы, входящие в её публикацию, — каждый по пути и байтам, — а не сжатые байты. Поэтому те же файлы, опубликованные с другим сжатием, по-прежнему совпадают, а другие файлы под той же версией — нет, и расхождение сообщается по условию для содержимого. Операция 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

Как исправить: причина не в ваших файлах сущностей, и никакое изменение в них это не устранит. Обновите кэш и lock-файл вместе командой aggrega pull --upgrade --release <release>, которая заново загружает данные из источника и перезаписывает и то, и другое. Если это помогло, кэшированная копия была изменена или усечена после записи. Если расхождение сохраняется после обновления, байты, которые отдаёт издатель, действительно отличаются от закреплённых, — это повторно опубликованная версия, и с этим вопросом следует обратиться к её издателю, причём лучше до принятия нового дайджеста, а не после.

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 или его lock-файл, импортированная схема сущности 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://… читает их, чтобы вы могли их посмотреть, а загрузка зависимости так же читает байты архива, чтобы найти закреплённую версию. Две формы этих байтов не содержат сущности для чтения.

Архив, который не распаковывается. Сущность, опубликованная вместе с объявленными файлами, публикуется как .tar.gz, и байты начинаются как такой архив, но поток сжатия или архив внутри него сформирован неправильно — чаще всего потому, что он обрезан. Байты при этом совпадают с дайджестом, который для них записан в собственном манифесте артефакта, то есть это ровно то, что было опубликовано: повреждение произошло до или во время публикации, а не по пути к вам.

Документ, который не является сущностью. Координата содержит единственный документ, и он не разбирается, не объявляет kind: или объявляет вид, который никогда не публикуется, например Release или Manifest. В этом случае ссылка указывает не на сущность, а на что-то, опубликованное рядом с каталогом, — например, на артефакт данных, опубликованный с помощью aggrega push-artifact.

Выводимые сообщения. Архив, поток сжатия которого сформирован неправильно, с ошибкой, которая его остановила:

oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked (oci: распаковка gzip: <archive error>: oci: опубликованный пакет невозможно распаковать)

архив, обрывающийся посреди файла:

read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked (чтение <file> из опубликованного пакета: <archive error>: 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 (опубликованные байты не разбираются как документ (<parse error>): oci: опубликованный артефакт не является документом сущности)

Как исправить: архив, который не распаковывается, должен заменить издатель. Опубликованные байты заморожены, поэтому решение — опубликовать сущность снова с новой версией; если вы её потребляете, передайте сообщение её издателю. Документ, который не является сущностью, почти всегда означает, что ссылка не та, которую вы имели в виду: проверьте, что она указывает координату, по которой опубликована сущность, — это ссылка, которую печатает aggrega push при публикации.

The registry could not answer what is attached to an artifact (Реестр не смог ответить, что прикреплено к артефакту)

Подписи и другие вложения прикрепляются к артефакту, а не находятся внутри него, и их поиск — это запрос к реестру. Это условие означает, что запрос остался без ответа: реестр не поддерживает такой поиск, артефакт, к которому прикреплены вложения, не удалось найти, или сам запрос завершился ошибкой.

Это не то же самое, что ответ «ничего не прикреплено», и именно смешение этих двух случаев это условие и призвано предотвратить. Артефакт, у которого действительно нет подписи, разрешается обычным образом и даёт пустой список. Здесь же список так и не был получен, поэтому о прикреплённом вообще ничего не известно.

Остановится ли сборка, зависит от того, требуется ли подпись, и оба варианта поведения выбраны намеренно:

  • Подпись требуется. Сборка останавливается. Обязательная проверка, которую не удалось выполнить, не пройдена, и допуск артефакта опирался бы на вопрос, который никому не удалось задать.
  • Подпись не требуется. Сборка продолжается и явно сообщает об этом, а не молчит. Поиск не дал ничего для проверки ни в одну сторону, поэтому отказ отклонил бы артефакт из-за вопроса без ответа, но молчание выглядело бы как чистая загрузка без подписи, которой это не является.

Выводимые сообщения. Реестр не поддерживает поиск:

oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed (oci: цель не поддерживает обнаружение ссылающихся объектов: <target kind>: oci: обнаружение ссылающихся объектов не удалось завершить)

сам артефакт не найден:

oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: не удалось разрешить субъект по указанной ссылке из-за исходного сбоя: oci: не удалось завершить обнаружение связанных артефактов)

и поиск завершился ошибкой:

oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: не удалось получить список связанных артефактов для указанной ссылки из-за исходного сбоя: oci: не удалось завершить обнаружение связанных артефактов)

Если подпись не требуется, тот же текст выводится как уведомление:

signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above> (проверку подписи для <uri> выполнить не удалось (реестр не ответил на поиск подписи, подпись не требуется; продолжение): <the message above>)

Как исправить: исправление за оператором, и проблема в реестре, а не в вашем каталоге. Если реестр вообще не поддерживает поиск вложений, он не может хранить подписи, поэтому либо зеркалируйте артефакт в реестр, который может, либо перестаньте требовать подписи от этого хоста в .aggrega-config.yaml — и отметьте, что именно вы выбираете, поскольку второй вариант означает, что подписи от этого хоста больше не проверяются. Если поиск завершился ошибкой в реестре, который его поддерживает, это проблема транспорта или прав доступа именно на конечной точке вложений, и единственное, что нужно, — повторить запуск, когда реестр станет доступен.

An artifact that must be signed carries no signature (Артефакт, который должен быть подписан, не несёт подписи)

Подпись требуется для артефакта, если его вид охватывает собственная политика подписи рабочего пространства или если реестр, из которого он получен, настроен требовать подпись. Это условие сообщает, что реестр ответил на запрос вложений, ничего не было вложено, а подпись требовалась.

Эти два требования — одна позиция, рассматриваемая в двух областях. Политика уровня рабочего пространства требует подпись для вида из своей области даже от хоста, собственная запись которого подписи не требует, поэтому хост, ничего не требующий, не освобождает артефакт, охваченный политикой рабочего пространства.

Если подпись не требуется, это вовсе не ошибка. Артефакт проверяется, если подпись есть, и тихо проходит, если её нет, — именно это позволяет использовать хост без настроенной позиции без лишних формальностей.

Артефакт, вид которого не удалось определить при активной политике уровня рабочего пространства, считается требующим подписи, а не освобождённым от неё, поэтому неклассифицируемый артефакт не может проскользнуть мимо включённой политики.

Выводимое сообщение, обрамлённое ссылкой, которую оно проверяло:

verifying the signature of <uri>: signing: no signature found for an artifact that requires one (проверка подписи <uri>: signing: не найдена подпись для артефакта, который её требует)

Как исправить: исправление — задача оператора или издателя, а не автора сущности. Если вы ожидали, что артефакт подписан, значит, он был опубликован без подписи — сообщите ссылку тому, кто его публикует, поскольку только он может приложить подпись. Если артефакт не предполагается подписывать, менять нужно требование: оно задаётся либо записью реестра в .aggrega-config.yaml, либо политикой подписи уровня рабочего пространства, а ссылка в сообщении указывает, какой хост проверить. Отключение требования означает, что артефакты с этого хоста больше не проверяются, поэтому лучше сузить область политики до вида, чем отключать её полностью.

A signature does not verify (Подпись не проходит проверку)

Подпись была найдена и проверена, и проверка не прошла. Это общий отрицательный исход такой проверки, охватывающий цепочку сертификатов, не восходящую к доверенному материалу, подпись без записи в журнале прозрачности там, где она требуется, подпись над другим артефактом, чем имеющийся, изменённый пакет и пакет, проверяемый по закреплённому ключу, с которым он не сходится.

Это условие намеренно отличается от подписи, подписант которой не является доверенным. Та структурно корректна и сделана не тем подписантом; эта вообще не прошла проверку. Их разделение позволяет отличить «артефакт — не то, что было подписано» от «артефакт подписан тем, кого вы не приняли».

То, для какого артефакта сделана подпись, проверяется дважды. Как только криптографическая проверка подписи проходит, инструментарий считывает из самой подписи, для какого артефакта она сделана, — то же самое прочтение, по которому каждая последующая сборка сверяет записанную подпись и которое позволяет сборке отвергнуть подпись, скопированную с одного артефакта на другой, ничего не проверяя, — и отвергает подпись, если это прочтение не называет имеющийся артефакт или если подпись имеет форму, из которой прочтение не может определить артефакт. Считываются обе формы, которые принимает получение: подпись, сделанная над самим артефактом, и подписанное утверждение, которое его называет. Прочтение следует собственным правилам криптографической проверки, поэтому для подписи, которую эта проверка принимает, они совпадают; отказ такого рода означает, что они не совпали, и о нём стоит сообщить со ссылкой и сообщением, а не обходить его настройкой.

Если запись реестра помечает проверку как рекомендательную, тот же текст выводится как уведомление, и выполнение продолжается.

Выводимые сообщения. От самой проверки, с цитатой того, что сообщил верификатор:

signing: signature bundle does not verify: <what the verifier reported> (signing: пакет подписи не проходит проверку: сообщение верификатора)

и, если криптографическая проверка проходит, а прочтение того, для какого артефакта сделана подпись, не совпадает:

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: пакет подписи не проходит проверку: его криптографическая проверка проходит, но он не называет указанный дайджест манифеста артефактом, для которого он сделан)

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 (signing: пакет подписи не проходит проверку: его криптографическая проверка проходит, но он имеет форму, из которой нельзя прочитать артефакт, для которого он сделан)

каждое обрамлено проверяемой ссылкой:

verifying the signature of <uri>: <the message above> (проверка подписи <uri>: <the message above>)

и, если запись реестра делает проверку рекомендательной, как уведомление вместо остановки:

signature verification failed for <uri> (advisory; continuing): <the message above> (проверка подписи для <uri> не прошла (рекомендательно; продолжение): <the message above>)

Как исправить: ничто в ваших файлах сущностей не вызывает это, и никакое изменение в них это не устранит. Рассматривайте это как утверждение об артефакте, а не о вашей конфигурации: имеющиеся байты — не те, что были подписаны, или подпись не может быть проверена настроенным доверенным материалом. Сначала получите артефакт заново, поскольку усечённая или изменённая кэшированная копия даёт именно такую ошибку, а свежая загрузка её устраняет. Если ошибка сохраняется после свежей загрузки, сообщите ссылку и собственные слова верификатора тому, кто публикует артефакт. Не прибегайте к рекомендательной настройке, чтобы обойти ошибку: эта настройка оставляет проверку работающей и лишь не даёт ей останавливать сборку, что является осознанным решением принимать непроверенные артефакты с этого хоста, а не способом что-либо исправить.

A signature verifies but its signer is not one the registry trusts (Подпись проходит проверку, но её подписант не входит в число доверенных для реестра)

Подпись прошла проверку — цепочка сертификатов восходит к доверенному материалу, и запись прозрачности есть, — но идентичность в этом сертификате не совпадает ни с одной из идентичностей, настроенных как допустимые для реестра. Артефакт подписан реальным подписантом, который не был принят.

Сравниваются обе половины идентичности — субъект и издатель, который за него поручился, — и не совпасть может любая из них. Сообщение называет обе, если их можно прочитать из сертификата, поскольку подписант, предъявляющий ожидаемый субъект от издателя, которого никто не принимал, выглядит так же, как неверный субъект, если не показаны обе половины.

Выводимые сообщения. Когда обе половины читаются:

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 (signing: идентичность подписи не является доверенной для этого реестра: сообщение верификатора; подписант предъявил указанного издателя с указанной идентичностью, но ни одна доверенная идентичность не допускает этого издателя)

и когда их нельзя прочитать, с возвратом к собственному отчёту верификатора:

signing: signature identity is not trusted for this registry: <what the verifier reported> (signing: идентичность подписи не является доверенной для этого реестра: сообщение верификатора)

Как исправить: это решение оператора, и оно настоящее, а не формальность. Сравните издателя и идентичность в сообщении с доверенными идентичностями, настроенными для этого реестра в .aggrega-config.yaml. Если это подписант, которого вы хотите принять, добавьте его: запись называет идентичность или шаблон, соответствующий ей, вместе с издателем, и оба должны быть верными. Если нет, артефакт подписан тем, кого вы не приняли, и добавление идентичности ради прохождения сборки — именно то, чего следует избегать. Реестры, публикующие собственную политику доверия, позволяют закрепить её при добавлении реестра — так нужные идентичности попадают в конфигурацию без ручного переписывания.

A keyless trust policy names no acceptable signer (Политика доверия без ключей не называет ни одного допустимого подписанта)

Проверка без ключей решает, принять ли артефакт, сопоставляя идентичность в его сертификате подписи с набором идентичностей, настроенных как допустимые. Пустой набор отвергается, а не считается политикой: сопоставление с пустотой либо приняло бы всех подписантов, либо отвергло бы всех, и ни то ни другое не входило в намерения оператора, настроившего проверку.

Выводимое сообщение, которое и есть собственная формулировка условия:

signing: keyless verification requires at least one trusted identity (signing: проверка без ключей требует хотя бы одной доверенной идентичности)

Как исправить: настройте для реестра хотя бы одну доверенную идентичность в .aggrega-config.yaml. Запись называет идентичность — точный субъект или соответствующий ему шаблон — вместе с издателем, который за неё ручается, и оба обязательны. Если реестр публикует собственную политику доверия, закрепление этой политики при добавлении реестра заполняет набор тем, что публикует реестр. Если вы вообще не собираетесь проверять подписи из этого реестра, это отдельная настройка, а не пустой набор идентичностей, и именно её явная установка говорит об этом.

The pinned trust root cannot be read (Закреплённый корень доверия не удаётся прочитать)

Корень доверия, закреплённый в рабочем пространстве, позволяет проверке без ключей выполняться без доступа к сети, где бы она ни запускалась: это файл, содержимое которого — материал, по которому проверяется каждая подпись. Это условие сообщает, что файл по настроенному пути не удалось превратить в пригодный материал доверия: он отсутствует, недоступен для чтения или его содержимое не является корнем доверия.

Сборка останавливается, а не переходит на запасной вариант. Закреплённый корень — это осознанный выбор проверять подписи по материалу, который вы контролируете, поэтому молча загрузить корень вместо него означало бы заменить этот выбор другим и получить результат проверки, которого никто не запрашивал.

Выводимое сообщение, называющее путь и цитирующее то, что сообщило чтение:

signing: cannot load pinned trust root: <path>: <what the read reported> (signing: не удаётся загрузить закреплённый корень доверия: <path>: <what the read reported>)

Как исправить: это задача оператора. Убедитесь, что путь, настроенный для корня доверия, существует и доступен для чтения тому, кто запускает команду: путь относительно другого рабочего каталога и файл, который есть, но не читается, — оба приводят к этому сообщению. Если файл существует и читается, значит, его содержимое не является корнем доверия: замените его актуальным пакетом из источника, откуда вы его получили, а не редактируйте. Если закреплённый корень не предполагался, менять нужно конфигурацию: снимите закрепление, и проверка будет использовать материал, который ей был бы передан в ином случае.

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 (signing: неподдерживаемый тип хранимого ключа: закреплённый ключ использует указанный алгоритм, требуется ECDSA P-256)

и ключ, загруженный для подписи:

signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256 (signing: неподдерживаемый тип хранимого ключа: хранимый ключ использует указанный алгоритм, требуется ECDSA P-256)

Как исправить: передайте ключ профиля, указанного в сообщении. Если вы выполняете проверку, ключ — это тот, что закреплён для реестра в .aggrega-config.yaml, и он должен быть открытой частью ключа, которым подписывает издатель; несоответствие здесь обычно означает, что закреплён не тот файл, поскольку ключ правильного типа, но не тот, сообщается как подпись, которая не проходит проверку. Если вы подписываете, сгенерируйте ключ указанного профиля или используйте путь без ключей, которому хранимый ключ вообще не нужен.

The workspace is offline and the step needs the network (Рабочее пространство работает офлайн, а шагу нужна сеть)

Рабочее пространство можно пометить как офлайн, и эта настройка — запрет, а не предпочтение: каждый шаг, который обратился бы к сети, отвергается в момент его создания, ещё до любого соединения. Ранний отказ позволяет ошибке сообщить «это рабочее пространство работает офлайн», а не проявиться позже как тайм-аут без объяснений.

Одно решение, читаемое в одном месте. Шаг, которому нужно заранее знать, доступна ли сеть, задаёт тот же вопрос, что и сама загрузка, поэтому проверка и операция, которую она охраняет, не могут прийти к разным выводам.

Это затрагивает несколько видов работы, и во всех случаях это один и тот же отказ: получение артефакта из реестра, получение источника сущности Recipe по сети, загрузка внешнего входа, получение идентичности для подписи и загрузка материала доверия. Сборка, читающая заполненный кэш, не затрагивает ни один из них, в чём и состоит смысл настройки.

Если вся команда — это сетевой обмен, отказ происходит в начале, а не в конце. 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: доступ к сети запрещён, поскольку рабочее пространство работает офлайн; устранение: передайте —offline=false, чтобы разрешить сеть для этого запуска, или очистите ключ верхнего уровня offline в файле конфигурации (или AGGREGA_OFFLINE), чтобы разрешить её впредь; если это сборка, которой нужно содержимое, отсутствующее на машине, сначала выполните aggrega pull —release <release> из окружения с подключением, чтобы заполнить кэш)

В обрамлении того, чему понадобилась сеть, — например, получения источника сущности Recipe:

sourceresolver: kind=<kind> url=<url> version=<version>: <the message above>

Добавление официального хаба в офлайн-рабочем пространстве не отвергается: хаб добавляется на своей встроенной базовой конфигурации, а уведомление сообщает, что политика доверия у хаба не запрашивалась, поскольку рабочее пространство работает офлайн.

Как исправить: сообщение называет три способа, и какой из них подходит, решать вам. Если режим задан, а вам нужно обойти его для одной команды, передайте --offline=false: флаг существует именно для этого, и это единственный выход для того, кто не сам писал файл конфигурации. Если рабочее пространство и должно работать офлайн, исправлять нужно недостающее содержимое: выполните pull там, где есть доступ к сети, чтобы кэш содержал всё, к чему обращается релиз, и тогда офлайн-сборке больше ничего не понадобится. Если оно вовсе не должно работать офлайн, очистите настройку в её источнике — ключ верхнего уровня offline в .aggrega-config.yaml или переменную окружения, названную в сообщении; именно переменная чаще всего застаёт людей врасплох, потому что её нет ни в одном файле. Учтите, что офлайн-рабочее пространство вообще не может подписывать по пути без ключей, поскольку выпуск сертификата и его запись — сетевые операции, у которых нет офлайн-формы.

При построении топологии

Когда у каждой сущности Component есть разрешённый Recipe, компилятор связывает Components в граф IR, читая блок uses: каждой сущности Component и сопоставляя цели и подключения функций.

Висячая цель uses

Ребро 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 не существует (<target>, подключено к сокету <socket>). Направьте цель на компонент, который объявляет Aggregate, или объявите компонент с этим именем.)

Находка привязывается к той авторской записи, которой она касается, в документе, где эта запись написана, поэтому соединение, проведённое собственным блоком uses: компонента, соединение, спроецированное подключением, и соединение, подключённое сущностью Release, сообщаются каждое в своём блоке. Каждое ошибочное соединение сообщается отдельной находкой, поэтому одна сборка называет их все, а не останавливается на первом.

Как исправить: объявите недостающий целевой компонент или исправьте имя цели в записи uses:, чтобы оно совпадало с существующим компонентом.

Два соединения одного компонента под одним псевдонимом

Компонент читает каждое из своих соединений по его псевдониму — ключу, под которым соединение записано, или, для соединения, записанного как элемент списка, по собственному имени его цели. Шаблон Recipe читает соединения компонента с ключом только по псевдониму, а утверждение читает их с ключом сначала по сокету, а затем по псевдониму, поэтому два соединения одного компонента под одним псевдонимом делили бы одну ячейку хотя бы в одном из этих представлений: более позднее заняло бы её, а другое отсутствовало бы в том, что видит шаблон или утверждение. Поэтому один псевдоним обозначает одно соединение компонента — к какому бы сокету каждое ни было подключено, что бы его ни провело (собственный блок uses: компонента, блок uses: вложения в любой области видимости или запись для отдельного ребра в Release) и какой бы ни была его цель. Такая пара останавливает сборку, как только граф становится окончательным, до выполнения любого утверждения и до какой-либо отрисовки.

Пара возникает из написания, допустимого на каждой поверхности по отдельности: собственная запись компонента и запись подключения на одном сокете и псевдониме; список, дважды называющий одну цель (models: [llama, llama]); один псевдоним на двух сокетах (models: { local: … } рядом с databases: { local: … }); два подключения, использующие один псевдоним; или запись сущности Release, проводящая соединение на сокете, который Aggregate оставил несвязанным, под псевдонимом, уже использованным в Aggregate на другом сокете. Две соседние формы до этой остановки не доходят: один ключ, записанный дважды в одном блоке записей с ключами, приводит к ошибке загрузки документа, а запись сущности 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. (псевдоним соединения уже используется другим соединением того же компонента (<alias>, в компоненте <component>, это соединение подключено к сокету <socket>, с целью <target>, записано в <file>, по пути <key path>; соединение, уже занимающее псевдоним, подключено к сокету <socket>, с целью <target>, записано в <file>, по пути <key path>). Дайте одному из двух соединений собственный псевдоним: компонент читает каждое соединение по его псевдониму, к какому бы сокету оно ни было подключено. Элемент списка берёт имя своей цели в качестве псевдонима, поэтому цель, указанную дважды, следует указать один раз или записать как две записи с ключами под двумя псевдонимами.)

Если оба соединения записаны по одному пути ключей — список, дважды называющий одну цель, — каждое также называется по своему месту в этом списке, list entry "2" рядом с list entry "1", и только это различает две записи.

Находка привязывается к собственной записи более позднего соединения — проведённого вторым, то есть того, которое иначе заняло бы ячейку псевдонима, — в документе, где эта запись написана. Поэтому запись сущности Release или подключение, которое пишет Release, регистрируется как ошибка эксплуатации, а запись в Aggregate — как ошибка разработчика. Каждое ошибочное соединение сообщается отдельной находкой, поэтому одна сборка называет их все.

Некоторые формы называются менее точно. Имя подключения, объявленное более чем на одном уровне — скажем, на компоненте и на содержащей его подсистеме, — проводит соединение из каждого объявляющего блока, и сборка записывает оба только под именем подключения. Тогда оба соединения называются в одном из объявляющих блоков — в собственном блоке подключений компонента, если имя объявлено там, — и ни одно не несёт позиции в списке. То же верно и внутри импортированного Aggregate, где объявляющие блоки — блок компонента и блок одной из собственных подсистем модуля — называются в собственном документе модуля. Во всех этих формах пара всё равно отклоняется.

Как исправить: дайте одному из двух соединений собственный псевдоним. Для списка, дважды называющего одну цель, укажите цель один раз или запишите два соединения как записи с ключами под двумя псевдонимами. Для одного псевдонима на двух сокетах переименуйте один из двух ключей. Подключение, подключающее сокет под псевдонимом, который компонент уже использует, получает другой ключ в собственном блоке uses:.

uses: socket not declared in the owning entity’s usesSchema (Сокет uses не объявлен в usesSchema сущности-владельца)

Блок uses: называет сокет, который сущность, владеющая поверхностью, не объявляет в своей usesSchema, на одной из двух поверхностей, где можно называть только объявленный сокет: в uses: вложения Feature, где сокет должен быть объявлен на вложенной сущности Feature, и в uses: для отдельных рёбер сущности Release, где он должен быть объявлен на потребляющей сущности Component. Сущность Release может подключать или настраивать рёбра только в пределах сокетов, которые уже объявляет usesSchema сущности Component.

Поверхность подключений проверяется на каждом уровне, где записано подключение: на компоненте, на подсистеме — сущности 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, место, тип компонента, имя сокета и объявленные сокеты)

Ветвь для вложений называет тип фичи вместо типа компонента; вложенная сущность Feature, которая вовсе не объявляет usesSchema, вместо этого сообщает, что объявления uses: для неё не допускаются.

Как исправить: во вложении исправьте имя сокета на объявленное вложенной сущностью Feature или объявите этот сокет в usesSchema сущности Feature. В записи для отдельного ребра сущности Release исправьте имя сокета на объявленное потребляющей сущностью Component — сущность Release не может ввести сокет, который сущность Component не объявляет, и поддерживаемый путь — перенести объявление в сущность каталога. Если сущность каталога вовсе не объявляет usesSchema, она не принимает объявлений uses: на этой поверхности — удалите блок.

Соединение несёт вложение под именем, для которого его сокет не объявляет слота

Блок features: записи соединения называет вложение, которое не объявлено ни одним слотом сокета соединения. Вложения, которые несёт соединение, образуют замкнутое множество: сокет, через который подключено соединение, объявляет в featuresSchema в записи usesSchema потребляющей сущности Component каждый слот, который может заполнить соединение на нём, а вложение под любым другим именем отклоняется при загрузке сборки. Сокет без featuresSchema не допускает вложений на своих соединениях, как и сокет, который сущность Aggregate называет без объявления в сущности Component, — такой сокет не объявляет слотов.

Правило действует для обоих документов, где записываются вложения соединения: записи соединения сущности Aggregate в uses: компонента и записи uses: для отдельного ребра сущности Release. Для компонента, который вносит подагрегат, имена разработчика проверяются после чтения собственного документа подагрегата, и находка называет файл этого документа и запись компонента в нём. Имена сущности Release проверяются после выравнивания композиции для каждого компонента, для которого пишет Release, и находка называет собственную запись Release — внутри границы, в которой она находится, или под записью маршрутизации, ведущей к компоненту подагрегата. Запись Release на сокете, который сущность Component не объявляет, сообщается остановкой о необъявленном сокете выше, которая перечисляет существующие сокеты, а не этой.

Выводимое сообщение. Сначала идёт отказ, затем документ и запись, имя вложения, соединение, сокет, компонент и слоты, объявленные сокетом, — затем что с этим делать:

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. (соединение несёт вложение под именем, для которого его сокет не объявляет слота. Запишите вложение под одним из слотов, объявленных сокетом, или объявите этот слот в featuresSchema сокета на сущности Component.)

Если имя отличается на одну правку от слота, объявленного сокетом, — переставленный, пропущенный, удвоенный или неверный символ, как бывает при опечатке, — этот слот называется сразу после него, так что вероятное задуманное написание оказывается в том же предложении:

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>", …) (соединение несёт вложение под именем, для которого его сокет не объявляет слота)

Отдельного уведомления для такого имени не выдаётся. В собственном блоке 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.» (Сокет не объявляет слотов, поэтому ни одно подключённое через него соединение не несёт вложений: удалите вложение или объявите слот в featuresSchema сокета на Component.) Если сущность 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.» (Тип компонента не объявляет этот сокет, поэтому сокет не объявляет слотов и ни одно подключённое через него соединение не несёт вложений: удалите вложение или объявите сокет и его слот в usesSchema сущности Component.)

О каждом ошибочном вложении сообщается отдельной находкой, так что одна сборка называет их все.

Как исправить: запишите вложение под слотом, объявленным сокетом; или, если соединению нужен слот, которого у сокета нет, объявите его в featuresSchema сокета на сущности Component. Для сокета, который сущность Component не объявляет, объявите сокет и его слот в usesSchema сущности Component или удалите вложение.

Release retargets a developer-declared edge (Release перенаправляет ребро, объявленное разработчиком)

Запись uses: для отдельного ребра в Release указывает цель, отличную от той, которую разработчик уже подключил для того же сокета и псевдонима. Release может настраивать ребро, объявленное разработчиком (задавать для ребра infra, указывая ту же цель или опуская её), и может подключать ребро в объявленный, но не связанный сокет, но не может перенаправлять ребро, объявленное разработчиком: архитектура, которую создал разработчик, принадлежит ему.

Обе цели сравниваются в том виде, в каком они записаны, а не в том, во что они разрешаются. В target: может быть указан опубликованный псевдоним подагрегата, а не идентификатор компонента, и этот псевдоним разрешается в компонент, для которого модуль его публикует. Поэтому запись Release, повторяющая тот же псевдоним, что написал разработчик, является настройкой и принимается — точно так же, как повторение обычного идентификатора компонента.

Ребро сохраняет цель, заданную разработчиком, независимо от того, срабатывает ли эта остановка, и infra: из записи Release к нему не применяется. Отклонённое перенаправление никогда не применяется частично.

Выводимое сообщение. Сначала идёт отказ, затем цель, объявленная разработчиком, цель, указанная в 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 перенаправляет ребро, объявленное разработчиком (объявленная цель “<declared-target>”, цель, указанная в Release, “<release-target>”, подключено в сокет “<socket>”). Уберите цель из записи Release, чтобы настроить соединение так, как оно было объявлено, или измените цель там, где соединение объявлено.)

Результат проверки привязан к созданной автором записи, в которой объявлено соединение, в документе, который его объявил. О каждой ошибочной записи сообщается отдельно, поэтому одна сборка называет их все, а не по одной за запуск.

Как исправить: уберите отличающийся target из записи uses: в Release, чтобы настроить существующее ребро (только infra для ребра), или, если соединение действительно относится к другому сокету, подключите его через сокет, который разработчик оставил несвязанным. Чтобы изменить саму цель, измените её в Aggregate, где задаётся топология.

Release per-edge configuration has no edge to apply to (Конфигурации ребра в Release не к чему применяться)

Запись uses: для отдельного ребра в Release задаёт infra:, вложения в features: или и то и другое, но после построения всех рёбер сборки у указанных в ней потребителя, сокета и псевдонима ребра нет.

Запись Release может делать две вещи: подключать ребро и настраивать его, и что именно она делает, определяется тем, указан ли в ней target:. Запись с целью создаёт ребро, которое настраивает. Запись без цели настраивает ребро, которое уже должно существовать: объявленное разработчиком в Aggregate или добавленное подключённой Feature. Поэтому запись, в которой не указана цель и которая не совпадает ни с одним существующим ребром, ни к чему не применяется: блок infra: и вложения под ним не попадают ни в какой вывод. Сборка останавливается, а не принимает ничего не делающий код, потому что иначе успешная сборка воспринимается как подтверждение того, что инфраструктура применена и соединение несёт то, что на него поместила запись.

Псевдоним входит в то, что указывает запись, поэтому запись, настраивающая псевдоним, который разработчик никогда не объявлял, не достигает ни одного ребра, даже если сокет связан под другим псевдонимом. То же касается записи, указывающей компонент, который Aggregate не объявляет.

О двух смежных ситуациях сообщают собственные остановки, а не эта, потому что каждая может сообщить больше. Сокет, который usesSchema потребляющего Component не объявляет, сообщается как необъявленный сокет, и это сообщение может перечислить существующие сокеты. 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. (конфигурации per-edge в сущности Release не к чему применяться (Release <release-name>, в .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, “<consumer>”, на сокете “<socket>”, под псевдонимом “<alias>”). Укажите для записи target, чтобы подключить ребро, или удалите её: запись без target настраивает ребро, которое уже должно существовать.)

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 (конфигурации per-edge в сущности Release не к чему применяться: ребро release <consumer>/<socket>/<alias> задаёт <infra|features|infra and features> для <consumer>, который не является компонентом топологии)

Как исправить: добавьте в запись target:, который подключает ребро и применяет к нему конфигурацию; исправьте псевдоним на тот, что Aggregate объявил для этого соединения, чтобы запись настраивала существующее ребро; исправьте имя компонента на то, которое объявляет Aggregate; или удалите запись, если конфигурация больше не нужна.

A Release attachment takes the name of a connection’s attachment (Вложение в Release принимает имя вложения соединения)

Release записывает вложение под именем, которое принимает вложение на одном из соединений компонента: псевдоним соединения, точка и слот, который заполняет вложение, — gpt.credential для вложения, заполняющего слот credential на соединении gpt. Вложение соединения записывается в записи этого соединения — в соединении Aggregate под uses: компонента или в записи uses: для отдельного ребра в Release для того же соединения — и становится вложением потребляющего компонента под этим составным именем. Release записывает вложения ещё в двух областях, ключи которых могут содержать точку, поэтому составное имя можно записать и там:

  • Собственный блок features: записи компонента, который прикрепляет вложения к этому компоненту.
  • Собственный блок features: границы, который прикрепляет вложения к каждому компоненту, размещённому в этой границе или во вложенной в неё границе, — включая компоненты подагрегата, которые граница подключает, не называя их. Ключ в нём вызывает остановку, если он совпадает с составным именем на любом компоненте, которого он достигает, независимо от того, указан ли в нём type:.

Сборка останавливается, а не сливает любой из них с вложением соединения, потому что тогда ни один документ не показывал бы целиком, что сборка с ним делает. Слот сокета заполняется для каждого соединения отдельно, собственной записью соединения, и никогда — вложением, каскадно приходящим из более широкой области. Ключ с точкой, который не принимает ни одно вложение соединения достигаемых им компонентов, является обычным именем вложения и не отклоняется.

Проверка охватывает вложение, которое любой из документов поместил на соединение, а также как компонент, предоставленный подагрегатом, так и компонент, объявленный в 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.

Выводимое сообщение для ключа на границе. В нём названы блок вложений границы и компонент, соединение которого несёт вложение:

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.

Ключ на границе, достигающий нескольких компонентов, соединения которых несут составное имя, сообщается по одному разу для каждого из них, потому что каждое соединение — отдельная правка.

Находка привязывается к блоку, в котором записан ключ, — к записи компонента или к features: границы, — потому что сам ключ содержит точку, а позиция не может адресовать такой ключ; вместо этого ключ называется в сообщении. В Release, где названы границы, запись компонента выглядит как .spec.boundaries.<boundary>.components.<component>, компонент, названный внутри маршрутизирующей записи aggregates:, называется через эту запись, под локальным именем, которое он там носит, а блок вложенной границы выглядит как .spec.boundaries.<outer>.boundaries.<inner>.features.

Как исправить: перенесите вложение в запись Release для этого соединения — uses.<socket>.<alias>.features.<slot> в компоненте, — записав там только infra:, чтобы задать размер вложению, объявленному в Aggregate, или type: и infra: для вложения, которое создаёт только Release; затем удалите ключ с точкой из features: компонента или границы. Ключ уровня границы, предназначенный для соединений нескольких компонентов, записывается по одному разу в каждом из этих соединений.

A Release connection attachment names no Feature type (Вложение соединения в Release не указывает тип Feature)

Позиционная запись uses: в Release помещает вложение на соединение в слот, для которого Aggregate не объявляет вложения на этом соединении, и не указывает type:. Вложение, которое Release записывает на соединение, — это одно из двух. Либо оно задаёт размер вложению, которое Aggregate уже объявляет на том же соединении, и не указывает тип, потому что его указывает объявление в Aggregate; либо это вложение, которое создаёт только Release, и тогда запись Release — единственное место, откуда может взяться его тип Feature. Без типа ничто не может выбрать FeatureRecipe для вложения.

Проверка охватывает как компонент, предоставленный подагрегатом, так и компонент, объявленный в 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.

О каждом ошибочном вложении сообщается отдельной находкой, так что одна сборка называет их все.

Как исправить: добавьте type:, указывающий Feature, которую прикрепляет вложение; или, если вложение должен объявлять разработчик, объявите его в записи соединения 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>") (идентичность компонента не может быть именем, которым помечаются генерируемые им ресурсы: переименуйте компонент (Aggregate, в <field-path>, <identity>, который должен <rule>))

и для идентичности, начинающейся так же, как составная, где <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>") (идентичность компонента не может быть именем, которым помечаются генерируемые им ресурсы: переименуйте компонент (Aggregate, в <field-path>, <identity>, который не должен начинаться с зарезервированного <opening>))

Как исправить: переименуйте компонент везде, где он упоминается: в сущности Aggregate, которая его объявляет, и в сущности Release, которая его размещает и настраивает. Дайте ему имя, которое начинается и заканчивается буквой или цифрой и не начинается ни с bfr--, ни с cfr--. Переименование компонента меняет имя, которое его ресурсы несут в кластере, поэтому для уже развёрнутого приложения относитесь к нему как к любому другому переименованию ресурса.

The target will not accept a name derived from an authored identity (Целевая платформа не принимает имя, производное от заданного автором идентификатора)

Каждая целевая платформа выводит собственные имена из идентификатора компонента: установщик чартов выводит имя релиза, оркестратор контейнеров — имена сервисов. Эта остановка означает, что целевая платформа не может использовать одно из них.

Aggrega не хранит правил именования ни одной целевой платформы. Компилятор не знает, какой длины может быть имя, какие символы допускает платформа и что её грамматика требует в начале имени, — и не знает этого намеренно, потому что всё это различается в зависимости от платформы, от вида ресурса, которому достаётся имя, а иногда и от отдельного сервиса внутри одного провайдера. Поэтому, прежде чем имя будет закреплено, компилятор спрашивает провайдера, который будет отрисовывать компонент, и эта остановка сообщает ответ провайдера. Именно поэтому сообщение содержит собственное название платформы для того, что было отклонено (release name, Service name), и собственную причину платформы, а не правило, встроенное в компилятор.

Почему имя отклоняется, а не сокращается. Написанное вами имя — это имя развёрнутой рабочей нагрузки: его сокращение переименовало бы каждый ресурс в каждом существующем выводе, причём сделало бы это за вас, без вашей просьбы. Выбрать другое имя может тот, кто написал это, поэтому остановка указывает на написанный вами ключ spec.components и оставляет имя без изменений. Имена, которые составляет сама Aggrega, — например, идентификатор сущности Feature, подключённой к целой границе, — вместо этого сокращаются, потому что они собираются из частей, написанных в нескольких документах, и ни один автор не видит, какой длины они достигают.

Целевая платформа может дать два ответа, и они ведут в разные стороны. Если было бы принято более короткое имя, остановка указывает подходящую длину, чтобы новое имя выбиралось один раз, а не дважды. Если никакая длина не поможет — символ, который грамматика платформы не допускает в той позиции, где он оказался, — длина не указывается, потому что сокращение этого не исправит. Самый частый случай второго рода: платформа, имена которой допускают только строчные буквы, экранирует каждый недопустимый символ, а каждое экранирование начинается с дефиса, поэтому имя, первый символ которого экранирован, превращается в имя, начинающееся с дефиса. Платформа, требующая в этой позиции строчную букву или цифру, отклоняет его, какой бы короткой ни была остальная часть. Платформа также может применять к началу имени более строгое правило ресурсов, названных по нему: целевая платформа helm отклоняет имя, начинающееся с цифры, сообщая о нём как о Service name, потому что Helm принимает такое имя релиза, а кластер отклоняет названный по нему Service в Kubernetes.

Третья форма возникает только для составного имени: платформа может указать длину меньше, чем самый короткий идентификатор, который компилятор способен составить из полученных частей, поскольку составной идентификатор резервирует место для различителя. Остановка сообщает об этом и называет способ исправления — сократить заданные автором части, — а не объявляет провайдера неисправным.

Некоторые имена существуют только для рабочей нагрузки, которую рендерит компонент. Провайдера спрашивают, как только разрешена сущность Workload этого компонента, и вопрос содержит form этой сущности Workload и её ключи Service, поэтому целевая платформа может оценить и имена, которые она из них строит. Для целевой платформы helm это добавляет два имени: CronJob name — не более 52 символов, оценивается только для сущности Workload формы scheduled, потому что кластер называет 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 (целевая платформа не примет имя, производное от заданной автором идентичности этого компонента: переименуйте компонент (компонент <identity>, записанный в <field-path>, который целевая платформа не может использовать как <name-kind>, <the target's reason>). выберите имя длиной не более <n> символов, которое примет целевая платформа)

Как исправить: переименуйте компонент так, чтобы платформа приняла имя, во всех местах, где он упоминается, — в сущности Aggregate, которая его объявляет, и в сущности Release, которая его размещает и настраивает. Если в сообщении указана длина, не превышайте её. Если нет, прочитайте причину платформы: обычно это недопустимый символ, чаще всего заглавная буква в начале имени, а для целевой платформы helm — цифра там же. Предпочитайте строчные буквы и цифры с дефисами между словами; глава об именовании объясняет, чем оборачивается имя для каждого вида целевой платформы. Если причина называет ключ Service, длину можно также высвободить, сократив этот ключ там, где его объявляет рабочая нагрузка, — а если причина говорит, что ключ не оставляет места, поможет только это. Переименование компонента меняет имя, которое носят его ресурсы, поэтому для уже развёрнутого приложения относитесь к нему как к любому другому переименованию ресурса.

Если идентификатор составлен компилятором, а не написан вами, та же остановка сообщает составленное значение и просит сократить части, из которых оно построено, — имя, под которым вы подключили сущность Feature, и путь границы, к которой вы её подключили.

A provider never accepted a name the compiler composed (Провайдер так и не принял имя, составленное компилятором)

Эта остановка сообщает о дефекте в плагине, а не в том, что написали вы.

Закрепление составного имени — это обмен: компилятор предлагает идентификатор, провайдер либо принимает его, либо сообщает, насколько коротким он должен быть, компилятор составляет более короткий, и провайдера спрашивают снова. Повторный отказ нормален и ожидаем: сокращение до заданной длины может поставить символ туда, где грамматика платформы его не допускает, и сообщение провайдера об этом — способ, которым компилятор, не знающий грамматики ни одной платформы, и провайдер, который её знает, приходят к согласию.

Ненормален провайдер, который не принимает ничего: указывает длину, получает имя такой длины и снова его отклоняет. Обмен ограничен, и по достижении предела сборка останавливается и называет провайдера, а не использует имя, на которое провайдер так и не согласился. Имя, закреплённое после отказа от попыток, было бы проставлено на реальных ресурсах без какой-либо записи в выводе о том, что согласие не достигнуто, и последствия проявились бы при применении, а не в сборке, которая их породила.

Выводимое сообщение:

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>, отклонено предложений: <n>, последнее из них — <identity>). сообщите о дефекте тому, кто сопровождает этот плагин провайдера)

Как исправить: сообщите о проблеме тому, кто сопровождает указанный плагин провайдера, приведя последнее предложение из сообщения. Никакое изменение в авторских файлах не обходит её: компилятор уже предложил каждую длину, которую запрашивал провайдер. Если провайдер сопровождаете вы, проверьте, что имя, обрезанное до указанного им предела, затем им принимается.

Обязательный сокет uses: не заполнен

Сущность Component объявляет в своей usesSchema сокет с пометкой required: true, и ничто в сборке не подключает соединение к этому сокету для одного из экземпляров этой сущности Component.

Подключить его могут три источника, и остановка срабатывает, только когда все три пусты. Собственный блок uses: экземпляра в сущности Aggregate; запись uses: для отдельного ребра в сущности Release, указывающая target:, которая создаёт соединение с объявленным, но не привязанным сокетом; и набор соединений, созданный композицией, — именно он отвечает за компонент, внесённый импортированной сущностью Aggregate: блок uses: такого компонента находится в собственном документе этой сущности Aggregate и читается только после сборки композиции. Поскольку третий источник становится полным последним, проверка выполняется, когда вся композиция уже существует, а не во время чтения двух авторских документов, и она задаёт один и тот же вопрос каждому компоненту, в каком бы документе он ни был объявлен.

Две формы, которые, казалось бы, должны заполнять сокет, этого не делают. Запись в Release без target: настраивает соединение, которое уже должно существовать, а не создаёт его, поэтому ничего не подключает (а если она содержит infra:, о ней сообщает собственная остановка выше). А uses: в подключении Feature называет сокеты, объявленные в подключённой сущности 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>. Имя экземпляра в ней — это имя, которое компонент носит в объявляющем его документе, поэтому для компонента, внесённого импортированной сущностью Aggregate, локатор называет ключ из собственного файла этой сущности Aggregate, а не имя с префиксом, данное ему композицией.

Сообщается о каждом незаполненном обязательном сокете на каждом компоненте: одна сборка сообщает обо всех, а не только о первом.

Как исправить: добавьте запись uses: для обязательного сокета, подключив его к цели, которую принимает selector: сокета; или подключите его из Release записью, указывающей target:. Если сокет больше не должен быть обязательным, измените usesSchema сущности Component, установив required: false, или удалите объявление required.

Превышена глубина вложенности подагрегатов

Цепочка импортов подагрегатов превышает максимальную глубину вложенности компилятора. Ограничение предотвращает неконтролируемое разворачивание глубоко вложенных топологий и вынуждает к архитектурной декомпозиции выше определённого порога.

Выводимое сообщение:

max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>. (превышена максимальная глубина вложенности подагрегатов: глубина <depth> на префиксе <flattened-prefix>.)

Как исправить: перестройте топологию агрегатов, уменьшив вложенность. Столь глубокая вложенность обычно означает, что форма сущности Aggregate повторяет организационную иерархию, а не топологию развёртывания, — рассмотрите возможность развернуть группы подагрегатов в равноправные подсистемы внутри одной родительской сущности Aggregate.

Несовпадение типа Feature между Aggregate и Release

И сущность Aggregate, и сущность Release присоединяют feature с одним и тем же именем экземпляра, но каждая объявляет свой type:, и присоединение из Release доходит до компонента из features: границы. Если же Release записывает его в собственной записи для компонента, тот же конфликт отклоняется раньше и сообщается как E0153 в разделе «A feature attached by both the Aggregate and the Release cannot be merged (Feature, присоединённую и в Aggregate, и в Release, невозможно объединить)» выше.

Выводимое сообщение:

feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>) (несовпадение типа feature между Aggregate и Release (узел <node-id>, подключение <instance-name>, существующий тип <type-in-aggregate> конфликтует с <type-in-release>))

Как исправить: либо уберите type: из Release (тип будет унаследован из Aggregate), либо измените одну из сторон, чтобы обе объявляли один и тот же тип. Сущности Release разрешено опустить type: или повторить тип из Aggregate, но заменить его другим она не может.

Циклический extends в Components или Features

Цепочка extends: сущности Component или цепочка extends: сущности Feature замыкается сама на себя.

Выводимое сообщение; если замыкается цепочка 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:.

Компонент композиции не размещён ни в одной границе

Release размещает компонент в границе двумя способами, и засчитывается любой из них. Она называет компонент в components границы, обращаясь к нему по id, который компонент носит после разворачивания всей композиции. Или она направляет модуль, вносящий компонент, в границу через aggregates, что сразу размещает все компоненты этого модуля.

Компонент, не попавший ни под один из способов, отрисовывается вне всех границ, объявленных в Release. Его выходной каталог, sync wave, аннотации и infra для отдельного компонента тогда берутся ниоткуда — а сборка иначе завершилась бы успешно, выдала бы артефакты и ничего не сообщила бы о том, что конфигурация оператора к нему так и не применилась. Два компонента, разделённые этой чертой, к тому же отрисовываются в разные выходные данные и теряют порядок, который у них был бы при совместном размещении.

Две формы намеренно под это не подпадают. Release, объявляющая components верхнего уровня вместо именованных границ, размещает всё, что называет: нормализация такой Release даёт ей собственную границу ровно с этими компонентами. А о компоненте, весь модуль которого Release нигде не разместила, сообщается один раз — для модуля, в записи ниже (одна ошибка, одно исправление, один ключ для правки), а не по разу на каждый компонент, собственное объявление которого корректно.

Выводимое сообщение. Значение в конце — id, который компонент носит после разворачивания композиции; для компонента, внесённого модулем, это имя модуля, точка и собственное имя компонента:

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; далее указываются Release, ключ в исходном документе и id компонента)

Как исправить: назовите компонент в components границы, используя ровно тот id, что приводит сообщение, — для компонента, внесённого модулем, это id с префиксом, а не имя, записанное в собственном файле модуля. Или, если весь модуль относится к одной границе, направьте его туда через aggregates, и все его компоненты будут размещены сразу.

Компоненты подмодуля не размещены ни в одной границе

Форма предыдущего правила на уровне модуля: модуль, подключённый композицией, внёс компоненты, и ни одна граница не содержит ни одного из них. Об этом сообщается один раз для модуля, а не для каждого компонента, поскольку модуль, нигде не размещённый, — это одна ошибка автора с одним способом исправления в одном ключе, а сообщение по каждому компоненту называло бы компоненты, собственные объявления которых совершенно корректны.

Правило проверяет размещение, а не форму записи, поэтому модуль, каждый компонент которого назван по отдельности в components границы, считается размещённым и проходит проверку: отклонить его из-за отсутствия записи маршрутизации значило бы отвергнуть форму записи, которую язык допускает. Модуль, размещённый лишь частично, тоже проходит — какие из его компонентов имеют собственные записи, решает правило для компонентов, и все пропущенные сообщаются там, каждый в своём ключе.

Модуль, не внёсший ни одного компонента, под это правило не подпадает: размещать нечего. Не подпадает и модуль, удалённый переключателем active: со значением false, — он вообще не входил в композицию.

Выводимое сообщение, привязанное к записи 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 для модуля в границу, к которой он относится, — это разместит все внесённые им компоненты. Либо, если его компоненты относятся к разным границам, назовите каждый из них в соответствующей границе, используя префиксные идентификаторы, которые они получают после разворачивания.

Граница называет компонент, которого нет в композиции

Обратная сторона двух предыдущих правил — избыточное именование, и это отдельный вопрос, а не ветвь одного из них: те спрашивают о компоненте, разместило ли его что-нибудь, а это правило спрашивает о записи, сделанной в Release, соответствует ли ей что-нибудь. Одно не следует из другого. Release может назвать несуществующий компонент, хотя все существующие компоненты размещены правильно, и может оставить реальный компонент неразмещённым, хотя все его записи разрешаются.

Запись, которая ничего не называет, ничего и не настраивает: её directory, subDirectory, syncWave, аннотации и покомпонентный infra написаны для отсутствующего компонента, поэтому под ними ничего не отрисовывается, и иначе сборка завершилась бы успешно, а конфигурация оператора молча не действовала бы.

Граница называет компонент двумя способами, и проверяются оба. В components запись адресует компонент по идентификатору, который он получает после разворачивания композиции, — поэтому компонент, внесённый модулем, записывается с префиксом этого модуля перед собственным именем. Внутри записи маршрутизации aggregates запись адресует компонент по локальному имени внутри этого модуля, которое разрешается в тот же идентификатор. Сообщение приводит идентификатор, который запись адресовала, и на маршрутизируемой оси это не то имя, что написано в файле: файл содержит локальную половину, а остальное дополняет модуль.

Подсистема ничего не добавляет к идентификатору компонента, поэтому компонент, объявленный внутри подсистемы, адресуется по своему простому имени. Запись, написанная так, будто подсистема входит в идентификатор, ничего не адресует и вызывает эту остановку.

Компонент, отключённый переключателем active: со значением false, под это правило не подпадает. Отключение компонента — действие автора, и не предполагается, что 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>") (граница называет компонент, которого нет в композиции: исправьте имя или удалите запись)

Как исправить: сравните идентификатор из сообщения с компонентами, которые действительно есть в композиции. Две частые причины — отсутствующий префикс модуля и имя подсистемы, вписанное в идентификатор; уберите подсистему, добавьте префикс модуля или исправьте написание. Если запись осталась от компонента, который с тех пор удалён или переименован, удалите её.

Ребро uses указывает на компонент, удалённый переключателем active:

Родственная остановка для висячей цели, описанной выше; о ней сообщается отдельно, чтобы автор узнал, почему цель отсутствует. Цели нет не потому, что она не была объявлена, — она объявлена, но намеренно удалена из этой сборки, так как её переключатель 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: компонента, к блоку присоединения и к соединению, подключённому сущностью 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.primary_db, а не finance-db-subsystem.internal-pg-primary, — или, если модуль пишете вы и хотите опубликовать компонент, перечислите его в 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 или задайте ему default: там, где он объявлен в Aggregate, чтобы у каждого окружения был ответ. Чтобы сущность присутствовала безусловно, удалите ключ active:, а не оставляйте его пустым.

Модуль, импортируемый композицией, не удаётся загрузить, или он импортирует сам себя

Сущность Aggregate включает в свою композицию другие Aggregates, перечисляя их в aggregates:, и каждая из них по очереди загружается и обходится, чтобы её компоненты вошли в граф. Здесь этот обход останавливают две ситуации.

Модуль вообще не удаётся загрузить: ссылка не разрешается ни во что, что может вернуть каталог, или документ за ней не удаётся прочитать. Причина, указанная загрузчиком, передаётся под остановкой, а не встраивается в неё, поэтому то, что не удалось, сообщается словами самого загрузчика.

Либо модуль называет тип, который уже находится в обходимой цепочке. Его развёртывание воспроизвело бы содержащую его цепочку без конца. Об этом сообщается в той точке, где ссылка замыкает цикл, с указанием и типа, и его места в композиции.

Выводимое сообщение для циклической ссылки:

sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>") (не удалось загрузить вложенный агрегат: циклическая ссылка на вложенный агрегат)

и для ошибки загрузки, когда остановка состоит из одного предложения, привязана к пути модуля, а под ней приводится причина от загрузчика:

sub-aggregate load failed (не удалось загрузить вложенный агрегат)

Как исправить: при ошибке загрузки прочитайте причину под остановкой: обычно это имя или версия, на которые каталог не может ответить, и исправление вносится в запись 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>") (коллизия идентификаторов узлов после развёртывания: переименуйте один из конфликтующих экземпляров, чтобы их идентификаторы после развёртывания различались)

Как исправить: переименуйте один из двух экземпляров, названных в сообщении, в документе, который его объявляет, и в каждой записи Release, которая к нему обращается.

Две подсистемы объявляют компонент под одним именем

Подсистемы группируют компоненты сущности Aggregate для читателя и для того, что на них каскадируется; они не уточняют имя, по которому обращаются к компоненту. К компоненту, объявленному в subsystems.frontend, обращаются как к api, а не frontend.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) (агрегат дошёл до топологии ненормализованным (непустые корневые компоненты наряду с синтезированной подсистемой по умолчанию))

и продолжается путём построения, который ожидает компилятор; это заметка для того, кто отлаживает сборку, а не инструкция по авторингу.

Как исправить: ничто в ваших файлах её не вызывает, и никакое изменение в авторинге её не устранит. Сообщите о ней, указав выполненную команду.

Патч плагина преобразования меток выходит за пределы меток узлов

Плагин управления, подключённый в роли преобразования меток, получает проекцию графа — одну запись на узел, несущую метки этого узла и значения, которые объявляет его экземпляр, причём любое значение, которое его Component объявляет чувствительным, скрыто, — и возвращает патчи к меткам узлов. Хост применяет их только к меткам, а затем проверяет, что полученный результат — всё то же представление меток: те же узлы, каждый несёт только метки, и каждое значение метки — строка.

Всё остальное отклоняется, и сборка останавливается. Добавление или удаление узла либо изменение поля узла, отличного от его меток, — это именно незаметное появление инфраструктуры, которую никто не объявлял, поэтому, вместо того чтобы принять изменение, не охватываемое ролью, сборка сообщает, какое правило ограничения нарушил патч. Метки — это вся область действия роли, и оператор, подключивший плагин, объявил именно это и не более.

Выводимые сообщения. Патч был отклонён до применения:

mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (патч мутатора отклонён: патч <n> не декодируется как документ JSON Patch: <what the reader could not do>) mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (патч мутатора отклонён: патч <n> не применяется к области меток узлов: <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) (патч мутатора отклонён: в изменённом множестве узлов появился узел "<node>" (мутатор не может добавлять узлы)) mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (патч мутатора отклонён: узел "<node>" получил поле вне “labels” (мутатор может изменять только метки)) mutator patch rejected: node "<node>" lost its "labels" field (патч мутатора отклонён: узел "<node>" потерял поле “labels”) mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (патч мутатора отклонён: после применения патча узел "<node>" содержит нестроковое значение метки: <what the reader found>)

Как исправить: ошибка в плагине, а не в ваших документах. Исправьте его так, чтобы каждая возвращаемая им операция обращалась к записи в labels какого-либо узла и задавала только строковые значения; чаще всего проблема в числовом или логическом значении метки, поскольку область принимает только строки. Удаление подключения из plugins.governance — самый быстрый способ разблокировать сборку, пока плагин исправляется.

Намеренное упущение: топология не обязана быть ацикличной

Aggrega допускает циклы в топологии: граф зависимостей не обязан быть направленным ациклическим графом. Архитектуры «агент — агент», шаблоны обратных вызовов и пары взаимной аутентификации создают циклические рёбра, и компилятор их принимает. Порядок при развёртывании — забота рендерера (через syncWave для каждой границы или эквивалент), а не графа IR.

При проверке контрактов inject

Компилятор обходит каждый блок inject: — как self-inject (Component, внедряющий значения в самого себя), так и uses-inject (связывание между сущностями Component) — и проверяет контракт доставки по схеме provides: целевой сущности Component, по разбиению меток сущности Feature и по набору объявленных ключей доставки. Ключ from: в блоке, который написал собственный компонент сущности Aggregate, проверяется сразу после разрешения каталога, поэтому ошибка указывает на написанную вами строку; такой ключ в блоке компонента, который добавляет модуль, проверяется после сборки композиции, импортирующей модуль, и ошибка указывает на строку в собственном документе модуля; ключ from: в соединении, которое добавляет присоединённая сущность Feature, проверяется после того, как свой вклад внесли все поверхности, способные создавать соединения, — это самый ранний момент, когда такое соединение существует и его можно проверить.

Ключ inject from отсутствует в provides цели

Запись inject: ссылается на ключ from:, который не публикует источник, из которого она читает: схема provides: целевой сущности Component — для собственного блока компонента или соединения, и сущность FeatureRecipe присоединённой сущности Feature — для собственного блока inject: присоединённой сущности Feature.

Проверка применяется независимо от того, где написано соединение. Соединение uses: попадает в построенную топологию с нескольких поверхностей описания — из собственного блока uses: сущности Component и из блока uses: присоединённой к ней сущности Feature, где бы ни было записано это присоединение: на компоненте, на подсистеме, на границе сущности Release или в записи компонента внутри границы Release, — и один и тот же ключ с опечаткой отклоняется на каждой из них. Диагностика указывает на блок, автор которого его написал: на собственную запись uses: присоединения, в месте, где объявлено само присоединение, а не на блок uses: потребляющего компонента, который для добавленного соединения вообще ничего не содержит.

То, относительно чего разрешается ссылка, зависит от того, где она находится. Ключ from: в self-inject на уровне Component разрешается относительно собственного provides: той же сущности Component. Ключ from: в соединении uses: разрешается относительно provides: компонента, на который указывает это соединение, — а если две поверхности записывают один сокет и один псевдоним, каждое соединение разрешается относительно цели, которую называет оно само, в той же сборке, которая отклоняет эту пару из-за общего псевдонима. Сущность Component, не объявляющая provides:, отклоняет каждую направленную на неё ссылку from:.

Собственный блок inject: присоединённой сущности Feature. Указанный там from: разрешается относительно ключей, которые сущность FeatureRecipe этой сущности Feature публикует в своём provides:, в том виде, в каком они вычислены для компонента, к которому присоединена сущность Feature, и проверяется при рендеринге этого компонента. Ключ, который сущность FeatureRecipe не публикует, ничего не поместил бы в окружение, файл или аргумент компонента, поэтому вместо этого сборка останавливается — если только сущность FeatureRecipe сама не читает записи присоединённой сущности Feature, в .inject, в шаблоне, который она вычисляет относительно собственного контекста рендеринга присоединённой сущности Feature — того, что содержит .inject: то есть в её сопоставлении значений, рабочей нагрузке, артефактах, пропусках или в with: либо when: шага конвейера, написанных встроенно или импортированных. Её locals:, provides:, source: и assertions: не содержат .inject, а её injectMapping: вычисляется относительно контекста компонента, поэтому чтение в любом из них не засчитывается. Такая сущность FeatureRecipe получает каждую запись в написанном виде и доставляет её по-своему, поэтому её записи не отклоняются, а ключ, который она не публикует, ничего не доставляет через собственную доставку компонента и остаётся в распоряжении сущности FeatureRecipe. Читает ли сущность FeatureRecipe .inject, определяется по путям, которые называют её шаблоны: шаблон, передающий дальше весь свой контекст (toJson .) или добирающийся до записей через функцию вроде index . "inject", не считается читающим их, и её записи, называющие неопубликованный ключ, отклоняются. Сущность Feature, присоединённая на границе, чья сущность FeatureRecipe рендерится один раз для этой границы, проверяется относительно этого одного вычисления; там, где ни одна граница, содержащая компонент, такого вычисления не произвела, проверять её ключи не относительно чего, и они не отклоняются. from:, называющий опубликованный ключ, доставляет как прежде. Находка размещается на собственной записи присоединённой сущности Feature, в документе, который её написал, — например, .spec.components.<component>.features.<attachment> в сущности Aggregate, — а запись, ключ доставки которой уже также удерживает другой источник inject, сообщается также в разделе «An attachment delivers a key another inject source already claimed (Присоединение доставляет ключ, который уже занял другой источник inject)», поскольку каждая требует собственного исправления.

В собственном блоке inject: компонента запись value: содержит литерал и ни относительно чего не разрешается, поэтому литерал, который случайно выглядит как ключ provides, там не отклоняется; на соединении запись value: отклоняется, как описано ниже в разделе «An inject: entry on a connection carries a literal (Запись inject на соединении содержит литерал)». Ключ называет только from:.

Собственная поверхность uses: для отдельных рёбер в сущности Release содержит target и infra, но не inject:, поэтому соединение, связанное там, не задаёт доставку и не имеет ключа from: для проверки.

Выводимое сообщение для from:, прочитанного в собственном блоке inject: сущности 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-key должен называть ключ provides, который публикует его источник)

Для from:, прочитанного в соединении uses:, сообщение начинается с того же отказа, а механизм и ключ доставки, под которыми написана запись, идут перед ошибочным ключом:

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-key должен называть ключ provides, который публикует его источник)

Для from:, прочитанного в собственном блоке inject: присоединённой сущности Feature, первым идёт ошибочный ключ, затем 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-key должен называть ключ provides, который публикует его источник)

Если цель вообще не объявляет ключей provides:, перечислять варианты нечего, поэтому сообщение заканчивается после типа компонента — или, в блоке присоединённой сущности Feature, после сущности FeatureRecipe.

Как исправить: либо измените ключ from: так, чтобы он совпадал с одним из объявленных ключей, перечисленных в сообщении, либо расширьте схему provides: целевой сущности Component, объявив нужный ключ. В блоке присоединённой сущности Feature измените ключ from: на ключ, который публикует сущность FeatureRecipe, или — если сущность FeatureRecipe ваша — опубликуйте ключ в её provides:, или сделайте так, чтобы она сама читала запись в .inject, если доставляет значение по-своему.

Required feature not attached (Обязательная функция не присоединена)

Сущность Component объявляет требование присутствия — аннотацию features.aggrega.ai/requiredType.<label>, — называющее тип Feature, которого нет среди присоединений, оказавшихся в итоге у этого экземпляра компонента, с учётом всех областей: блоков уровня компонента и уровня подсистемы в сущности Aggregate, блоков уровня границы и уровня компонента в сущности Release, а также расширения по аннотациям.

Выводимое сообщение:

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 требуемого типа (<required-type>, требуется типом компонента <component-type>, под меткой требования <label>))

Три значения — это тип Feature, которого требует мандат (его уже называет предложение выше, поэтому он стоит без подписи), затем тип компонента, объявляющий требование, и метка требования; каждое подписано, чтобы читатель мог различить две ссылки на сущности. Компонент, требующий два разных типа, выдаёт два различающихся сообщения, а двум компонентам, объявляющим требование из разных типов, сообщается, какой тип предъявил каждое требование. Отчёт привязан к собственному ключу компонента в components:, а для компонента, записанного внутри подсистемы, — сначала к ключу этой подсистемы.

Имя, под которым записано присоединение, здесь не имеет значения: требование проверяет лишь, присутствует ли вообще присоединение названного типа. Его удовлетворяет привязка слота, как и присоединение под любым другим именем.

Как исправить: присоедините Feature требуемого типа к компоненту в Aggregate или в Release либо в более широкой области, от которой компонент наследует. Если сущность Component больше не должна этого требовать, удалите аннотацию требования из её объявления в каталоге.

Malformed attachment requirement (Некорректное требование присоединения)

Объявление требования присутствия невозможно вычислить. Значение аннотации — непрозрачная строка, поэтому до чтения компилятором её форму ничто не проверяет: значение, не являющееся URI типа Feature, или ключ, называющий семейство требований без метки после префикса, сообщается как повреждённое объявление, а не как неудовлетворённое требование — опечатка никогда не должна читаться как удовлетворённое требование.

Выдаваемые сообщения:

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. (некорректное требование к вложению (ключ, объявленный типом компонента, невозможно вычислить, так как значение должно быть URI типа Feature вида «издатель/имя» из сегментов kebab-case в нижнем регистре, например core/prometheus-exporter). Исправьте эту аннотацию в сущности каталога для типа компонента.)

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. (некорректное требование присоединения (<key>, объявлено типом компонента <component-type>; его невозможно вычислить, поскольку ключу нужна метка, называющая требование, например features.aggrega.ai/requiredType.database). Исправьте эту аннотацию в сущности каталога типа компонента.)

Сообщение начинается с ключа аннотации — объявления, к которому относится остановка, — а после него называет тип компонента, чьё объявление повреждено, поэтому оно указывает сущность для исправления, хотя отчёт привязан к экземпляру компонента, использующему этот тип: экземпляр — это место, где вы видите ошибку, а сущность каталога — место, где её устраняют.

Эта остановка возникает сразу после сборки композиции, то есть раньше всех проверок, читающих готовый граф. Поэтому сборка с повреждённым требованием сообщает только о нём: более поздние проверки не выполняются, поскольку они рассуждают о том, что говорит объявление, а объявление невозможно прочитать. Исправьте его и пересоберите, чтобы увидеть остальное.

Как исправить: исправьте сущность каталога Component. Исправление вносится в каталог, а не в Aggregate — именно поэтому эта остановка отличается от «Required feature not attached (Обязательная функция не присоединена)», где изменить нужно ваши собственные документы.

Required attachment slot not bound (Обязательный слот присоединения не привязан)

Сущность каталога объявляет слот присоединения с required: true в своей featuresSchema, и ничто не привязывает имя этого слота на экземпляре сущности. Проверка выполняется по присоединениям, которые остаются у экземпляра после свёртки всех областей: блоков features: уровня компонента и уровня подсистемы в Aggregate, блоков уровня границы и уровня компонента в 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. (обязательный слот присоединения не заполнен (<slot>, объявлен обязательным типом компонента <component-type>). Присоедините Feature под этим именем в Aggregate или в Release, на компоненте или в области над ним.)

Два значения — это собственное имя слота и тип компонента, который его объявляет, поэтому экземпляр, оставивший незаполненными два слота, выдаёт два различающихся сообщения. Сообщение привязано к ключу слота в блоке features: компонента в Aggregate; поскольку именно этот ключ и отсутствует, редактор помещает его на ближайший существующий ключ — блок features:, если компонент его записывает, и сам компонент, если нет. Отсутствующее вложение никто не писал, поэтому ни один автор документа им не выделяется: сообщение остаётся на компоненте и регистрируется как ошибка разработчика, а способ исправления называет оба документа, поскольку слот может заполнить любой из них — Aggregate на компоненте или содержащей его подсистеме, Release в своей записи для компонента или на содержащей его границе.

Слот, объявленный сокетом — в featuresSchema записи usesSchema, — требуется от каждого соединения, проведённого через сокет, а не от компонента: каждое соединение заполняет его само, на собственной записи в 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. (обязательный слот вложения не заполнен: слот объявлен обязательным сокетом типа компонента и оставлен незаполненным соединением. Прикрепите Feature под этим слотом в features этого соединения, в его записи в Aggregate или в Release.)

Это сообщение привязано к записи соединения в документе, который провёл соединение: к записи uses: в Aggregate или к записи Release для отдельного ребра, если соединение провёл Release. Соединение, которое проводит присоединённая Feature, подключается к сокету, объявленному этой Feature, а не к сокету компонента, поэтому заполнять слоты сокетов компонента — не его задача.

Как исправить: присоедините Feature под именем слота в Aggregate или в Release — на компоненте или в более широкой области, общей для всех потребителей слота; для слота сокета — на соединении, названном в сообщении. Присоединение под другим именем не привязывает слот: слот — это именованная точка привязки, поэтому привязкой служит имя. Если слот больше не должен быть обязательным, измените featuresSchema сущности каталога — собственную схему компонента или схему сокета, — удалив объявление required.

Two Features declared to conflict reach one component (Две Features, объявленные конфликтующими, достигают одного компонента)

interoperability.conflictsWith сущности Feature называет Features, вместе с которыми её нельзя присоединить, а один компонент в итоге несёт эту Feature и одну из названных. Проверка выполняется по присоединениям, которые остаются у компонента после свёртки всех областей: блоков features: уровня компонента и уровня подсистемы в Aggregate, блоков уровня границы в Release (каждой границы, внутри которой находится компонент, включая вложенные) и записей уровня компонента, а также присоединений, созданных раскрытием по аннотациям. Поэтому пара вызывает остановку, если обе написаны на компоненте, если одна находится на содержащей его границе или подсистеме или если одна находится на внешней границе, а другая — на вложенной в неё. Две Features, присоединённые к соседним границам без общих компонентов, никогда не встречаются, а граница без компонентов ни до чего не доходит, поэтому ни то, ни другое не вызывает остановку.

Достаточно одного объявления: остановка срабатывает, если список любой из Features называет другую. Имена сравниваются без версии с обеих сторон, поэтому запись соответствует любой версии названной 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, с которым он объявляет конфликт: первый прикреплён в Release на границе, второй — в Aggregate на компоненте. Прикрепите только один из двух там, где они встречаются: удалите одно вложение или перенесите его в область, которая не содержит этот компонент.)

Первое значение — это 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, на компоненте, который вносит импортированный модуль, или в более широкой области. Прикрепление под именем, которое не объявляет ни один слот, является свободным прикреплением и не несёт ограничений слота.

Выводимое сообщение, когда присоединение диктует доставку, которую его слот не принимает, — сначала слот, затем механизм, затем каждый механизм, который принимает список разрешённых inject слота, в порядке, в котором слот их объявляет (при пустом списке разрешённых ничего не следует):

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>") (присоединение не соответствует объявленной форме своего слота)

Компонент, который вносит импортированный модуль, проверяется после построения композиции, которая его импортирует, и сообщается во второй форме. Она называет 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)

Один и тот же ключ доставки (например, одно и то же имя переменной окружения) заявлен дважды среди написанных разработчиком источников inject для одного компонента — на уровне Component и в записи uses[], двумя записями uses[] одного компонента или в двух механизмах доставки собственного блока inject: сущности Component. Доставка не может идти из двух мест одновременно, поэтому ключ, заявленный дважды, — это противоречие, а не вопрос о том, какой из них победит.

Сборка проверяет это в четырёх местах, потому что они видят разные наборы написанных источников и зависимых соединений и задают им разные вопросы, и каждое сообщает об ошибке в своей форме.

Первое читает соединения, которые вы написали в сущности Aggregate, и сообщает об ошибке при разрешении ваших файлов. Оно называет механизм доставки, ключ, а затем сокет и псевдоним первого в авторском порядке соединения, которое тоже заявляет этот ключ:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>") (дублирующийся ключ доставки в нескольких источниках inject)

Второе читает тот же написанный блок и задаёт ему другой вопрос: заявляет ли компонент один ключ в двух своих собственных механизмах доставки, без участия какого-либо соединения. Оно сообщает об ошибке по одному разу для каждого механизма, заявляющего ключ, с позицией в собственной записи этого механизма, и называет механизм, к которому относится сообщение, ключ, а затем все остальные механизмы, заявляющие его, в авторском порядке:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>") (дублирующийся ключ доставки в нескольких источниках inject)

Ни один из механизмов не является виновником, и оба сообщения относятся к тому, что можете изменить вы: переименуйте ключ в одном из них или уберите одну из двух доставок. Какие механизмы компонент вообще может использовать — отдельный вопрос, на который отвечает его список разрешённых spec.inject, — см. «Self-inject mechanism not in the component’s allowlist (Механизм self-inject отсутствует в списке разрешённых компонента)» ниже.

Компонент, который добавляет модуль, тоже подпадает под эти две первые формы, читаемые из собственного документа модуля после сборки композиции, которая его импортирует; тогда они называют сущность Aggregate модуля и ключ в её документе.

Третье читает соединения, которые несёт готовая топология, включая те, что добавило от вашего имени присоединение Feature. Оно выполняется до любого рендеринга и называет написанный вами ключ доставки вместе с сокетом зависимости, который тоже доставляет его:

duplicate delivery key across self-inject and uses-inject ("<key>", socket "<socket>") (дублирующийся ключ доставки в self-inject и uses-inject)

Один написанный ключ, доставляемый через два сокета зависимостей, сообщается по одному разу для каждого сокета, поэтому одна сборка сообщает обо всех них, а не только о том, до которого дошла первой.

Четвёртое читает ту же готовую топологию и задаёт ей другой вопрос: доставляют ли два собственных зависимых соединения компонента один ключ, при том что сам компонент ничего не заявляет. Оно сообщает об ошибке по одному разу на каждом соединении, с позицией в собственной записи доставки этого соединения, и называет путь записи, а за ним каждый сокет, доставляющий ключ:

duplicate delivery key across inject sources ("inject.<mechanism>.<key>", "<socket>", "<socket>") (дублирующийся ключ доставки в нескольких источниках inject)

Сокет, названный дважды, говорит вам, что оба соединения находятся на одном сокете под разными псевдонимами — тогда их различает только позиция, поэтому читайте путь поля в каждом из двух сообщений, а не имена сокетов.

Ни одно из соединений не является виновником, и оба вы можете изменить: переименуйте один из ключей или уберите одну из двух доставок.

Если ключ — это путь, путь поля вместо этого называет блок механизма. Что записано в ключе доставки — дело самого механизма, а механизм file доставляет в путь монтирования, поэтому такой ключ содержит точки, тогда как путь поля разделяет ими свои шаги. Путь поля останавливается на последнем шаге, который можно назвать без неоднозначности, а не записывает такой, который читался бы как обход ключей, которых в вашем документе нет, поэтому для ключа вроде /etc/app/config.yaml он выглядит как .spec.components.<component>.inject.<mechanism> и на этом останавливается. Сообщение в любом случае называет ключ, и именно это сохраняет одинаковую практическую пользу сообщения, — но место, где его читать, различается в четырёх формах выше, поэтому читайте путь поля, чтобы найти блок, а ключ берите из той из четырёх форм, что у вас: если подробности начинаются с механизма доставки, ключ — это значение в кавычках сразу после него; если подробности начинаются с самого ключа, это первое значение в кавычках; а если подробности начинаются с собственного пути записи доставки, ключ — последний шаг этого пути.

Как исправить: переименуйте один из конфликтующих ключей или удалите дублирующееся объявление. Обратите внимание: если injectMapping сущности FeatureRecipe переписывает ключ, доставленный собственным блоком inject: компонента или блоком inject: одного из его соединений, это намеренный перехват, и он не помечается ни здесь, ни где-либо ещё.

Ключ, заявленный сущностью Feature, присоединённой к компоненту, попадает в то же общее пространство с третьей из трёх поверхностей написания и сообщается в разделе «An attachment delivers a key another inject source already claimed (Присоединение доставляет ключ, уже заявленный другим источником inject)» ниже; ключ, который доставляют две присоединённые Features, где более поздняя из двух доставляет его через injectMapping своей FeatureRecipe, сообщается в разделе «Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Две присоединённые Features доставляют один ключ, более поздняя — через injectMapping своей FeatureRecipe)».

Self-inject on a component without an allowlist (Self-inject на компоненте без списка разрешённых)

Разработчик написал блок inject: на уровне компонента, но каталожная сущность Component не объявляет spec.inject. Сущности Components без списка разрешённых spec.inject являются типами Black-Box: они не получают внедрения, написанного разработчиком.

Выводимое сообщение:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>") (self-inject для компонента без списка разрешённых spec.inject)

Сообщение указывает на сам блок inject: — именно этот элемент нужно удалить.

Как исправить: удалите блок inject: из этого экземпляра Component или перейдите на тип White-Box Component, объявление которого в каталоге включает spec.inject.

Self-inject mechanism not in the component’s allowlist (Механизм self-inject отсутствует в списке разрешённых компонента)

Разработчик написал блок inject: на уровне компонента с механизмом (например, env или определённой формой монтирования файла), которого нет в списке разрешённых spec.inject сущности Component.

Выводимое сообщение:

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>", …) (self-inject для компонента без списка разрешённых spec.inject)

Механизмы, которые тип разрешает, следуют за продиктованным, поэтому сообщение содержит и то, что было написано, и то, что допускает тип. Тип, вообще не объявляющий список разрешённых, сообщает продиктованный механизм, после которого ничего нет.

И это правило, и правило выше действуют для компонента, который добавляет модуль, после сборки композиции, импортирующей модуль; тогда отчёт называет сущность Aggregate модуля и ключ в её документе.

Как исправить: перейдите на разрешённый механизм или, если Component должен поддерживать нужный вам механизм, расширьте его список разрешённых spec.inject в каталоге.

Ребро uses диктует доставку на сокете, в списке разрешённых которого нет ни одного механизма

Блок inject: на ребре uses: подключается к сокету, запись usesSchema которого не объявляет список разрешённых механизмов inject: или объявляет пустой. Такой сокет является соединением типа Black-Box: объявившая его сущность обрабатывает значения зависимости внутри себя, поэтому потребитель получает то, что выдаёт Recipe поставщика, и не выбирает форму доставки. Отсутствующий ключ inject: и inject: [] — одно и то же объявление.

Сокет читается у той сущности, которая его объявила: ребро, заданное на прикреплении Feature, разрешается по usesSchema прикреплённой Feature, а любое другое ребро — по схеме потребляющей сущности 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. (inject ребра uses задаёт механизм доставки, который сокет не допускает ("<mechanism>", на сокете "<socket>", объявлен в типе компонента "<component-type>"). Сокет не объявляет разрешённого списка механизмов доставки, поэтому не допускает никакого указания механизма — объявившая его сущность доставляет значения зависимости сама. Удалите блок inject из этого соединения и читайте значения из provides соединения в потребляющем Recipe либо объявите допустимые для сокета механизмы в его записи usesSchema.)

Результат проверки привязан к той заданной записи, к которой он относится, в документе, где эта запись написана: .spec.components.<consumer>.uses.<socket>.<alias> для ребра, проведённого собственным блоком uses: компонента, и .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias> для ребра, проведённого прикреплением, — с корнем в блоке, объявившем прикрепление, который может принадлежать подсистеме или границе, а не самому компоненту. Если сокет был объявлен на прикреплённой Feature, сообщение называет тип feature вместо типа компонента. Каждое нарушающее ребро сообщается отдельным результатом, поэтому одна сборка называет их все.

Как исправить: удалите блок inject: с ребра и читайте значения зависимости из .context.uses.<alias>.provides.<name> в потребляющем Recipe; или, если соединение должно быть прозрачным, объявите механизмы доставки, которые разрешает сокет, в списке разрешённых inject: его записи usesSchema.

Сокет, который объявляющая сущность вообще не объявляла, — другой случай, и здесь он не отклоняется: у ad-hoc сокета нет списка разрешённых механизмов, поэтому ребру не за что выйти.

Ребро uses диктует механизм доставки вне списка разрешённых механизмов сокета

Блок inject: на ребре uses: называет механизм доставки, которого нет в списке разрешённых механизмов 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. (inject ребра uses задаёт механизм доставки, который сокет не допускает (на сокете, который допускает перечисленные выше механизмы, объявлен в указанном типе компонента). Укажите один из механизмов, допустимых для сокета, либо расширьте разрешённый список inject этого сокета в записи usesSchema объявляющей сущности.)

Результат проверки привязан к той заданной записи, к которой он относится, по тем же путям, что называет отказ выше. Если сокет был объявлен на прикреплённой Feature, сообщение называет тип feature вместо типа компонента.

Как исправить: перейдите на один из разрешённых механизмов или, если сущность должна поддерживать нужный вам механизм, расширьте список разрешённых механизмов inject: этого сокета в его записи usesSchema в каталоге.

Запись inject: содержит и литерал, и исходный ключ

Запись inject: доставляет одно из двух: литерал, заданный под value:, — в собственном блоке компонента, единственном месте, где доставляется литерал, — или ключ, читаемый из компонента, на который указывает соединение, заданный под from:. Запись, содержащая и то и другое, говорит две вещи сразу и не даёт правила выбора между ними, поэтому она отклоняется, а не позволяет одному из двух тихо победить.

Схемы авторинга допускают ровно одно из пары, поэтому документ, прочитанный из файла, отклоняется при загрузке. Эта проверка стоит за той: она читает каждый блок inject:, который содержат сущности Aggregate и Release, пока эти два документа разрешаются, так что документ, собранный каким-либо иным путём, чем из файла, всё равно отклоняется до того, как из него что-либо будет построено, а не получает молча выбранное одно поле. Она охватывает те же блоки, что и проверка формы ниже.

Каждый механизм доставки, содержащий нарушающую запись, сообщается как отдельная находка, привязанная к этому механизму в документе, где он записан, — .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:, не называет ничего из того, что публикует цель, поэтому ему нет места на соединении, и запись отклоняется, а не отбрасывается. Литерал, который компонент доставляет самому себе, относится к собственному блоку inject: компонента, где value: допускается.

Проверяется каждое соединение, каким бы документом оно ни было проведено: соединение в собственном блоке uses: компонента, соединение, которое проводит привязанная сущность Feature в сущности Aggregate, и соединение, которое проводит привязка, записанная в сущности Release. Оно отклоняется до какого-либо рендеринга, поэтому о нём сообщает как aggrega validate --release, так и aggrega build.

Каждая нарушающая запись сообщается как отдельная находка, привязанная к записи соединения в документе, который его провёл, — .spec.components.<component>.uses.<socket>.<alias> для собственного соединения компонента, .spec.components.<component>.features.<attachment>.uses.<socket>.<alias> для соединения, проведённого привязкой, а в сущности Release — тот же путь под записью привязки, например .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: на from:, называющий этот ключ provides:. Если это литерал, нужный потребляющему компоненту, перенесите запись в собственный блок inject: этого компонента, механизмы которого определяются списком разрешённых spec.inject его типа Component.

An inject: entry on an attached Feature carries a literal (Запись внедрения в присоединённой сущности Feature содержит литерал)

Блок inject:, написанный в присоединённой сущности Feature, доставляет в компонент то, что публикует сущность FeatureRecipe этого присоединения: каждая запись называет один из ключей, которые публикует provides: сущности FeatureRecipe, под from:. Литерал, написанный под value:, не называет ничего, что публикует присоединение, поэтому под in: этой записи до компонента ничего не дошло бы; запись отклоняется, а не собирается и отбрасывается. Литерал, нужный компоненту, относится к собственному блоку inject: компонента, где value: допускается и доставляется.

Проверяется каждое присоединение, на котором сущность Aggregate пишет блок inject:: как в собственном блоке features: компонента, так и в блоке features: подсистемы, который распространяется на каждый компонент, содержащийся в подсистеме, — в сущности Aggregate, которую называет сущность Release, и в каждом модуле, который эта сущность Aggregate импортирует под aggregates:, на любой глубине. Соединение, которое проводит присоединение, несёт собственный блок inject:, и литерал в нём подпадает под описанное выше отклонение для соединений. Присоединение в сущности Release не пишет собственного блока inject:. Запись отклоняется до того, как что-либо будет отрендерено, поэтому aggrega validate --release сообщает о ней так же, как aggrega build.

Каждая ошибочная запись сообщается как отдельная находка, регистрируемая как DEVELOPER_ERROR в отношении сущности Aggregate, документ которой написал блок, — собственного документа модуля для присоединения, написанного в модуле, — и размещаемая на механизме доставки внутри блока присоединения в этом документе: .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: на from:, называющий этот ключ provides:. Если это литерал, нужный компоненту, перенесите запись в собственный блок inject: компонента, механизмы которого определяет список разрешённых spec.inject его типа Component:

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:. Механизм, содержащий что-либо иное, например сопоставление имён ключам, не доставляет ничего, что может прочитать компилятор, поэтому он отклоняется, а не отбрасывается. Механизм, записанный вообще без значения, ничего не доставляет и не отклоняется.

Схемы авторинга допускают только список, поэтому документ, прочитанный из файла, отклоняется при загрузке как документ, не соответствующий схеме своего вида. Эта проверка стоит за той: она читает каждый блок inject:, который содержат сущности Aggregate и Release, пока эти два документа разрешаются, так что документ, собранный каким-либо иным путём, чем из файла, всё равно отклоняется до того, как из него что-либо будет построено, а не теряет доставку. Она охватывает каждый блок любого из документов: в сущности Aggregate — собственный блок компонента, блок привязки и блоки на соединениях, которые проводит любой из них; в сущности Release — блоки на соединениях, которые проводят её привязки.

Каждый нарушающий механизм сообщается как отдельная находка, привязанная к этому механизму в документе, где он записан, и называющая механизм, и обо всех таких находках в сборке сообщается сразу. Находки сущности 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> для блока на одном из его соединений и .spec.components.<component>.features.<attachment>… для блока привязки, с .subsystems.<name> для каждой подсистемы, в которой объявлен компонент или привязка. В сущности Release — блок на соединении, которое проводит привязка, через эту привязку: .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism> для привязки на всю границу, .spec.boundaries.<boundary>.components.<component>.features.<attachment>… для привязки к компоненту, с .boundaries.<name> для каждой вложенной границы и .aggregates.<module> для каждой записи маршрутизации, через которую назван компонент.

Как исправить: запишите каждый механизм, названный в сообщении, как список. Запись DB_URL: host под env: становится - in: DB_URL с from: host, если host называет ключ provides: — подключённого компонента на соединении, самого компонента в его собственном блоке, — или, в собственном блоке компонента, с value: host, если это литерал, предоставляемый этой стороной.

The Feature filling an attachment slot does not satisfy the slot’s selector (Feature, заполняющая слот прикрепления, не удовлетворяет селектору слота)

Сущность Component объявляет именованные точки привязки для ожидаемых ею Features, и слот может объявить selector:, ограничивающий метки того, что его заполняет. Прикрепление привязывается к слоту, если несёт имя слота; в этом случае метки названной им сущности 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 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.

Находка привязывается к ключу заполнения в документе, где это заполнение написано, и относится к автору этого документа: блок features: компонента в сущности Aggregate — ошибка разработчика, а заполнение, которое делает только сущность 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.

Слот, объявленный сокетом, — в featuresSchema записи usesSchema — точно так же проверяет заполнение каждого соединения по своему selector:. Прикрепление, которое соединение несёт в слоте, сопоставляется с ограничением, и недопустимое заполнение останавливает сборку; сообщение называет сокет и соединение, а также слот:

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.

Находка привязывается к ключу прикрепления в features: этого соединения, в документе, где написано заполнение: в записи соединения в сущности 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. Если сообщение говорит, что ограничение не удалось вычислить, ошибка в выражении селектора: исправьте его в объявлении слота в сущности Component или в объявлении сокета.

An attachment written under another name fits a slot its component leaves empty (Прикрепление под другим именем подходит к слоту, который компонент оставляет пустым)

Собственная поверхность прикреплений сущности Component открыта: прикрепление под именем, которого не объявляет ни один слот, является свободным прикреплением и допустимо. Одна форма на этой поверхности вызывает остановку, потому что именно так выглядит заполнение, предназначенное для слота, но написанное под неверным именем. Сборка останавливается, когда для одного прикрепления выполняется всё следующее:

  • оно написано на самом компоненте — в собственном блоке features: компонента в сущности Aggregate или в записи сущности Release для этого компонента;
  • его имя не является слотом, который объявляет тип компонента;
  • метки его сущности Feature удовлетворяют selector: слота, объявленного типом;
  • после свёртки всех областей ничто не привязывает этот слот на компоненте.

Если ничего не делать, такое прикрепление остаётся свободным, а слот, для которого оно предназначалось, — пустым, и необязательный пустой слот собирается успешно и ничего не доставляет. Правило действует для любой сущности Feature, а не только для учётных данных.

Всё остальное на поверхности остаётся свободным. Прикрепление, чья сущность Feature не подходит ни к одному объявленному слоту, собирается; как и дополнительное прикрепление рядом со слотом, который уже что-то привязывает, если ни один другой подходящий для него слот не остаётся пустым. Прикрепление, унаследованное компонентом от подсистемы или границы Release, никогда не проверяется, поэтому общая форма — одни учётные данные, прикреплённые один раз в области, где находятся несколько компонентов, без заполнения слота каким-либо компонентом, — собирается. Слот без selector: ничего не говорит о том, для какой сущности Feature он предназначен, поэтому никакое прикрепление так с ним не сверяется. Прикрепление, которое несёт соединение, здесь тоже не проверяется: слоты сокета — закрытый набор, и любое другое имя на соединении вызывает остановку «A connection carries an attachment under a name its socket declares no slot for (Соединение несёт прикрепление под именем, для которого его сокет не объявляет слота)».

Выводимое сообщение. Сначала идёт предложение условия, затем имя, под которым написано прикрепление, компонент, прикрепляемая сущность 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.

Если сущность 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.

Находка привязывается к ключу прикрепления в документе, где оно написано, и относится к автору этого документа. О прикреплении в собственном блоке features: компонента в сущности Aggregate сообщается по пути .spec.components.<component>.features.<attachment> как об ошибке разработчика; о прикреплении, написанном только сущностью Release в её записи для компонента, сообщается там — под границей, которая называет компонент, .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 (Обязательный слот прикрепления не привязан)».

Чем это отличается от предупреждения о почти совпадении. Предупреждение «An attachment name is one edit from a declared slot (Имя прикрепления отличается от объявленного слота на одну правку)» касается написания имени: имя на одну правку от слота, чьему selector: сущность Feature прикрепления не удовлетворяет; такая сборка проходит с предупреждением. Эта остановка касается того, к чему подходит сущность Feature, независимо от имени: имя может быть любым, а подходящий слот должен оставаться пустым. Если имя на одну правку от слота и его сущность Feature к этому слоту подходит, предупреждение не выдаётся, и если слот остаётся пустым, единственной находкой будет эта остановка.

Как исправить: прикрепите его под именем слота, чтобы оно заполнило слот, — сообщение называет слот или всех кандидатов, если их несколько. Если это действительно отдельное прикрепление, заполните также и слот, поскольку дополнительное прикрепление свободно, как только привязан каждый подходящий для него слот; или, если оно должно достигать нескольких компонентов, прикрепите его на подсистеме или границе Release, в которой они находятся. Если сущность Feature никогда не должна заполнять этот слот, сузьте selector: слота в объявляющей его сущности Component.

An attachment delivers a key another inject source already claimed (Привязка доставляет ключ, уже занятый другим источником inject)

Три поверхности описания доставляют значения в канал внедрения одного компонента через блок inject:: собственный блок inject: компонента, блоки inject: в записях его блока зависимостей и блок каждой привязанной к нему сущности Feature. Они разделяют одно пространство ключей на каждый механизм доставки, поэтому ключ, занятый двумя из них, неоднозначен в том, какое значение придёт, и сборка останавливается, а не позволяет одной поверхности незаметно вытеснить другую. Привязанная сущность Feature может доставлять значения и вторым способом — через injectMapping своей сущности FeatureRecipe; этот путь встречается с тем же пространством после того, как все блоки выполнили доставку, и о нём сообщается в разделе «Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Две привязанные сущности Features доставляют один ключ, более поздняя — через injectMapping своей сущности FeatureRecipe)» ниже.

Это условие описывает сторону этого пространства, относящуюся к блоку привязки. О нём сообщается, когда собственный блок inject: привязки занимает ключ, который уже удерживает какая-либо более ранняя доставка, — запись выше в разделе «Duplicate delivery key across inject sources (Повторяющийся ключ доставки в разных источниках inject)» описывает то же правило со стороны, написанной разработчиком, и вместе они охватывают притязания каждого блока.

Кто вызвал коллизию, решает порядок. Первое притязание на ключ удерживает его, а сообщается о более поздних, — поэтому привязка, чей ключ уже занят, получает об этом сообщение, а привязка, занявшая ключ первой, не получает сообщения о более поздней, которая ничего не вытеснила. Притязание, которое вообще ничего не доставило, оставляет ключ свободным и ни в чём из этого не участвует.

Находка указывает на собственную запись привязки внутри блока компонента — именно её и следует редактировать; сообщение называет ключ и механизм, в пространстве ключей которого он находится. О каждом конфликтующем ключе сообщается отдельно, поэтому привязка, дублирующая два ключа, сообщит вам об обоих.

Выводимое сообщение:

duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>") (дублирующийся ключ доставки между attachment-inject и другим источником inject)

Как исправить: ни одна из сторон не является виновником, и изменить можно обе. Переименуйте ключ на той стороне, которой вы управляете, — чаще всего это собственная запись inject: компонента, поскольку сопоставление сущности Feature записано в документе каталога, — или уберите одну из двух доставок. Если значение действительно должно поставлять подключение, удалите заявку, написанную разработчиком, а не заявку подключения. Учтите, что запись ключа через injectMapping сущности FeatureRecipe для Feature — это другой путь, и здесь он не сообщается: перезапись ключа, который доставил собственный блок inject: компонента или одно из его соединений, является перехватом и не сообщается вовсе, а запись ключа, который доставила другая подключённая сущность Feature, сообщается в записи ниже.

Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Две привязанные сущности Features доставляют один ключ, более поздняя — через injectMapping своей сущности FeatureRecipe)

Привязанная сущность Feature доставляет значения в канал внедрения своего компонента двумя путями: через блок inject:, написанный в привязке, и через injectMapping своей сущности FeatureRecipe, вывод которого называет ключ доставки — часто на основе значения, которое несёт привязка, например выбранной для учётных данных переменной окружения. Когда две привязанные сущности Features приходят к одному ключу при одном механизме доставки и более поздняя из них приходит туда через своё сопоставление, сборка останавливается. Если бы сборка продолжилась, компонент прочитал бы то значение, которое случайно было записано последним, и одни учётные данные могли бы оказаться подставлены вместо других, причём в выводе ничего бы об этом не говорилось.

Условие охватывает каждую подключённую сущность Feature, где бы она ни была подключена: собственный блок features: компонента, подсистема, граница или запись компонента в Release, раскрытие аннотации и запись features: соединения. Более ранней из двух доставок может быть сопоставление другой сущности Feature или её собственный блок inject: — сборка сообщает обе пары под этим одним условием.

Кто вызвал коллизию, решает порядок. Каждый блок inject: выполняет доставку до рендеринга любого сопоставления, а сопоставления рендерятся в одном фиксированном порядке — в порядке, в котором inject mapping обходит привязанные сущности Features компонента, описанном в конвейере компиляции, — поэтому первая доставка под ключом удерживает его, а сообщается о более поздней сущности Feature. Решает только наличие: значения не сравниваются, поэтому о двух сущностях Features, доставляющих одно и то же значение под одним ключом, всё равно сообщается. Ключ, которого в выводе сопоставления нет вовсе, доставкой не является; ключ с пустым значением — является, потому что пустое значение заменяет то, что там было. Один ключ при двух разных механизмах доставки — это два ключа, а не коллизия.

Что не сообщается. Перезапись через injectMapping сущности FeatureRecipe ключа, который доставил собственный блок inject: компонента или один из блоков inject: его соединений, является перехватом — маршрутизирующая сущность Feature уточняет хост, защитный механизм перенаправляет upstream, — и значение сопоставления заменяет эту одну запись. Перезапись сопоставлением сущности Feature ключа, который доставил её собственный блок inject:, — это преобразование сущностью Feature собственной доставки, и оно тоже не сообщается.

Находка указывает на собственную запись более поздней сущности Feature — внутри блока features: компонента или, для сущности Feature, которую несёт соединение, на её запись под этим соединением в документе, который её написал, например .spec.components.<component>.uses.<socket>.<alias>.features.<slot> в сущности Aggregate. Сообщение называет ключ, механизм доставки и обе сущности 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, которая может читать собственные values и infra привязки, а ключ другой выбирается так же или её собственным блоком inject, если она доставляла через такой блок. Сущность Release задаёт infra привязки и никогда — её values, поэтому, если ключ выбирается значением, выполните эту привязку в сущности Aggregate вместе со значением, а остальное по-прежнему задавайте из сущности Release.)

Как исправить: дайте одной из двух сущностей Features собственный ключ — для сущности Feature с учётными данными это обычно ключ, который называют её значения, — или удалите одну из двух привязок. Если обе должны поставлять одну переменную, решите, какую из них должен читать компонент, и привяжите только её. Два набора учётных данных, которые сущность Release привязывает сама, оба приходят под ключом, который их сущность Feature называет по умолчанию, поскольку сущность Release не может записать values привязки: привяжите один из них в сущности Aggregate со значением, называющим его ключ, и задайте его источник из сущности Release в той же записи.

A component declares an inject mechanism the attached Feature maps nothing to (Компонент объявляет механизм inject, которому присоединённая сущность Feature ничего не сопоставляет)

Список разрешённых spec.inject сущности Component может называть механизмы доставки помимо стандартных — механизм, который понимает собственная обвязка компонента и для которого всё, что доставляет в него, должно произвести значение. Когда сущность Feature присоединена к такому компоненту, именно injectMapping сущности FeatureRecipe указывает, под каким механизмом доставляется каждое производимое им значение. Механизм, который компонент объявил, но для которого сопоставление не производит ключа, — это доставка, которая молча никогда не произойдёт, поэтому сборка вместо этого останавливается.

Сопоставление, которое ничего не говорит о механизмах, — не сопоставление, которое говорит, что их нет. 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; добавьте ключ механизма в injectMapping сущности Recipe ("<mechanism>", recipe "<featurerecipe>"))

Как исправить: сообщение называет обе половины. Добавьте ключ механизма в injectMapping сущности FeatureRecipe, чтобы сущность Feature производила для него значение, или удалите механизм из списка разрешённых spec.inject сущности Component, если ничто не должно доставлять под ним. Если FeatureRecipe принадлежит чужому каталогу, третий вариант — присоединить сущность Feature, чьё сопоставление покрывает этот механизм.

An attached Feature’s injectMapping output cannot be read (Не удаётся прочитать вывод injectMapping присоединённой сущности Feature)

injectMapping сущности FeatureRecipe — это шаблон, а то, что он выдаёт, читается как YAML: словарь с ключами по механизму доставки — env, file, arg или собственный механизм компонента — либо плоский словарь доставок в окружение. Если вывод не читается ни как то, ни как другое, ни один из его ключей не может быть доставлен, поэтому сборка останавливается, а не рендерит компонент так, будто присоединённая сущность Feature ничего не доставила. Важнее всего это для учётных данных: компонент, ожидающий пароль, который он так и не получил, иначе мог бы работать без него, и ничто в выводе об этом не сообщило бы.

Обычная причина — значение, которое шаблон записал в кавычках как есть. Двойная кавычка внутри него преждевременно завершает скаляр в кавычках, а обратная косая черта начинает escape-последовательность, которую YAML может не знать, поэтому сопоставление, которое правильно рендерится для большинства значений, ломается на том, которое содержит такой символ, — часто на пароле. Пустой вывод или вывод, который разбирается как словарь, ничего не доставляющий, — это не данное условие: он ничего не доставляет, и именно это он и сообщает.

Фрейм над сообщением называет рендерящийся компонент, затем присоединение — по имени, которое оно носит в компоненте, — и сущность FeatureRecipe, в которой записано сопоставление, в виде feature "<attachment>" (recipe "<featurerecipe>") injectMapping output. Под сообщением указана причина, по которой вывод не удалось прочитать, — строка и то, что YAML там обнаружил, например yaml: line 2: found unknown escape character. Если шаблон читает значение, которое автор объявил чувствительным, и причина зависит от содержимого этого значения, причина скрывается, а на её месте стоит предложение, сообщающее об этом, поэтому остановка никогда не цитирует значение, сломавшее вывод. Сборка сообщает об остановке под тегом CATALOG_ERROR, потому что сопоставление пишет автор сущности FeatureRecipe.

Выводимое сообщение:

FeatureRecipe injectMapping output could not be read as a dictionary of deliveries (Вывод injectMapping сущности FeatureRecipe не удалось прочитать как словарь доставок)

Как исправить: в injectMapping сущности FeatureRecipe записывайте каждое значение через toJson — {{ .values.key }}: {{ .values.origin | toJson }}, — что записывает его как строку JSON, которую YAML читает обратно в точности, какие бы символы она ни содержала. Если сущность FeatureRecipe принадлежит чужому каталогу, значение также можно изменить так, чтобы оно не содержало двойных кавычек и обратной косой черты, пока сопоставление не исправлено.

An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Вывод injectMapping присоединённой сущности Feature записывает доставки под ключом, по которому ничего не доставляется)

Вывод injectMapping сущности FeatureRecipe сливается с каналом внедрения компонента по ключам верхнего уровня. 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") (Вывод injectMapping сущности FeatureRecipe записывает ключ, который не читает ни один механизм доставки хоста)

Как исправить: в injectMapping сущности FeatureRecipe перенесите записи из-под all: в механизм, из которого их читает компонент, — обычно env: или механизм с именем, которое читает сущность Recipe компонента. Если сущность FeatureRecipe принадлежит чужому каталогу, вместо этого присоедините сущность Feature, сопоставление которой доставляет это значение.

При рендеринге вывода

После проверки всех контрактов компилятор вычисляет шаблоны Go в значениях Component, блоках injectMapping сущностей FeatureRecipe и в источниках Recipe и FeatureRecipe, а затем передаёт результат рендереру.

Шаблон provides: ссылается на несамодостаточный корень (provides: template references a non-self-contained root)

Шаблон provides: сущности Recipe ссылается на корень вне самодостаточного набора. Блок provides вычисляется на этапе вычисления provides, до наполнения канала inject и до обхода межузловых рёбер, поэтому может ссылаться только на данные собственного узла: .context.instance_id, .context.rendered_name, если provider узла его сообщает, .values, .infra, разрешённые .locals узла и статические строки. Проверка основана на положительном списке разрешённого, поэтому любой другой корень останавливает сборку — .context.inject и .context.uses (межузловые), .context.annotations.*, .context.labels, .context.metadata и .metadata.* (данные, связанные с размещением или развёртыванием, которые поверхность provides не предоставляет), а также .attachment_name (проход provides базовой сущности Recipe не разрешает никакого подключения). Ссылка на любой из них явно останавливает сборку, а не тихо рендерит пустое значение.

.locals входит в поверхность: locals узла разрешаются в преамбуле того же этапа, до его provides, поэтому шаблон provides читает их и получает разрешённые значения.

Выводимое сообщение:

provides block references a root outside the self-contained set ("<expression>") (блок provides ссылается на корень вне самодостаточного набора ("<expression>"))

Остановка привязана к сущности Recipe, объявляющей запись, и к написанному ключу внутри неё — .spec.provides.<name>, — поэтому указывает на блок, который нужно править, а не на компонент, связавший Recipe. Каждая запись, выходящая за пределы поверхности, сообщается в той же сборке; если таких несколько, находки группируются под provides entries that reach outside the data they are evaluated against.

Как исправить: переработайте шаблон так, чтобы он брал данные только из собственных опор Recipe. Если значение зависит от вывода другого узла, эта зависимость должна находиться в блоке uses[].inject вызывающего узла, а не в provides целевого узла. Если значение вычисляется, поместите выражение в запись locals: и читайте его из provides — тогда выражение находится в одном месте. Если вам нужно было пространство имён развёртывания (или другие данные о размещении), чтобы построить хост для обращения между пространствами имён, опубликуйте здесь голый хост и уточните его на стороне потребителя с помощью функции маршрутизации — provides производителя не должен зависеть от того, где он развёрнут.

Для provides: сущности FeatureRecipe действует то же правило для locals: её собственные locals: разрешаются раньше её provides:, поэтому запись provides сущности FeatureRecipe тоже читает .locals.

Запись locals: ссылается на соседнюю запись, определённую ниже в том же блоке (locals: entry references a sibling defined later in the same block)

Блок locals: разрешается в порядке записи его элементов, и запись читает только соседнюю запись, определённую выше неё. Прямая ссылка .locals.<key> на запись, которую блок определяет ниже, останавливает сборку: компилятор никогда не сортирует и не переупорядочивает блок, чтобы ссылка разрешилась, поскольку тогда вывод следовал бы выводу компилятора, а не написанному. Без остановки ссылка разрешилась бы по политике отсутствующих ключей в пустую строку, и производное имя хоста или секрета тихо потеряло бы сегмент, из которого строилось.

Эту ошибку определяют оба разрешения блока locals:, и одно из них — закрепление. Блок разрешается для двух разных целей: чтобы собственные шаблоны Recipe могли читать его при рендеринге артефакта и чтобы можно было разрешить структурированную координату source: и закрепить артефакт, который она называет. Ошибка определяется по объявленному порядку ключей и написанному тексту — этого ей достаточно, — поэтому оба разрешения доходят до неё и сообщают об одном и том же условии: aggrega pull и сборка, заполняющая lock-файл, отвергают блок точно так же, как рендеринг. При написании полезно знать два следствия. При разрешении координаты читается весь блок, поэтому запись не по порядку останавливает сборку, даже если каждое поле source: задано литералом и не читает ни одного local. А Recipe, у которой source: — простая строка или которая вовсе не объявляет source:, не разрешает координату, поэтому для такой Recipe об ошибке сообщается при рендеринге вывода.

Выводимое сообщение для записи в собственном блоке locals: компонентной сущности Recipe. Оно привязано к написанному ключу внутри 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 ссылается на соседнюю запись, определённую ниже в том же блоке (<expression>, называемый ключ — <referenced>, разрешено на этот момент <the locals available here>, достигнуто через компонент <component>). определите <referenced> выше <key> в блоке 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 ссылается на соседнюю запись, определённую ниже в том же блоке (<expression>, называемый ключ — <key>, разрешено на этот момент <the locals available here>, достигнуто через компонент <component>). запись locals не может читать саму себя; вычислите значение непосредственно из .values и .infra)

Одну сущность Recipe связывают многие компоненты, поэтому одна ошибка в общем блоке сообщается по разу для каждого связавшего её компонента — и различает эти находки именно reached through the component. У них общая позиция, поскольку все они касаются одной и той же написанной записи в одном документе; позиция указывает, где править, а имя компонента — какой из ваших компонентов представляет каждая находка. Находки не объединяются, потому что объединение сказало бы, что что-то не так, не сказав, каких компонентов это касается, а именно на это вам нужно реагировать.

Та же ошибка в блоке locals:, который объявляет recipe сущности Feature, сообщается так же: с привязкой к написанному ключу внутри этого recipe, с именем компонента, к которому относится подключение, и в группе с соседними записями с той же ошибкой. Если recipe подключён в нескольких местах, ошибка сообщается по разу для каждого — каждое подключение связывает этот блок независимо, поэтому каждое является отдельным случаем, а не повтором одного.

Когда в такой форме сообщается ссылка на саму себя, её указание позиции называет саму ссылающуюся запись, а не нижележащую, потому что ключ находится именно там.

Как исправить: переместите запись, на которую ссылаются, выше читающей её записи. Переупорядочивание блока locals: меняет поведение везде, где одна запись читает другую, поэтому исправление — ровно то переупорядочивание, которое называет сообщение. Ссылку на саму себя — запись, называющую собственный ключ, — переупорядочиванием не исправить; вместо этого вычислите значение напрямую из .values и .infra, о чём сообщение говорит вместо указания переместить запись.

Ключ locals: не существует

Шаблон читает .locals.<key> для ключа, который блок locals: вообще не объявляет, — опечатка или ключ, который был переименован или удалён. Эту остановку вызывает каждая поверхность, читающая этот столп: запись locals:, шаблон provides:, шаблон source: сущности Recipe и разрешение структурированной координаты source:, которое читает весь блок, чтобы закрепить артефакт, названный координатой. Столп locals — открытая карта с ключами, поэтому неизвестный ключ в нём проходит проверку корня и иначе разрешился бы в пустую строку; именно остановка не даёт этому пустому значению попасть в выводимый артефакт.

Выводимое сообщение, когда ошибочная ссылка находится в шаблоне 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 не объявляет (Recipe <recipe> provides[<key>] ссылается на <expression>, блок locals не объявляет <referenced>, он объявляет <the keys it does declare>). исправьте имя ключа)

Выводимое сообщение, когда она находится в самой записи 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 не объявляет ("<expression>", отсутствующий ключ — "<referenced>", блок объявляет "<the keys it does declare>", достигнуто через компонент "<component>"). исправьте имя ключа)

Как исправить: замените имя ключа на одно из тех, что объявляет блок; сообщение их перечисляет. Эта остановка отличается от остановки по порядку выше, потому что способы исправления разные: никакая перестановка не заставит разрешиться несуществующий ключ.

Проверка читает путь, в который ссылка разрешается, а не её написание, поэтому псевдоним блока отслеживается: ключ, достигнутый через точку, которую переопределяет тело with .locals, или через переменную, привязанную к .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, и именно обёрнутая форма важнее всего: обёртка может дать запасное значение для отсутствующего ключа под определённым корнем, но никогда — для отсутствующего корня, поэтому без этой остановки обёрнутая форма тихо разрешилась бы в пустое значение и позволила бы сборке успешно завершиться. Отсутствующий ключ под определённым корнем не затрагивается и по-прежнему следует политике missingkey=zero для шаблонов значений, описанной ниже в разделе «Missing template key — asymmetric policy (Отсутствующий ключ шаблона — асимметричная политика)», поэтому идиомы необязательных ключей, такие как {{ .values.optional_field | default "fallback" }}, продолжают работать.

Та же остановка охватывает опечатку в ключе уровнем ниже, под опорой с объявленной формой. У некоторых опор есть набор ключей, определяемый компилятором: .context, .metadata, .inject, .workload и .boundary в контексте рендеринга Recipe и FeatureRecipe, а также .manifest в шаблоне пути. Ссылка на ключ, который одна из этих опор не определяет, — {{ .context.nmae }}, {{ .metadata.typo }}, {{ .workload.containres }}, {{ .boundary.nmae }} — приводит к остановке точно так же, как неверный корень, и диагностика перечисляет ключи, определяемые этой опорой. В собственных шаблонах привязки сущности Feature .inject определяет, помимо env, file, arg и all, по одному дополнительному ключу для каждого механизма доставки, который называет собственный блок inject: привязки: привязка, записывающая механизм vault_ref:, читается по пути {{ .inject.vault_ref.VAULT_PATH }}, а диагностика перечисляет .inject.vault_ref среди ключей, которые определяет .inject. Механизм, который привязка не называет, приводит к остановке даже внутри if или with, поскольку ссылка проверяется до запуска шаблона. Чтобы прочитать механизм, который привязка может не называть, защитите обращение: {{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}. Защищённая пара собирается независимо от того, называет ли привязка этот механизм и записывает ли она вообще блок inject:, — тогда .inject ничего не содержит, и with пропускает своё тело, тогда как hasKey непосредственно над .inject привёл бы к остановке на значении, не являющемся отображением. Внутри защиты index по-прежнему приводит к остановке на ключе, которого нет в названном механизме. Другие опоры открыты, потому что в них хранятся данные с ключами, а не набор, объявляемый компилятором, — среди них .values, .infra, .locals, .provides, .features и .steps в контексте рендеринга, а также .parameters и .parent_boundary в шаблоне пути. Открытая опора принимает любой ключ. Отсутствующий ключ под открытой опорой не вызывает эту остановку — он следует политике поверхности для отсутствующих ключей, описанной ниже в разделе «Missing template key — asymmetric policy (Отсутствующий ключ шаблона — асимметричная политика)», поэтому {{ .values.optional_field | default "fallback" }} и все прочие идиомы необязательных ключей продолжают работать.

Какие опоры объявлены, а какие открыты, — свойство поверхности, а не то, на что может повлиять шаблон: компилятор считывает это из формы контекста рендеринга, который он собирается предоставить. Именно это позволяет остановке из-за опечатки и необязательному ключу сосуществовать в одном шаблоне.

Поверхность может также сузить ключ, который её опора в остальных случаях определяет, и такое сообщение не означает опечатку. Если ключ несёт значение, бессмысленное на конкретной поверхности или относящееся к другому узлу, эта поверхность отвергает ссылку, а не разрешает её в неверное значение, и диагностика перечисляет ключи, которые она определяет. Следует знать два случая, оба — {{ .context.rendered_name }}. В собственных шаблонах присоединения Feature ключ несёт имя компонента-хоста в том виде, в каком его сообщает собственный provider хоста, поэтому он отвергается в присоединении к хосту, provider которого не сообщает имени, — к хосту, размещающему только набор артефактов, или к хосту, рендерящемуся через provider, не выводящий такого имени, — и допускается на всех остальных хостах. {{ .context.instance_id }} на этой поверхности допускается и называет компонент-хост, для которого разрешается присоединение, — по нему на таком хосте именуются собственные ресурсы хоста. В записях locals: сущности Recipe ключ отвергается независимо от того, что сообщает provider узла: локальная переменная разделяет контекст с шаблоном source: сущности Recipe, а то, предоставляет ли узел источник, — одно из того, от чего зависит имя, поэтому там имя не предлагается. Диагностика перечисляет .context.instance_id как единственный ключ, который .context там определяет; читайте отрендеренное имя в записи 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-name> ссылается на <dotted-path>, контекст рендеринга определяет <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>) (шаблон ссылается на корень, который контекст рендеринга не определяет (шаблон <template-name> ссылается на <dotted-path>, <pillar> определяет <the keys that pillar defines>))

Как исправить: замените ссылку на одну из перечисленных в диагностике — большинство сообщений вызвано опечаткой в .values, .infra или .context либо в ключе под .context или .metadata. Удаление обёртки с запасным значением не снимет остановку, а добавление обёртки никогда её не подавляло; обёртка лишь скрывала, какая ссылка неверна. Если данные действительно принадлежат другому узлу, они попадают в этот шаблон через канал inject — подключите их записью uses[].inject у потребителя и читайте из .context.inject, — а не через собственный корень.

Проверка охватывает все поверхности шаблонов, которые вычисляет рендерер, каждую — относительно набора ссылок, определяемого её собственной поверхностью: valuesMapping, injectMapping, workload в Recipe и FeatureRecipe, тела artifacts:, записи provides: и locals:, source:, тела when: и with: шагов pipeline, assertions:, шаблоны самоинъекции value: уровня компонента в Aggregate, а также шаблоны путей границ Release (directory: / subDirectory:). Две из этих поверхностей называют некоторые отказы собственной диагностикой, потому что описываемая ими ошибка конкретнее, чем «такой ссылки не существует»: шаблон пути, обращающийся к переменной, которая ему не передаётся, охватывается ниже ошибкой «Path-template references a variable outside the allowlist (Шаблон пути ссылается на переменную вне списка разрешённых)», а FeatureRecipe уровня границы, обращающийся к опоре уровня компонента, — ошибкой «FeatureRecipe template references a field outside its scope’s allowlist (Шаблон FeatureRecipe ссылается на поле вне списка разрешённых для его области)». Всё остальное, что отвергают эти две поверхности, — включая опечатку в ключе под допускаемой ими опорой, — приводит к этой остановке, поэтому ни одна диагностика не сообщит вам, что ваша ссылка — не то, чем она является.

An artifacts: template reads a pillar the Recipe does not declare (Шаблон artifacts читает опору, которую Recipe не объявляет)

Шаблон записи artifacts: читает .workload или ключ под ним в сущности Recipe, которая не объявляет workload:; либо читает .source или ключ под ним в сущности Recipe, которая не объявляет source:. Обе опоры всегда присутствуют в контексте рендеринга артефактов — это корни, которые определяет данная поверхность, — поэтому ссылка корректна, а остановка связана с отсутствием объявления, а не с ошибкой в ссылке. Recipe, рендерящая Deployment из синтезированной рабочей нагрузки, и Recipe, рендерящая чарт из источника, имеют разную форму, и тело artifacts:, написанное для одной из них, обращается к опоре, которую другая никогда не заполняет.

Проверка выполняется до вычисления записи, и именно этот порядок делает сообщение полезным. Отсутствующая опора поступает в шаблон как пустое значение, поэтому при обычном вычислении сборка либо ничего не вставила бы в выводимый файл, либо завершилась бы ошибкой с тем, что шаблонизатор сообщает о чтении ключа из пустоты, — и ни то, ни другое не называет ни опору, ни отсутствующее объявление. Отказ заранее позволяет остановке назвать точное выражение, обратившееся к опоре, в том виде, в каком вы его написали.

Объявленный source:, который рендерится в пустую строку, считается отсутствием источника, потому что проверка читает источник после вычисления его собственного шаблона. Это то же значение, из которого затем рендерит провайдер, поэтому у сущности Recipe, чей source: разрешился в ничто, нет источника и для тела artifacts:.

Выводимое сообщение имеет одну форму, где бы ни была написана запись artifacts:. Меняется не само предложение, а подписи после него, указывающие, какой документ содержит запись.

Называется каждая ошибочная ссылка в шаблоне, поэтому о теле, обращающемся к двум отсутствующим опорам, вы узнаете обе, а не только ту, что встретилась первой. Каждая ссылка сообщается в документе, объявляющем запись, в том виде, в каком вы её написали, с подписью о выводе, к которому она относится:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>) (шаблон артефакта ссылается на опору, которую Recipe не объявляет)

Выражение называет опору в первом сегменте, и именно это указывает, какого объявления не хватает: .source.chart обращается к source:, .workload.containers — к workload:.

Запись, объявленная собственной сущностью Recipe компонента, сообщается относительно блока artifacts: этой Recipe.

Запись, объявленная сущностью FeatureRecipe, — прикреплённой к компоненту как функция или объявленной на границе — проверяется по опорам, которые объявляет эта FeatureRecipe, а не компонент-хост, сообщается относительно блока artifacts: этой FeatureRecipe и несёт ещё одну подпись с именем прикрепления, которое её связывает:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>) (шаблон артефакта ссылается на опору, которую Recipe не объявляет)

Подпись прикрепления сообщает то, чего не может сказать сама позиция: компонент может нести несколько прикреплений, а прикрепление, объявленное на границе, достигает каждого компонента этой границы. Само предложение в обоих случаях называет Recipe; какой документ открыть, говорят вместе позиция и подпись прикрепления.

Если один шаблон содержит несколько ссылок, каждая получает собственное сообщение под строкой, называющей их общую запись, и эта строка тоже называет документ:

artifact <output-name> references pillars its Recipe does not declare (артефакт ссылается на опоры, которые его Recipe не объявляет)

artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare (артефакт ссылается на опоры, которые не объявляет FeatureRecipe, связанная прикреплением)

Все эти сообщения несут одно и то же условие остановки, о каком бы документе они ни были, поэтому всё, что сопоставляет по условию, а не по тексту, не видит между ними разницы.

Как исправить: либо объявите опору, которую читает шаблон, либо перестаньте её читать. Объявление — правильное исправление, если тело artifacts: соответствует этой форме Recipe: добавьте workload:, которого ожидают ссылки шаблона на контейнер, порт или том, или source:, путь чарта или модуля которого он подставляет. Удаление ссылки — правильное исправление, если тело было написано для другой Recipe и повторно использует неприменимый здесь фрагмент; если значение действительно поступает из другого места, опубликуйте его через provides: узла-производителя и читайте из канала inject, а не обращайтесь к опоре, которую эта Recipe не заполняет. Защита ссылки резервной обёрткой не снимает остановку — отсутствует опора, а не ключ под ней, — как и перенос ссылки в другую запись той же Recipe, потому что каждая запись одного блока artifacts: вычисляется по одним и тем же опорам.

Эта остановка отличается от [Template references a root the render context does not define (Шаблон ссылается на корень, который контекст рендеринга не определяет)] выше, и различать их стоит, потому что способы исправления разные. Та срабатывает на корень, который поверхность вообще не определяет, или на опечатку в ключе под опорой с фиксированной формой — {{ .workload.containres }} в Recipe, которая действительно объявляет рабочую нагрузку. Эта срабатывает на правильно написанную ссылку на опору, которой просто нет.

Шаблон читает отображаемое имя, которое провайдер узла не сообщает

Шаблон читает {{ .context.rendered_name }} — имя, которое привязанный провайдер даёт выводу, отображаемому им для узла, из исходника, предоставленного автором, или из синтезируемой им рабочей нагрузки, — на узле, провайдер которого такого имени не сообщает. Ссылка корректна, и ключ определён в контексте отображения; отсутствует лишь ответ для этого узла.

Отказ существует потому, что альтернатива хуже остановки. Имя попадает в шаблон как простая строка, поэтому узел без имени отобразил бы ссылку в пустоту и вывел бы адрес, в котором не хватает одного сегмента, — .svc.cluster.local там, где подразумевалось имя хоста, — с кодом выхода ноль и без каких-либо сообщений сборки. Такой артефакт развёртывается, но то, что он называет, не существует. Отказ до любого вычисления сообщает об ошибке применительно к шаблону, который написал автор.

Сообщает ли провайдер узла такое имя, определяется привязкой Recipe до любого вычисления, поэтому здесь ничего не угадывается.

Сообщений два, и какое из них вы получите, зависит от узла, а не от того, где вы написали ссылку. У узла, который не предоставляет собственного исходника и провайдер которого не сообщает для него имени, ресурсы названы по его идентификатору, поэтому корректное значение существует, и сообщение его называет. У узла, который предоставляет исходник, при провайдере, не выводящем для него имени, замены нет — а предложение идентификатора отправило бы вас к значению, не называющему ни одного ресурса этого узла, поэтому сообщение так и говорит.

Выводимое сообщение, когда узел не предоставляет собственного исходника:

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 (шаблон читает имя, которое цель даёт ресурсам, отображаемым ею для узла, а провайдер этого узла такого имени не сообщает; корректный шаблон читает значение, предоставляемое собственным провайдером узла (“.context.rendered_name”, провайдер "<provider>"). Читайте вместо этого {{ .context.instance_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>"). 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 (шаблон читает имя, которое цель даёт ресурсам, отображаемым ею для узла, а провайдер этого узла не сообщает такого имени; соответствующий шаблон читает значение, которое предоставляет собственный провайдер узла (.context.rendered_name, провайдер <provider>). Запишите значение, не зависящее от имени, которое выводит эта цель: для вывода, отображаемого ею из предоставленного исходного кода, она не сообщает никакого имени, поэтому читать здесь нечего)

Если ссылка находится в шаблоне, отличном от записи provides:, сообщение дополнительно называет поле, в котором она написана, — field "valuesMapping", field "artifacts[probe.tf.json]", — поскольку ключ записи artifacts: является именем выходного файла и содержит символ, которым позиция разделяет собственные сегменты, так что позиция заканчивается на блоке, содержащем запись.

Какие шаблоны охватываются: каждый шаблон, который Recipe пишет непосредственно, — его записи provides:, его valuesMapping:, тело workload:, каждая запись artifacts:, а также with: и when: каждого шага конвейера. Одна поверхность шаблонов в проверку не входит: запись valuesMapping:, workload: или artifacts:, предоставленная через $import:, — называет ли импорт локальный файл или запись библиотеки, — не содержит текста в Recipe, пока отображение её не разрешит, поэтому ссылка внутри такого тела отображается как пустое значение, а не вызывает остановку.

Как исправить: читайте ключ, который называет сообщение. Если вывод вашего узла создаётся для него провайдером, не сообщающим имени, — синтезированная рабочая нагрузка, размещённый набор артефактов, — то {{ .context.instance_id }} — это имя, которое эти ресурсы действительно носят, и это правильное значение, а не запасной вариант. Если ваш узел предоставляет собственный chart или модуль и сообщение не предлагает замены, то имя, к которому вы обращались, этот провайдер не выводит: опубликуйте то, что от него не зависит, или назовите ресурс в предоставленном исходнике и прочитайте это имя из заданного вами значения. В ../templates/rendered-resource-names.md описано, какие провайдеры сообщают имя и почему для каждого из остальных сообщать нечего.

Шаблон читает факты отображения своих вызывающих без объявления

Шаблон в FeatureRecipe, прикреплённом к компоненту, читает render_facts под .context.used_by — то, что компоненты, подключающиеся к хосту прикрепления, сообщили о своих отображениях, — а FeatureRecipe не задаёт readsCallerRenderFacts: true.

Ключ определяет, когда отображается прикрепление. Без него прикрепление отображается сразу после компонента, к которому оно прикреплено, а подключающийся компонент, идущий позже в порядке сборки, к этому моменту ещё не отображён, поэтому выведенного им прочитать нельзя. Отказ от шаблона до любого отображения сообщает об отсутствующем объявлении применительно к написанному вами полю, а не порождает сборку, шаблон которой читает то, что вывели одни вызывающие, но не другие.

Выводимое сообщение:

template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>) (шаблон читает факты отображения своих вызывающих, но FeatureRecipe не задаёт readsCallerRenderFacts (<reference>, записано в <field>))

Ссылка цитируется относительно подключения, с которого она прочитана, — .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 (шаблоны прикреплений, читающие факты отображения своих вызывающих без объявления)

Как исправить: задайте readsCallerRenderFacts: true в spec сущности FeatureRecipe. Тогда её прикрепления отображаются после отображения всех компонентов, и больше ничего в том, что они отображают, не меняется — см. страницу сущности FeatureRecipe. Контрактом является ключ, а эта остановка лишь помогает найти шаблон, которому он явно нужен: проверка читает шаблон в написанном виде, поэтому ссылка, построенная во время выполнения шаблона, или ссылка в содержимом, импортированном из файла или библиотеки, остановки не вызывает — всё равно задайте ключ в таком FeatureRecipe. Шаблон, читающий поле render_facts с какого-либо другого списка рядом с .context.used_by, также вызывает остановку, как и шаблон, читающий собственные факты хоста как .render_facts внутри {{ with .context }} рядом с ним, — записывайте собственные факты хоста полностью как .context.render_facts, что никогда не принимается за факты вызывающих; задание ключа устраняет любой из случаев ценой лишь более позднего отображения.

FeatureRecipe, который отображается один раз для границы (executionScope: boundary), здесь не проверяется: у шаблонов, создающих его ресурсы, нет .context для чтения, и ссылка на него отклоняется как поле вне списка разрешённых для его области.

A pipeline step reads its callers’ render facts (Шаг конвейера читает факты рендеринга вызывающих компонентов)

Поле with: или when: шага конвейера в сущности FeatureRecipe, присоединённой к компоненту, читает render_facts внутри .context.used_by — то, что компоненты, подключающиеся к хосту присоединения, сообщили о собственном рендеринге.

Шаг конвейера никогда не видит этих подключений. Шаг может переписывать собственные документы компонента-хоста, а собственный вывод компонента остаётся одним и тем же, кто бы к нему ни подключался, поэтому шаблоны шага вычисляются без .context.used_by — для любой сущности FeatureRecipe, независимо от того, задаёт ли она readsCallerRenderFacts: true. Этот ключ определяет, когда рендерится присоединение, но никогда не определяет, что видит шаг. Поэтому шаг, читающий факты вызывающих компонентов, не прочитал бы ничего, и сборка останавливается до начала рендеринга, а не отображает такое чтение как пустое значение.

Выводимое сообщение:

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>) (шаг конвейера читает факты рендеринга вызывающих компонентов, но шаг конвейера не читает компоненты, подключающиеся к его хосту; он читает только собственные факты рендеринга хоста (<reference>, записано в <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: — с заданным readsCallerRenderFacts: true, как описано на странице сущности FeatureRecipe. Одна лишь установка ключа эту остановку не устраняет. Проверка читает шаблон в том виде, в каком он написан, с ограничениями, описанными в записи выше: ссылка, построенная во время выполнения шаблона, или ссылка в содержимом, импортированном из файла или библиотеки, не вызывает остановки, а шаг, читающий поле с именем render_facts из какого-либо другого списка рядом с .context.used_by или собственные факты хоста как .render_facts внутри {{ with .context }} рядом с ним, тоже вызывает остановку.

Сущность FeatureRecipe, которая рендерится один раз для границы (executionScope: boundary), здесь не проверяется — по причине, указанной в записи выше.

A template reads its targets’ render facts without declaring it (Шаблон читает факты рендеринга своих целей, не объявив этого)

Шаблон в сущности FeatureRecipe, присоединённой к компоненту, читает render_facts внутри .context.uses — то, что компоненты, с которыми связан хост присоединения, сообщили о собственном рендеринге, — а 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 (<reference>, записано в <field>))

Ссылка приводится так, как её записал шаблон: полностью под псевдонимом одного подключения — .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 (шаблоны присоединений, читающие факты рендеринга компонентов, с которыми связан их хост, не объявив этого)

Как исправить: задайте readsTargetRenderFacts: true в spec сущности FeatureRecipe — readsCallerRenderFacts: true эту остановку не устраняет, поскольку помещает факты в компоненты, подключающиеся к хосту, а не в те, с которыми он связан. Это рендерит её присоединения после рендеринга всех компонентов и помещает факты каждой цели в её подключение, больше ничего не меняя в том, что они рендерят, — см. страницу сущности FeatureRecipe. Контрактом является ключ, а эта остановка лишь помогает найти шаблон, которому он явно нужен: проверка читает шаблон в том виде, в каком он написан, поэтому ссылка, построенная во время выполнения шаблона, или ссылка в содержимом, импортированном из файла или библиотеки, не вызывает остановки — всё равно задайте ключ в такой FeatureRecipe. Шаблон, который вообще читает .context.uses и при этом читает поле с именем render_facts из какого-либо другого значения — в том числе факты вызывающего компонента внутри {{ range .context.used_by }}, — тоже вызывает остановку; задайте ключ, а также readsCallerRenderFacts, если шаблон читает факты вызывающих компонентов.

Сущность FeatureRecipe, которая рендерится один раз для границы (executionScope: boundary), здесь не проверяется — по причине, указанной выше в записи о вызывающих компонентах.

A pipeline step reads its targets’ render facts (Шаг конвейера читает факты рендеринга своих целей)

Поле with: или when: шага конвейера в сущности FeatureRecipe, присоединённой к компоненту, читает render_facts внутри .context.uses — то, что компоненты, с которыми связан хост присоединения, сообщили о собственном рендеринге.

Шаг читает подключения, которые создаёт его хост, так же, как их читает собственная сущность Recipe хоста, и никогда не читает факты рендеринга их целей — для любой сущности FeatureRecipe, независимо от того, задаёт ли она readsTargetRenderFacts: true. Шаг может переписывать собственные документы компонента-хоста, а собственный рендеринг хоста читает то, что публикуют его цели, но никогда не то, что они вывели, поэтому шаблоны шага вычисляются без этих фактов. Поэтому шаг, читающий их, не прочитал бы ничего, и сборка останавливается до начала рендеринга, а не отображает такое чтение как пустое значение.

Выводимое сообщение:

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>) (шаг конвейера читает факты рендеринга компонента, с которым связан его хост, но шаг конвейера читает только собственные факты рендеринга хоста (<reference>, записано в <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: — с заданным readsTargetRenderFacts: true, как описано на странице сущности FeatureRecipe. Одна лишь установка ключа эту остановку не устраняет. Проверка читает шаблон в том виде, в каком он написан, с ограничениями, описанными в записи выше.

Сущность FeatureRecipe, которая рендерится один раз для границы (executionScope: boundary), здесь не проверяется — по причине, указанной выше в записи о вызывающих компонентах.

Нарушение межузловой типобезопасности через selector:

Одна остановка охватывает оба выражения меток, которые автор каталога пишет, чтобы ограничить, что можно связывать или присоединять, поскольку оба нарушаются одинаково: набор меток не удовлетворяет выражению, объявленному сущностью каталога.

Ребро uses:, цель которого не проходит selector: своего сокета. Сокет usesSchema объявляет поле selector:, исключающее целевую сущность Component, присоединённую на другом конце ребра. Селектор — способ автора каталога сказать «этот сокет принимает только цели, метки которых соответствуют этому выражению»; ребро, которое проходит поиск по имени сокета, но не проходит выражение селектора, является нарушением типобезопасности.

Выводимое сообщение:

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. (нарушение селектора: выражение селектора, объявленное на сокете, не удовлетворяется метками цели. Добавьте метки, которых требует селектор, в тип компонента цели или подключите сокет к компоненту, который уже несёт их.)

Присоединение, компонент которого не проходит appliesTo: сущности Feature. Сущность 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. (нарушение селектора: выражение appliesTo, объявленное сущностью Feature, не удовлетворяется метками компонента. Добавьте в тип этого компонента метки, которых требует appliesTo сущности Feature, или подключите Feature, условиям применимости которой компонент уже удовлетворяет.)

Любое из выражений может быть также записано в форме, которую грамматика меток вообще не может прочитать. Об этом сообщает та же остановка, последнее значение которой — причина, по которой выражение не удалось прочитать, а не набор меток, не удовлетворивший его; именно это отличает выражение, которое не удалось вычислить, от выражения, которое было вычислено и оказалось ложным:

selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity. (нарушение селектора: выражение appliesTo, объявленное сущностью Feature, не удалось вычислить. Исправьте селектор appliesTo в сущности каталога для Feature.)

Селектор сокета, который грамматика не может прочитать, тоже отклоняется ещё до того, как что-либо подключится к сокету. 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 способ исправления вместо этого называет usesSchema этой сущности Feature. К сокету ещё ничего не подключено, поэтому ошибка — в сущности каталога: она классифицируется как CATALOG_ERROR и называет файл сущности.

Остановка несёт ключ авторинга, к которому относится, — запись сокета uses: или запись features:, именующую присоединение, — вместе с файлом, который его объявляет, поэтому указываемая позиция — это запись, которую вы редактируете, а не начало документа. Сущность Component, написанная внутри подсистемы, позиционируется в подсистеме, под которой она написана, уровень за уровнем. Присоединение позиционируется в записи features:, которая его написала, в документе, который его написал, и относится к автору этого документа: собственный блок компонента или блок подсистемы в сущности Aggregate — ошибка разработчика; а для присоединения, которое создаёт только сущность Release, — её запись для компонента или блок features: границы, содержащей компонент, — ошибка оператора. Если присоединение пишут оба документа, оно позиционируется там, где назван его type, что сущность Aggregate делает всегда. Присоединение, написанное на соединении, позиционируется в своём ключе под features: этого соединения, в документе, который его написал, — в записи соединения сущности Aggregate или в записи сущности Release для ребра, если присоединение создаёт только Release. Сущность Feature, которую только Release присоединяет к компоненту, не допускаемому её объявлением, выглядит так:

[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, метки которой удовлетворяют селектору, либо скорректируйте выражение селектора в сущности каталога, чтобы оно принимало нужный класс целей. Проверьте metadata.labels целевой сущности Component с помощью aggrega inspect, чтобы убедиться, какие метки она несёт.

Как исправить нарушение присоединения: либо присоедините Feature к компоненту, метки которого допускает её объявление, либо расширьте appliesTo: сущности Feature — добавив альтернативу в appliesToAnyOf:, если Feature действительно обслуживает более одного класса компонентов. Если компонент должен подходить, но не подходит, недостающая часть обычно — метка: проверьте его с помощью aggrega inspect и добавьте то, чего требует выражение, в metadata.labels сущности Component.

Unknown provider (Неизвестный провайдер)

Сущность Recipe объявляет capability: <name>, где <name> не называет ни одного провайдера, которого обслуживает компилятор. Компилятор не может передать рендеринг провайдеру, о котором ничего не знает.

Выводимое сообщение:

unknown provider: <provider-name> (неизвестный провайдер: <provider-name>)

Как исправить: убедитесь, что имя провайдера написано правильно — cloudformation, compose, helm, helm-chart и terraform являются именами, которые обслуживают встроенные плагины провайдеров. Если вы имели в виду собственный корпоративный провайдер, убедитесь, что в рабочем пространстве каталога, на которое указывает сборка, есть рендерящая провайдер сущность Plugin, обслуживающая это имя (pluginType: provider с этим именем в её spec.provider.capabilities).

A capability is served by more than one provider plugin (Возможность обслуживается более чем одним плагином провайдера)

Сборка доходит до возможности — или pull разрешает её, — которую обслуживает более одной рендерящей провайдер сущности Plugin (pluginType: provider, каждая перечисляет эту возможность в своём spec.provider.capabilities), а рабочее пространство не выбрало, какая из них её рендерит. Вместо того чтобы выбирать провайдер произвольно, сборка останавливается и называет обоих кандидатов. Каталог, содержащий два плагина для одной возможности, допустим — два издателя могут каждый поставлять плагин для helm или compose, и каталог принимает оба. Неоднозначность проявляется только в точке использования: остановка срабатывает, когда сборка или pull действительно доходит до спорной возможности, а не во время загрузки.

Выводимое сообщение. Первым идёт правило, остановившее сборку, а за ним — подробности: какая возможность, какие кандидаты и какую привязку написать:

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 (возможность обслуживается более чем одним плагином провайдера; добавьте запись plugins.providers, чтобы выбрать один из них)

Как исправить: добавьте в конфигурацию рабочего пространства запись plugins.providers с ключом по возможности, значение которой выбирает идентичность плагина, который её рендерит. Оставьте оба плагина в федеративном каталоге; привязка сообщает этому рабочему пространству, какому из них передавать спорную возможность.

The plugin serving a provider cannot assemble what that provider combines (Плагин, обслуживающий провайдер, не может собрать то, что этот провайдер объединяет)

Провайдер сообщает, что происходит с выводом каждого узла группы диспетчеризации: вывод каждого узла записывается напрямую по пути диспетчеризации, фрагменты сворачиваются в один документ, или каждый узел помещается на собственную позицию внутри одной объемлющей структуры. Если провайдер сообщает, что вывод объединяется, — объединённый файл compose, зонтичный чарт, — обслуживающий его плагин должен предоставлять экспорт, выполняющий объединение. Эта остановка срабатывает, когда это не так: плагин объявляет поузловой рендеринг (render_node) без соответствующего assemble_boundary, поэтому узлы группы можно отрендерить, но их вывод нельзя объединить.

Обе стороны этого расхождения принадлежат плагину. То, что происходит с выводом группы диспетчеризации, — часть того, что плагин сообщает о себе при загрузке, а экспорт, который выполнял бы объединение, — одна из записей в spec.exports сущности Plugin, сверяемая с тем же отчётом, — поэтому остановка называет плагин, заявляющий сборку, которую его поверхность экспорта не предоставляет.

Сборка останавливается, а не пропускает этап объединения. Пропуск записал бы фрагмент каждого узла по пути, где ожидался один артефакт, и сообщил бы об успехе, а ничто далее не может отличить эти фрагменты от плоского поузлового вывода, который провайдер, не заявляющий сборку, выдаёт намеренно, — поэтому отсутствующий артефакт обнаружился бы там, где вывод применяется, а не во время сборки.

Группа диспетчеризации без пути диспетчеризации пропускается. Вывод, записанный без пути, является поузловым, поэтому там ничего не собирается и заявлению об объединении нечем управлять.

Выводимое сообщение — по одному результату на каждую нарушающую группу диспетчеризации, с именем провайдера и путём, по которому собирается эта группа:

provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>") (провайдер, который должен собирать свою группу диспетчеризации, не предоставляет сборщик границы (<provider>, путь диспетчеризации <path>))

Если нарушающих групп диспетчеризации больше одной, результаты приходят вместе в отчёте dispatch groups whose provider offers no boundary assembler (группы диспетчеризации, провайдер которых не предлагает сборщик границы).

Как исправить: обслуживайте возможность плагином, который объявляет и render_node, и assemble_boundary, — см. ../entities/plugin.md о поверхности авторинга spec.exports и ../schema/plugins/wasm-provider.md о том, что получает экспорт сборки. Если плагин пишете вы, согласовать обе стороны — ваша задача: добавьте экспорт сборки или не заявляйте сборку, и тогда вывод каждого узла попадёт по пути диспетчеризации без объединения. Если вы используете опубликованный плагин, выберите версию, предлагающую оба экспорта, или плагин, провайдер которого не заявляет сборку для этой возможности.

A boundary-level Feature’s output reaches no assembled file (Вывод сущности Feature уровня границы не попадает ни в один собранный файл)

Сущность Feature, привязанная под features: границы, чья сущность FeatureRecipe объявляет executionScope: boundary, рендерится один раз для всей границы, и её вывод попадает в каталог, в который для неё вычисляются собственные directory: и subDirectory: границы. Провайдер, сводящий свой вывод в один документ, — compose в один docker-compose.yaml, cloudformation в один стек, — записывает вклад такой сущности Feature только как часть файла, который он собирает там из компонентов границы. Этот файл существует, только если вывод хотя бы одного компонента попадает в тот же каталог при том же провайдере.

Его нет, если компоненты границы попадают в другое место: когда они находятся во вложенных границах, чей subDirectory: отправляет их в другое место, — скажем, "{{ .component_id }}", чтобы каждый компонент получил свой файл, — или в каталоге, который вывод сущности Feature не разделяет. В каталоге сущности Feature ничего не собирается, поэтому её вывод не был бы записан никуда — для моста compose это сервис шлюза, который не содержит ни один файл, — а сборка сообщила бы об успехе. Вместо этого сборка останавливается.

Сущность Feature, чей провайдер записывает каждый вклад отдельными файлами, — helm, helm-chart и terraform, — не затрагивается: эти файлы записываются независимо от того, собирается ли что-либо рядом с ними.

Выводимое сообщение — одна находка на каждую нарушающую сущность Feature, привязанная к её записи под features: границы и называющая границу, сущность Feature, путь диспетчеризации, куда был направлен её вывод, и провайдер:

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)

Мост compose, привязанный к родительской границе bridge, единственная дочерняя граница которой размещает каждый компонент под 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, — для дочерних границ directory: "{{ .parent_boundary.directory }}" без собственного subDirectory:, чтобы они разделяли файл родителя. Сообщение называет каталог, куда был направлен вывод сущности Feature, — именно его и нужно разделить.

Path-template references a variable outside the allowlist (Шаблон пути ссылается на переменную вне списка разрешённых)

Шаблон directory: или subDirectory: ссылается на имя переменной, которого нет в списке разрешённых переменных шаблонов путей, — например, опечатка вида {{ .parmaeters.region }} или поле, которое существует в контексте рендеринга сущности Recipe, но не доступно шаблонам путей (например, .context.inject или .values). Та же остановка срабатывает на {{ .component_id }} в шаблоне directory:: переменная существует, и шаблоны subDirectory: могут её читать, но directory: границы вычисляется один раз для всей границы, а не один раз для каждого компонента, поэтому переменная уровня компонента сделала бы итоговый путь зависимым от того, какой компонент оказался вычислен первым.

Шаблоны путей проверяются во время разбора, до начала любого рендеринга, по переменным, которые определяет контекст шаблонов путей, за вычетом тех, которые отвергает конкретная поверхность. Компилятор также вычисляет шаблоны путей с семантикой 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 }}. Другие поверхности (valuesMapping сущности Recipe, injectMapping сущности FeatureRecipe и т. д.) используют другую форму контекста; ссылки на .context.*, .values, .infra или .locals намеренно не доступны шаблонам путей, поскольку вывод путей — структурный вопрос, а не вопрос рендеринга значений.

Path collision: two contributors emit at incompatible paths (Коллизия путей: два участника выводят по несовместимым путям)

Две границы, объявления путей которых вычисляются в один путь сборки, направляются через разные провайдеры. Обе собираются там, и каждая записывает файлы, о которых другая ничего не знает, поэтому одна молча вытесняет другую на диске — а сборка, создавшая вытесненный вывод, выглядит успешной.

subDirectory: по умолчанию даёт каждому провайдеру собственный подпуть, поэтому два провайдера приходят к одному пути только там, где объявления написаны так, чтобы вычисляться одинаково: например, две границы с общим directory:, у которых subDirectory: задан одним и тем же литералом.

Выводимые сообщения. Сообщается по одному результату на каждую участвующую границу, поэтому каждая граница, вывод которой достиг пути, называется отдельно, а не сворачивается в список внутри одного сообщения. Ошибка — встреча двух провайдеров на одном пути, поэтому результатов всегда не меньше двух, и они приходят вместе в отчёте, указывающем, что у них общего:

assembly paths reached by more than one provider (пути сборки, достигнутые более чем одним провайдером)

Каждый результат называет путь, границу, вывод которой его достиг, и провайдер, через который направляется эта граница:

dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>") (путь диспетчеризации получил вывод нескольких провайдеров (<path>, граница <boundary>, провайдер <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: по умолчанию, чтобы вывод каждого провайдера попадал в собственный подпуть. Шаблон compose-bridge намеренно сводит две подграницы в один путь сборки; этот шаблон требует, чтобы обе границы были нацелены на один провайдер и несли совместимые аннотации, разрешённые каскадом.

Выходной каталог границы не является каталогом внутри корня вывода

Значения 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 (выходной каталог границы не указывает на каталог внутри корня вывода (Release "<release>", граница "<boundary>", directory: "<value>", путь вывода "<path>"). укажите каталог внутри корня вывода, например «deploy/prod», — без ведущего «/», без «..», поднимающегося выше него, и не сам корень вывода)

Если ошибка в подкаталоге, третье значение выглядит как subDirectory: "<value>".

Как исправить: запишите поле, названное в сообщении, как каталог внутри корня вывода. Каталог, который должен находиться рядом с корнем вывода, следует разместить внутри него. Чтобы записать вывод границы непосредственно в её directory:, задайте subDirectory: "." — сам каталог при этом всё равно должен указывать на собственный каталог.

Feature уровня границы называется . или ..

Провайдер, который выделяет каждому участнику собственный каталог, — terraform в modules/ и helm-chart в charts/, — помещает сущность Feature, присоединённую к границе, в каталог, названный только по имени экземпляра, рядом с компонентами границы. Ключ features: границы допускает . и .., но ни то, ни другое не является именем каталога: . поместило бы файлы Feature в каталог, содержащий всех участников, а .. — в каталог уровнем выше, так что файлы оказались бы вне позиции, отведённой провайдером для 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” (имя экземпляра Feature уровня границы не является именем каталога (Release "<release>", граница "<boundary>", feature "<instance>"). переименуйте экземпляр Feature в features границы, дав ему обычное имя, например «audit»)

Как исправить: переименуйте экземпляр в features: границы, дав ему обычное имя.

Конфликт идентификаторов экземпляров между границами, собираемыми по одному пути

Две границы, собираемые в один и тот же кортеж (путь, провайдер), вносят компоненты с одинаковыми идентификаторами экземпляров. Объединённая сборка не может различить два фрагмента компонентов: один Helm-чарт не может содержать два Deployment с именем web-server, а один файл 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 (несколько участников используют один и тот же идентификатор экземпляра по одному пути диспетчеризации: путь диспетчеризации для провайдера уже содержит узел с этим идентификатором; идентификаторы экземпляров компонентов должны быть уникальны в пределах группы сборки)

Как исправить: переименуйте один из конфликтующих компонентов в сущности Aggregate или разнесите две границы по разным путям directory:, чтобы каждый экземпляр компонента попадал в собственную сборку.

Два участника записывают один и тот же путь вывода

Два участника одной сборки создают файл по одному и тому же пути вывода. Это отличается от описанного выше конфликта идентификаторов экземпляров: компоненты названы по-разному, и сборка может их различить, — на одном пути оказываются файлы, которые они выводят. Чаще всего это происходит, когда провайдер записывает вывод участников рядом друг с другом, а не в позиции каждого компонента, так что два компонента, чьи Recipes выводят одно и то же имя файла (например, две записи artifacts: с именем main.tf), встречаются на одном пути. Собственный вывод сборщика может так же конфликтовать с файлом участника.

Конфликтуют ли два участника, выводящие одно имя файла, зависит от того, куда их помещает провайдер. Провайдер, вкладывающий каждого участника в собственную позицию в сборке, разделяет два одноимённых файла; провайдер, записывающий участников рядом друг с другом, — нет. Сравнивается итоговый путь, по которому был бы записан файл, а не имя, выведенное участником, поэтому вложенный случай не сообщается.

Сборка останавливается, а не записывает один из двух файлов, отбрасывая другой. Правильного молчаливого решения нет: переименование одного файла или добавление к нему суффикса изобрело бы имя, которого никто не задавал, а слияние их содержимого — документ, которого никто не писал. Сообщается о каждом конфликтующем пути и называется каждый участник, записывающий его, так что одна сборка показывает всю картину, а не по одному конфликту за раз.

Выводимые сообщения. Для каждого конфликтующего пути сообщается одна находка — один раз, сколько бы границ ни питало сборку, в которой он возник, — так что сборка, участники которой встретились на двух путях, сообщает об обоих, и ни один конфликт не сообщается дважды:

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 <name> для экземпляра компонента, feature <name> для feature, присоединённой к границе, и the <provider> assembly для собственного объединённого вывода сборки. Участники перечисляются в порядке имён, поэтому фраза одинакова при каждой сборке одних и тех же входных данных.

Файл, который Recipe вносит в общий вывод границы, тоже подпадает под это правило. Блок boundary: сущности Recipe записывает свои файлы рядом с собственным собранным выводом провайдера, по одному на имя файла. Несколько компонентов, объявляющих одно имя с идентичными байтами, дают один файл и никогда не конфликтуют; объявление его с разными байтами вызывает здесь конфликт с указанием файла и каждого объявившего его компонента, как и имя, которое записывает сама сборка провайдера, — например, aggrega.modules.tf для terraform, что называет the terraform assembly среди участников. Файл, объявленный несколькими компонентами одинаково и встретившийся с собственным файлом сборки, называется со всеми ними, как component <name-1> and component <name-2>.

Границы, питавшие сборку, тоже называются, причём перечисляются, а не выделяются по одной. Границы, чьи объявления directory: вычисляются одинаково, собираются как одна, и ничто в конфликте не говорит, в какой из них были объявлены встретившиеся участники, — поэтому находка перечисляет каждую границу, чьё объявление могло бы их разделить, и ни про одну не утверждает, что виновата именно она. По той же причине находка относится ко всему документу Release: указание одной границы внутри него отправило бы вас к документу, который мог ничего не внести в этот путь.

Если конфликтует более одного пути, находки поступают вместе в отчёте, указывающем их общее:

assembled output paths written by more than one contributor (пути собранного вывода, записанные более чем одним участником)

Как исправить: переименуйте выводимый файл в той Recipe, которой вы управляете, — ключ artifacts:, ключ блока boundary: или имя файла, выводимое трансляцией Workload, — чтобы они больше не встречались. Если две Recipes объявляют один общий файл и подразумевают одну и ту же конфигурацию, сделайте их объявления побайтно одинаковыми. Если два участника действительно относятся к разным выводам, задайте их границам разные пути directory:, чтобы каждая собиралась отдельно.

Одно и то же имя выводится внутри вывода более одного раза

В одной сборке одно и то же имя оказывается использовано дважды для чего-то внутри выводимых ею файлов, там, где есть место только для одного такого объекта. Это происходит двумя способами: два участника выводят одно и то же имя или собственный вывод одного участника содержит это имя дважды. Это отличается от двух описанных выше конфликтов: если участвуют два участника, компоненты названы по-разному и их файлы оказываются на разных путях, так что в структуре сборки нет ничего неправильного, — дело в имени в содержимом, например в идентификаторе, которым цель обращается к одному ресурсу, или в имени, под которым один вывод публикуется, чтобы на него ссылался другой.

Какие имена сравниваются, следует из того, что провайдер делает с выводом сборки. Если провайдер объединяет этот вывод в один документ — один шаблон стека, один файл compose, — сравниваются друг с другом имена внутри этого документа, а участник, чей вывод записывается в виде собственных отдельных файлов, остаётся вне его. Его имена ни с чьими не встречаются, поэтому между ними ничего не останавливается, и никакое переименование этого не изменит. Если же провайдер записывает вывод каждого участника в собственные файлы — рендер чарта, набор манифестов, — каждый участник сборки сравнивается с каждым другим, потому что имя в таком выводе уникально в пределах всего, что читает эти файлы как набор, а не в пределах одного файла.

Собственные ресурсы сущности FeatureRecipe следуют тем же путём, что и ресурсы её компонента-хоста, потому что присоединение вносит вклад в сборку, к которой принадлежит его хост. Поэтому, если провайдер объединяет вывод, имена присоединения сравниваются с именами компонента-хоста и каждого другого присоединения точно так же, как имена двух компонентов: все они оказываются внутри одного документа, и одно из двух равных имён вытесняет там другое. Если провайдер не объединяет вывод, ресурсы присоединения записываются в каталог, названный по компоненту, к которому оно присоединено, и его имена всё равно сравниваются с каждым участником сборки — именно здесь обнаруживается идентичность ресурса, которая должна быть уникальной в пределах кластера. Таким образом, сравнение в обоих случаях одинаково, и различается лишь то, где оказывается имя, которое было бы вытеснено.

Одну половину этой остановки всё это не затрагивает: собственный вывод одного участника, содержащий имя дважды. Это имя, использованное дважды внутри вывода, записанного одним участником, поэтому сборка останавливается, где бы этот вывод ни был записан, а две вещи, которые нужно разделить, всегда находятся внутри него.

Большинство таких имён принадлежат самому провайдеру и выводятся из экземпляра компонента и ресурса, поэтому два компонента могут прийти к одному имени всякий раз, когда совпадают части, из которых оно выводится, — и один компонент может так же прийти к одному имени дважды, когда два его собственных ресурса построены из совпадающих частей. Поскольку имя находится в байтах самого файла, сборка его не видит: провайдер сообщает выведенные им имена, а сборка их сравнивает.

Один вид имени принадлежит самой сборке, а не провайдеру, и сообщается так же: идентичность, которой помечается каждый ресурс, выводимый сущностью FeatureRecipe, и которая попадает в ваш вывод как метка aggrega.ai/component-id. Она сообщается под видом имени component-id, так что ту же строку можно найти в вашем собственном выводе. Если FeatureRecipe синтезирует свои ресурсы, по этой идентичности они и называются; если она рендерит чарт или фрагмент, предоставленный её автором, имена внутри этого рендера остаются именами компонента-хоста, и идентичность несут только метки.

Для feature, присоединённой к компоненту, она составляется из компонента, к которому присоединена feature, и ключа, указанного вами в features:, после фиксированного начала. Компонент-хост входит в значение, потому что одно имя feature, присоединённое к нескольким компонентам, выводит на каждом отдельный набор ресурсов, и каждому набору нужна собственная идентичность.

Для feature, присоединённой к границе, она составляется из имени feature и каждого сегмента пути границы, после собственного начала. В обоих местах значения составляются, а не подставляются: символ, который алфавит меток не допускает, записывается в развёрнутом виде, а не заменяется, а части соединяются последовательностью, которую не может содержать ни одна записанная часть, поэтому два различимых присоединения всегда получают две идентичности. Единственный остаток — длина: составленная идентичность, слишком длинная для значения метки, сокращается вокруг дайджеста всего значения, и две сокращённые идентичности теоретически могут совпасть. Эта остановка сообщает о таком совпадении между двумя участниками, чьи имена сравниваются, а два присоединения к одному компоненту являются двумя такими участниками везде, где провайдер их хоста собирает их вместе. О том, как строится каждая из них, см. ../providers/well-known-annotations.md.

Рендер Kubernetes сообщает собственный вид имени: имя, которое каждый ресурс, созданный его рендерингом, несёт в metadata.name. Такое имя должно быть уникальным в пределах своего kind — а для вида, который кластер хранит в пространствах имён, ещё и в пределах своего пространства имён, — а не во всём выводе, поэтому вид имени указывает, к чему из этого он относится. Он начинается с resource-names, а затем содержит kind ресурса и пространство имён, в которое попадает ресурс: то, которое ресурс указывает сам, или, если он не указывает никакого, то, которым аннотирована граница. Так, resource-names:Service--default — это имена объектов Service, попадающих в default. Вид, который API Kubernetes хранит вне всех пространств имён, — ClusterRole, StorageClass, CustomResourceDefinition, — а также пользовательский вид, который CustomResourceDefinition в том же рендере объявляет с областью Cluster, содержит только свой kind, какое бы пространство имён ни было записано в его документе: resource-names:ClusterRole — это имена всех ClusterRole в выводе. Всё, кроме букв и цифр, записывается в развёрнутом виде, а не заменяется, и две части соединяются последовательностью, которую не может содержать ни одна записанная часть, поэтому две разные пары никогда не дают один вид имени, а один только вид никогда не совпадает с видом имени из вида и пространства имён. Service и Deployment могут иметь одно имя, а два пространства имён независимо содержат одно имя вида с пространством имён, поэтому ни то, ни другое не вызывает остановки. Само имя сообщается точно так, как его записал ваш чарт, поэтому именно эту строку следует искать в шаблонах.

Поэтому два участника одного вывода, каждый из которых записывает один объект уровня кластера под одним именем, вызывают остановку, даже если Release размещает их в двух пространствах имён, потому что применение обоих записывает этот объект дважды; а один чарт, записывающий такой объект в двух разных пространствах имён, что рендер выводит как два файла, вызывает остановку как один участник, содержащий имя дважды. Вид, который ничто в рендере не классифицирует, — пользовательский вид, чей CustomResourceDefinition рендер не выводит, или документ без apiVersion, — сравнивается в пределах своего пространства имён, как вид с пространством имён, потому что ничто в рендере не говорит, что кластер хранит его вне пространства имён; поэтому два участника, записывающие один такой объект в двух пространствах имён, не встречаются.

Имена сравниваются среди участников одного вывода и никогда — между двумя выводами. Две границы являются двумя выводами, если у каждой есть собственный каталог — тот, который она указывает, или тот, который получает каждая граница, не указывающая directory:, — и ничто в сборке не говорит, применяются ли два вывода к одному кластеру или к двум: CustomResourceDefinition одного оператора, поставляемый в каждый из двух кластеров, — это одно имя в двух выводах, и это корректно. Поэтому две границы, каждая из которых записывает один объект уровня кластера под одним именем, собираются, даже если обе применяются к одному кластеру; в таком случае выводите объект только из одной из них.

Чаще всего к этой остановке приводит такая конфигурация: два Features, присоединённых к одному компоненту, каждый из которых поставляет чарт, предоставленный его автором. Оба чарта рендерятся с одним и тем же именем релиза — именем компонента-хоста, чтобы присоединение чарта не переименовывало ресурсы, которые его автор уже объявил и развернул, — а именование ресурса по имени релиза относится к самым распространённым приёмам в чартах. Со структурой вывода всё в порядке: два ресурса просто носят одно имя. Если провайдер компонента пишет отдельные документы, каждое присоединение пишет в собственный каталог, и применение обоих оставляет тот, что был применён последним; если он сворачивает свою группу в один документ, оба присоединения вносят вклад в этот документ, и одно из двух имён вытесняет в нём другое. Переименуйте ресурс в чарте, который вы контролируете, или дайте ему имя, содержащее что-то, что различает два присоединения, — причём до шаблона должно дойти именно присоединение: оба чарта рендерятся с именем релиза хоста, поэтому само по себе переименование присоединения ничего не меняет. Передайте .attachment_name в чарт через valuesMapping: сущности FeatureRecipe и задайте его в том из собственных значений чарта, из которого строятся имена его ресурсов.

Вторая конфигурация приводит к той же остановке с одним Feature вместо двух: чарт, шаблон которого записывает имя ресурса литералом, присоединён к двум компонентам. Каждый хост рендерит его под собственным именем релиза, так что литерал — единственная причина, по которой две копии носят одно имя. Назовите ресурс по .Release.Name, и хост снова войдёт в имя — именно так уже поступает чарт, строящий имена ресурсов из идентичности своего релиза.

Третья конфигурация имеет ту же форму, но на один уровень авторинга глубже: FeatureRecipe, поставляющий свои ресурсы через artifacts:, а не через чарт, присоединён под одним именем к двум компонентам, и его тело записывает имя ресурса литералом. Вывод каждого присоединения попадает в каталог, названный по его хосту, поэтому выходные пути различаются и со структурой вывода всё в порядке — но оба тела несут одно и то же имя, и применение обоих оставляет то, что было применено последним. Имя в теле artifacts сравнивается точно так же, как имя, отрендеренное чартом: оба описывают один и тот же ресурс в одном и том же кластере, поэтому происхождение имени не влияет на то, что происходит при применении обоих. Такое толкование опирается на то, что два имени читаются вместе, а это происходит, когда провайдер пишет вывод каждого участника отдельными файлами, которые целевая система читает как один набор. Если же провайдер сливает вывод сборки в один документ, файлы каждого присоединения находятся вне этого документа и имя внутри одного из них ограничено им, поэтому два таких присоединения никогда не встречаются и сборка продолжается.

Сообщается не о каждом имени, поэтому сборка, которая не остановилась, не устанавливает, что каждое имя, которое в итоге будет нести её вывод, было сравнено. Ресурс, имя которому даёт кластер, — объявляющий generateName вместо name, — пока не несёт имени, так что сообщать не о чем. А имя, записанное в какое-то другое поле, чтобы его позже прочитал контроллер, не является именем ресурса, поэтому ничто его не сравнивает. Оба ограничения следуют из чтения выпущенного документа, поэтому оба применяются к телу artifacts точно так же, как к отрендеренному шаблону чарта.

Тело artifacts: — это шаблон, поэтому имя в нём, которое должно различаться для каждого хоста, составляется, а не записывается литералом. .context.rendered_name — имя, которое даёт ему собственный провайдер компонента-хоста (в helm — имя его релиза, записанное символами, допустимыми в имени Kubernetes), а .attachment_name — ключ, под которым вы его присоединили, так что {{ .context.rendered_name }}-{{ .attachment_name }} даёт ресурсу собственное имя на каждом хосте и в каждом присоединении. На хосте, провайдер которого не сообщает такого имени, составьте его из .context.instance_id, идентичности хоста. Одно написанное тело попадает на каждый хост, к которому оно присоединено, со всеми именами, что в нём есть, и литерал на всех них одинаков — поэтому придайте такую форму имени, которое должно быть уникальным в кластере.

Смысл имени никак не интерпретируется — два сообщённых имени либо совпадают как текст, либо нет, — поэтому одно и то же сообщение охватывает все виды имён, кто бы их ни вывел.

Имя может появиться более чем в одном отчёте для одного компонента, потому что о каждой части компонента сообщается по мере её рендеринга. Это один ресурс, названный в каждом отчёте, к которому он относится, а не имя, использованное дважды, и остановки это не вызывает. Остановку вызывает один отчёт, несущий одно имя дважды, потому что такой отчёт описывает вывод, где имя действительно использовано дважды.

Это толкование зависит от того, что считается одним участником, и для вида component-id ответ — присоединение, а не компонент или граница, на которой оно находится. Присоединение идентифицируется обеими координатами, которые вы для него написали, — компонентом, к которому оно присоединено, вместе с ключом в features:, или путём границы вместе с именем на этой границе, — поэтому два присоединения на одном компоненте — это два участника, точно так же, как два на разных компонентах, а одно имя feature, записанное на двух границах, — это два участника, хотя имя на каждой одинаково. Именно то, что это два участника, делает их идентичности сравнимыми в каждой из этих конфигураций; сравниваются ли две из них вообще, определяется тем же правилом, что и для любого другого имени здесь, поэтому, если провайдер сливает вывод, присоединение, вывод которого пишется отдельными собственными файлами, находится вне слитого документа и сравнивается только само с собой. Поэтому два присоединения, пришедшие к одной идентичности, вызывают остановку везде, где их выводы могут достичь друг друга, и каждая находка называет обе свои координаты, чтобы вы могли понять, какие две вещи разделить. Поскольку обе координаты входят в составное значение, два различимых присоединения приходят к двум идентичностям при любой допустимой длине — так что к этой остановке приводит конфигурация, в которой значение, слишком длинное для своей цели, было сокращено и два сокращённых значения совпали. Если две сокращённые идентичности совпадают, а их выводы не могут достичь друг друга — два присоединения на одном компоненте при провайдере, который сливает вывод, и каждое пишется отдельными собственными файлами, — ничто их не сравнивает, и два набора ресурсов несут один aggrega.ai/component-id на двоих.

Одну конфигурацию стоит назвать прямо, потому что кажется, будто она должна вызывать остановку, но это не так: присоединение feature под одним и тем же именем к двум компонентам полностью поддерживается и не требует переименования. Компонент входит в составное значение, поэтому metrics на api и metrics на web приходят к двум идентичностям, и ресурсы каждого компонента получают собственную идентичность, — это важно, потому что каскад, который по замыслу создаёт одно имя присоединения для многих компонентов, не оставляет автору другого имени. Любой способ, которым FeatureRecipe поставляет ресурсы, ставит его идентичность на то, что он выпускает, включая способ, который лишь вендорит источник и рендерит его как есть, поэтому каждый из них сравнивается; feature, FeatureRecipe которого не выпускает ничего, сравнивать нечего.

Сборка останавливается, а не оставляет одно и отбрасывает другое. Правильного молчаливого разрешения нет: если оставить первое, объявленный вами ресурс полностью выпал бы из вывода, а сборка сообщила бы об успехе, и всё, что ссылалось на выпавший ресурс, тихо разрешилось бы в оставшийся. Сообщается о каждом конфликтующем имени, с указанием вида имени и каждого участника, который его вывел, — так что одна сборка показывает всю картину, а не по одному конфликту за раз. Участник, собственный вывод которого несёт имя дважды, называется как выведший имя более одного раза — это и говорит вам, что две вещи, которые нужно разделить, находятся внутри одного компонента, а не между двумя.

Выводимые сообщения. На каждого участника и каждое конфликтующее имя выводится одно сообщение, поэтому каждый участник, получивший это имя, назван отдельно, а не свёрнут в список внутри одного сообщения. Если имя получили два участника, сообщений будет не меньше двух, и они приходят вместе под отчётом, где указано, что у них общего:

dispatch groups whose contributors derive one name more than once in one key space (группы диспетчеризации, участники которых получают одно имя более одного раза в одном пространстве ключей)

Каждое сообщение называет имя, вид этого имени, участника, который его получил, а также провайдер и путь сборки, в которую сливается их вывод:

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>") (конфликт производных имён: одно имя получено более одного раза в одном пространстве ключей (пространство ключей, получено компонентом, несущим присоединение, провайдер, путь диспетчеризации))

Собственный рендеринг компонента — имя, которое его провайдер получил для самого компонента, а не для одного из его присоединений, — не несёт второй координаты, поэтому сообщение заканчивается именем компонента.

Если собственный вывод одного участника содержит имя дважды, этот участник — единственное сообщение, поэтому оно приходит само по себе, без отчёта над ним, и участник назван как получивший имя более одного раза, а не как встретившийся с другим участником:

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 передаёт провайдеру, или аннотации, которую читает провайдер, — измените его у того из двух, который вы контролируете. Если два участника действительно относятся к разным выводам, задайте их границам разные пути directory:, чтобы каждая собиралась отдельно и два имени никогда не встречались. Если один участник назван как получивший имя более одного раза, обе конфликтующие вещи находятся внутри этого одного компонента: найдите два ресурса, создаваемых его Recipe, имена которых совпадают, и измените то, по чему назван один из них, — ключ, под которым он объявлен, или значение, из которого он строится, — чтобы провайдер получил для каждого отдельное имя. Если вид имени — отдельный вид уровня кластера, например resource-names:ClusterRole, названные документы описывают один объект в кластере, в какие бы пространства имён они ни были помещены: выпускайте его только от одного участника — через значение, которое предлагает его чарт, например переключатель установки его определений, — или, если это должны быть два объекта, дайте одному из них собственное имя в чарте или теле, которые вы контролируете; один участник, названный для него дважды, записывает его в двух пространствах имён, и один из двух документов следует убрать.

An authored export name is one the build derives for a cross-stack reference (Заданное автором имя экспорта совпадает с тем, которое сборка выводит для межстековой ссылки)

Блок Outputs: в Recipe для cloudformation — это написанный автором код CloudFormation, и запись в нём может нести собственный Export: с Name:; это имя попадает в собранный стек ровно в том виде, в каком написано. Отдельно от этого, когда ребро uses пересекает границу, провайдер публикует потребляемое значение как Output стека с Export под именем, которое он выводит из release, границы, компонента и предоставляемого ключа. Эта остановка срабатывает там, где они встречаются: написанное вами имя совпадает с именем, которое вывод дал для той же сборки, поэтому стек объявил бы одно имя экспорта дважды из двух мест, а имя экспорта должно быть уникальным.

Останавливает только совпадение. Объявление имени экспорта в записи Outputs поддерживается, и имя, не совпадающее ни с одним выведенным, публикуется рядом с выведенными без замечаний — в любой записи, кроме того вывода стека, на котором межстековая ссылка публикует собственный экспорт для потребляемого ею ключа. Export: там вызывает остановку, если только он не несёт в точности выведенное имя; этот случай описан в разделе The output a cross-stack reference publishes on already carries an Export (Вывод, на котором публикует межстековая ссылка, уже несёт Export).

Остановка сообщает выведенное имя экспорта вместе с четырьмя частями, из которых оно построено, чтобы вы видели, какая межграничная ссылка его породила, и называет вывод стека, под которым находится ваше объявление, — с пометкой, что это имя собирает провайдер, а не имя, написанное в Recipe: провайдер строит его, кодируя компонент и запись в буквы и цифры, допустимые в логическом ID, поэтому оно не совпадает со строкой, которой был записан любой из них. Искать следует имя экспорта. Ваша запись пишет его точно так же, как остановка, — именно это и делает их коллизией, — поэтому это единственная строка, которая встречается и в сообщении, и в ваших собственных файлах.

Сравнение ограничено одним стеком: имена экспорта, которые объявляет этот стек, сопоставляются с именами, выведенными для межграничных ссылок, публикующих в него. Два стека друг с другом не сравниваются, а имя экспорта, записанное как встроенная функция CloudFormation, разрешается во время развёртывания, поэтому сравнивать нечего. С чем имя встретится среди экспортов, уже развёрнутых в учётной записи и регионе, — свойство развёртывания, которое сборка не наблюдает.

Выводимое сообщение. Условие называет вид сбоя, а собственное предложение провайдера сообщает, что произошло; окружающий отчёт также называет связываемое ребро 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: имя экспорта, которое выводит межграничная связь, уже объявлено другой записью Outputs в том же стеке: связь выводит имя экспорта для ключа provides компонента в границе Release, а другая запись Outputs того же стека уже объявляет это же имя экспорта — это объявление находится под выводом стека, имя которого собирает этот провайдер, а не написано в Recipe; каждая перекрывающая запись Outputs пишет своё имя экспорта точно так же, как остановка, поэтому поиск этого имени в ваших Recipes приведёт к записи — переименуйте объявляемое записью имя экспорта или удалите блок Export этой записи и позвольте связи опубликовать экспорт)

Как исправить: найдите в своих Recipes имя экспорта, названное в остановке, — запись Outputs, объявляющая его, пишет его идентично, — затем либо переименуйте это имя экспорта, чтобы оно больше не совпадало, либо удалите блок Export: этой записи и позвольте межстековому связыванию опубликовать экспорт самостоятельно. Удаление обычно правильно, если запись существовала для экспорта того же значения, которое потребляет ребро: провайдер и так публикует Export для этого значения, поэтому авторский ничего не добавляет. Сохраните авторский Export: и переименуйте его, если запись экспортирует значение для другого потребителя, который импортирует его под выбранным вами именем.

The output a cross-stack reference publishes on already carries an Export (Вывод, на котором публикует межстековая ссылка, уже несёт Export)

Когда ребро uses пересекает границу, провайдер публикует Export потребляемого значения на выводе стека, который он собирает для производящего компонента и предоставляемого ключа, — на том же выводе, к которому приходит Recipe для cloudformation, когда его блок Outputs: пишет запись под этим ключом. Export:, уже имеющийся на этом выводе, сохраняется, только если его Name: в точности совпадает с именем, которое выводит провайдер: это экспорт, уже опубликованный более ранней межстековой ссылкой на то же значение, так что все потребители импортируют одно имя. Любой другой Export: там вызывает остановку, потому что запись экспорта провайдера перезаписала бы написанное вами, а сохранение вашего оставило бы всех потребителей импортирующими имя, которое ссылка никогда не публиковала.

Остановка срабатывает на четырёх формах Export: на этом выводе:

  • Name:, являющийся другой строкой;
  • Name:, записанный как встроенная функция CloudFormation, которая разрешается во время развёртывания, поэтому провайдер не может прочитать, что она означает;
  • блок Export:, не называющий ничего;
  • Export:, записанный как простое значение, а не как блок.

Имя экспорта, объявленное вами в любой другой записи Outputs, сравнивается отдельно, см. An authored export name is one the build derives for a cross-stack reference (Заданное автором имя экспорта совпадает с тем, которое сборка выводит для межстековой ссылки).

Выводимое сообщение. Условие называет вид сбоя, а собственное предложение провайдера сообщает, что произошло; окружающий отчёт также называет связываемое ребро 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, который связь не писала: связь выводит имя экспорта для ключа provides компонента в границе Release, а вывод стека, который этот провайдер собирает для этого ключа и компонента, — см. ниже; удалите блок Export этой записи и позвольте связи опубликовать экспорт, который импортируют все потребители)

<what-it-found> — одно из следующего, в порядке перечисленных выше форм:

already declares the export name <name> (уже объявляет имя экспорта) 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 (уже объявляет имя экспорта, не являющееся строкой, — заданное встроенной функцией, которая разрешается во время развёртывания, поэтому этот провайдер не может его прочитать) already carries an Export block declaring no export name (уже несёт блок Export, не объявляющий имени экспорта) already carries an Export that is not a block, where CloudFormation expects one carrying a Name (уже несёт Export, не являющийся блоком, тогда как CloudFormation ожидает блок с Name)

Как исправить: в Recipe компонента, названного в остановке, найдите запись Outputs под названным предоставляемым ключом и удалите блок Export: этой записи — тогда межстековое связывание опубликует экспорт, который импортируют все потребители. Если значение нужно экспортировать также под собственным именем, для потребителя вне этой сборки, напишите этот Export: в записи Outputs под другим ключом: имя экспорта там поддерживается, если только это не имя, которое выводит сборка.

Chart-name mismatch on a merged helm-chart umbrella (Несовпадение имени чарта в объединённом зонтичном чарте helm-chart)

Две или более границы вносят вклад в один и тот же путь сборки провайдера helm-chart, но их действующие аннотации aggrega.ai/chart-name (разрешаемые через каскад аннотаций границ) не совпадают. У зонтичного чарта Helm ровно одно имя чарта; рендерер не может выбрать одного из конфликтующих кандидатов.

Выводимые сообщения. Для каждой участвующей границы выдаётся отдельная находка, содержащая значение, в которое разрешилась эта граница, поэтому расходящиеся имена приходят по одному на находку, а не одной выведенной коллекцией. Отчёт, в котором они приходят, указывает их общее:

merged dispatch groups whose boundaries disagree on the assembly name (объединённые группы диспетчеризации, границы которых расходятся в имени сборки)

Каждая находка называет значение, в которое разрешилась граница, аннотацию, из которой оно прочитано, границу, провайдер и путь, в который они объединяются:

merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>") (сборка по объединённому пути имеет конфликтующие значения аннотации имени сборки)

Как исправить: объявите совпадающую аннотацию aggrega.ai/chart-name на каждой участвующей границе (механизм каскада избавляет от повторения, если у участников общая родительская граница — объявите один раз на родителе) или разнесите границы по отдельным путям directory:, чтобы каждая получила собственный зонтичный чарт.

FeatureRecipe template references a field outside its scope’s allowlist (Шаблон FeatureRecipe ссылается на поле вне разрешённого списка своей области)

FeatureRecipe с executionScope: boundary ссылается на поле, существующее только для компонента, например .context.instance_id, .context.inject или .context.uses, — у таких полей нет осмысленного значения на уровне границы, — в шаблоне, который выполняется один раз для границы: в своих locals:, provides:, valuesMapping:, artifacts: или в with: либо when: шага конвейера. Верно и зеркальное условие: FeatureRecipe с областью компонента (по умолчанию), ссылающийся на поля .boundary.*, не проходит тот же валидатор. Проверка выполняется на этапе разбора по списку разрешённых полей соответствующей области, до начала любого рендеринга. injectMapping сущности FeatureRecipe с областью границы здесь не проверяется: он выполняется один раз для каждого компонента, до которого доходит привязка, в контексте этого компонента, поэтому читает .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>") (шаблон FeatureRecipe ссылается на поле только для компонента при executionScope: boundary)

FeatureRecipe с областью границы, чей valuesMapping читает .context.instance_id, выводит:

[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")

Как исправить: перепишите шаблон с использованием полей, доступных в данной области, или измените executionScope у FeatureRecipe. Сущности FeatureRecipes с областью boundary обращаются к .boundary.path, .boundary.boundary_name, .boundary.components, коллекциям .boundary.*_uses_edges, .boundary.labels, .boundary.annotations и .boundary.feature_attachments. Сущности FeatureRecipes с областью Component обращаются к .context.instance_id, .context.inject, .context.uses, .context.labels, .context.annotations. Обе области совместно используют .values, .infra, .locals, .provides, .steps и .metadata. Параметр Release не является отдельной опорой на этой поверхности — он попадает в шаблон FeatureRecipe через запись values или infra, которая на него ссылается.

Self-inject value template references cross-node data (Шаблон значения самоинъекции ссылается на данные других узлов)

Шаблон value: в inject: уровня компонента берёт данные из .context.inject или .context.uses. Канал инъекций — именно то, что строит этот проход, поэтому шаблон внутри собственного значения самоинъекции компонента не может из него читать.

Причина — в .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.

Отсутствующий ключ шаблона — асимметричная политика

Обработка отсутствующего ключа зависит от поверхности шаблона. Там, где пустой результат попадает в ограниченное место — в поле манифеста, которое автор может перечитать, — промах допускается, и чтение ничего не выводит. Там, где пустой результат привёл бы к неверной структуре или неверному вердикту, поверхность отклоняет ссылку, а не разрешает её в пустоту.

  • Интерполяция параметров в Aggregate — ссылки {{ .parameters.<key> }}, которые содержит собственный текст сущности Aggregate, — самая ранняя из этих поверхностей: она выполняется над исходным документом до разрешения каталога, поэтому её политика применяется к тексту, который ещё не видела ни одна другая поверхность. Ссылка на параметр, который сущность Release так и не заполнила, выводится как пустота, а конвейер default или условие if над таким чтением ведут себя точно так же, как над незаполненным параметром. Ссылка, по которой шаблон итерирует, продолжает итерироваться как пустота, что и нужно при обходе необязательного списка, — если только текст её также не выводит: в этом случае сборка останавливается, как описано ниже в «A template reads and iterates a path that holds nothing (Шаблон читает и перебирает путь, в котором ничего нет)». Ссылка, у которой отсутствует родитель, — .parameters.db.host, когда параметр db не заполнен, — по-прежнему останавливает сборку, потому что спускаться некуда, а подстановка родителя заменила бы остановку незаметно неверным артефактом. Одно ограничение стоит назвать именно ограничением, а не политикой: ссылка, привязанная к корню, который поверхность не определяет, остаётся нетронутой, а не выводится как пустота, поэтому она попадает в интерполированный документ в виде собственного текста-заполнителя шаблонизатора, <no value>. Ничто на этой поверхности не останавливает на ней сборку, поэтому привязывайте каждую ссылку на параметр к .parameters, а случайный <no value> считайте опечаткой в корне.
  • Шаблоны путей (directory: / subDirectory: границы в Release) вычисляются с missingkey=error. Ссылка на переменную, которую поверхность им не предоставляет, останавливает сборку на этапе разбора — см. «Path-template references a variable outside the allowlist (Шаблон пути ссылается на переменную вне списка разрешённых)» выше, — как и опечатка в ключе под .manifest, ключи которого объявлены. Разрешённая, но не определённая на момент вычисления ссылка, например ключ .parameters, который Release не предоставляет, приводит к явной ошибке, а не к незаметной подстановке пустой строки в путь каталога.
  • assertions (в Component, Feature, Recipe или FeatureRecipe) вычисляются с missingkey=error. Ссылка на неопределённый ключ останавливает сборку с диагностикой об отсутствующем ключе, в которой названы сущность, экземпляр и утверждение. Именно строгость делает утверждение надёжным: предикат, чья ссылка выведена как пустое значение, сравнивался бы с пустотой и проходил, так что одна опечатка незаметно отменила бы правило, ради которого написано утверждение. Поскольку голая ссылка останавливает сборку до того, как может сработать запасное значение, простой default не обеспечивает запасное значение для необязательного поля на этой поверхности — защитите ссылку с помощью hasKey или используйте вспомогательную функцию optional, которая сама выполняет проверку наличия. Чтение ключа через index тоже его не обеспечивает: index останавливает сборку на ключе, которого нет в отображении, называя этот ключ.
  • Шаблоны значений (valuesMapping в Recipe, записи locals: и provides:, тела artifacts:, тела Workload, injectMapping и pipeline.with в FeatureRecipe, а также шаблоны value: самовнедрения на уровне компонента) вычисляются с missingkey=zero, поэтому ссылка на неопределённый ключ не останавливает сборку — чтение ничего не выводит, и в артефакт попадает пустота. На этой поверхности всё же останавливает сборку ссылка, спускающаяся через контейнер, который автор не предоставил, — .values.tls.ca, когда tls не задан, — потому что спускаться некуда. Как пустота выводится только последний ключ ссылки, все контейнеры которой присутствуют. Поле верхнего уровня, которое контекст определяет, но в котором ничего нет, — .workload в сущности Recipe, которая ничего не синтезирует, .features у компонента без присоединений, — так же выводится как пустота при чтении целиком. Одна ссылка остаётся одной ссылкой, как бы она ни была написана: .values.list, $.values.list и (.values).list называют один и тот же ключ, поэтому перебор в одном написании — это перебор во всех, а ключ, читаемый из столпа в скобках, выводится или останавливает сборку точно так же, как при прямом написании. Ключ, по которому шаблон итерирует, продолжает итерироваться как пустота, если он не задан, а ключ, который шаблон и выводит, и перебирает, останавливает сборку, если он не задан, — см. «A template reads and iterates a path that holds nothing (Шаблон читает и перебирает путь, в котором ничего нет)» ниже. Защита работает ожидаемо: {{ .values.optional_field | default "fallback" }} действительно подставляет запасное значение, потому что незаданное значение считается пустым для default и ложным для if. Авторы, которым нужно различать отсутствие и нулевое значение — отличать «ключ отсутствует» от «ключ присутствует и пуст», — используют вспомогательную функцию optional, описанную в templates/sprig-functions.md, и читают каждый ключ одним способом в пределах шаблона: ключ, который тот же шаблон читает и как .values.<key>, считается присутствующим, поэтому optional возвращает его пустое значение, а не запасное. Эта политика не распространяется на чтение через index: индексация отображения ключом, которого в нём нет, останавливает сборку с указанием ключа здесь, как и на любой поверхности, — см. «A template indexes a map with a key the map does not hold (Шаблон индексирует отображение ключом, которого в нём нет)» ниже.
  • Координата source: — шаблонизируемые поля структурированного блока source: в Recipe или FeatureRecipe (version, ref, chart, module_subdir) — вычисляется с missingkey=error. Ссылка на ключ, который ничто не предоставляет, останавливает сборку с указанием поля источника, а не разрешается в пустоту: пустые version или ref закрепили бы другой артефакт, чем тот, что указал автор, а закрепление воспроизводит каждая последующая сборка. На этой поверхности также отличается доступный набор функций, и здесь ссылка в locals:, которую отклоняет авторский порядок самого блока, останавливает сборку до любого вычисления — см. ниже.
  • Типизированные контракты параметров перехватывают случаи отсутствия обязательного параметра и нарушения контракта на уровне контрактов параметров, до запуска интерполяции, — см. «Parameter type mismatch / contract violation (Несоответствие типа параметра / нарушение контракта)» выше.

Набор вспомогательных функций одинаков для шаблонов значений, шаблонов путей и утверждений: функции Sprig плюс собственные функции Aggrega (optional и capitalizedWords). Среди них есть fail из Sprig, поэтому шаблон значения может остановить сборку собственным сообщением, как описано ниже в разделе «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 или предоставьте отсутствующий ключ как типизированное объявление parameters.* в Aggregate со значением из Release, как запись provides: вышестоящего Component, подключённую через uses[].inject, или как запись locals: в той же сущности.

Resolving a source: coordinate registers a narrower function set (Разрешение координаты регистрирует более узкий набор функций)

Структурированный блок source: разрешается, чтобы закрепить названный в нём артефакт, и это разрешение регистрирует собственные вспомогательные функции Aggrega и ничего больше: optional и capitalizedWords доступны, а index останавливается на ключе, которого нет в карте, точно так же, как при рендеринге сущности Recipe; функции Sprig недоступны. Среди поверхностей, на которых сущность Recipe или FeatureRecipe задаёт шаблоны, только у этой отличается набор функций, поэтому выражение, которое корректно рендерится в другом месте того же Recipe, здесь может быть отклонено. Более узкий набор выбран намеренно: то, что закрепляется, определяется значениями и infra, которые задаёт автор, а среди функций Sprig есть такие, что читают часы, окружение, источник случайности или сеть.

Вызов функции Sprig в поле source: или в записи locals:, которую это поле читает, приводит к остановке на этапе разбора. Диагностика начинается с 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 (разбор шаблона в .spec.locals, читаемого .spec.source: ошибка разбора шаблона источника (причина: функция не определена); поле источника и каждая читаемая им запись locals вычисляются при разрешении источника только с собственными вспомогательными функциями Aggrega (optional, capitalizedWords и index), без функций Sprig, добавляемых при рендеринге; запишите значение без этой функции или перенесите его в запись locals, которую не читает ни одно поле источника)

Поле source:, само вызывающее функцию, сообщается так же, но называется только поле.

Охват — это записи, которые читает координата. Разрешение координаты вычисляет каждую запись locals:, которую читает поле source:, и каждую запись, которую в свою очередь читает такая запись, — и никакие другие. Запись, до которой не доходит ни одно поле source:, при разрешении источника не вычисляется, не разбирается и не проверяется, поэтому локальное значение, нужное рендерингу, — выполняющее арифметику с функциями Sprig или называющее ресурс по .context.instance_id, — не влияет на закрепление артефакта; оно вычисляется, и любая ошибка в нём сообщается, при рендеринге 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 и отклоняется в другом:

  • source:, записанный простой строкой, — URI или локальный путь, а не отображение, — берётся дословно, поэтому у него нет полей для вычисления, и блок locals: здесь вообще не разрешается.
  • Сущность без source: не разрешает координату, поэтому её блок locals: разрешается только для собственного рендеринга этой сущности, где действует полный набор функций.

Контракт порядка ссылок здесь тот же для каждой записи, которую читает координата. Разрешение координаты отклоняет в каждой вычисляемой записи те же ссылки, что отклоняет рендеринг: запись, читающую соседнюю запись, объявленную в блоке ниже, и любой шаблон, читающий ключ, которого блок не объявляет. Обе ситуации сообщаются как условия, описанные выше в разделах «locals: entry references a sibling defined later in the same block» и «locals: key does not exist», — то же условие с тем же решением, какое бы разрешение ни достигло его первым, — и в сообщении называется поле 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") (вычисление шаблона в .spec.source: ошибка вычисления шаблона источника во время блокировки (причина: в карте нет записи для ключа); поле читает .spec.locals, которое здесь не удалось вычислить (причина: в карте нет записи для ключа))

Ни поле 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) (шаблон версии источника ссылается на .provides, что является недопустимой обратной ссылкой (locals питают provides, никогда наоборот) — переработайте его, чтобы он читал только .values и .infra (и .locals поверх них): шаблон источника ссылается на .provides (недопустимая обратная ссылка))

Где возникает остановка: во время заполнения или обновления lock-файла — aggrega pull или сборка, которая его заполняет (--auto-pull, --upgrade или параметр рабочего пространства auto_pull). Каждый сбой сообщается одной диагностикой с заголовком в виде кода произошедшего — E0111 для шаблона, который не разбирается, E0112 для ссылки на .provides, E0110 для шаблона, который разобрался, но не смог быть вычислен, — одинаково в терминале и в редакторе, подключённом к aggrega serve. Отсутствующий ключ в поле source:, в отличие от недоступной функции, сообщается во время выполнения, а не разбора, с указанием поля и ключа, который не удалось прочитать.

Как исправить: optional зарегистрирована на этой поверхности и в каждом шаблоне значений, шаблоне пути и утверждении, что делает её переносимым выбором: {{ optional .values "chart_version" "25.0.8" }} вместо {{ default "25.0.8" .values.chart_version }}. Перед заменой учтите семантическую разницу: optional срабатывает, когда ключ отсутствует, а default — когда значение пустое, поэтому ключ, заданный как пустая строка или ноль, сохраняет заданное значение при optional и заменяется при default. Если выражению действительно нужна функция Sprig — чтобы преобразовать строку, а не подставить запасное значение, — вынесите её за пределы того, что читает координата: в запись locals:, которую не читает ни одно поле source:, или на поверхность, которая её потребляет (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 (шаблон: выполнение в: ошибка вызова index: шаблон обращается к словарю по ключу, которого в словаре нет (ключ). читайте ключ, который может отсутствовать, через функцию, которая сначала проверяет его наличие, например optional, get или hasKey)

На поверхности, которая сообщает о сбое шаблона под собственным условием, — запись provides: («A provides: template could not be evaluated (Не удалось вычислить шаблон provides:)»), интерполяция параметров («A {{ .parameters.* }} reference cannot be interpolated (Ссылку невозможно интерполировать)»), предикат схемы («An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Предикат x-aggrega-when: или x-aggrega-validate: невозможно вычислить)»), координата source: («Resolving a source: coordinate registers a narrower function set (Разрешение координаты source: регистрирует более узкий набор функций)») — заголовок содержит код этого условия, а строка выше служит указанной в нём причиной, включая ключ.

Как исправить: решите, может ли ключ обоснованно отсутствовать.

  • Может. Читайте его через функцию, которая сначала проверяет его наличие: {{ optional .values "replicas" 1 }} возвращает запасное значение, если ключ отсутствует, и значение, каким бы оно ни было, если он есть; get из Sprig возвращает пустую строку для отсутствующего ключа; hasKey проверяет без чтения. optional зарегистрирована на всех поверхностях, кроме интерполяции параметров и предикатов параметра или схемы, где доступны get и hasKey из Sprig; координата source: регистрирует optional, но не Sprig.
  • Не может. Задайте его. Ключ, названный в сообщении, — тот, который запросил шаблон, поэтому обычные причины таковы: ключ опубликован под другим именем (учётные данные, чей key не совпадает с именем переменной, которое читает Recipe), ключ написан с ошибкой в шаблоне или в заданных значениях, либо соединение, которое доставило бы ключ, не подключено.

A template reads and iterates a path that holds nothing (Шаблон читает и перебирает путь, который ничего не содержит)

Шаблон выводит путь как есть и одновременно перебирает тот же путь — скажем, "user": "{{ .values.user }}" и "users": "{{ range .values.user }}…{{ end }}" в одном valuesMapping, — а данные там ничего не содержат: ключ не задан, содержит null или является полем верхнего уровня, которое контекст определяет, но для которого ничего не содержит, например .workload в сущности Recipe, не синтезирующей никакой рабочей нагрузки. Сборка останавливается до выполнения шаблона и называет путь — на каждой поверхности, которая рендерит незаданное значение как пустое: в шаблонах значений, перечисленных выше в разделе «Missing template key — asymmetric policy (Отсутствующий ключ шаблона — асимметричная политика)», и в интерполяции параметров в сущности Aggregate.

Каждое чтение по отдельности имеет ответ. Выводимое незаданное значение рендерится как пустое, а перебираемое не даёт ни одной итерации. Путь, читаемый обоими способами, не может иметь ни того, ни другого ответа: рендеринг его как пустого привёл бы к сбою range на тексте, а оставление его незаданным вывело бы в артефакт текст-заполнитель шаблонизатора <no value>, при том что сборка завершилась бы успешно. Поэтому ни один ответ не даётся, и вместо этого сборка останавливается.

То, что считается выводом пути, определено узко, и граница проведена там, где шаблон заведомо его выводит:

  • Путь выводится, когда действие состоит из пути и ничего больше — {{ .values.user }}, {{ $.values.user }}, {{ (.values).user }} или переменная, привязанная к пути, {{ $u }} после {{ $u := .values.user }}, — в точке, которой шаблон достигает при каждом выполнении.
  • Путь не выводится, когда чтение находится в теле if, with или range либо в ветви else, потому что выполнится ли это чтение, зависит от условия, а условие может быть именно той проверкой, которая не даёт ему встретить пустоту, — поэтому {{ if .values.user }}{{ .values.user }}{{ end }} рядом с range .values.user рендерится как прежде. Не выводится он и тогда, когда чтение является собственной проверкой охранного условия, присваиванием переменной или аргументом функции — {{ .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 (Шаблон не удалось вычислить)», поэтому там заголовок содержит код того условия, а строка выше — это причина, которую он содержит, включая путь.

Как исправить: определите, какое из двух чтений имеет в виду шаблон.

  • Путь должен существовать. Задайте его — в values: сущности Aggregate, в infra: сущности Release или в параметре, который заполняет сущность 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:, — был разобран, начал выполняться и остановился, не выдав текста. Остановила его собственная причина шаблонизатора, которую остановка несёт под собой: ссылка, спускающаяся через контейнер, который ничем не предоставлен, например {{ .values.tls.ca }}, когда tls не задан; сравнение значений двух типов, например {{ if eq .context.instance_id 1 }}, которое сравнивает текст с числом и останавливается с cannot compare text with a number; или вызов fail из Sprig, который шаблон значения может сделать, чтобы отклонить входные данные собственным сообщением.

Четыре вида ошибок в этих шаблонах вместо этого сообщаются под собственными условиями. Запись 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>. Сборка сообщает об остановке с тегом CATALOG_ERROR, потому что шаблон написан автором сущности Recipe или FeatureRecipe. aggrega pull сталкивается с той же ошибкой, когда рендерит сущность Release, чтобы обнаружить читаемые ею внешние входные данные: он сообщает об ошибке, всё равно записывает закрепления зависимостей в lock-файл и сообщает, что закрепления внешних входных данных могут быть неполными; сборка на этом останавливается.

Как исправить: прочитайте причину шаблонизатора в конце отчёта — она называет шаблон, строку и столбец, а также выражение, на котором он остановился. Для контейнера, который ничем не предоставлен, предоставьте его или защитите чтение, чтобы оно никогда не спускалось в отсутствующее: {{ 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 — один и тот же ключ во всех ролях, и каждая роль сначала сверяет его со схемой. Роль преобразования выполняется там, где сборка её применяет, а в сборке, которая сначала выполняет pull, — во время этого pull, поэтому сообщение там начинается с шага, который её вызвал, как в 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 (ir-verdict: плагин: with.settings не удовлетворяет объявленной плагином схеме настроек: настройки подключения политики не удовлетворяют объявленной плагином схеме настроек)

Для подключения, заданного в роли render-verdict, начальная часть содержит эту роль. То, что обнаружила проверка схемы, — собственный отчёт валидатора схемы, и он занимает больше одной строки.

Как исправить: исправьте настройки в with.settings этого подключения в plugins.governance. Подробности в середине сообщения называют ошибочный ключ и то, что схема ожидала в этом месте; объявленные плагином настройки описаны в его собственной документации.

A pipeline step failed (Шаг конвейера завершился с ошибкой)

Сущность FeatureRecipe может объявлять конвейер: последовательность шагов, каждый из которых вызывает экспорт плагина над документами, выданными узлом, чтобы сущность Feature могла преобразовывать вывод, созданный собственной сущностью Recipe компонента. Под этим условием шаг сообщает о сбое по любой причине, кроме патча, адресующего то, чего нет в наборе документов, — для этого случая ниже есть отдельный отчёт.

Сбойный шаг называется по его id и индексу, а следующая за ними часть сообщения указывает, что именно не удалось: рендеринг входных данных with шага, сам вызов, вывод, который хост не смог прочитать, ошибка, возвращённая плагином, диагностика уровня ошибки, выданная плагином, патч, отклонённый движком патчей, или патч, указывающий область видимости, которой нет в обходе.

Сбойный шаг откатывается целиком. Документы восстанавливаются в состояние до запуска шага, а собственные выходные данные шага отбрасываются вместе с ними, поэтому when или with последующего шага не может прочитать частичный результат. Шаг, объявленный с optional: true, после этого сообщает о сбое как о предупреждении, и обход продолжается; шаг, не являющийся необязательным, останавливает сборку. Чего 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: шага, и исправлять его вам. Диагностика ошибки — это собственные слова плагина о ваших входных данных. Отклонённый патч и неизвестная область видимости — это вывод плагина, не соответствующий тому, что выдал узел, и они на ответственности автора плагина. Если шагу действительно допустимо завершаться сбоем — это необязательное обогащение, а не обязательное преобразование, — объявите его с optional: true, помня, что это допускает сбой, но не нарушенный контракт.

A pipeline step’s typed input or output does not satisfy its declared contract (Типизированные входные или выходные данные шага конвейера не соответствуют объявленному контракту)

Экспорт плагина может объявлять схему для принимаемых входных данных и для возвращаемых выходных. Проверяется и то, и другое: отрендеренное значение with — до вызова, возвращённые выходные данные — после него. Диагностика с уровнем серьёзности, не объявленным в общем контракте, отклоняется на тех же основаниях.

Это останавливает сборку даже для шага, объявленного с optional: true, и именно это различие объясняет, почему условие отделено от сбоя шага. Необязательность допускает шаг, который не смог выполнить свою работу, — неудавшийся вызов, возражение плагина. Она не допускает вывод, который хост не может направить, или входные данные, никогда не имевшие той формы, которую, по словам экспорта, он принимает: объявленный контракт — это обязательство, и сборка, молча пропустившая шаг с нарушенным контрактом, сообщала бы об успехе над сущностью 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 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

Если шаблон 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».

Как исправить: при нарушении входных данных исправьте блок with: шага в соответствии со схемой, объявленной его экспортом, — подробности называют поле и ожидаемое значение. Нарушение выходных данных и необъявленный уровень серьёзности исправляет плагин; ошибка не в объявлении шага, поэтому пометка шага как необязательного не устранит ни то, ни другое.

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>"

У документа нет дерева для адресации. У некоторых единиц нет структуры, в которую может указывать патч, — двоичное содержимое, свободный текст, область, которую провайдер не может безопасно обойти. Такая единица всё равно передаётся шагу с пометкой её типа медиа и байтами, чтобы её можно было выбрать и выдать целиком; применить к ней патч нельзя, потому что пути не на что разрешаться. Патч к такой единице останавливает обход, а не пропускается молча:

pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>"

Что считается структурированным, определяет собственное прочтение единицы провайдером, а не фиксированная проверка, поэтому одно и то же содержимое может быть адресуемым у одного провайдера и непрозрачным у другого.

Оба случая — собственные отказы обхода, и сборка сообщает о них для узла, конвейер которого применил патч, поэтому сообщение выше приходит под остановкой, называющей этот узел. Эта остановка — останавливающая сборку форма тех же двух ошибок адресации, описанная ниже в разделе «A pipeline step addresses documents the node does not have (Шаг конвейера адресует документы, которых нет у узла)», — там же рассмотрен третий адрес, по которому шаг может ничего не достичь: запрос документов хост-компонента в месте, которое ни с одним не связано.

Как исправить: оба случая на ответственности автора плагина, а не вашей. Шаг получает набор документов, над которым выполняется, и может прочитать, какие ключи в нём есть, поэтому отсутствующая цель означает, что шаг адресует документ, который этот узел не выдал, — примените патч к существующему документу или сначала выдайте нужный документ и примените к нему патч на более позднем шаге. Для непрозрачной единицы замените патч выдачей всей единицы: непрозрачное содержимое заменяется, а не редактируется.

Операция test патча не совпала с документом

Патч может содержать операцию test, которая утверждает, что находится по пути, прежде чем будут применены следующие за ней операции. Движок отклоняет весь патч, если утверждение не выполняется, — именно это делает условный патч условным, а не оптимистичным: плагин, который проверяет перед правкой, тем самым говорит, что не тронет документ, который он не распознаёт.

Под этим условием сообщается о двух ситуациях. По пути нет вообще ничего — об этом говорит сообщение. Или значение есть, но не то, что утверждалось, — тогда выдаётся голый отказ: ни утверждённое, ни найденное значение не приводится.

Выдаваемые сообщения:

jsonpatch: test operation failed: no value at path (jsonpatch: операция test не выполнена: по пути нет значения) jsonpatch: test operation failed (jsonpatch: операция test не выполнена)

Если патч пришёл в выводе шага конвейера, отказ появляется под сбоем этого шага с указанием шага. Если патч пришёл от плагина преобразования меток, отказ появляется под отказом патча меток.

Как исправить: ошибка в плагине, а не в ваших документах. Проверка, ожидавшая значение, которого в документе нет, обычно означает, что плагин работает со структурой, для которой он не написан, — с выводом другого провайдера или с документом, который уже изменил более ранний шаг того же конвейера. Если исправлять патч вам, либо ослабьте проверку до того, что документ действительно содержит, либо сделайте так, чтобы условие when шага пропускало этот случай, вместо проверки внутри патча.

Форма workload: и поля рядом с ней не согласуются

workload: объявляет form: — форму запускаемого объекта, выраженную в понятиях, понятных любой цели, а не в словаре какой-то одной цели. Некоторые поля имеют смысл только для одной формы, а форме, объявленной без нужного ей поля, нечего связно отрисовать. Проверяются оба направления, до того как какая-либо цель переведёт workload, поэтому о несогласованности сообщается один раз относительно написанного вами, а не по разу на каждую цель в её собственных формулировках.

Проверяются пять сочетаний, и каждое выдаёт собственное предложение, называющее обе половины и то, что нужно написать:

workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful (workload объявляет том persistentTemplate, но не имеет form: stateful; объявите form: stateful) workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at (workload имеет form: reference, но не объявляет endpoint; задайте в endpoint внешний хост или URL, на который указывает ссылка) workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint (workload объявляет endpoint, но не имеет form: reference; объявите form: reference или удалите endpoint) workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) (workload имеет form: scheduled, но не объявляет schedule; задайте в schedule cron-выражение из 5 полей или @-макрос, например @daily) workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule (workload объявляет schedule, но не имеет form: scheduled; объявите form: scheduled или удалите schedule)

Каждое сообщение привязано к экземпляру компонента, workload которого читался, и считается ошибкой трансляции, поскольку несогласованность возникает между двумя полями одного написанного блока.

Условия, под которыми они записываются и в которые разрешаются их короткие коды: persistentTemplate volume requires form: stateful, form: reference requires an endpoint, endpoint requires form: reference, form: scheduled requires a schedule и schedule requires form: scheduled.

Одно сочетание действует только в одну сторону. Workload с form: stateful без шаблона заявки на реплику — обычное дело и ничего не вызывает: правило состоит в том, что шаблону заявки нужна стабильная идентичность каждой реплики, которую даёт только эта форма, а не в том, что форме нужен шаблон заявки. Два других сочетания действуют в обе стороны, поскольку у endpoint и у schedule есть ровно одна форма, на которой они что-то значат.

Обе пары с endpoint есть и в схеме Workload, поэтому workload, нарушающий любую из них, отклоняется на этапе схемы, под E0214, раньше, чем дойдёт до своего предложения выше. endpoint: в любой форме, кроме reference, — включая опущенный form:, поскольку он читается как stateless, — отклоняется как

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here (проверка workload не пройдена на этапе схемы: значение endpoint соответствует форме, которая здесь не допускается)

а form: reference без endpoint: вместо этого заканчивается на .endpoint: missing required property: endpoint. Способ исправления — тот, что даёт предложение этой пары.

Как исправить: каждое предложение называет оба поля и даёт оба варианта ответа. Добавьте поле, нужное форме, или смените форму на ту, к которой относится поле, или удалите поле, если оно осталось после правки: удаление значения schedule: с сохранением ключа — самый частый случай.

Значение schedule: у workload не является выражением, которое принимает проверка

Workload с form: scheduled содержит schedule:, указывающее, когда он запускается, и значение проверяется на структуру до того, как его прочтёт какая-либо цель. Принимаются два варианта записи: один из пяти макросов @hourly, @daily, @weekly, @monthly и @yearly или выражение crontab из пяти полей, в которых используются только цифры и символы *, ,, - и /.

Что проверка читает и чего не читает. Она считает поля и смотрит на символы в них. Она не вычисляет диапазоны, арифметику шагов и названия дней недели, поэтому выражение из пяти полей с числами вне диапазона здесь проходит, и отклонять его — дело цели. Выражение из шести полей с ведущим полем секунд отклоняется: эта поверхность принимает пять полей, а цель, которой нужны секунды, получает их другим способом.

Выводимое сообщение:

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 у workload не является допустимым cron-выражением; используйте выражение crontab из 5 полей, например «0 0 * * *», или один из @hourly, @daily, @weekly, @monthly, @yearly)

Условие, под которым оно записывается и в которое разрешается его короткий код, — schedule is not a valid cron expression.

Как исправить: сначала посчитайте поля — расписание из четырёх или шести полей является самой частой причиной, а лишний пробел внутри поля разбивает его на два. Замените название дня или месяца его номером и используйте макрос там, где он выражает то, что вы имели в виду.

A workload suspend: is set on a form other than scheduled (Поле приостановки workload задано в форме, отличной от запланированной)

suspend: true приостанавливает повторяющееся расписание workload с form: scheduled: запланированный ресурс рендерится, но ни один запуск по его расписанию не начнётся, пока он не будет возобновлён. Ни одна другая форма не имеет расписания, поэтому в любой другой форме полю нечего приостанавливать, и сборка останавливается, а не рендерит 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; объявите form: scheduled с расписанием или удалите suspend)

Находка привязана к экземпляру компонента, workload которого читался, и сообщается как ошибка трансляции. Условие, под которым она записана, — suspend requires form: scheduled; именно в него разрешается её короткий код.

Правило действует только в одну сторону и только для true. Workload с form: scheduled без suspend: — обычный случай и выполняется по своему расписанию, а suspend: false, значение по умолчанию, ни в какой форме ничего не вызывает.

Как исправить: если workload должен был запускаться только тогда, когда его кто-то запускает, сделайте его form: scheduled с schedule: и оставьте suspend: true; в противном случае оставьте форму как есть и удалите suspend:, которое не читает ни одна другая форма.

Библиотечный $import: записан не в форме с голым именем

Три поля в Recipe и FeatureRecipe могут брать своё тело из библиотеки вместо того, чтобы записывать его на месте: запись artifacts.<name>:, valuesMapping: и workload:. Каждое из них записывает $import: с голым именем библиотеки, затем #, затем путь к записи на поверхности, которую читает это поле, — соответственно #/artifacts/, #/mappings/ и #/workloads/. Значение не такой формы не называет ничего, что сборка могла бы разрешить, и отклоняется при разрешении поля.

Эти три поля намеренно зеркальны друг другу, поэтому ошибка выглядит одинаково для всех трёх и меняется только поверхность:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>" (artifacts $import: не является ссылкой на библиотеку артефактов с голым именем) valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>" (valuesMapping $import: не является ссылкой на библиотеку сопоставлений с голым именем) workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>" (workload $import: не является ссылкой на библиотеку рабочих нагрузок с голым именем)

О версии, записанной через @, сообщается вместе с написанием, которое следует использовать, а не жалобой на то, что библиотека не найдена, поскольку это самая частая ошибка в этой форме:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>" (artifacts $import: не является ссылкой на библиотеку артефактов с голым именем: разделитель версии — ’:’, а не ’@’; используйте исправленное значение)

Здесь сообщается ещё об одной форме, и это не ошибка написания. Собственное тело файла пакета ArtifactLibrary не может само быть $import: другого пакета: один слот файла не может развернуться во множество файлов, поэтому вложенный импорт отклоняется, а не разрешается во что-то, чего автор не писал. Вместо этого объединяйте пакеты в месте их использования.

Запись artifacts:, которую пишет собственный Recipe компонента, определяется до любого рендеринга, поэтому сообщение привязано к блоку artifacts: в этом Recipe и называет ссылку, пакет, файл, тело которого содержит вложенный импорт, и запись, в которой был записан импорт. Обо всех файлах пакета такой формы сообщается за одну сборку; если их больше одного, результаты группируются под 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 (artifacts $import: не является ссылкой на библиотеку артефактов с голым именем (пакет, файл пакета, запись artifacts). Тело файла пакета не может импортировать другой пакет — объедините их в записи artifacts, которая их использует)

Запись artifacts:, которую пишет FeatureRecipe, сообщает о том же условии при разрешении пакета, называя первый файл такой формы:

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) (artifacts $import: не является ссылкой на библиотеку артефактов с голым именем: тело файла пакета является $import: корня поля (вложенный библиотечный импорт внутри файла пакета не поддерживается; объединяйте в месте использования))

valuesMapping:, который пишет собственный Recipe компонента, определяется до любого рендеринга, поэтому сообщение привязано к ключу valuesMapping: в этом Recipe и содержит написание, которое следует использовать:

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/ (valuesMapping $import: не является ссылкой на библиотеку сопоставлений с голым именем. Укажите библиотеку и запись по обе стороны фрагмента)

valuesMapping:, который пишет FeatureRecipe, сообщает об ошибке при разрешении ссылки в форме, приведённой в списке выше.

workload:, который пишет собственный Recipe компонента, определяется до любого рендеринга, поэтому сообщение привязано к ключу workload: в этом Recipe и содержит написание, которое следует использовать:

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/ (workload $import: не является ссылкой на библиотеку рабочих нагрузок с голым именем. Укажите библиотеку и запись по обе стороны фрагмента)

workload:, который пишет FeatureRecipe, сообщает об ошибке при разрешении ссылки в форме, приведённой в списке выше.

Как исправить: перепишите значение как <Library>#<entry-path>, добавляя :<version> после имени библиотеки, только если нужна нижняя граница выбираемой версии. Проверьте, что фрагмент соответствует полю: путь записи #/mappings/… в workload: называет поверхность, которую это поле не читает, и об этом сообщается здесь, а не как об отсутствующей записи. Та же форма идентификации действует для $ref: схемы, отказы по которому описаны выше в разделе «A $ref: is not written in a form the compiler can resolve (Ссылка $ref: записана не в форме, которую компилятор может разрешить)».

A library $import: names a library or an entry the catalog does not hold (Библиотечный импорт называет библиотеку или запись, которых нет в каталоге)

$import: записан правильно, но того, на что он указывает, нет. Шесть условий охватывают две половины ссылки для трёх видов библиотек, и то, какое из них вы получили, говорит, какую половину проверять: либо самой библиотеки нет среди того, что видит сборка, либо библиотека есть, но не публикует запись.

Множество, по которому разрешается ссылка, — это собственный каталог рабочего пространства плюс библиотеки, которые lock-файл закрепил и подгрузил при загрузке сборки. Поэтому библиотеки, от которой ничто в замыкании зависимостей сущности Release не объявляет зависимость, в этом множестве нет, как бы правильно ни выглядела ссылка на неё.

Библиотеки нет:

artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>") (импорт artifact-library ссылается на ArtifactLibrary, которой нет в каталоге: ArtifactLibrary (пакет)) mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>") (импорт mapping-library ссылается на MappingLibrary, которой нет в каталоге: MappingLibrary (запись)) workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>") (импорт workload-library ссылается на WorkloadLibrary, которой нет в каталоге: WorkloadLibrary (запись))

Записи нет:

artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>" (импорт artifact-library ссылается на пакет, которого нет в ArtifactLibrary: пакет в ArtifactLibrary) mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>" (импорт mapping-library ссылается на запись, которой нет в MappingLibrary: запись в MappingLibrary) workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>" (импорт workload-library ссылается на запись, которой нет в WorkloadLibrary: запись в WorkloadLibrary)

Запись artifacts:, которую пишет собственный Recipe компонента, сообщает об отсутствующем пакете в своей форме. Эта запись определяется до какого-либо рендеринга, поэтому сообщение привязано к блоку artifacts: в этом Recipe и называет запись, в которой был написан импорт, вместе с обеими половинами ссылки:

artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>") (импорт artifact-library ссылается на пакет, которого нет в ArtifactLibrary (ArtifactLibrary, запись artifacts))

valuesMapping:, который пишет собственный Recipe компонента, сообщает об отсутствующей записи в своей форме по той же причине: он тоже определяется до какого-либо рендеринга, поэтому сообщение привязано к ключу valuesMapping: в этом Recipe и называет обе половины ссылки:

mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>") (импорт mapping-library ссылается на запись, которой нет в MappingLibrary (MappingLibrary))

workload:, который пишет собственный Recipe компонента, сообщает об отсутствующей записи в своей форме по той же причине: он тоже определяется до какого-либо рендеринга, поэтому сообщение привязано к ключу workload: в этом Recipe и называет обе половины ссылки:

workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>") (импорт workload-library ссылается на запись, которой нет в WorkloadLibrary (WorkloadLibrary))

Запись artifacts:, которую пишет FeatureRecipe, valuesMapping: или workload:, которые пишет FeatureRecipe, и любая ссылка на библиотеку, которую сборка не видит, сообщают об ошибке при разрешении ссылки — в формах, приведённых в двух списках выше.

Каждое сообщение называет и библиотеку, и запись, какая бы половина ни дала сбой, поэтому одного сообщения достаточно, чтобы отличить отсутствующую библиотеку от отсутствующей записи, ничего не открывая.

Как исправить: при отсутствующей записи сверьте имя с тем, что публикует библиотека, — имя записи является ключом в собственной карте этой библиотеки и чувствительно к регистру. При отсутствующей библиотеке ссылка обычно верна, а неполным оказывается замыкание: объявите зависимость от этой библиотеки, чтобы она загружалась, и обновите lock-файл, чтобы она была закреплена. Библиотека, доступная в одном рабочем пространстве и недоступная в другом, — та же ошибка, видимая с другой стороны.

A library $import: addresses its library by registry location (Библиотечный импорт адресует свою библиотеку по расположению в реестре)

Библиотечный $import: называет свою библиотеку по идентичности, а не по реестру, в котором она опубликована. Через какой реестр разрешается имя — это конфигурация рабочего пространства, а какая версия используется — ответ lock-файла, поэтому ссылка с хостом фиксирует в документе каталога две вещи, которые должна решать сборка, — и документ перестаёт работать в любом рабочем пространстве с другой конфигурацией.

Случаев, когда такая ссылка ещё может дойти до этой остановки, меньше, чем кажется. Собственные поля $import: в Recipe и FeatureRecipe отклоняются раньше их схемой, которая не допускает префикса реестра ни в одной из трёх позиций. Остаётся ссылка, которую не описывает никакая схема: прочитанная из собственного тела записи библиотеки, которую потребляющая её сущность не писала и не может увидеть, пока тело не разрешено.

Выводимое сообщение для поверхностей valuesMapping: и workload:, где резолвер сообщает только значение:

library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>" (библиотечный $import: содержит хост реестра; ссылайтесь на библиотеку по идентичности в виде голого имени)

Запись artifacts: до этой остановки не доходит, и причину стоит знать, если вы ищете её там. Её собственная ссылка отклоняется вместе с остальным документом, как и в любой другой позиции; а в отличие от двух других поверхностей, файл пакета, тело которого само является импортом, отклоняется, а не раскрывается, — так что нет тела, из которого могла бы прийти ссылка с хостом.

Как исправить: удалите хост и всё, что стоит перед именем библиотеки, оставив <Library>#<entry-path>. Если ошибочное значение находится в библиотеке, которую вы потребляете, а не публикуете, исправление — дело автора этой библиотеки; пока оно не выйдет, сборку восстановит импорт другой записи или написание тела на месте.

Two artifact outputs of one Recipe carry the same filename (Два выходных артефакта одного Recipe имеют одинаковое имя файла)

Блок artifacts: в Recipe называет по одному выходу на ключ, а пакет, импортированный по ключу, добавляет свои файлы под ним. Два выхода с одним именем файла означали бы, что один перезаписывает другой, поэтому сборка останавливается, а не выбирает, какой останется.

Это остаточная защита, и сказать об этом — часть того, что она собой представляет. Выход называется по ключу, под которым он написан, ключи отображения уникальны в пределах одного документа, а поверхность написания ограничивает ключ одним именем файла — поэтому две написанные записи не могут столкнуться, и ключ не может совпасть с вложенным именем, которое создаёт пакет другого ключа. Защита по-прежнему охватывает содержимое, попавшее в проекцию, минуя собственную проверку документа на повторяющиеся ключи: состояние, собранное во время работы сборки, а не прочитанное из файла. Поэтому столкновение, о котором сообщается здесь, указывает на то, как была собрана сборка, а не на строку, которую можно увидеть.

Она проверяется для каждого 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, выходной артефакт выдан более одного раза))

Как исправить: откройте Recipe, названный в сообщении, и сверьте его ключи artifacts: с файлами, которые добавляет любой импортируемый им пакет. Если ключи действительно различны, а столкновение сохраняется, документ ни в чём не виноват, и о сообщении стоит сообщить тому, кто сопровождает сборку.

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 и опубликованный пакет обычно пишут разные авторы, поэтому сообщение называет обе половины вместе со способом исправления.

Запись artifacts:, которую пишет собственная сущность Recipe компонента, определяется до любого рендеринга, поэтому сообщение указывает на блок artifacts: в этой сущности Recipe и называет сначала файл, затем библиотеку, из которой он получен, и запись, в которой он используется. Каждый файл пакета, имя которого отклонено, сообщается в одной сборке; если таких файлов несколько, результаты группируются под 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 ”/” (имя файла пакета artifact-library не называет собственного файла под ключом artifacts, под который вложен его выход. Переименуйте файл внутри пакета ArtifactLibrary в обычное имя файла под ключом artifacts, по которому он используется, например «config.yaml» или «rbac/role.yaml», — без частей «.» или «..» и без начального, завершающего или удвоенного «/»)

Запись artifacts:, которую пишет сущность FeatureRecipe, сообщает о том же условии при разрешении пакета, называя сущность, в которой она записана, и первый такой файл:

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 ”/” (имя файла пакета artifact-library не называет собственного файла под ключом 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, которой поручено выполнить тот же шаг: дайджест байтов файла записывается в entity.lock рядом с сущностью Recipe. Запись из boundary.artifacts: сущности Recipe закрепляется и сравнивается так же и записывается под boundary/<key> — это имя, которое ей даёт сообщение. Каждая сборка заново читает файл, снова вычисляет его дайджест и отклоняет расхождение, поэтому файл, изменённый после закрепления, никогда не рендерится так, будто он был проверен. aggrega pull --verify выполняет то же сравнение и сообщает о расхождении тем же сообщением.

Сравнивается содержимое записи, а не результат её рендеринга. Тело артефакта — это шаблон, и его вычисление подставляет значения, которые различаются для каждого экземпляра компонента, поэтому дайджест по выходу расходился бы для каждого экземпляра с отличающимися значениями. Записанное содержимое — один и тот же текст для каждого экземпляра, привязывающего сущность Recipe, и поэтому один записанный дайджест — правильный эталон для сравнения.

У сущности Recipe, которую никто не закреплял, рядом нет закрепления, и сборка её не сравнивает. Для сборки отсутствие закрепления — не расхождение: оно означает, что сравнивать нечего. Команда pull по такой сущности Recipe вместо этого останавливается, как описано в разделе 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 сравнивается с дайджестом, записанным рядом с FeatureRecipe, а не рядом с сущностью Recipe компонента-хоста. На двух поверхностях присоединения сообщение называет также присоединение, и именно это указывает, какой документ открыть.

Выдаваемые сообщения:

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 для импортирующей его сущности, чтобы записать новый дайджест; иначе восстановите файл)

Как исправить: есть два ответа, и правильный зависит от того, было ли изменение намеренным. Если было, выполните aggrega pin для сущности Recipe, чтобы закрепление было заново взято из текущих байтов файла, и зафиксируйте перезаписанный ею 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-файл их записал, каждая сборка сравнивает источник в его текущем виде с этими закреплениями до того, как провайдер его прочитает, и отклоняет расхождение — поэтому chart или модуль, отредактированный после закрепления, никогда не отрисовывается так, будто он был проверен. aggrega pull --verify выполняет то же сравнение и сообщает о расхождении тем же сообщением. Сборка называет экземпляр компонента, источник которого она разрешала, и документ Recipe под ним.

Источник сравнивается как единый набор файлов. Файл с изменившимся содержимым, файл, добавленный в источник, и файл, удалённый из него, — каждый меняет то, из чего отрисовывается сущность, поэтому о каждом сообщается, с дайджестом, который файл имеет сейчас, и дайджестом, записанным для него. Файл рядом с сущностью, который источник не вносит, — заметка или README рядом с Recipe, — не сравнивается. Источник, записанный как шаблон, например ./charts/{{ .values.flavour }}, вносит каждый файл в каталоге сущности, потому что то, какой каталог он называет, решает каждый Release; для такой формы сообщается об изменении любого файла в каталоге.

Если lock-файл сущности Recipe не записывает закрепления для её источника, сборке не с чем сравнивать. Сборка её не отклоняет; это делает pull или push, который не закрепляет, как описано в разделе An entity reads an input the lock beside it records no pin for (Сущность читает входные данные, для которых lock-файл рядом с ней не записывает закрепления). Закрепления, которые lock-файл всё ещё хранит для локального источника, больше не объявленного в Recipe, не закрепляют ничего из того, что она читает, поэтому ни с чем не сравниваются. Сущность Recipe, которую pull разрешил из реестра, вместо этого покрывается дайджестом, который lock-файл записывает для содержимого её публикации.

Lock-файл, записанный до изменения, сообщает первым. Lock-файл записывает сущность по её содержимому, а файлы источника входят в него, поэтому сборка или aggrega pull --verify с lock-файлом, записанным до изменения файла, останавливается до запуска этого сравнения, и The lockfile no longer matches what the release resolves to (Lock-файл больше не соответствует тому, во что разрешается релиз) называет сущность и оба дайджеста. Обычный aggrega pull называет изменившийся файл через An entity reads an input the lock beside it records no pin for (Сущность читает входные данные, для которых lock-файл рядом с ней не записывает закрепления). То же верно для импортированного файла. Если в lock-файле нет собственной записи сущности, сборка и проверяющий pull встречают именно это сравнение: сущность Recipe или FeatureRecipe, которую Manifest называет по ссылке, совпадающей с именем сущности Component или Feature, достижимой из Release, записывается под этой ссылкой как Component или Feature, поэтому при изменении файлов Recipe в lock-файле ничего не меняется.

Выдаваемые сообщения:

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 (дайджест файла — …, записанное закрепление — …). Если источник был изменён намеренно, выполните … для сущности, чтобы снова записать её файлы; иначе восстановите файлы) 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 (дайджест файла — …, закрепление для него не записано). Если источник был изменён намеренно, выполните … для сущности, чтобы снова записать её файлы; иначе восстановите файлы) 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, чтобы файлы её источника были закреплены заново, и зафиксируйте перезаписанный entity.lock. Если нет, восстановите файлы, названные в сообщении.

Каждый файл, который несёт публикация сущности, читается из собственного каталога сущности, и символическая ссылка там отклоняется, а не разыменовывается. Переход по ней опубликовал бы байты, на которые она указывает, под собственным именем ссылки — откуда бы она ни указывала, включая места вне каталога сущности, — в артефакт, который затем хешируется и, где применяется подпись, подписывается. Пропуск же опубликовал бы артефакт, содержимое которого незаметно отличается от вашего каталога. Поэтому любая форма ссылки отклоняется одинаково: ссылка на файл, ссылка на каталог, ссылка в никуда, ссылка на саму себя и две ссылки, указывающие друг на друга.

Отказ происходит везде, где читаются файлы сущности: в aggrega pin, в публикации до упаковки чего-либо (включая пробный запуск), в pull и проверяющем pull, сверяющих entity.lock с файлами сущности, в сборке, сравнивающей локальный источник с его закреплениями, и при отрисовке, читающей каталог локального источника до передачи какой-либо его части провайдеру. Сообщение называет ссылку по её пути рядом с документом сущности, а диагностика указывает на саму ссылку.

Ссылка, исключённая вашими правилами игнорирования, не является файлом, который несёт сущность, поэтому она пропускается, как любой другой исключённый этими правилами файл, и по ней никогда не выполняется переход. Эти правила — те, что записаны в 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-файл рядом с ней не содержит закрепления)

Сущность Recipe или FeatureRecipe может зависеть от байтов за пределами собственного документа: от удалённого source:, координаты которого записаны полностью, от файла, который импортирует запись artifacts с помощью $import, и от файлов source:, указывающего на каталог или файл рядом с ней. Закрепление для каждого из них записывается в entity.lock рядом с сущностью, и запись его — шаг автора сущности, aggrega pin. Поэтому pull не записывает эти закрепления сам: для сущности в одном из ваших каталогов, которую собирает Release, он сравнивает то, что записал бы этот шаг, с содержимым lock-файла и останавливается, когда в lock-файле нет закрепления — или есть такое, которому входные данные больше не соответствуют, — вместо того чтобы без запроса писать в каталог автора. Сборка, которая заполняет собственный lockfile, является pull и останавливается так же.

Push останавливается на том же сравнении — для единственной сущности, которую он собирается опубликовать. До построения бандла и до обращения к какому-либо реестру он сравнивает то, что записал бы шаг для сущности, с lock-файлом рядом с ней и отказывает так же — в том числе при пробном запуске, — если только push не попросили выполнить этот шаг самостоятельно. То, что сообщение предлагает в конце, у этих двух команд различается, потому что у каждой свои способы записать закрепления; то, о чём сообщение сообщает, — нет.

Локальный источник сверяется со своими закреплениями как единый набор файлов. Если lock-файл не содержит ни одного из них, каждый файл, который вносит источник, сообщается здесь как отсутствующий. Если содержит, файл, добавленный после закрепления, сообщается как отсутствующий, а изменённый или удалённый файл — как закрепление, которому входные данные больше не соответствуют; сборка же сообщает о том же изменении как A local source no longer matches the pins recorded beside its Recipe (Локальный источник больше не соответствует закреплениям, записанным рядом с его Recipe). Закрепления, которые lock-файл ещё хранит для локального источника, больше не объявленного в Recipe, — его source: удалён или теперь указывает на удалённый артефакт, — ничего из читаемого Recipe не закрепляют, поэтому не останавливают ни pull, ни push, ни проверяющий pull, ни сборку; следующий aggrega pin удаляет их.

Сообщение называет все отсутствующие входные данные по классам. Каждое из них — это remote source, названный по url и версии, в которую он разрешился, imported file, названный по ключу artifacts, который его использует, или local source file, названный по пути рядом с сущностью, — так что вы знаете, что требует закрепления: источник или файл. Все такие сущности в Release сообщаются за один запуск.

Сущность, разрешённая из реестра, никогда не проверяется так при pull, потому что её публикация уже прошла эту проверку. Она находится в кэше содержимого, а не в каталоге, который вы редактируете, поэтому pull не читает и не пишет lock-файл рядом с ней, а её источники сверяются с lockfile сущности Release. Сущность, опубликованная с помощью aggrega push, была отклонена при публикации, если её 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 рядом с ней не записано закрепление (Recipe, удалённый источник: закрепление не записано, импортированный файл: записанное закрепление ему больше не соответствует). Исправление: выполните 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 рядом с ней не записано закрепление (Recipe, удалённый источник: закрепление не записано). Исправление: выполните aggrega pin и зафиксируйте entity.lock, который он запишет рядом с сущностью; чтобы вместо этого эта публикация сама записала закрепления, перезапустите её с —pin-sources; чтобы их записывала каждая публикация в этом рабочем пространстве, задайте pin_sources_at_push: true в конфигурации рабочего пространства)

Средняя часть сообщения публикации называет то, что принимает интерфейс, из которого вы публиковали: --pin-sources в терминале, поле pinSources в демоне и аргумент pin_sources инструмента ассистента.

Как исправить: если сущность ваша, выполните для неё aggrega pin и зафиксируйте записанный entity.lock, затем снова выполните pull или push — или выполните push с --pin-sources, который выполняет этот шаг до построения бандла. Если она чужая — каталог, который вы используете из отдельного каталога, — её издатель ещё не закрепил её; задайте pin_sources_at_pull: true в конфигурации рабочего пространства, чтобы каждый pull сам записывал закрепления, или передайте --pin-sources одному pull. Шаг полностью описан в aggrega pin.

A provides: template could not be evaluated (Не удалось вычислить шаблон provides)

Запись provides: — это шаблон, создающий значение, которое другой компонент читает через связь зависимости. Это условие сообщает запись, которую не удалось вычислить: шаблон, который не разбирается, вызываемая в нём функция, не зарегистрированная на этой поверхности, ссылка, спускающаяся через то, что контекст рендеринга не предоставил, или чтение через index ключа, которого нет в map.

Оно отличается от двух отказов, которые выполняются до вычисления того же блока, — ссылки на корень вне самодостаточного набора и ссылки, которую отвергает собственный порядок записей блока, — оба описаны выше. Те называют выражение, которое нужно изменить; это же передаёт то, что сообщило само вычисление, поэтому рядом с ним названа запись.

Выдаваемое сообщение, называющее экземпляр компонента, запись внутри блока и то, что сообщило вычисление:

provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>) (не удалось вычислить шаблон provides (узел, provides[], сообщение вычисления))

Заголовок несёт код этого условия, E0056, что бы ни сообщило вычисление. Если вычисление остановилось на собственном прерывающем условии — обычно это чтение через index ключа, которого нет в карте, — это условие сообщается под данным, а не вместо него: под caused by (2): сначала идёт предложение этого условия, а затем собственный отчёт вычисления вместе с его предложением. Поэтому читатель, сопоставляющий коды, относит каждую неудачную запись provides: к E0056, а причину неудачи вычисления читает из условия под ним, предложение которого соответствует его собственному коду в таблице всех условий — E0327 для отсутствующего ключа.

Как исправить: откройте блок provides: сущности Recipe на ключе, названном в сообщении, и прочитайте указанную причину — обычно она называет позицию разбора или функцию. Обработка отсутствующих ключей на этой поверхности выводит отсутствующий конечный ключ как пустое значение, а не завершается ошибкой, поэтому сбой здесь — структурная ошибка: шаблон, который не разбирается, ссылка, спускающаяся через контейнер, который не был предоставлен, или чтение через index ключа, которого нет в map, — это и называет указанная причина. Если значение действительно необязательное, читайте его через вспомогательную функцию optional, а не спускайтесь в то, чего может не быть.

A Recipe or FeatureRecipe does not publish a provides key its contract declares (Сущность Recipe или FeatureRecipe не публикует ключ, объявленный её контрактом)

Сущности Component и Feature объявляют в schema.provides ключи, которые опубликует всё, что к ним привязывается, — выходной контракт, относительно которого потребитель описывает свои соединения. Сущность Recipe, привязанная к Component, и сущность FeatureRecipe, привязанная к Feature, должны выдавать каждый ключ, указанный в этом контракте. Реализатор, который этого не делает, отклоняется, поскольку иначе отсутствующий ключ не доставил бы вообще ничего: ссылка потребителя пришла бы как незаданная переменная, пустой аргумент или несуществующий файл, без каких-либо объяснений причины.

Контракт — это наличие ключей, и ничего больше. Каждый объявленный ключ должен присутствовать; дополнительные ключи допускаются. Сами значения никогда не проверяются — это непрозрачные указатели, передаваемые как строки, поэтому типы, объявленные контрактом, остаются заявлением для потребителя, а не проверкой, которую выполняет сборка.

Сообщается о каждой нехватке. Сущность Recipe, в которой не хватает трёх ключей, порождает три находки, каждая из которых привязана к своей записи в блоке provides: этой сущности Recipe, так что все три исправляются по результатам одной сборки. Сообщение называет отсутствующий ключ, тип, контракт которого его объявляет, и экземпляр, к которому была привязана сущность 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 не публикует ключ provides, объявленный контрактом schema.provides её абстрактной сущности; объявлен типом компонента, привязан к экземпляру компонента)

Пара Feature и FeatureRecipe сообщает о том же условии через собственное разрешение присоединения, называя пару и ключ:

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 не публикует ключ provides, объявленный контрактом schema.provides её абстрактной сущности; сущность FeatureRecipe не публикует ключ provides, объявленный контрактом schema.provides сущности Feature)

В этом случае сообщается о первом отсутствующем ключе в порядке сортировки, и на этом проверка останавливается, так что для этой пары называется один ключ за сборку, тогда как для пары с Component называются все. В обоих случаях ключи обходятся в порядке сортировки, благодаря чему результат одинаков от запуска к запуску.

Как исправить: добавьте отсутствующий ключ в блок provides: сущности Recipe или FeatureRecipe или удалите его из schema.provides сущности Component или Feature, если ничто не должно его публиковать. Ключ, шаблон которого отрисовывается в пустоту, всё равно публикуется — со значением в виде пустой строки, поэтому присутствующая пустая запись выполняет контракт и здесь не сообщается. Если пустое значение должно останавливать сборку, отклоните его в утверждении: утверждения сущности 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, раздел «Что отказ сообщает об объявленном значении».

При отдельной проверке сущность сообщает о невыполненном утверждении как о предупреждении. aggrega validate, получивший файл сущности Recipe, проверка этого файла редактором через aggrega serve и инструмент validate из aggrega mcp, получивший entity, собирают Recipe на основе заполнителей и значений по умолчанию из схемы, а не значений, которые задаёт Release, поэтому они не могут отличить утверждение, ожидающее Release, от сломанного. Там утверждение, вызывающее fail, — собственное утверждение Recipe или объявленное в Component, который она реализует, — сообщается как предупреждение с приведённым выше сообщением, завершённым фразой A Release must satisfy this assertion before a build of it can pass., и проверка проходит. Ссылка на ключ, который ничто не предоставляет, и утверждение, которое не разбирается, — это не невыполненные утверждения: каждое из них — ошибка в тексте самого утверждения, и проверка оценивает её так же, как любую другую ошибку. У сборки всегда есть Release, и она останавливается на утверждении, как описано здесь; см. невыполненное утверждение — это предупреждение.

Как исправить: сообщение после последнего двоеточия написано автором утверждения, и именно оно говорит, что изменить, — утверждение пишется так, чтобы столкновение с ним подсказывало ответ. Если сообщается отсутствующий ключ, а не фраза автора, ошибка в самом утверждении: исправьте ссылку или защитите её, как описано выше. Если правило не должно применяться к этой сущности Release, это вопрос к сущности, содержащей утверждение, а не к вашему собственному файлу.

Шаг конвейера адресует документы, которых у узла нет

Шаг конвейера адресует документ по области и ключу. Три условия охватывают случаи, когда адрес ни на что не указывает, и каждое останавливает сборку, чтобы шаг не сообщил об успехе правки, которая так и не произошла.

Узел его не выводил. Патч называет пару области и ключа, которой нет среди документов, созданных этим узлом:

node "<instance>": pipeline PATCH targets a document the node did not emit (узел: PATCH конвейера нацелен на документ, который узел не выводил)

Нет хоста для адресации. Шаг обратился к документам хост-компонента в месте, которое не связано ни с одним компонентом: в собственном конвейере компонента, единственная область которого — его собственный вывод, или в 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 (узел, документ))

Каждое приходит вместе с собственным описанием адреса от обхода и привязывается к экземпляру компонента, чей конвейер его создал.

О двух из трёх сообщается ещё до обхода. Есть ли у места документы хоста, следует из того, где был написан конвейер, поэтому шаг, объявляющий, что работает с документами хоста в месте, где их нет, называется, как только сборка узнаёт, что объявляет каждый плагин, не дожидаясь рендеринга узла, — а 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 (Патч конвейера адресует документ, которого нет в наборе, или документ без дерева для адресации)».

Как исправить: все три относятся к автору шага, а не к вам. Для отсутствующей цели примените патч к документу, который узел действительно выводит, или выведите нужный документ на более раннем шаге и примените к нему патч на более позднем — шаг может прочитать, какие ключи ему переданы. Для отсутствующего хоста перенесите шаг в место, связанное с хост-компонентом, адресуйте вместо этого собственные документы места или удалите шаг. Для единицы без дерева замените патч выводом всей единицы: непрозрачное содержимое заменяется, а не редактируется.

Патч конвейера адресует вывод, который ещё не собран

Некоторые провайдеры сворачивают вывод отдельных узлов группы диспетчеризации в один документ — объединённый compose-файл, зонтичный чарт. Пока это слияние не произошло, отдельных документов нет, есть только фрагменты, поэтому патчу, адресующему документ, не во что указывать. Поэтому конвейер для такого компонента откладывается целиком и воспроизводится, когда слияние создаст документы; это обычный путь, и от автора он ничего не требует.

Это условие доходит до сборки, когда патч всё же приходит к фрагменту. Случай, который оно называет, — собственный вывод прикреплённой Feature. Когда провайдер компонента сворачивает свою группу, весь конвейер прикрепления задерживается, пока слияние не создаст документы, — и воспроизведению передаются только документы компонента. Шаг против собственного вывода Feature предлагается только во время рендеринга компонента, то есть до любого слияния, поэтому ему нечего адресовать. Это верно независимо от того, как передаётся собственный вывод Feature: входит ли он в слияние или записывается как отдельные документы, его собственная область никогда не является областью, которую несёт воспроизведение.

Вывод документов это не затрагивает. Вывод добавляет документ, а не редактирует его, и выполняется для каждого узла у любого провайдера, поэтому он полностью вне этого условия.

Об условии сообщается до любого обхода, по тому, что объявляют плагины и провайдеры, и ещё раз, как нижняя граница, во время рендеринга узла. Выводимые сообщения:

pipeline PATCH targets an assembler provider’s pre-assembly fragments ("<attachment>") (PATCH конвейера нацелен на фрагменты провайдера-сборщика до сборки) 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 конвейера нацелен на фрагменты провайдера-сборщика до сборки (узел, документ области рендерится провайдером-сборщиком). фаза после сборки повторно выполнит этот PATCH, когда документы станут отдельными)

Как исправить: адресуйте документы компонента вместо собственных документов Feature — именно эта форма воспроизводится после слияния; или переведите компонент на провайдер, который не сворачивает свою группу диспетчеризации; или удалите шаг. Какой из трёх вариантов верен, зависит от того, что шаг должен был изменить, и сообщение называет адресованную область, чтобы вы могли это определить. Изменение собственного capability: в FeatureRecipe к ним не относится: оно не меняет, какая область передаётся воспроизведению после слияния, а именно об этом данное условие.

Плагин шага конвейера не заявляет провайдер, рендерящий то, что шаг адресует

Плагин, используемый шагом конвейера, может объявить провайдеры, с которыми он протестирован. Этот список — явное заявление, а не подразумеваемое «всё похожее»: запуск плагина с провайдером, которого он не называет, рискует применить патч, написанный для другой формы вывода, поэтому сборка останавливается, а не пробует.

Шаг сопоставляется с тем провайдером, который рендерит адресуемые шагом документы: с собственным провайдером компонента для шага против документов компонента и с собственным провайдером Feature для шага против документов Feature. У Feature, прикреплённой к компоненту, возникают оба случая, и это два разных значения из двух разных документов.

Пустой или отсутствующий список заявлений ни с чем не совпадает, поэтому каждый шаг, использующий такой плагин, сообщает здесь. Плагин, который сборка не смогла опросить, — другой случай, и здесь он не сообщается: недоступный самоотчёт — это отсутствие заявления, а не пустое заявление, и такой шаг останавливается с самой ошибкой разрешения, загрузки или самоотчёта, которую и следует исправить.

Об этом сообщается, как только сборке становится известно, что каждый плагин объявляет о себе, до запуска, который вызвал бы шаг, и один раз на каждый написанный шаг, а не один раз на сборку, поэтому автор видит все проблемные шаги конвейера за одну сборку. Имена Provider сопоставляются точно.

Выводимые сообщения: первое — из собственного конвейера компонента, второе — из конвейера Feature, которое также называет прикрепление:

pipeline plugin is not compatible with the rendering provider ("<provider>") (плагин конвейера несовместим с рендерящим провайдером) pipeline plugin is not compatible with the rendering provider ("<attachment>", "<provider>") (плагин конвейера несовместим с рендерящим провайдером)

Как исправить: находка привязана к написанному шагу, а названный в ней провайдер — то, с чем нужно согласовать объявление. Если плагин ваш, добавьте провайдер в объявляемую им совместимость после тестирования с ним. Если нет, выберите версию плагина, которая заявляет этот провайдер, рендерите эту область через провайдер, который плагин заявляет, или удалите шаг.

A provider refused a node’s input (Провайдер отклонил входные данные узла)

Провайдер может проверить входные данные, переданные ему для компонента, перед их отрисовкой и сообщить о том, что обнаружил. Находки с уровнем серьёзности halt останавливают сборку; находки с уровнями warning и information выводятся вместе с результатом сборки и никак не меняют выводимые байты.

Это собственное прочтение ваших входных данных провайдером, а не компилятором, поэтому против чего он возражает и насколько конкретно об этом сообщает, решает провайдер. Компилятор называет компонент и провайдера и передаёт сообщения провайдера в том виде, в каком они были возвращены; если провайдер сообщил о нескольких, они приходят вместе через точку с запятой, так что одна сборка сообщает вам обо всех.

Используется одна и та же маршрутизация, относятся ли входные данные к собственному Recipe компонента или к подключённому Feature, поэтому проверка провайдера выглядит одинаково в обоих случаях.

Выводимое сообщение:

provider rejected node input: node "<instance>", provider "<provider>": <the provider's messages> (провайдер отклонил входные данные узла: узел, провайдер: сообщения провайдера)

Как исправить: прочитайте сообщения провайдера — они указывают, что в разрешённых входных данных он не смог принять. Входные данные собираются из значений Recipe и собственной конфигурации компонента, поэтому исправление обычно находится в одном из них; что требуется провайдеру, описано на его собственной справочной странице. Если провайдер возражает против того, что нельзя изменить из документа, это вопрос к тому, кто написал Recipe или плагин.

A provider rendered the same input twice and produced different output (Провайдер дважды отрисовал одни и те же входные данные и получил разный результат)

При идентичных входных данных сборка даёт идентичный результат — это контракт, относительно которого инструменты ревью и развёртывания читают результат сборки. Включаемый по желанию режим сборки проверяет это напрямую: каждый компонент отрисовывается дважды из одних и тех же входных данных, и выводимые байты сравниваются. Провайдер, чьи две отрисовки расходятся, переносит состояние между ними или иным образом не является функцией своих входных данных, и сборка останавливается.

Обычная сборка отрисовывает каждый компонент один раз, поэтому это условие встречается только в режиме проверки. Наличие этого режима ничего не меняет в обычной сборке.

Сравнивается необработанный вывод провайдера — те же байты, из которых вырезаются отрисованные артефакты, — поэтому обнаруживается различие в любом месте того, что он произвёл, а не только различие, дошедшее до итогового файла.

Выводимое сообщение:

rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic (отрисовка узла: узел (провайдер): две отрисовки идентичных входных данных дали разный результат: отрисовка провайдера недетерминирована)

Как исправить: сначала найдите, чем различаются две сборки компонента, названного в сообщении, — соберите его дважды и сравните результаты. Если различие — это значение, которое подключаемый вами чарт генерирует заново при каждой отрисовке, — случайный пароль, сгенерированный ключ, метка времени в Secret или ConfigMap, — то ошибка в выводе этого чарта, а не в провайдере, и вы можете устранить её сами одним из двух способов. Задайте значение через ту настройку, которую чарт для него предлагает, из valuesMapping: в Recipe, чтобы чарт перестал его генерировать. Или, если сгенерированный документ — это тот, который Release не должен поставлять, например Secret, который оператор предоставляет отдельно, исключите его из сборки записью omits: в Recipe; см. Recipe → Поле omits:. В противном случае ошибка на стороне провайдера, а не ваших документов, и ничто из написанного вами её не устранит. Сообщите о ней тому, кто публикует плагин, обслуживающий этого провайдера, указав компонент, названный в сообщении, — обычные причины — метка времени, случайное значение или порядок, следующий порядку итерации по map, а не порядку, в котором писал автор. Пока ошибка не исправлена, обычный режим сборки не затронут, и на практике решением будет закрепить плагин на версии, которая прошла проверку.

An omits entry left out nothing the source rendered (Запись omits не исключила ничего из отрисованного источником)

Каждая запись списка omits: в Recipe или FeatureRecipe, применимая к сборке — её when: отсутствует, пусто или истинно, — должна исключить из вывода хотя бы одну вещь, отрисованную источником: документ, который отрисовывает чарт, сервис, том или конфиг, объявленный в compose-файле, или ресурс, объявленный в шаблоне CloudFormation. Провайдер, отрисовывающий источник, сопоставляет каждую запись с тем, что он отрисовал, и сообщает, сколько единиц исключила каждая; запись, не исключившая ни одной, останавливает сборку.

Запись, которая ничему не соответствует, — это утверждение об источнике, которое больше не верно. Обычная причина — обновление источника, переименовавшее или удалившее то, что названо в записи, — и тогда переименованный документ или сервис оказывается в выводе под новым именем, а именно его запись и должна была не допустить, — а другая причина — ошибка в самой записи. Если пропустить это, в поставку попадёт то, что запись должна была исключить, поэтому сборка останавливается и называет запись.

Сообщение называет узел, провайдера, документ, объявляющий запись, и позицию записи в списке omits: этого документа, считая с 0, а также kind, имя и пространство имён, в которые разрешилась запись, причём пространство имён — только если запись его называет. Для FeatureRecipe, подключённого к компоненту, узел — это этот компонент; для подключённого к границе строка над сообщением называет подключение и его границу. Если ничему не соответствуют несколько записей, называется первая в том порядке, в котором вы их написали, поэтому при каждом запуске называется одна и та же запись. Поле, шаблон которого прочитал значение, объявленное чувствительным, показывается как <redacted>, а не как то, во что оно разрешилось. Запись, отброшенная её when:, никогда не передаётся провайдеру и никогда не проверяется.

Выводимое сообщение. Категория доходит до вас в заголовке в квадратных скобках:

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 (запись omits не исключила ничего из отрисованного источником (узел, провайдер, документ omits[позиция], kind, имя, пространство имён). исправьте запись так, чтобы она называла что-то, что отрисовывает источник, или удалите её; обычная причина — обновление источника, которое это переименовало или удалило)

Заголовок содержит краткий код этого условия, E0334.

Как исправить: сравните запись с тем, что источник отрисовывает сейчас, — соберите без этой записи и посмотрите, что отрисовывает компонент, — затем исправьте kind, имя или пространство имён записи либо удалите запись, если названного ею больше нет. Для чарта запись называет документ по его собственным kind, metadata.name и, если запись называет пространство имён, по пространству имён, в котором находится документ; для compose-файла она называет service, volume или config по ключу; для шаблона CloudFormation она называет ресурс по его Type и логическому ID в любом из шаблонов источника. См. Recipe → Поле omits:.

A provider’s omitted counts do not match the omits entries it was handed (Число исключённых единиц, возвращённое провайдером, не соответствует переданным ему записям omits)

Провайдер, который объявляет, что исключает отрендеренные единицы, сообщает для каждой переданной ему записи omits:, сколько единиц эта запись сопоставила, — одно число на запись, в том порядке, в каком записи были переданы. Если отчёт отсутствует, содержит слишком мало или слишком много чисел или содержит число меньше нуля, установить, исключила ли запись хоть что-нибудь, невозможно, поэтому сборка останавливается. Ничто из написанного вами к этому не приводит: так сообщается о провайдере, чей возвращённый вывод не соблюдает объявленный им контракт.

Выводимое сообщение. Сообщение называет узел и провайдер, затем число переданных записей и то, что вернулось, — либо количество чисел, либо число меньше нуля и запись, для которой оно было возвращено:

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) (число исключённых единиц, возвращённое провайдером, не соответствует переданным ему записям omits (узел, провайдер, передано записей omits, возвращено чисел исключённых единиц))

Заголовок содержит короткий код этого условия, E0336.

Как исправить: сообщите об этом тому, кто публикует плагин, обслуживающий этот провайдер, указав компонент, названный в сообщении. Обязанности провайдера описаны в контракте плагина в разделе Исключение отрендеренных единиц.

Assembled output still carries a cross-boundary placeholder (Собранный вывод всё ещё содержит заполнитель межграничной ссылки)

Когда связь зависимости проходит между двумя собранными выводами, переносимое ею значение неизвестно в момент рендеринга потребляющей стороны: его публикует другая сторона, а разрешается оно после сборки обеих. Поэтому сборка записывает во входные данные потребляющего компонента заполнитель, а провайдер заменяет его своей формой перекрёстной ссылки, когда сборка уже существует.

Это условие сообщает о заполнителе, пережившем такую замену. Пережить замену значит, что разрешение до него не дошло: значение оказалось там, куда провайдер не может обратиться, — чаще всего оно было вставлено в более длинную строку, а не стояло как целое значение, — или пересечение было помечено, а на другой стороне не оказалось ничего, что могло бы его разрешить. Заполнитель никогда не является допустимым выводом, поэтому сборка останавливается, а не выпускает файл, содержащий его.

Сообщение называет провайдер, записавший файл, и путь, по которому файл находится: путь уникален только в пределах одной сборки, поэтому лишь вместе они однозначно определяют файл. Сообщается о каждом проблемном файле, а не только о первом, и о каждом — один раз, сколько бы границ ни участвовало в сборке, в которой он находится. Ошибка относится к документу Release в целом, а не к границе внутри него: неисправность в том, как значение попало в файл, а не в объявлении границы, поэтому менять объявление границы не нужно.

Выводимое сообщение:

assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>") (собранный вывод содержит неразрешённый заполнитель межграничной ссылки)

Как исправить: самая частая причина — значение, которое потребляющая сторона подставила в более длинную строку. Перекрёстная ссылка должна быть целым значением, в качестве которого она внедряется, поэтому измените сопоставление в Recipe так, чтобы оно передавало её целиком, а составляйте окружение на собственном языке целевой платформы. Если значение стоит целиком, а заполнитель всё равно остаётся, неисправность на стороне провайдера и относится к тому, кто публикует этот плагин.

Шаблон может читать значения производителя непосредственно из соединения, по пути .context.uses.<alias>.provides, а в FeatureRecipe с областью границы — из соединений границы в .boundary. Если соединение связывает два компонента, которые рендерятся в разные выходные данные, и провайдер связывает их собственной ссылкой, каждое из этих значений попадает в шаблон как заполнитель, который провайдер заменяет после сборки обоих выходов: ссылкой между стеками или самим значением. Поэтому шаблон может только копировать такое значение — записывать его целиком, внутри более длинной строки или через функцию, оставляющую его без изменений, например quote.

Сравнение, ветвление, длина или функция, изменяющая значение, — eq, if, len, upper, trimPrefix — были бы вычислены по заполнителю, а не по значению, причём незаметно. Сборка проверяет это, вычисляя шаблон дважды — один раз по заполнителям и один раз по реальным значениям, — и останавливается, если после обратной подстановки каждого заполнителя результаты расходятся. Это относится к каждому шаблону, читающему такое соединение: к собственным шаблонам Recipe, к injectMapping: подключённого FeatureRecipe и к шаблонам 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, потребляющий компонент, который читает его из своего соединения на сокете, и производящий компонент. Копируйте значение как есть, целиком или внутри более длинной строки, потому что провайдер записывает на его место то, чем значение становится в другом выходе, а ветвление стройте на собственном значении компонента)

Как исправить: копируйте значение, названное в сообщении, а не проверяйте и не преобразуйте его, и принимайте решение на основе значения, которое потребляющий компонент задаёт сам, — одного из собственных ключей values или infra, — а не того, что читает его соединение. В описании провайдера CloudFormation сказано, чем скопированное значение становится в другом стеке.

A provider named a directory for a contributor that is not one directory (Провайдер указал для участника каталог, который не является одним каталогом)

Провайдер, размещающий каждого участника в собственной позиции внутри одного охватывающего вывода, объявляет каталог, в котором находятся эти позиции, и сборка встраивает в него идентичность каждого компонента. Значение должно называть ровно один каталог: значение с разделителем пути или называющее текущий либо родительский каталог поместило бы файлы компонента не в его собственную позицию — либо вообще за пределы сборки, либо незаметно переставив их внутри неё.

Сборка останавливается, а не составляет такой путь. Сообщение называет провайдер, объявивший значение, и само значение, поэтому ясно, какой провайдер менять и что он объявил.

Провайдера, который не объявляет такой каталог, это не затрагивает. Каждый участник тогда располагается непосредственно в каталоге развёртывания под собственным именем, так что отказ называть охватывающий каталог — допустимый вариант, а не упущение.

Выводимое сообщение:

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 (провайдер указал для собственного подкаталога каждого участника каталог, который не является именем одного каталога: провайдер объявил nest_segment; значение должно называть один каталог, не содержать разделителя пути и не называть ни текущий, ни родительский каталог)

Как исправить: это значение не создаётся ни одним документом каталога, поэтому в ваших файлах исправлять нечего — оно исходит от плагина, обслуживающего провайдер. Сообщите об этом тому, кто публикует плагин, приведя значение из сообщения. Если плагин ваш, объявите имя одного каталога или не объявляйте ничего, чтобы каждый участник располагался в каталоге развёртывания.

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>") (подключение связывает FeatureRecipe с executionScope: boundary, но ни одна граница, содержащая компонент, его не объявляет (на компоненте в границе))

и для компонента вне какой-либо области, который такого значения не даёт:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>") (подключение связывает FeatureRecipe с executionScope: boundary, но ни одна граница, содержащая компонент, его не объявляет)

Как исправить: объявите подключение в features: на границе, для которой оно должно генерировать, — в области, где находится компонент, или в одной из охватывающих её, — а не только на компоненте. Если вы имели в виду генерацию для каждого компонента, подключите вместо этого Feature, чья FeatureRecipe не объявляет область границы.

The sandbox refused a plugin (Песочница отклонила плагин)

Каждый плагин сообщает, что он собой представляет и что ему нужно, прежде чем ему позволят выполнять какую-либо работу, и песочница сверяет это сообщение с тем, что она готова предоставить. Это условие охватывает весь класс сообщений, которые песочница не примет, а фраза указывает, какая часть была отклонена: версия интерфейса плагинов, которую хост не поддерживает; вид плагина, для которого у хоста нет словаря; плагин, запрашивающий исходящий сетевой доступ или доступ к файловой системе; плагин, называющий вызов хоста вне набора, который предлагает хост, или импортирующий из пространства имён вне допустимого набора; отсутствующий или некорректный экспорт; поле со значением вне закрытого набора, которым оно ограничено; или самоописание, которое вообще невозможно прочитать.

Отказ происходит до запуска плагина, а отклонённый плагин останавливается до того, как сбой распространится, поэтому ничего из запрошенного им не предоставляется даже ненадолго.

Часть того, что плагину недоступно, здесь не проверяется, потому что это никогда не предоставляется. Хост даёт гостю замороженные часы, никакой файловой системы, никакого окружения и никакого места для собственного вывода, поэтому гость, пытающийся обратиться к чему-либо из этого, завершается сбоем при попытке, а не получает отказ заранее. Это условие охватывает сообщение, которое плагин делает о себе, и проверяется оно до его запуска.

Выводимые сообщения. Каждое завершается фразой условия, а то, что ей предшествует, называет плагин и отклонённую часть его сообщения. Версия интерфейса, которую хост не поддерживает:

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: плагин отклонён песочницей)

плагин без экспорта, которого требует его вид, названного по тому же реестру, из которого читается сам вид:

<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox (плагин не объявляет экспорт: wasm: плагин отклонён песочницей)

поле, ограниченное фиксированным набором, содержит что-то иное — та же форма охватывает режим сборки, а также поля operates и scope каждого экспорта:

plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox (экспорт плагина объявляет неизвестный scope (ожидается own, host или пустое значение): wasm: плагин отклонён песочницей)

парная возможность, объявленная без обоих своих экспортов, или экспорты без объявления возможности:

plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox (плагин объявляет возможность связывания через границы, но не экспортирует одновременно link_publish и link_resolve: wasm: плагин отклонён песочницей)

имя возможности, которое Recipe никогда не сможет выбрать, — провайдер, обслуживающий имя с двоеточием, или шаг конвейера, совместимый с таким именем, — потому что capability: в Recipe читается как имя до последнего двоеточия и закрепление версии после него. 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 (плагин обслуживает возможность, имя которой содержит двоеточие; ссылка на возможность в Recipe читается как возможность до последнего двоеточия и закрепление версии после него, поэтому ни один Recipe не может назвать это имя: сообщайте имя возможности без двоеточия: 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: плагин отклонён песочницей)

Как исправить: ничто в ваших файлах сущностей не вызывает этого, и никакое изменение в них это не устранит — отклоняется собственное сообщение плагина. Если вы используете опубликованный плагин, сообщите о сообщении тому, кто его публикует, и до тех пор выберите версию, которую принимает хост. Если плагин ваш, сообщение называет поле и оба значения, поэтому исправление — то, на которое указывает фраза: поддерживайте версию интерфейса, которую поддерживает хост, объявляйте известный ему вид, держите каждое поле в пределах его закрытого набора, объявляйте экспорт, которого требует ваш вид, и объявляйте ровно те вызовы хоста, которые использует ваш бинарный файл, — не больше и не меньше.

A plugin is not the kind of plugin the socket expects (Плагин не того вида, которого ожидает гнездо)

Каждая точка подключения указывает, какому виду плагина она передаёт работу, и каждый плагин сообщает свой вид. Это условие сообщает о расхождении между ними: плагин, обслуживающий провайдер, подключён там, где ожидается линтер; парсер — там, где ожидается импортёр; плагин, не являющийся терминальной командой, запускается как она. Проверка выполняется при загрузке плагина, поэтому плагин неверного вида никогда не доходит до работы, которую его попросили бы выполнить.

Сборка останавливается, а не пытается всё равно, потому что у разных видов нет общего интерфейса. Плагин другого вида вызывался бы через экспорты, которых у него нет, а возвращённое читалось бы по форме, которую он никогда не создавал.

Чтение самоописания плагина без утверждения вида не затрагивается. Поверхность, которой нужно лишь узнать, что плагин сообщает о себе, — вывод списка настроенного, генерация сущности для плагина — не задаёт ожиданий, и там эта проверка пропускается.

Выводимое сообщение называет плагин и оба вида, причём ожидаемый вид дан и словами, и объявленным значением:

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() сообщает иной тип плагина: wasm: объявленный тип плагина не совпадает с describe() плагина)

Как исправить: подключите плагин того вида, который принимает точка подключения, — сообщение называет ожидаемый вид. Если плагин тот, который вы и имели в виду, подключение находится не на своём месте: перенесите его на поверхность, к которой относится его вид. Если вы автор плагина и он должен быть ожидаемого вида, он сообщает о себе неверный вид, и исправлять нужно плагин, а не конфигурацию, которая его подключает.

A plugin failed while it was running (Плагин дал сбой во время выполнения)

Плагин, которому поручили некоторое действие, не вернул результат. Этот случай охватывают три условия, и различаются они только тем, как распространился сбой: плагин аварийно завершился, плагин сам остановил своё выполнение или плагин отработал до конца и сообщил, что не может выполнить запрошенное. Они намеренно составляют одну классификацию, чтобы сборка одинаково обрабатывала любой способ, которым может дать сбой плагин.

Плагин аварийно завершился. Большинство ошибок внутри плагина — недостижимая инструкция, деление на ноль, чтение за пределами его памяти — на выходе превращаются в обычные сбои и до этого условия не доходят. Оно служит страховочной сеткой за этим путём для аварии, которая его минует.

Плагин сам остановил своё выполнение. Запрашивая выход, плагин делает то, для чего в модели плагинов нет применения: плагин возвращает результат через вызов, которым его вызвали, а не завершением. Останавливается только его собственное выполнение; процесс сборки не затрагивается.

Плагин сообщил о сбое. В конверте результата, который возвращает плагин, есть место, чтобы сообщить, что он не смог завершить работу, и такое сообщение передаётся дальше как сбой, а не читается как результат.

Выводимые сообщения; каждое называет плагин или экспорт и содержит то, что сообщил сбой. Аварийное завершение содержит восстановленное значение:

wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call (wasm: гостевой плагин аварийно завершился в экспорте: wasm: гостевой плагин аварийно завершился во время вызова)

плагин, остановившийся сам, содержит код, с которым он остановился:

wasm: plugin "<plugin>" call to <export> invoked proc_exit(<code>): wasm: plugin invoked proc_exit (wasm: вызов экспорта плагина обратился к proc_exit: wasm: плагин обратился к proc_exit)

а сообщённый сбой содержит собственное сообщение плагина:

call "<export>": wasm: guest plugin reported an error: <the plugin's message> (вызов: wasm: гостевой плагин сообщил об ошибке)

Как исправить: ни одно из трёх условий не вызывается вашими файлами сущностей, и никакое изменение в них их не устранит — каждое является ошибкой внутри плагина. Сообщите текст сообщения тому, кто публикует плагин, указав названный в нём экспорт, и закрепите версию плагина, которая работала, пока ошибку не исправят. Если плагин ваш: возвращайте сбой в конверте результата вместо аварийного завершения или выхода, чтобы сборка получила сообщение, которое можно показать; а если сообщённый сбой — обдуманный ответ самого плагина, его сообщение и увидит читатель, поэтому стоит указать, что именно во входных данных он не смог принять.

A plugin returned something that is not the shape the socket reads (Плагин вернул данные не той формы, которую читает точка подключения)

Каждая точка подключения сверяет полученный результат с ожидаемой формой и отвергает всё остальное — поле, которое форма не объявляет, поле, значение которого не имеет объявленного для него типа, или байты, вообще не являющиеся корректным результатом.

Она отвергает результат, а не читает то, что может, потому что чтение того, что получается, было бы незаметным. Экспорт, который вызывает подключение, можно выбрать для каждого подключения, поэтому подключение может назвать экспорт, результат которого имеет совсем другую форму. Пропуск неподходящих частей даёт пустой результат — а пустой результат сам по себе законный ответ: вердикт не возвращён, замечаний нет. Эти два случая было бы невозможно различить, и сборка продолжилась бы так, будто плагин её одобрил.

Выводимое сообщение называет экспорт, из которого пришёл результат, и содержит причину, по которой чтение не удалось, — вместе они указывают, какой экспорт должно было назвать подключение:

call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read> (вызов: wasm: гостевой плагин вернул вывод не той формы, которую читает точка подключения)

Как исправить: сверьте функцию входа, которую называет подключение, с экспортами, объявленными плагином, — частая причина в подключении, указывающем не на тот экспорт, а причина в сообщении называет лишнее поле. Если экспорт выбран верно, плагин возвращает форму, которую точка подключения не читает, и исправлять нужно плагин; сообщите об этом тому, кто его публикует, указав и экспорт, и причину.

A plugin returned a diagnostic at a severity that is not declared (Плагин вернул диагностику с необъявленным уровнем серьёзности)

Вместе с результатом плагин может возвращать наблюдения, и у каждого есть уровень серьёзности из закрытого набора: один останавливает сборку и называет, что исправить, другой показывается рядом со сборкой, которая всё же завершается, третий записывает наблюдение и ничего не меняет. Для уровня вне этого набора у хоста нет маршрута, и сборка останавливается.

Хост отвергает значение, а не выбирает маршрут, и обе альтернативы хуже. Пропуск наблюдения, которое нельзя направить, означал бы, что делать ничего не нужно, — а там, где плагин решает, принять ли сборку, это читается как одобрение: возражение плагина пропустило бы сборку, так и не будучи показанным. Обработка его как останавливающего уровня отвергла бы сборку из-за значения, которое никто не выбирал. Оба варианта незаметны, поэтому хост сообщает, что значение неверно, и исправляется плагин.

Проверка выполняется один раз, там, где читается результат, а не в каждом месте, где наблюдение позже показывается, — это ещё и единственный момент, когда личность плагина ещё известна: наблюдение, включённое в отчёт, уже не знает, какой плагин его поднял.

Выводимое сообщение называет плагин, экспорт, ошибочное наблюдение, его значение и объявленные значения:

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" (вызов плагина: wasm: гостевой плагин вернул диагностику, уровень серьёзности которой не объявлен контрактом: у диагностики уровень серьёзности; объявленные уровни серьёзности —)

Как исправить: ваши файлы сущностей тут ни при чём — значение пришло от плагина. Сообщите об этом тому, кто публикует плагин, указав названное в сообщении значение. Если плагин ваш, выдавайте один из трёх объявленных уровней серьёзности; сообщение их называет, а индекс указывает, на какое наблюдение смотреть.

A provider returned two output files under one path (Провайдер вернул два выходных файла по одному пути)

Провайдер возвращает свой вывод как список файлов, каждый из которых называет путь, по которому он записывается. Хост собирает их с ключом по пути и записывает байты каждого файла дословно, не запуская собственного сериализатора. Два файла с одним путём оставляют в этой коллекции два значения для одного ключа.

Хост отвергает их, а не выбирает один, потому что впоследствии ни один выбор нельзя отличить от другого. Сохранение последнего отбрасывает файл, который провайдер велел записать; сохранение первого отбрасывает более поздний. В любом случае вывод на диске корректен и короче на один файл, и ничто не фиксирует, что файл был отброшен, — а уцелевший путь уцелел бы в любом случае, так что ничто в результате не говорит о коллизии. Какой из двух имелся в виду, может ответить только провайдер.

Условие возникает везде, где провайдер возвращает файлы: при рендеринге одного узла и при сборке вывода группы диспетчеризации в один артефакт. Условие и исправление в обоих случаях одинаковы, поэтому оба о нём сообщают.

Выводимое сообщение называет путь, возвращённый дважды, и узел или путь диспетчеризации, для которого он был возвращён:

provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>") (гостевой провайдер вернул два выходных файла по одному пути; соответствующий контракту гость возвращает каждый выходной путь не более одного раза (путь, узел))

Как исправить: ваши файлы сущностей тут ни при чём — пути пришли от провайдера. Сообщите об этом тому, кто его публикует, указав названный в сообщении путь. Если провайдер ваш, возвращайте каждый выходной путь не более одного раза: стройте список путей по множеству, чтобы второй файл по тому же пути обнаруживался там, где он создаётся, и дайте второму файлу отдельный путь, если нужны оба.

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 содержит файл с его путём и содержимым (узел, побочный эффект))

Как исправить: ничто в ваших файлах сущностей не вызывает эту ошибку — ответ пришёл от плагина. Сообщите о ней тому, кто его публикует, процитировав индекс, названный в сообщении. Если плагин ваш, заполняйте член 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 (Сборке провайдера передан фрагмент, который его собственная нарезка не создавала)

Провайдер, форму вывода которого нельзя адресовать напрямую, может нарезать её сам: он разбивает выходной файл на адресуемые фрагменты, каждый под своим токеном, и возвращает их. Затем шаг конвейера адресует фрагмент по этому токену, а повторная сборка побайтово точно вставляет отредактированные фрагменты обратно в файл. Обе половины составляют один контракт: токены, под которыми нарезан файл, — это те же токены, которые разрешает его повторная сборка.

Если повторной сборке передан токен, которого нарезка того же файла не создавала, отредактированному содержимому некуда вернуться: для него нет диапазона байтов. Сборка отказывает, а не отбрасывает фрагмент, потому что отброшенный фрагмент даёт файл, который корректно сформирован, но лишён правки, которую шаг должен был внести: ничего не сломалось, ничего не искажено, а правки просто нет.

Две половины могут разойтись только там, где они разделены, — у кодека, который нарезает сам, а для остального заимствует стандартную структурную сборку. Нарезка под одним набором токенов и сборка по другому дают именно эту ошибку. Кодек, которому принадлежат обе половины, до неё дойти не может: его собственная сборка отвечает за его собственные токены.

Выводимое сообщение, в котором названы токен, ни во что не разрешившийся, и файл, для которого он был указан:

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 указывает токен изменённого фрагмента, которого нарезка не создавала; соответствующий контракту кодек нарезает и собирает файл под одними и теми же токенами (токен, файл))

Как исправить: ваши файлы сущностей тут ни при чём. Если провайдер ваш, сделайте так, чтобы токены, создаваемые одной половиной, были токенами, которые разрешает другая: вычисляйте их один раз и передавайте дальше, а не вычисляйте независимо на каждой стороне; а если нарезка переписывает файл перед разбиением, собирайте по той же переписанной форме. Если провайдер не ваш, сообщите об этом его издателю, указав токен из сообщения.

A workload declares a form compose cannot express (Рабочая нагрузка объявляет форму, которую compose не может выразить)

Провайдер compose отрисовывает долго работающие сервисы. У рабочей нагрузки, объявляющей, что она запускается по одной копии на машину, по расписанию или однократно до завершения, нет чистого эквивалента на одной машине, поэтому отрисовка останавливается, а не выводит обычный сервис, — тот бы запустил её, поддерживал в работе и исказил то, что было запрошено.

Выводимое сообщение. Условие называет вид сбоя — у провайдера нет выражения для чего-то, что объявляет сборка, — а собственное предложение провайдера называет переданную ему форму:

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: для формы рабочей нагрузки нет сопоставления в compose; compose поддерживает только stateless и stateful: compose не может выразить эту форму рабочей нагрузки)

Как исправить: если целевая среда действительно одномашинная среда compose, выразите работу как долго работающий сервис — формы stateless и stateful являются двумя, которые он отрисовывает. Если вы имели в виду именно эту форму, отрисовывайте эту границу через провайдер, у целевой среды которого есть эквивалент: копия на машину, запуск по расписанию и задание до завершения имеют прямые выражения в других средах, а выбор провайдера относится к границе, а не к рабочей нагрузке.

A container declares a field compose has no primitive for (Контейнер объявляет поле, для которого в 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 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. Если вы имели в виду именно это поле, отрисовывайте эту границу через провайдер, у целевой среды которого есть такой примитив.

An omits entry names a kind or a namespace a compose file does not have (Запись omits называет вид или пространство имён, которых нет в файле compose)

Запись omits: в сущности Recipe или FeatureRecipe, которая берёт за источник файл compose, исключает одну единицу верхнего уровня этого файла, а в файле compose ровно три вида, которые может назвать запись, — service, volume и config, каждый под ключом services:, volumes: или configs:, — и нет пространств имён. Запись, называющая любой другой вид, в том числе Secret из документа чарта или network из compose, или содержащая namespace, не называет ничего, что файл мог бы исключить, поэтому отрисовка останавливается, а не считает запись ничему не соответствующей. Виды сравниваются точно, поэтому Service отклоняется там, где имеется в виду service. Все записи проверяются до того, как что-либо исключается, и называется первая ошибочная в порядке написания записей.

Выводимые сообщения. Оба сообщают условие для конструкции, у провайдера для которой нет выражения, а собственное предложение провайдера называет запись и принимаемые им виды. Поле, шаблон которого прочитал значение, объявленное конфиденциальным, показывается как <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 (имя) называет вид: compose исключает service, volume или config, каждый по своему ключу в services:, volumes: или configs:, и никакой другой вид)

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 (вид, имя) называет пространство имён, а в файле compose нет пространств имён: compose исключает service, volume или config, каждый по своему ключу в services:, volumes: или configs:, и никакой другой вид; удалите пространство имён из записи)

Как исправить: назовите единицу так, как это делает файл compose, — kind: service, volume или config, а name: — её ключ в этом разделе — и удалите namespace:. См. compose → Режим с источником.

Запись omits называет пространство имён, которого нет в шаблоне CloudFormation

Запись omits: в сущности Recipe или FeatureRecipe, которая берёт за источник шаблон CloudFormation, исключает один ресурс, названный своим Type в поле kind записи и своим логическим ID в поле name записи. В шаблоне нет пространств имён, поэтому запись с полем 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 (плагин не может выразить конструкцию, которую объявляет эта сборка; cloudformation-provider: запись omits (kind, name) называет пространство имён, а в шаблоне CloudFormation нет пространств имён: cloudformation исключает ресурс, названный своим Type в поле kind записи и своим логическим ID в Resources в поле name записи; удалите пространство имён из записи)

Как исправить: удалите namespace: из записи, которая называет ресурс только его Type и логическим ID. См. cloudformation → Исключение ресурсов из шаблона-источника.

Опубликованный порт объявляет транспорт, который 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 может записать, или оставьте его необъявленным, и запись будет опубликована без суффикса. Если вы имели в виду именно этот транспорт, рендерьте эту границу через провайдер, цель которого может его выразить.

Количество ресурсов невозможно преобразовать в значение compose

Количества процессора и памяти контейнера, а также его счётчик nvidia.com/gpu записываются в нотации, которую Kubernetes использует для ресурсов, а compose хранит их в собственных единицах — счётчик GPU становится счётчиком резервирования устройств NVIDIA, — поэтому каждое читается как количество и преобразуется из своего значения. Это могут остановить две вещи, и сообщение указывает, какая из них встретилась: значение, которое вообще не является количеством, и количество, для которого в compose нет точной формы, — отрицательная величина, объём памяти, не равный целому числу байтов, количество процессора точнее девяти знаков после запятой для ядра, счётчик GPU, не равный целому числу устройств, или величина, превышающая максимум, который может хранить compose. Контейнер, у которого request и limit для nvidia.com/gpu запрашивают разные счётчики, тоже останавливает сборку, потому что compose резервирует для сервиса один счётчик. Сборка останавливается, а не округляет значение и не выдаёт приближение, потому что лимит, который молча оказывается не тем, что запрашивали, — это та разница, которую никто не ищет, пока что-нибудь не остановят за его превышение.

Выводимые сообщения. Каждое начинается с условия — значения, не имеющего представления в том, что выдаёт провайдер, — затем называет ресурс, является ли значение request или limit, его путь в сущности 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: request или limit ресурса по пути — значение не является количеством; количество — это число, например 2, 0.5 или 1.5, с необязательным знаком и не более чем одним из двух: целочисленной экспонентой (1e3, 5E-2) или суффиксом единицы (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): количество ресурсов невозможно преобразовать в значение deploy.resources compose)

За количеством, которое 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 (у плагина нет представления для переданного ему значения; compose: узел, контейнер: compose: request или limit памяти по пути — количество, которое compose не может представить точно; значение памяти в compose — целое число байтов от 0 до 9223372036854775807: количество ресурсов невозможно преобразовать в значение deploy.resources compose)

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 (у плагина нет представления для переданного ему значения; compose: узел, контейнер: compose: request или limit процессора по пути — количество, которое compose не может представить точно; значение cpus в compose — число ядер от 0 до 9223372036.854775807 не более чем с девятью знаками после запятой: количество ресурсов невозможно преобразовать в значение deploy.resources compose)

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 (у плагина нет представления для переданного ему значения; compose: узел, контейнер: compose: request или limit nvidia.com/gpu по пути — количество, которое compose не может представить точно; счётчик устройств в compose — целое число устройств от 0 до 9223372036854775807: количество ресурсов невозможно преобразовать в значение deploy.resources compose)

Если request и limit для 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 (у плагина нет представления для переданного ему значения; compose: узел, контейнер: compose: request nvidia.com/gpu по пути и limit по пути запрашивают разные счётчики; compose резервирует для сервиса один счётчик устройств, поэтому запишите одинаковый счётчик в оба поля или только limit: количество ресурсов невозможно преобразовать в значение deploy.resources compose)

Если шаблон сущности Workload читает значение, которое автор объявил конфиденциальным, ни одно сообщение не приводит отклонённое значение, и оба счётчика опускаются таким же образом.

Как исправить: если значение не является количеством, запишите его в форме, описанной в Workload → Количества ресурсов; одиночный суффикс, например m, — это то, что оставляет шаблон, когда интерполируемое им значение пусто, поэтому исправлять нужно тот вход, который прочитал шаблон. Если это количество, которое compose не может представить, запишите величину в пределах диапазона, указанного в сообщении, — память как целое число байтов в любой единице (1536Mi, а не 1.5001Gi), процессорное время не точнее девяти знаков после запятой для ядра, а счётчик GPU как целое число устройств (1, а не 0.5 или 500m). Если request и limit для GPU расходятся, запишите одинаковый счётчик в оба поля или запишите только limit — именно этот счётчик Kubernetes планирует для той же сущности Workload.

Количество ресурса, которое выдаёт провайдер helm, не является количеством

Провайдер helm дословно копирует каждое количество ресурса в выдаваемые им манифесты — значения resources.requests и resources.limits каждого контейнера и init-контейнера, включая расширенные ресурсы, а также ephemeral.sizeLimit, persistent.size и persistentTemplate.size каждого тома — и сначала проверяет каждое из них на соответствие форме количества, по сущности Workload в том виде, в каком её вычислили шаблоны сущности Recipe. Значение вне этой формы останавливает сборку здесь, тогда как иначе сборка прошла бы без ошибок, а кластер отклонил бы значение при установке чарта.

Выводимое сообщение. Оно начинается с условия, затем называет узел, путь поля в сущности 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 попадает в поле ровно в том виде, в каком был записан.

Тип сервиса, который провайдер helm не может отрисовать

Провайдер helm отрисовывает каждую запись services сущности Workload как Kubernetes Service, тип которого — type этой записи. Запись Loopback требует, чтобы её порты были доступны с собственного loopback-адреса хоста и ниоткуда больше, а у Kubernetes Service нет типа, который это обеспечивает: на каких адресах узлов слушает Service типа NodePort — это настройка всего кластера, а не отдельного Service. Поэтому сборка останавливается на первой записи Loopback в порядке объявления сервисов, до записи какого-либо ресурса.

Сборка останавливается, а не отрисовывает запись как другой тип, потому что каждый из имеющихся у Service типов меняет доступность порта: Service типа ClusterIP лишает запись запрошенной публикации, а Service типа NodePort публикует порт на каждом адресе узла, который допускает кластер, — то есть даёт более широкую доступность, ради избежания которой запись и существует.

Выводимое сообщение. Оно начинается с условия, затем называет узел, путь сервиса в сущности 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: узел: services: тип «Loopback» публикует порты сервиса только на loopback-адресе хоста, а у Kubernetes Service нет такого типа; объявите ClusterIP, чтобы оставить порты внутри кластера, или NodePort либо LoadBalancer, чтобы опубликовать их вне его)

Как исправить: для цели helm объявите тип, определяющий, насколько далеко порт должен быть доступен в кластере, — ClusterIP, чтобы оставить его внутри, NodePort или LoadBalancer, чтобы опубликовать его. Запись Loopback предназначена для цели compose, которая публикует порт на 127.0.0.1; см. Workload → services.

Версия Kubernetes, для которой провайдер helm не может отрисовать чарт

Провайдер helm отрисовывает чарт из исходников для версии Kubernetes, указанной в аннотации aggrega.ai/kubernetes-version на компоненте или на его границе, и читает значение так же, как helm template --kube-version читает свой флаг. Значение, которое этот флаг отклонил бы, — "one.two", "latest", одиночное число, например "1", число с ведущим нулём, например "01.20", — не даёт версии, которую чарт мог бы прочитать как .Capabilities.KubeVersion, поэтому сборка останавливается до отрисовки чарта.

Сборка останавливается, а не отрисовывает чарт для версии по умолчанию, потому что чарт читает версию, чтобы выбрать версию API, поле или целый механизм, и чарт, отрисованный для версии, отличной от указанной вами, выдаёт структуру для той другой версии — которую кластер, куда он развёртывается, может не поддерживать.

Пустое значение не отклоняется. Оно считается незаданным, и чарт отрисовывается для версии по умолчанию: той, для которой отрисовывает стандартный helm template того же выпуска helm.

Выводимое сообщение. Оно начинается с условия, затем называет узел и границу, в которой он размещён, аннотацию, значение и то, почему оно не является версией, и указывает, в какой форме его записать:

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», на компоненте или на его границе)

Сообщение называет и узел, и его границу, потому что провайдер читает аннотации компонента и его границы вместе, причём собственное значение компонента имеет приоритет, так что значение могло быть записано в любом из этих мест.

Как исправить: укажите версию кластера, в который развёртывается чарт, — мажорную и минорную версию, например "1.31", или полную, например "v1.31.2", — на компоненте или на его границе, либо удалите аннотацию, чтобы отрисовать чарт для версии по умолчанию. См. helm → Версия Kubernetes, для которой отрисовывается чарт.

Проверку работоспособности нельзя преобразовать в healthcheck compose

Объявленная проверка работоспособности становится healthcheck compose, и помешать этому могут две вещи.

Проверка пути по HTTP на контейнере, который не публикует ни одного порта. Проверка строится как запрос к порту контейнера, поэтому без объявленного порта не к чему её построить.

Проверка, в которой не объявлен ни один способ проверки — ни путь, ни порт для подключения, ни команда для запуска. Преобразовывать в проверку нечего. Это защита, стоящая за схемой, а не структура, которую вы, скорее всего, напишете: наличие одного из трёх способов проверяется до того, как проверка попадает сюда.

Выводимые сообщения. Оба сообщают об одном условии — провайдер не смог свести нечто необходимое ему ровно к одному значению, — а собственная фраза провайдера уточняет, о чём речь:

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: узел, контейнер: проверка 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 читает первый порт контейнера, поэтому порт должен существовать, чтобы проверку можно было построить. Если контейнер действительно ничего не публикует, проверяйте его иначе: проверке, запускающей команду, порт не нужен. Проверке без объявленного способа задайте один из трёх.

У тома 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 (compose AssembleBoundary: сервис ссылается на config, смонтированный по пути; объявите каждый как запись configs: верхнего уровня из входа artifacts: сущности Recipe: тому configmap требуется файл, выпущенный через вход artifacts: сущности Recipe; не найден)

Как исправить: выпустите файл из входа artifacts: сущности Recipe под именем, на которое ссылается том, — они сопоставляются по этому имени, поэтому обычная причина — несовпадение того, что запрашивает том, и того, что выпускает Recipe. Если содержимое должно было поступать из другого места, том — неподходящий для этого механизм: значение, которому место в окружении, следует поместить туда.

То, что исключила запись omits, всё ещё упоминается в файле compose

Запись omits: исключает сервис, том или config из исходного файла compose, а compose отклоняет файл, упоминающий то, что в нём не объявлено. Поэтому после удаления единиц, указанных в записях, любая ссылка на одну из них, оставшаяся в остальной части файла, останавливает рендеринг: сервис, указанный в depends_on, links, volumes_from, extends, значении build.additional_contexts или в режиме сети, IPC, PID или UTS вида service:; том, указанный как источник записи volumes:; config, указанный записью configs:, — всё это читается в каждом сервисе, в хуках pre_start каждого сервиса и в каждом задании. Полный список, а также значения, которые лишь выглядят как ссылки, приведены в разделе compose → Исходный режим.

Проверка читает собственный файл объявляющей сущности Recipe или FeatureRecipe, поэтому она останавливает рендеринг, даже если другой участник того же собранного файла объявляет единицу с именем исключённой. Сообщается о каждой ссылке, а не только о первой, — сервисы в порядке ключей, затем задания, хуки каждого сервиса после него, — так что одна сборка называет их все.

Выводимое сообщение. Сначала идёт условие, затем каждая ссылающаяся запись, указанная ею единица и поле, в котором находится ссылка:

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 (compose: то, что исключила запись omits, всё ещё упоминается в файле: сервис упоминает единицу в поле; compose отклоняет файл, упоминающий сервис, том или config, которые в нём не объявлены: исключите также то, что их упоминает, измените ссылку через valuesMapping или удалите запись)

Единица, имя записи которой построено из значения, объявленного конфиденциальным, отображается как <redacted>.

Как исправить: решите, что из двух вы имели в виду. Если ссылающемуся сервису единица всё ещё нужна, оставьте её: удалите запись. Если не нужна, измените ссылку через valuesMapping: сущности Recipe — список там заменяет список базового файла, поэтому depends_on: [] очищает его, — или исключите ссылающийся сервис собственной записью.

То, что исключила запись omits, всё ещё упоминается в шаблоне CloudFormation

Запись omits: исключает ресурс из исходного шаблона CloudFormation, а CloudFormation отклоняет шаблон, упоминающий ресурс, который в нём не объявлен. Поэтому после удаления ресурсов, указанных в записях, любая ссылка на один из них, оставшаяся в остальных шаблонах, останавливает рендеринг: Ref, Fn::GetAtt в списочной форме или в форме строки с точкой, DependsOn ресурса или переменная Fn::Sub — всё это читается в любом месте тела каждого ресурса и в каждом выводе. Полный список, а также значения, которые лишь выглядят как ссылки, приведены в разделе cloudformation → Исключение ресурсов из исходного шаблона.

Проверка читает собственные шаблоны объявляющей сущности Recipe или FeatureRecipe вместе: ссылка на логический ID, который всё ещё объявлен в другом из этих шаблонов, не останавливается, а ссылка на исключённый ресурс останавливает рендеринг, даже если другой компонент объявляет ресурс с этим логическим ID. Сообщается о каждой ссылке, а не только о первой, — шаблон за шаблоном в том порядке, в котором их содержит источник, в каждом шаблоне сначала ресурсы, затем выводы в порядке ключей, — так что одна сборка называет их все.

Выводимое сообщение. Сначала идёт условие, затем каждая ссылка: шаблон, в котором она находится, ресурс, который она указывает, способ указания и её расположение в виде пути от корня шаблона:

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 (cloudformation-provider: то, что исключила запись omits, всё ещё упоминается в шаблонах источника: шаблон упоминает ресурс (тип) по пути; CloudFormation отклоняет шаблон, упоминающий ресурс, который в нём не объявлен: исключите также то, что его упоминает, или удалите запись)

Если поля записи построены из значения, объявленного конфиденциальным, логический ID и тип её ресурса отображаются как <redacted>, как и любой шаг пути, содержащий этот логический ID.

Как исправить: решите, что из двух вы имели в виду. Если ссылающемуся ресурсу исключённый ресурс всё ещё нужен, оставьте его: удалите запись. Если не нужен, исключите и ссылающийся ресурс собственной записью — значение, привязанное к параметру, заменяет только ссылку на этот параметр, поэтому ссылку на ресурс им изменить нельзя. Вывод, упоминающий ресурс, исключить нельзя, поэтому ресурс, упомянутый в выводе, остаётся.

Ключ valuesMapping не называет ни одного параметра исходного шаблона CloudFormation

Исходный шаблон CloudFormation принимает значения через объявленные в нём Parameters, а valuesMapping сущности Recipe или FeatureRecipe, использующей его как источник, записывает по одному ключу на каждый заполняемый параметр. Ключу, который не называет ни одного параметра, объявленного каким-либо шаблоном источника, некуда деться, поэтому рендеринг останавливается, а не отбрасывает его, — это та ошибка, о которой сам CloudFormation сообщил бы для неизвестного параметра, но сообщённая, пока исправить её ещё в ваших руках. Параметры заполняет только valuesMapping: значения, которые ничем не сопоставлены, так никогда не читаются, поэтому собственные значения компонента или прикрепления, написанные для других его входов, с этим не сталкиваются.

Выводимое сообщение. Сначала идёт условие, затем каждый ключ, который ничего не назвал, и то, что объявляет каждый шаблон источника:

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 (cloudformation-provider: valuesMapping сущности Recipe или FeatureRecipe записывает ключ, и ни один шаблон источника не объявляет параметр с таким именем: шаблон объявляет …; исходный шаблон принимает значения только через объявленные в нём параметры, поэтому переименуйте ключ в параметр, для которого он предназначен, или удалите его из valuesMapping)

Как исправить: сравните ключ с параметрами, перечисленными в сообщении, — обычная причина — опечатка в ключе, — и переименуйте его или удалите из valuesMapping. См. cloudformation → Значения для параметров исходного шаблона.

Another component references a CloudFormation parameter a sourced template’s binding filled (Другой компонент ссылается на параметр CloudFormation, заполненный привязкой подключённого шаблона)

Заполнение параметра подключённого шаблона через valuesMapping сущности Recipe или FeatureRecipe прикреплённой сущности Feature, которая подключает этот шаблон, заменяет каждую ссылку на параметр во всех шаблонах этого источника и удаляет его объявление. Содержимое из другого места того же собранного стека — фрагмент или подключённый шаблон другого компонента либо фрагмент компонента, к которому прикреплена сущность Feature, — которое по-прежнему называет параметр через Ref, переменную Fn::Sub или Fn::ValueOf правила, называет то, чего стек больше не объявляет, и CloudFormation отклоняет это при развёртывании стека, поэтому сборка останавливается. Имя, которое какой-либо компонент стека всё ещё объявляет — как собственный параметр или как логический ID ресурса, — является ссылкой, которую стек разрешает, и не останавливает сборку.

Выводимое сообщение. Сначала идёт условие, затем каждая ссылка: компонент и шаблон, в которых она находится, параметр и компонент, чей valuesMapping в сущности Recipe или прикреплённой FeatureRecipe его заполнил, — сущность 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 (плагин не смог разрешить то, что ему требуется, ровно в одно значение: параметр, заполненный привязкой подключённого шаблона, всё ещё упоминается в другом месте собранного стека: шаблон компонента ссылается на параметр, который привязывает valuesMapping сущности Recipe или FeatureRecipe, выполняющей рендеринг для компонента; …; привязка параметра удаляет его объявление из источника, который его объявляет, и ни один шаблон стека его больше не объявляет, поэтому ссылка не называет ничего, что CloudFormation может разрешить: ссылайтесь вместо этого на то, что публикует привязывающий компонент, объявите параметр в ссылающемся шаблоне или удалите ключ из valuesMapping)

Как исправить: если ссылающемуся компоненту нужно значение, пусть компонент, заполняющий его, опубликует его через provides, и ссылайтесь на это; или объявите параметр в ссылающемся шаблоне, чтобы он получал собственное значение; или удалите ключ из valuesMapping, чтобы параметр остался объявленным и каждый компонент читал значение, переданное при развёртывании стека. См. cloudformation → Значения для параметров подключённого шаблона.

A value bound to a CloudFormation parameter cannot take the parameter’s type (Значение, привязанное к параметру 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:…}} либо встроенную функцию — или оставьте параметр непривязанным, чтобы значение передавалось при развёртывании стека.

A value bound to a CloudFormation parameter is one its constraints refuse (Значение, привязанное к параметру 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 отклонил бы его при развёртывании стека; привяжите значение, допустимое для параметра)

Как исправить: привяжите значение, допустимое по ограничению; собственное объявление параметра в шаблоне перечисляет, что разрешено.

A secret bound to a CloudFormation parameter would be written into the template (Секрет, привязанный к параметру CloudFormation, был бы записан в шаблон)

Значение, привязанное к параметру, записывается в шаблон, где его может прочитать любой, кто может прочитать шаблон стека. Рендеринг останавливается на литерале, привязанном к параметру, который шаблон объявляет как NoEcho, а если valuesMapping сущности Recipe или FeatureRecipe читает значение, объявленное автором как чувствительное, — на каждом литерале, который привязывает это отображение, поскольку ни один его результат нельзя проследить до значения, из которого он получен. Динамическая ссылка и встроенная функция записываются как заданы — включая текст внутри встроенной функции, — поэтому чувствительное значение, которое отображение вставляет в строку 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, и привязанное к нему значение было бы записано в шаблон как есть; привяжите вместо него динамическую ссылку ({{resolve:secretsmanager:…}} или {{resolve:ssm-secure:…}}) или встроенную функцию либо оставьте параметр непривязанным для значения во время развёртывания)

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; … (valuesMapping сущности Recipe или FeatureRecipe читает значение, объявленное чувствительным, поэтому создаваемый им литерал отклоняется, а привязка параметров … записала бы литерал в шаблон как есть; …)

Как исправить: сохраните секрет в 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 по имени

Fn::ValueOf в разделе Rules шаблона называет параметр по его логическому ID, а не через Ref, и читает значение, переданное для него при развёртывании стека. Привязка параметра удаляет его объявление из каждого шаблона источника, и правило — в любом из этих шаблонов — ссылалось бы на несуществующее, поэтому рендеринг останавливается.

Выводимое сообщение. Сначала идёт условие, затем правило, его шаблон и параметр:

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 (правило шаблона читает параметр через Fn::ValueOf, которая называет объявленный параметр по его логическому ID, а привязка параметра удаляет его объявление из источника; оставьте параметр непривязанным, чтобы правило могло прочитать его при развёртывании)

Как исправить: удалите ключ параметра из 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> (собранный стек компонента … не может содержать преобразование, объявленное компонентом)

Как исправить: поместите компонент, объявляющий преобразование, в отдельную границу, чтобы его стек не содержал ничего, что преобразование могло бы изменить; или, если сообщение называет содержимое, объявленное другим компонентом, перенесите это содержимое в компонент, объявляющий преобразование.

Два компонента упорядочивают одну пару преобразований противоположно

Собранный стек выполняет преобразования в одном порядке, построенном из собственного порядка каждого компонента и из порядка, документированного CloudFormation. Если два порядка не могут выполняться одновременно — два компонента перечисляют одну пару преобразований в противоположном порядке или компонент перечисляет AWS::Serverless-2016-10-31 перед AWS::LanguageExtensions, хотя CloudFormation документирует обратный порядок, — единого порядка для записи нет, поэтому рендеринг останавливается.

Выводимое сообщение. Сначала идёт условие, затем пара и те, кто упорядочил её в каждом направлении:

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 собранного стека выполняет их в одном порядке; объявите их в одном порядке)

Как исправить: объявите пару в одном порядке во всех компонентах, где перечислены оба преобразования, следуя порядку 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 (У ссылки через границу нет принимающего стека, в который её можно записать)

Когда связь зависимости проходит между двумя отдельно собираемыми выходными данными, принимающая сторона рендерится с заполнителем, а ссылка вписывается, как только существуют обе стороны. Это условие возникает, когда собранные выходные данные принимающей стороны вообще не содержат шаблона стека: нет документа, в который можно записать ссылку, поэтому заполнитель невозможно заменить.

Выводимое сообщение. Условие называет вид сбоя, а собственное предложение провайдера указывает, какие входные данные:

a plugin could not resolve something it requires to exactly one value cloudformation-provider: cross-boundary link resolve received no consumer stack template

Как исправить: ничто из написанного вами внутри принимающего компонента не вызывает этого — это форма того, что собрала его граница. Проверьте, что принимающая сторона вообще рендерится провайдером CloudFormation: у связи, входящей в границу, которая собирает что-то другое, нет стека, куда могла бы попасть ссылка, и такая связь должна соединять две границы, собираемые одним и тем же провайдером. Если обе стороны должны быть 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, который цель отклоняет, поэтому рендеринг останавливается, а не выводит его.

Выводимые сообщения. Оба сообщают об одном условии — провайдеру требуется нечто, что он не смог свести ровно к одному значению, — а собственное предложение провайдера указывает, какой из двух случаев встретился. Каждое печатается под рамкой, называющей узел:

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

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

Как исправить: объявите в рабочей нагрузке ровно один сервис типа 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> (wasm: гостевой плагин назвал условие, которое сокет не объявляет: гость назвал …, и …; плагин называет условие, объявленное этим компилятором, и прибегает к одному из …, когда лучшего нет: …)

Как исправить: ничто в ваших файлах сущностей этого не вызывает — ошибочен отчёт плагина, а сбой, о котором он сообщал, реален. Действуйте по собственному предложению плагина — это последняя часть сообщения. Если плагин ваш, сообщайте об условии, которое объявляет этот компилятор, — об одном из общих видов, перечисленных в сообщении, если сбой не подходит ни под одно из более конкретных условий; если плагин не ваш, передайте ошибочный номер тому, кто его публикует.

A source artifact is cached without a workspace root to anchor it (Артефакт источника кешируется без корня рабочего пространства, к которому его можно привязать)

Полученный артефакт источника хранится в ячейке внутри кеша артефактов рабочего пространства, а путь к этой ячейке строится от корня рабочего пространства. Это условие сообщает, что корень пришёл пустым, из-за чего путь к ячейке оказался бы относительным — он разрешался бы относительно того каталога, в котором процесс окажется в момент записи байтов, и кеш попал бы туда, куда его никто не помещал.

Такой путь отклоняется, а не разрешается, потому что ячейка, записанная не туда, хуже, чем отсутствие ячейки: последующие чтения ищут в правильном месте, ничего не находят и получают артефакт заново, так что вы увидите кеш, в котором словно никогда ничего нет, и ничто больше не укажет на причину.

Выводимое сообщение. Оно начинается с собственного предложения условия, за которым следует то, что идентифицирует артефакт:

cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>) (cacheslot: пустой workspaceRoot)

Как исправить: ничто в ваших файлах сущностей этого не вызывает, и никакое изменение в них это не устранит — корень рабочего пространства передаёт то, что запускает сборку, а не каталог. Запускайте сборку изнутри рабочего пространства, чтобы корень был обнаружен, а не передан пустым. Если вы запускаете компилятор из собственного ПО, передавайте корень рабочего пространства явно; вызывающая сторона, которой действительно нужен кеш относительно текущего каталога, передаёт одну точку — это принимается и явно выражает такое намерение.

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 (значение, из которого строится расположение в кеше, поместило бы кешированные файлы за пределы места, которое оно называет в кеше (version … для сущности …). Версия, имя, вид или хост называют один каталог кеша, поэтому не содержат / или \ и не равны . или ..; путь URL или подкаталог модуля может называть каталоги ниже своего места, но не может подниматься выше. Исправьте значение там, где оно написано, или, если его отдал реестр, попросите издателя опубликовать версию с корректным значением)

Как исправить: если значение написали вы — source.version, url или module_subdir сущности Recipe или FeatureRecipe, — исправьте его так, чтобы оно называло один каталог или путь, остающийся в пределах своего места; сообщение цитирует значение и ключ, из которого оно прочитано. Если его отдал реестр, опубликованная сущность содержит версию или координату, которая таковой не является, и никакое ваше изменение этого не исправит: сообщение называет то, что было загружено, а исправление — за тем, кто это публикует.

Ряд операций записывает или удаляет собственные файлы — в местах, которые они определяют сами, а не в указанных вами: каталог вывода сборки и каждый файл, который она туда записывает, а также каталог .trace, который заменяет сборка с трассировкой; lock-файл сущности Release и запись о доверии к плагинам рядом с ним, которые записывает pull; entity.lock рядом с сущностью, который записывает aggrega pin, а также pull, закрепляющий источники, — рядом с каждой закрепляемой сущностью; файл .aggrega-config.yaml рабочего пространства, когда команда записывает конфигурацию рабочего пространства; кэш артефактов и каждое его поддерево, которые заполняет pull и очищают aggrega cache clear и aggrega cache prune; пакеты подписей, которые pull хранит в этом кэше для каждого артефакта, чью подпись он проверил; черновики, которые записывает aggrega import; сущности Plugin, которые aggrega plugin gen-catalog записывает в свой каталог вывода; и маркер .aggrega/active-release, который записывает языковой сервер редактора при сохранении сущности Release по умолчанию, а также содержащий его каталог .aggrega. Это справедливо независимо от того, откуда запущена операция — из командной строки, языкового сервера редактора или инструментов ассистента. В разделе Граница рабочего пространства описано применяемое здесь правило и пути, которые намеренно выходят за пределы рабочего пространства.

У каждого из этих мест есть каталог, внутри которого оно должно оставаться, и какой именно — зависит от каталога, в котором операция его составляет:

  • Рабочее пространство — для всего, что составляется внутри него. Это обычный случай, и он относится также к указанному вами каталогу, лежащему внутри рабочего пространства. Каталоги сборки dist и .trace всегда составляются здесь, в корне рабочего пространства, из какой бы папки ни запускалась сборка; так же составляются черновики импорта, в котором не указан каталог вывода.
  • Указанный вами каталог вне рабочего пространства — для всего, что составляется в нём: каталог вывода, передаваемый в aggrega plugin gen-catalog или aggrega import; каталог указанной вами сущности Release или сущности, названной в конфигурации рабочего пространства, если он лежит вне рабочего пространства, — для lock-файла и записи о доверии рядом с ним; каталог сущности, указанной вами в aggrega pin, или каталог каталога, указанный через --catalog или перечисленный в конфигурации в catalog_dirs, — для entity.lock рядом с каждой сущностью в нём. Сам каталог используется так, как вы его указали: если он является ссылкой, запись идёт через неё туда, куда она указывает, — а то, что записывается внутри него, остаётся внутри него.
  • Сам каталог кэша артефактов — для всего, что записывается в кэш внутри него, и всего, что там удаляют aggrega cache clear и aggrega cache prune: это относится и к каталогу по умолчанию .aggrega/cache, и к artifact_cache_dir, который в конфигурации указан с выходом за корень рабочего пространства (../shared-cache). Собственный каталог кэша или файл в нём, являющийся ссылкой за пределы каталога кэша, отклоняется, даже если он ведёт в другое место внутри рабочего пространства, чтобы ничто записываемое в кэш и ничто удаляемое при очистке или чистке не попало на файл вне его. Сначала оценивается, где находится сам каталог кэша: указанный внутри корня рабочего пространства прослеживается, куда бы он ни вёл внутри рабочего пространства, и отклоняется, будучи ограничен рабочим пространством, если ведёт за его пределы; указанный с выходом за корень рабочего пространства используется так, как вы его указали, и если он является ссылкой, запись идёт туда, куда она указывает.

Каждое из этих мест проверяется до того, как там что-либо будет записано или удалено. Самая глубокая существующая часть пути, с прослеживанием каждой символической ссылки по пути, должна быть каталогом, внутри которого путь должен оставаться, или лежать внутри него. Ссылка в любом месте пути, ведущая за пределы этого каталога, — dist, связанный с каталогом в другом месте, lock-файл, связанный с файлом в другом проекте, .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

У диагностики нет категории: ошибка заключается в структуре файлов на диске, а не в каком-либо написанном вами документе.

Как исправить: удалите ссылку, названную в сообщении, и запустите операцию снова, чтобы она создала на этом месте настоящий каталог или файл; либо сделайте так, чтобы ссылка вела куда-либо внутри названного в сообщении каталога, — тогда она будет прослежена. Причина не в ваших файлах сущностей, и никакие изменения в них это не устранят.

A name the operation writes holds a part Windows cannot hold (Имя, которое записывает операция, содержит часть, которую Windows не может сохранить)

В Windows некоторые имена не доходят до файла в том виде, в каком они записаны. Имя, которое Windows резервирует для устройства, — CON, PRN, AUX, NUL, CONIN$, CONOUT$, с COM0 по COM9 и с LPT0 по LPT9, а также имена 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

У диагностики нет категории: имя приходит от того, что его создало, — издателя архива, Recipe или библиотеки, импортера, пути, указанного в правке, — а не из одного документа, к которому компилятор относит ошибку.

Как исправить: переименуйте указанную в сообщении часть там, откуда берётся имя. Для записи архива это опубликованный исходный артефакт или сущность, изменить которые может только их издатель. Для сгенерированного файла — имя вывода, которое ему даёт Recipe или ArtifactLibrary; для черновика — импортер, который его назвал; для правки — путь документа. Никакие настройки машины с Windows не сделают имя пригодным в записанном виде.

Условия, которые не останавливают сборку

Каждое из условий выше останавливает сборку. Некоторые условия имеют собственный короткий код и сообщение, но никогда её не останавливают; они перечислены здесь, чтобы код, который у вас на руках, всегда к чему-то вёл, с какой бы страницы вы ни пришли.

Они делятся на четыре вида, и разницу стоит знать до того, как вы начнёте искать исправление.

  • Рекомендация. Сборка сообщает о ней и продолжает работу, а результат рендеринга одинаков независимо от того, примете ли вы меры. Каждая рекомендация полностью описана на странице warnings.md — что её вызывает, где в процессе компиляции она проверяется, что она выводит и что с ней делать, — а записи ниже указывают нужный раздел, не повторяя его здесь.
  • Условие, которое поглощает редактор. На него отвечает сама интеграция с редактором, и оно не попадает ни в результат сборки, ни в диагностику.
  • Страховка за более ранним отказом. Правило, которое она защищает, обеспечивается раньше условием, которое останавливает сборку, поэтому сборка сначала встречает именно его.
  • Отказ в команде, которая не является сборкой. Это жёсткая остановка с реальным способом исправления — она завершает команду, которая её встретила, и ничего не публикуется, не записывается и не изменяется, — но ни один этап компиляции до неё не доходит, поэтому ни одна сборка о ней не сообщает. Такие отказы встречаются при публикации или подписании артефакта, закреплении входных данных сущности, добавлении реестра, редактировании документа, преобразовании стороннего описания источника в черновые авторские файлы и проверке всего каталога — на корректность или на соответствие соглашениям о публикации; в каждой записи указано, к какой команде она относится и кто может её исправить.

Привязка аннотации объявляет один путь в обоих списках опор

Рекомендация. Привязка аннотации в Manifest называет один и тот же путь с точками и в списке maps.infra, и в списке maps.values. Объявлять такое пересечение допустимо, и компилятор его не контролирует: правило разрешения конфликтов маршрутизации детерминированно направляет путь через infra, из-за чего сторона values этого пути становится недостижимой из Aggregate.

Её сообщение начинается так:

annotation binding declares one path in both pillar lists (привязка аннотации объявляет один путь в обоих списках опор)

Она предупреждает вас до того, как сборка встретит остановку, описанную выше в разделе «An annotation routes through a pillar its authoring side may not use (аннотация направляется через опору, которую её авторская сторона использовать не может)», — рекомендация является ранним сигналом, а та остановка обеспечивает соблюдение правила. Проверка описана в разделе «Binding-map-overlap lint» на странице warnings.md.

Имя вложения отличается от объявленного слота на одну правку

Рекомендация. Компонент присоединяет 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 (имя вложения почти совпадает с объявленным слотом)

Описано в разделе «Attachment-slot near-miss lint» на странице warnings.md, включая порог сопоставления и то, что проверка намеренно не обнаруживает.

Имя сокета в uses: отличается от объявленного сокета на одну правку

Рекомендация. Собственный блок uses: компонента называет сокет, который его тип не объявляет, но который отличается от одного из объявленных на одну правку. Разработчик владеет топологией, которую объявляет Aggregate, и может назвать сокет, которого каталог не предусмотрел, поэтому имя сокета, не объявленное типом, в этом месте допустимо и ничего не останавливается. Рекомендация указывает на последствие: имя с опечаткой создаёт собственное специальное соединение без селектора и без контракта для ребра, а нужный вам сокет остаётся неподключённым.

Её сообщение начинается так:

uses socket name is a near miss for a declared socket (имя сокета в uses почти совпадает с объявленным сокетом)

Описано в разделе «Uses-socket near-miss lint» на странице warnings.md. Два соседних места, где имя сокета, отсутствующее в usesSchema сущности-владельца, действительно останавливает сборку, описаны выше в разделе «uses: socket not declared in the owning entity’s usesSchema (сокет не объявлен в сущности-владельце)».

Recipe публикует ключ provides, который его Component не объявляет

Рекомендация. Recipe, привязанный к компоненту, публикует в provides: ключ, который тип компонента не объявляет в своём контракте spec.schema.provides:. Публиковать больше, чем объявляет Component, допустимо и останется допустимым — контракт требует подмножества и разрешает надмножество. Рекомендация указывает на последствие, незаметное ни с одной из сторон: потребитель, читающий через ребро uses:, видит объявленный контракт цели, а не то, что выдаёт её Recipe, поэтому необъявленный ключ не доставляется, и шаблон потребителя, читающий его, выводит пустое значение.

Её сообщение начинается так:

Recipe publishes a provides key its Component does not declare (Recipe публикует ключ provides, который его Component не объявляет)

Обратный случай рекомендацией не является: Component, объявляющий ключ, который его Recipe не публикует, оставляет контракт невыполненным и останавливает сборку. Описано в разделе «Undeclared-provides-key lint» на странице warnings.md.

Объявленный параметр ничем не читается

Рекомендация. Aggregate объявляет запись в spec.parameters:, и ни одна ссылка {{ .parameters.<key> }} в собственном тексте этого Aggregate её не читает, поэтому что бы ни передал для неё Release, результат рендеринга одинаков. Компилятор не контролирует, какие настройки открывает автор, а параметр вполне может быть объявлен раньше ссылки, которая будет его читать, поэтому это рекомендация, а не остановка.

Её сообщение начинается так:

declared parameter is read by no reference in the Aggregate (объявленный параметр не читается ни одной ссылкой в Aggregate)

Описано в разделе «Unread declared-parameter warnings» на странице warnings.md, включая то, почему значение по умолчанию не даёт исключения, и то, какие ссылки проверка видит, а какие нет.

Привязка провайдера называет возможность, которую не обслуживает ни один плагин, читаемый сборкой

Рекомендация. Запись plugins.providers называет возможность, но не плагин, и ни один из плагинов-провайдеров, которые читает сборка, — в каталогах, внутри компилятора или среди записанных в lock-файле, — эту возможность не обслуживает. Так выглядит опечатка в имени возможности, и такая запись ничем не читается: привязка учитывается, только когда Recipe запрашивает её возможность, а привязка без плагина не выбирает ничего, что разрешение возможности не выбрало бы и без неё.

Это рекомендация, а не остановка, потому что сборка не может знать наверняка. Привязки записываются один раз для всего рабочего пространства, а сборка выполняется для одного Release, поэтому плагин, обслуживающий возможность, может читаться только другим Release. Запись, называющая плагин, оценивается иначе и останавливает сборку там, где она заведомо неверна, — см. выше «A plugins.providers binding names a plugin that does not serve the capability (привязка plugins.providers называет плагин, который не обслуживает эту возможность)».

Её сообщение начинается так:

plugins.providers entry names a capability no provider-rendering plugin the build reads serves (запись plugins.providers называет возможность, которую не обслуживает ни один читаемый сборкой плагин рендеринга провайдера)

и продолжается названием возможности и обслуживаемой возможностью, отличающейся на одну правку, если такая есть. Описано в разделе «Provider-binding unserved-capability warning» на странице warnings.md.

Позиция в редакторе выходит за пределы документа

Условие, которое поглощает редактор. Функции редактора, зависящие от положения курсора, — переход к определению, всплывающие подсказки, автодополнение — сначала находят курсор в разобранной структуре документа. Это условие сообщает данный шаг, когда позиция указывает на строку, которой в документе нет; так временно бывает, пока правка ещё обрабатывается, а позиция, отправленная редактором, была вычислена по тексту, который документ уже успел изменить.

Его сообщение:

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 превышает ограничение глубины)» выше.

Она включена в каталог, потому что объявлена и имеет собственный код, так что имеющийся у вас код всегда находит описание. Ничто из того, что вы можете написать, её не вызывает, а её появление означало бы, что описанное выше устройство больше не соблюдается, — об этом стоит сообщить как о дефекте, а не обходить.

Явное значение вытеснило значение, заданное аннотацией

Предупреждение. Раскрытие на основе аннотаций превращает аннотацию, которую несёт 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 указывает, где была написана вытесненная аннотация, — это область, от которой она унаследована, если она не написана на вытеснившем её компоненте, — так что это не повтор ключа компонента под другой подписью.

Что делать: ничего, если явное значение — то, что вы имели в виду. Предупреждение существует, чтобы приоритет был выбором, а не неожиданностью. Если это не то, что вы имели в виду, есть два выхода, и они различаются по охвату. Удалите явную запись — и значение аннотации пройдёт к этому ключу. Или удалите аннотацию с компонента или области, которые её несут, — и вклада не будет вовсе, что затронет и все остальные ключи, которые задаёт эта аннотация. Если нужны обе стороны, но для разных ключей, сузьте ту, что охватывает больше задуманного, чтобы они больше не пересекались.

Соединение проходит между собранными выводами двух разных провайдеров

Если два конца соединения-зависимости собираются в разные выводы, провайдер, заявляющий поддержку связывания через границы, связывает их нативно — публикует ссылку на стороне-производителе и разрешает её на стороне-потребителе. Это связывание записывается в собственном словаре одного провайдера, и провайдер не может разрешить ссылку, опубликованную другим. Поэтому соединение, два конца которого отрисовываются разными провайдерами, не связывает ни один из них.

Это предупреждение, и сборка не останавливается. Соединение по-прежнему передаёт своё значение: контракт внедрения передаёт скалярное значение стороны-производителя стороне-потребителю точно так же, как в любом другом месте, так что в итоге получается работающее соединение, связанное обычным способом, а не сломанное. Результат проверки сообщает, что нативное связывание, которого вы могли ожидать, не произошло, — и вывод не меняется независимо от того, отреагируете ли вы.

Достаточно, чтобы связывание заявлял один провайдер. Обоим концам заявлять его не нужно: одно заявление означает, что нативное связывание ожидалось и невозможно, а автор, подключивший этого провайдера, — тот, кто его хотел. Требование обоих заявлений ничего бы не сообщало в обычном смешанном развёртывании, где один провайдер связывает, а другой нет, — а именно для этого случая и предназначена проверка.

Размещение концов не учитывается. Собранный вывод определяется своим путём и своим провайдером вместе, поэтому два конца с разными провайдерами всегда находятся в разных выводах, как бы они ни были размещены. Считываются два провайдера и два их заявления.

Об этом сообщается один раз для каждого такого соединения с позицией в документе и ключе, где соединение было написано.

Выводимое сообщение, начинающееся с дальнего конца и затем называющее сокет и провайдера каждого конца:

cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>") (связывание через границы между конечными точками, отрисованными разными провайдерами, не поддерживается (…, сокет …, провайдер потребителя …, провайдер цели …))

Как исправить: если скалярного значения, которое соединение уже передаёт, достаточно, ничего делать не нужно — это уведомление, а не ошибка. Если нужно нативное связывание, оба конца должны отрисовываться одним провайдером: переместите один конец в границу, которая проходит через провайдера другого, или обслуживайте обе возможности одним провайдером. Если ни то ни другое невозможно, в развёртывании остаётся форма с передачей значения, и соединение работает.

Средство запуска плагинов командной строки собрано без способа находить плагины

Плагин, добавляющий команду терминала, запускается компонентом, который сначала должен превратить ссылку на плагин в байты. Это условие сообщает, что компонент был собран без той части, которая выполняет это преобразование, поэтому от ссылки нет пути к чему-либо, что можно запустить.

Оно касается команды терминала, а не сборки, поэтому ни один этап компиляции до него не доходит: оно возникает там, где вызывается установленная команда, и его результатом является отказ этой команды запуститься, а не остановка какой-либо сборки.

Ни один путь в поставляемом инструменте командной строки не может его вызвать. Везде, где инструмент собирает этот компонент, он передаёт ему средство поиска, поэтому проверка срабатывает только там, где компонент собирает что-то другое и не передаёт средство поиска.

Выводимое сообщение, которое и есть собственная формулировка условия:

cliplugin: no plugin resolver configured (cliplugin: не настроен механизм разрешения плагинов)

Как исправить: ничто в ваших файлах сущностей этого не вызывает, и ничто из написанного в каталоге или рабочем пространстве этого не устраняет. Если вы запускаете опубликованный инструмент командной строки, это условие для вас недостижимо: установленная команда, которая не запускается, сообщает о чём-то другом, и читать следует выведенное ею сообщение. Если вы встраиваете средство запуска плагинов в собственное программное обеспечение, при его создании передайте средство поиска, которое разрешает ссылку на плагин в его байты.

Псевдоним реестра уже привязан к другому хосту

Отказ при добавлении реестра в рабочее пространство, а не при сборке. Псевдоним — это короткое имя, выбирающее одну запись реестра, поэтому он уникален среди записей. Регистрация псевдонима, который уже занят другим хостом, отклоняется, а не перекрывает существующую привязку, поскольку это незаметно изменило бы, куда указывает каждая ссылка, использующая этот псевдоним.

Повторное добавление того же хоста под его существующим псевдонимом не является конфликтом: запись обновляется на месте, что и происходит при повторном запуске команды для изменения других настроек хоста.

Выводимое сообщение, называющее псевдоним и хост, который уже его занимает:

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: отказ существует для того, чтобы перенос псевдонима был осознанным действием, а не побочным эффектом добавления реестра.

Реестр отдаёт документ доверия, который невозможно прочитать как таковой

Отказ при добавлении реестра, а не при сборке. Реестр может публиковать идентичности подписи, которыми, как он ожидает, подписываются артефакты, чтобы при добавлении реестра их можно было закрепить, а не заставлять оператора переписывать их вручную. Это условие сообщает о реестре, который ответил документом, непригодным в качестве политики доверия.

Это жёсткий отказ именно потому, что конечная точка ответила. Реестр, который ничего не публикует, — обычный, ожидаемый исход, который допускается; реестр, публикующий что-то нечитаемое, — это ошибка конфигурации, и если ничего из него не закрепить, реестр незаметно остался бы незакреплённым, хотя выглядел бы закреплённым.

Здесь сообщается о трёх случаях: содержимое, которое вообще не декодируется, включая документ с полем, не определённым форматом; запись идентичности, не указывающая ни точную идентичность, ни шаблон; и запись идентичности без издателя. Последние два отклоняются, потому что такая запись никогда не может совпасть с подписью, а значит, ослабила бы закрепление, создавая видимость его усиления.

Выводимые сообщения. Содержимое, которое не декодируется:

registrytrust: advertised trust config is malformed: <what the decoder reported> (registrytrust: объявленная конфигурация доверия имеет неверный формат)

запись идентичности, с которой нечего сопоставлять:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp (registrytrust: объявленная конфигурация доверия имеет неверный формат: запись идентичности должна задавать identity или identity_regexp)

и запись без издателя:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer (registrytrust: объявленная конфигурация доверия имеет неверный формат: запись идентичности должна задавать issuer)

Каждое обрамляется командой, которая с ним столкнулась:

aggrega registry add: <the message above>

Как исправить: исправление за тем, кто обслуживает реестр, а не за вами: перешлите им сообщение, поскольку в нём названа точная запись и то, чего в ней не хватает. Чтобы пока продолжить работу, добавьте реестр без закрепления его объявленной политики и укажите идентичности или ключ сами; команда принимает их напрямую — так же поступают и с реестром, который вообще не публикует политику.

Реестр не публикует документ доверия

Обычный, ожидаемый исход, а не ошибка, и он ничего не останавливает. Реестр может публиковать ожидаемые им идентичности подписи, и большинство этого не делают. На запрос такой реестр отвечает, что документа у него нет, и добавление реестра продолжается: исход выводится как уведомление, а идентичности вместо этого закрепляются вручную.

Этот случай намеренно отличается от недоступного реестра. Этот реестр ответил; ответ состоял в том, что он не публикует политику. Разделение этих случаев позволяет допускать намеренное отсутствие документа, сохраняя видимость проблемы с доступностью.

Выводится как уведомление, называющее реестр, его ответ и то, что делать вместо этого:

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.

Исключение — официальный хаб: у него есть встроенная базовая политика, поэтому если он не публикует документ, вместо него закрепляется эта базовая политика, а уведомление сообщает, что ответил хаб и что вместо документа используется базовая политика, а не просит вас закрепить идентичности.

Как исправить: ничего не сломано. Если вы хотите проверять подписи из этого реестра, укажите идентичность или ключ при его добавлении, точно как сказано в уведомлении, — это обычный путь для реестра, не публикующего политику. Если нет, реестр добавляется без позиции по подписям, и артефакты из него проверяются, только если они несут подпись.

Реестр добавляется в автономном режиме без политики доверия для закрепления

Отказ при добавлении реестра, а не при сборке. Добавление реестра — единственный момент, когда закрепляется доверие к нему: объявляемые им подписывающие идентичности загружаются один раз, и каждое последующее получение проверяется по этой закреплённой копии. Когда рабочее пространство работает в автономном режиме, эту загрузку выполнить нельзя, поэтому к реестру не обращаются вовсе. Вместо того чтобы записать запись, которая не доверяет ничему — и по которой реестр проверялся бы при каждом последующем получении, — добавление любого реестра, кроме официального хаба, отклоняется, если вы не предоставите политику сами.

Три случая не отклоняются. Если указать идентичности или ключ, регистрируются именно они и никакой загрузки не выполняется, поэтому в автономном режиме это работает так же, как в сетевом. Официальный хаб добавляется на основе встроенного базового набора, который у него есть независимо от того, выполняется ли загрузка. А запрос без загрузки — --fetch-trust=false — регистрирует запись по флагам, точно так же, как в сетевом режиме.

Это условие встречается везде, где добавляется реестр: aggrega registry add, aggrega config init --registry <host>, запросы aggrega/registryAdd и aggrega/configInit команды aggrega serve, сообщение об ошибке которых содержит короткий код перед формулировкой, и инструменты регистрации aggrega mcp, которые выполняют эти команды. Инициализация конфигурации не принимает идентичностей или ключа, поэтому в автономном режиме она может добавить только хаб; любой другой реестр добавляйте вместо этого через 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, — чтобы объявляемая им политика была загружена и закреплена; впоследствии ничего повторять не нужно, поскольку последующие получения проверяются по закреплённой копии. Если выйти в сеть нельзя, укажите политику вручную: одну или несколько записей --identity <identity>=<issuer> для бесключевого реестра или --key с путём к файлу его открытого ключа для реестра с ключом — то есть то, что вы закрепили бы из его объявления.

Тег уже опубликован с другим содержимым

Отказ при публикации, а не при сборке. Опубликованные байты неизменны: перед выгрузкой чего-либо целевая версия ищется, и дайджест, на который она указывает, сравнивается с дайджестом, который дало бы имеющееся содержимое. Версия, уже указывающая на другое содержимое, отклоняется.

Повторная публикация побайтно идентичного содержимого не является конфликтом. Дайджесты совпадают, ничего не выгружается, и команда сообщает, что версия уже опубликована, — поэтому повторный запуск частично удавшейся публикации безопасен и завершает публикацию: прикрепляются дата публикации, которой у версии ещё нет, и её подпись, если отправка подписывает, а версия, у которой есть и то и другое, ничего не получает, как описано в разделе Completing a publication an earlier push left partial.

Флага, который это переопределяет, нет. Изменённое содержимое публикуется под новой версией: именно так у потребителей остаётся версия, на которую можно осознанно перейти, а не версия, изменившаяся у них под ногами.

Выводимые сообщения называют версию, дайджест, который она содержит, и предложенный дайджест. При публикации сущности каталога, где также названа проверка, подтверждающая повышение версии:

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 push: версия уже опубликована; перезапись отклонена — опубликуйте новую версию (aggrega lint —pre-publish проверяет повышение версии): oci: тег уже опубликован с другим содержимым)

и при публикации артефакта данных:

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 (aggrega push-artifact: версия уже опубликована; перезапись отклонена — опубликуйте новую версию: oci: тег уже опубликован с другим содержимым)

Как исправить: повысьте версию и опубликуйте снова. Для сущности каталога это означает metadata.version и каталог версии, в котором находится сущность; они меняются вместе. Прежде чем это сделать, убедитесь, что изменение было задумано: если дайджесты различаются для версии, которую вы, по вашему мнению, не трогали, содержимое на диске не совпадает с опубликованным, и выяснить причину важнее, чем опубликовать поверх. Проверка перед публикацией, названная в сообщении, сравнивает версию с предыдущей и позволяет убедиться, что повышение версии верно.

Сущность делит свой каталог с другой сущностью

Отказ при закреплении и при публикации, а не при сборке. У каждого вида сущностей есть собственный каталог, кроме трёх, которые корень рабочего пространства содержит рядом друг с другом: Aggregate, Release и Manifest. Опубликованная сущность — это один артефакт по одной координате для каждой версии, и каталог, в котором она создаётся, отражает это: шаг закрепления записывает единственный entity.lock, для которого в каталоге есть место, а публикация упаковывает сущность из её каталога. Поэтому сущность любого другого вида, рядом с которой находится другая сущность, отклоняется в обоих этих случаях: командой aggrega pin, получением или отправкой, которым поручено выполнить закрепление за автора, и командой aggrega push независимо от того, выполняет ли она закрепление. Отказ происходит до загрузки чего-либо, и ничего не записывается.

Каталог с несколькими сущностями по-прежнему загружается, проходит линтинг, валидацию и сборку. Структура оценивается только тогда, когда из каталога что-то создаётся, — и это также момент, когда сообщение может назвать мешающую сущность. Получение без закрепления ничего не записывает рядом с сущностью и не отклоняется.

Сущностью рядом с ней считается любой другой YAML-документ непосредственно в том же каталоге, чей kind: является видом сущности. Собственные файлы чарта, фрагмент 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>/ держит её там же, где каталог стандартной библиотеки держит каждую сущность. Каталог обнаруживается обходом, поэтому сборка по каталогу после перемещения выдаёт тот же результат.

У вида сущности нет медиатипа артефакта

Отказ при публикации, а не при сборке. У каждого публикуемого вида сущности есть медиатип для каждой из двух форм, которые принимает его артефакт, — только его документ или архив документа и объявленных им файлов, — и упаковка сущности ищет его по виду. Это условие сообщает о виде, для которого записи нет.

Ни одна сборка до этого не доходит. Единственное другое место, где выполняется тот же поиск, считает отсутствующую запись признаком «это не библиотека» и продолжает работу, поэтому там условие никогда не проявляется.

Выводимое сообщение: собственная формулировка условия, обрамлённая командой и упаковываемым файлом:

aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch (aggrega push: пакет: oci: неизвестный вид сущности для выбора медиатипа)

Как исправить: сверьте поле kind: публикуемого файла с видами, которые выводит aggrega push --list-kinds: здесь сообщается о виде с опечаткой или неподдерживаемом виде, и исправление поля — всё, что нужно. Если вид есть в этом списке, это пробел в инструментарии, а не в вашей сущности, и о нём стоит сообщить, указав вид.

Опубликованный архив содержит запись, которую 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, затем способом исправления. Описано в разделе «A published archive carries an entry Windows cannot use (Опубликованный архив содержит запись, которую Windows не может использовать)» в warnings.md.

Как исправить: переименуйте часть, названную в сообщении, на диске и везде, где объявления сущности называют этот файл, и опубликуйте снова. Если версия не предназначена для использования в 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: реестр требует подписей; повторите запуск с подписью артефакта (флага для отправки неподписанного содержимого здесь нет): signing: реестр требует подписей; отказ отправлять неподписанное содержимое)

требование политики рабочего пространства, которое называет вид, из-за которого артефакт попал в её охват:

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: политика подписи требует подписи для вида; повторите запуск с подписью артефакта (флага для отправки неподписанного содержимого здесь нет): signing: политика подписи требует подписи для этого вида артефакта; отказ отправлять неподписанное содержимое)

и подпись, которую не удалось создать; о ней сообщается в рамках условия реестра с цитированием исходного сбоя:

aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: подпись: signing: реестр требует подписей; отказ отправлять неподписанное содержимое)

Один вид сбоя подписи называется отдельно, потому что общее сообщение об отклонении заставляет повторно получать учётные данные, что не может помочь:

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: подпись: токен идентичности не содержит подтверждённого утверждения email или subject — процесс/клиент OIDC не вернул идентичность с областью email (повторный экспорт или повторное получение токена не поможет); настройте поставщика идентичности/клиента/область так, чтобы он её возвращал: signing: реестр требует подписей; отказ отправлять неподписанное содержимое)

Как исправить: исправление — задача оператора. Подпишите артефакт и опубликуйте снова — имеющимся ключом или бесключевым способом, в зависимости от того, на что настроено рабочее пространство. Если вы не ожидали, что потребуется подпись, сообщение указывает, какой источник её потребовал: собственная позиция реестра находится в записи этого реестра в .aggrega-config.yaml, а требование, привязанное к виду, — в политике подписи всего рабочего пространства. Ослабление любого из них — это решение о том, что вы готовы публиковать без подписи, поэтому сужение охвата политики обычно лучше, чем её отключение.

References signed together need different signing credentials (Ссылкам, подписываемым вместе, нужны разные учётные данные для подписи)

Отказ при подписании, а не при сборке. aggrega sign, получив несколько ссылок, и aggrega deprecate --from, получив пакетный файл, подписывают всё переданное одними учётными данными: одним хранимым ключом или одной бесключевой идентичностью. Какие учётные данные нужны ссылке, определяет конфигурация её реестра: signing.key_path, применимый к этому реестру, выбирает указанный в нём ключ, а если такого нет, ссылка подписывается без ключа. Если ссылкам, названным вместе, нужны разные учётные данные — ключ для одного реестра и никакого для другого или два разных ключа, — ничего не подписывается, и сообщение называет реестры с каждой стороны.

Проверка выполняется до запроса идентичности и до чтения какого-либо реестра, поэтому ничего не подписывается и не прикрепляется и никому не предлагается войти ради запуска, который не состоится. Подпись нельзя отозвать у того, кто уже её получил, поэтому запуск отклоняется, а не подписывается теми учётными данными, которые нужны одной из ссылок.

Ключ, переданный через --key, решает за все ссылки. Он применяется ко всем названным ссылкам, что бы ни говорила конфигурация для каждого реестра, поэтому такой запуск здесь никогда не отклоняется.

Это условие встречается везде, где подписывается пакет: aggrega sign, aggrega deprecate --from, запросы aggrega/signArtifacts и aggrega/deprecateArtifact сервера aggrega serve, чьё сообщение об ошибке содержит короткий код перед предложением, и инструменты sign-artifacts и deprecate-artifact сервера aggrega mcp. Вызов инструмента, достигающий сервера через слушатель, никогда не использует ключ, указанный в конфигурации, поэтому там каждая ссылка подписывается идентичностью, которую передаёт вызов, и вызов здесь не отклоняется.

Выдаваемое сообщение. Оно начинается с собственного предложения условия, затем следуют все учётные данные с реестрами, для которых они подписывали бы, а в конце — способ исправления:

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 (aggrega sign: подписание: ссылкам, названным вместе, нужны разные учётные данные для подписи, поэтому ничего не подписано (реестр подписывает хранимым ключом, указанным в 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 (aggrega sign: подписание: ссылкам, названным вместе, нужны разные учётные данные для подписи, поэтому ничего не подписано (реестр подписывает хранимым ключом, указанным в 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 (Отсоединённая подпись не проходит проверку с переданным ключом)

Отрицательный результат проверки голой подписи над полезной нагрузкой по открытому ключу, полностью офлайн: полезная нагрузка отличается от подписанной, подпись была изменена или ключ не тот, которым она создана.

Ничто в поставляемом наборе инструментов до этого не доходит. У проверки, к которой оно относится, нет вызывающих вне её собственных тестов, поэтому ни одна команда пользователя — сборка, получение или публикация — о нём не сообщает. Оно описано здесь, чтобы код указывал на что-то, а не потому, что сборка может его вывести. Проверка, которую действительно выполняет получение, идёт по полному пакету подписи и сообщает о результате отдельно.

Выдаваемое сообщение с цитатой того, что сообщил верификатор:

signing: signature does not verify: <what the verifier reported> (подписание: подпись не проходит проверку)

Как исправить: ничто в ваших файлах сущностей этого не вызывает, и ничто из написанного в каталоге или рабочем пространстве этого не устраняет. Если вы запускаете опубликованный инструмент командной строки, это условие для вас недостижимо, и проблема с подписью, которую вы видите, на самом деле сообщается одним из описанных выше условий проверки пакета. Если вы используете пакет подписания напрямую из собственного ПО, полезная нагрузка, подпись и ключ должны быть тремя связанными друг с другом элементами; обычная причина — полезная нагрузка, повторно сериализованная между подписанием и проверкой: байты тогда различаются, хотя содержимое читается так же.

A resolved artifact is not a documentation bundle (Разрешённый артефакт не является пакетом документации)

Ссылка, разрешающаяся в артефакт другого вида — сущность каталога, плагин, — отклоняется, а не кешируется как документация, поэтому ошибочно направленная ссылка даёт сбой там, куда она направлена, а не позже, как нечитаемый пакет.

Где это возникает. Пакет документации загружается в кеш, общий для всех проектов на машине, из настроенного реестра рабочего пространства в зарезервированном пространстве имён docs: сервером для ассистентов один раз, при запуске и до любого ответа, aggrega explain и объяснением кода в редакторе, когда кому-то из них он впервые нужен, а также aggrega scaffold --example, — в каждом случае только если на машине нет копии, которую допускает проверка подписи рабочего пространства. Эту проверку каждая загрузка выполняет над полученным.

Сеанс это никогда не останавливает. Загрузка сообщает результат в поток журнала сервера, и соединение продолжается в любом случае; отклонённый артефакт стоит лишь ресурсов документации, которые затем отвечают «не найдено» в этом сеансе. Команде 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 (docscache: ссылка имеет не тот тип медиа, что ожидается: docscache: артефакт не является пакетом документации)

Как исправить: ничто в ваших файлах сущностей этого не вызывает, и никакое изменение в авторинге этого не устраняет. Ссылка, использованная загрузкой, указывает на что-то, что не является пакетом документации; проверьте настроенный реестр рабочего пространства, так как ссылка на пакет выводится из него, а корректно оформленная ссылка, указывающая на другой артефакт, разрешается успешно и даёт сбой только здесь.

Страница отсутствует в пакете документации

Пакет документации был закэширован, его содержимое проверено, а запрошенной страницы — или, для aggrega scaffold --example, каталога примера — в нём нет. Это отличается от полного отсутствия пакета: пакет на месте и цел, а в нём нет нужной записи.

Оно не доходит ни до какой сборки. Поверхность, которая отдаёт страницы документации редактору или ассистенту, превращает его в обычный ответ «не найдено» для запрошенного ресурса. aggrega scaffold --example ничего не записывает и сообщает о нём как об отказе, называющем пример и пакет, за которым следует указание на aggrega scaffold --example --list, выводящую примеры, которые пакет действительно содержит.

Полезно различать, какой из двух ответов «не найдено» вы получаете, хотя поверхность отображает их одинаково. Этот означает, что пакет закэширован и цел, а страницы в нём нет. Другой — нет пакета, который рабочее пространство может читать, потому что ничего не закэшировано или единственная копия отклонена проверкой подписи рабочего пространства — означает, что получение не завершилось, и поток журнала сервера сообщает причину.

Выводимое сообщение, называющее страницу и пакет, в котором её искали:

page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle (страница в пакете: docscache: страница не найдена в пакете документации)

Как исправить: в ваших файлах ничего не сломано. Страница отсутствует в пакете потому, что пакет старше неё или запрошенный путь не совпадает с путём, под которым она опубликована: пакет получается в той версии, которую сервер сообщает как собственную, поэтому страницы, добавленной после этой версии, в нём нет. Если страница никогда не существовала, запрос указал путь, который документация не использует, и нужный путь можно найти в опубликованной документации.

Правка дала бы документ, который отклоняет его схема

Отказ при правке документа, а не при сборке. Одна структурированная правка — добавление компонента, присоединение Feature, подключение ребра или установка значения — составляется и вставляется в документ, после чего результат проверяется по схеме для вида этого документа. Если проверка возражает, правка отклоняется и ничего не записывается. Это относится к aggrega edit-document, а также к той же возможности, к которой обращается редактор через aggrega serve или ассистент; это тонкие точки входа в одну реализацию.

Вид определяется по самому документу и никогда не передаётся вызывающей стороной. Вызывающая сторона могла бы указать неверный вид, и тогда результат проверялся бы по схеме, по которой документ не написан, — что пропустило бы именно ту правку, для отклонения которой существует эта проверка.

Файл остаётся побайтно таким, каким был, а запись атомарна, поэтому отклонённая правка неотличима от никогда не предпринятой, и исправленный запрос можно повторить для исходного документа.

Предмет этого условия — корректно сформированный запрос. Запрос указал правку, которую эта возможность применяет, а документ, который получился бы, отклонила бы схема авторинга, если бы вы набрали его вручную, — поэтому никакое правило авторинга здесь не повторяется: попытка задать в Release значение разработчика отклоняется той же схемой в обоих случаях. Запрос, который вообще не задал правку — путь узла, не ведущий ни к чему в документе, значение в виде отображения там, где нужен скаляр, запись, которая уже есть и содержит другое, — отклоняется по своим причинам, и каждая поверхность сообщает об этом по своему каналу.

Документ, который уже был недопустимым, тоже сообщает об этом. Проверка выполняется даже тогда, когда правка ничего не изменила, поэтому правка документа, который продукт отказался бы читать, сообщает об этом, а не об успехе.

Эта проверка — та же, которую применяет каждое чтение документа, поэтому она также отклоняет сущность Recipe или FeatureRecipe, конвейер которой объявляет один идентификатор шага дважды, — правило, которое не может выразить ни одна схема; тогда возражение после предложения начинается с собственного предложения и совета этого условия, как описано в A pipeline declares one step id twice (Конвейер объявляет один идентификатор шага дважды).

Выводимое сообщение, содержащее после предложения собственное возражение схемы — вид документа и файл, затем позицию, ошибочный ключ и то, что схема сказала в этом месте, — и завершающееся советом:

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 (правка отклонена, так как получившийся документ был бы недопустимым, и ничего не записано: проверка оболочки документа не пройдена. Исправьте документ в соответствии со схемой его вида)

Как исправить: откройте документ в позиции, которую приводит сообщение, и прочитайте возражение: оно говорит, что схема ожидала у этого ключа. Изменять обычно нужно запрос, а не документ — запросите запись, которую схема допускает в этом месте, и тот же запрос применится без ошибок. Если ключ вообще не может присутствовать в документе этого вида, он относится к той поверхности авторинга, где может, а страница сущности для этого вида перечисляет объявляемые ею поля. Что допустимо семантически, на этом этапе не решается — например, объявляет ли производитель данный сокет зависимости, — поэтому этот отказ всегда касается формы документа и никогда не касается того, что можно потреблять через соединение.

Ключ аннотации использует префикс, зарезервированный платформой

Отказ при проверке сущности на соответствие соглашениям публикации, а не при сборке. Префикс aggrega.ai/, а также feature.aggrega.ai/ вне Feature, принадлежат платформе: ключ под таким префиксом несёт смысл, назначаемый платформой, поэтому ваша собственная сущность, пишущая туда, претендует на пространство имён, которое ей не принадлежит.

Во время авторинга оно носит рекомендательный характер, а на шлюзе публикации приводит к отказу, и в обоих случаях называется это одно условие. Найденное одинаково в обоих случаях; различаются только последствия. Так ведёт себя большинство описанных здесь правил соглашений публикации, поэтому это сказано один раз и подразумевается в записях ниже, где не сказано иное, — два правила, которые сравнивают с уже опубликованной версией, указывают это в своих записях, поскольку не могут работать с локальным содержимым вообще.

Её сообщение начинается так:

an annotation key on the entity uses a prefix the platform reserves (ключ аннотации сущности использует префикс, зарезервированный платформой)

Как исправить: перенесите ключ под префикс, принадлежащий вашей организации. Если у рабочего пространства есть причина всё же писать под зарезервированным префиксом, это правило входит в число отключаемых, описанных в разделе «The discipline rules» в aggrega-lint.md.

Имя сущности не соответствует форме, ожидаемой для её вида

Отказ при проверке сущности на соответствие соглашениям о публикации, а не при сборке. Для каждого вида сущностей действует соглашение о форме имени — число сегментов для облачно-нативных видов, PascalCase для видов библиотек, — и имя, которое объявляет эта сущность, не соответствует форме, ожидаемой для её вида.

Её сообщение начинается так:

the entity’s name does not follow the documented name shape for its kind (имя сущности не соответствует документированной форме имени для её вида)

Как исправить: переименуйте сущность в соответствии с формой, ожидаемой для её вида; соглашения для каждого вида перечислены в разделе «The discipline rules» в aggrega-lint.md, вместе со способом отказа от правила для каталога, который намеренно именует сущности по-своему.

Схема использует динамическую ссылку, которую нельзя разрешить заранее

Отказ при проверке сущности на соответствие соглашениям о публикации, а не при сборке. Схема, которую несёт сущность, использует конструкцию динамической ссылки, цель которой выбирается во время валидации документа, а не фиксируется при написании схемы. Здесь ссылки раскрываются заранее, поэтому для разрешения такой конструкции нет выполняющейся валидации.

Её сообщение начинается так:

a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow (схема в сущности использует конструкцию динамической ссылки, которой не может следовать разрешение ссылок между документами)

Как исправить: замените динамическую конструкцию обычной ссылкой, которая указывает цель напрямую. Если схеме действительно нужна эта конструкция и на неё не будут ссылаться из других документов, у правила есть способ отказа, описанный в разделе «The discipline rules» в aggrega-lint.md.

Схема объявляет идентификатор, которым владеет платформа

Отказ при проверке сущности на соответствие соглашениям о публикации, а не при сборке. Схема, которую несёт сущность, объявляет собственный идентификатор, тогда как канонический идентификатор выводится из идентичности сущности. Объявленный идентификатор вытесняет выведенный, поэтому ссылка, написанная на канонический идентификатор, перестаёт разрешаться.

Её сообщение начинается так:

a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity (схема в сущности объявляет собственный идентификатор, тогда как идентичностью этой схемы владеет платформа)

Как исправить: удалите объявленный идентификатор, чтобы он выводился автоматически. Способ отказа для схемы, намеренно публикуемой под собственным идентификатором, описан в разделе «The discipline rules» в aggrega-lint.md.

Метка категории сущности Component и её каталог называют разные категории

Отказ при проверке сущности на соответствие соглашениям о публикации, а не при сборке. Сущность Component несёт метку категории и размещается в каталоге категории; соглашение состоит в том, что оба называют одну и ту же категорию, чтобы каталог, который просматривает читатель, и метка, с которой сопоставляется селектор, не могли расходиться.

Её сообщение начинается так:

the entity’s category label does not match the category directory the entity is filed under (метка категории сущности не совпадает с каталогом категории, в котором размещена сущность)

Как исправить: исправьте то из двух, что неверно, чтобы они совпадали, — либо переместите файл в каталог, который называет метка, либо исправьте метку на категорию, которую называет каталог. Закрытый набор категорий и способ отказа описаны в разделе «The discipline rules» в aggrega-lint.md.

Расширение схемы записано непосредственно в содержимое схемы

Отказ при проверке сущности на соответствие соглашениям о публикации, а не при сборке. Сущность Component или Feature записывает расширение схемы Aggrega непосредственно в содержимое своей схемы, тогда как у сущности есть полноценная поверхность для объявления того же самого. Непосредственно записанная форма работает, а соглашение предпочитает объявленную поверхность, потому что именно ей учат страницы сущностей и именно её читают инструменты.

Это единственное правило в группе, о котором сообщает и сборка, в виде рекомендации, которая не останавливает сборку. Проверка сущности на соответствие соглашениям о публикации на этапе публикации повышает ту же находку до отказа.

Её сообщение начинается так:

the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema (сущность записывает расширение схемы Aggrega непосредственно в содержимое схемы вместо объявления его в usesSchema или featuresSchema)

Как исправить: перенесите расширение на собственную поверхность сокетов или вложений сущности — там, где его объявляют страницы сущностей component.md и feature.md. Способ отказа описан в разделе «The discipline rules» в aggrega-lint.md.

Сущность Plugin не закрепляет ни одного ограничения среды выполнения, поэтому действуют ограничения платформы

Рекомендация, выдаваемая при проверке сущности на соответствие соглашениям о публикации — как во время написания, так и на этапе публикации; она ничего не останавливает, и сборка её не выдаёт. Сущность Plugin объявляет предел памяти и ограничение времени, которые хост применяет при загрузке и запуске плагина. Плагин, не объявляющий ни того, ни другого, работает с настройками платформы по умолчанию, и это поддерживаемый исход, а не ошибка, — поэтому здесь сообщается, что действуют значения по умолчанию и что их можно закрепить явно.

Её сообщение начинается так:

the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply (сущность Plugin не объявляет собственных ограничений ресурсов среды выполнения, поэтому действуют значения платформы по умолчанию)

Как исправить: закрепите ограничения, которые действительно нужны плагину, или намеренно оставьте значения по умолчанию. У правила нет настройки отказа, и причина в том, что оно сообщает факт о сущности, а не оценку её: ослаблять нечего. Поля описаны на странице plugin.md.

Слот вложения допускает только секретные данные, но не указывает, что обрабатывает их

Рекомендация, выдаваемая при проверке сущности на соответствие соглашениям о публикации — как во время написания, так и на этапе публикации; она ничего не останавливает, и сборка её не выдаёт. Слот вложения может через свой селектор закрепить, что заполнить его может только сущность Feature, несущая секреты, и может отдельно зафиксировать, что всё, что его заполняет, обрабатывает секретные данные. Селектор указывает, какие заполнения допустимы; запись указывает обработку. Слот, который закрепляет первое и опускает второе, оставляет обработку выводить из селектора, вместо того чтобы её можно было прочитать из слота. Проверяется каждый слот, который объявляет сущность: слот её собственного блока вложений и, у сущности Component, слот, который сокет зависимости объявляет для каждого подключения, проведённого через него, — находка о слоте сокета называет сокет рядом со слотом.

Её сообщение начинается так:

an attachment slot admits only secret material and does not declare that it handles it (слот вложения допускает только секретные данные и не объявляет, что обрабатывает их)

Как исправить: объявите обработку в слоте рядом с закрепляющим её селектором. У правила нет настройки отказа — по той же причине, по которой её нет у правила об ограничениях Plugin: оно сообщает факт о сущности и оставляет решение за вами.

Сущность Recipe публикует ключ provides, который её Component не объявляет, — проверка при публикации

Рекомендация, выдаваемая при проверке сущности на соответствие соглашениям о публикации — как во время написания, так и на этапе публикации; она ничего не останавливает, и сборка её не выдаёт. Сущность Recipe публикует ключ в provides:, а сущность Component, которую реализует Recipe, не объявляет этот ключ в опоре provides своей схемы. Потребитель, подключающийся через соединение, читает объявленный контракт Component, а не то, что выдаёт Recipe, поэтому ключ создаётся, а затем отклоняется там, где его пытаются потребить.

🔴 Это описывают два условия, и это не одно и то же. Рекомендация, которую выдаёт сборка, описана выше в разделе «Сущность Recipe публикует ключ provides, который её Component не объявляет»; эта выдаётся при проверке сущности на соответствие соглашениям о публикации и имеет собственный код. Находка — один и тот же факт, встреченный на двух поверхностях: чтобы понять, какая из них перед вами, посмотрите код в диагностике.

Её сообщение начинается так:

the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused (сущность Recipe публикует ключ provides, который не объявляет реализуемая ею сущность Component, поэтому потребителю, подключающему этот ключ, будет отказано)

Как исправить: объявите ключ в сущности Component, чтобы контракт, который читает потребитель, включал то, что выдаёт Recipe, — или прекратите публиковать его из Recipe, если его не предполагается потреблять. Способ отказа описан в разделе «The discipline rules» в aggrega-lint.md.

Аннотация метрик Component и его ключ provides расходятся

Рекомендация, выдаваемая при проверке сущности на соответствие соглашениям публикации — как во время написания, так и на этапе публикации; она никогда ничего не останавливает, и сборка её не выдаёт. Сущность Component может указать, как аутентифицируются метрики её продукта, в аннотации observability.aggrega.ai/metrics-credential — none, target-key или separate-token, — и может объявить ключ provides metrics_credential_required, который каждая из её сущностей Recipes публикует, сообщая, нужны ли метрикам одного экземпляра учётные данные. Это один и тот же факт о продукте, увиденный с двух сторон, поэтому Component, указывающий, что его метрики не требуют учётных данных, такого ключа не объявляет, а указывающий, что требуют, — объявляет. Это условие сообщает о сущности Component, у которой они расходятся, и называет Component, значение аннотации и лишний или отсутствующий ключ.

Её сообщение начинается так:

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, сообщающий, что метрикам экземпляра нужны учётные данные)

Как исправить: исправьте то из двух, что неверно, — объявите metrics_credential_required в разделе provides и публикуйте его из каждой сущности Recipe, если метрики требуют учётных данных; удалите его, если не требуют; или измените аннотацию на значение, описывающее продукт. Настройки отключения у этого правила нет — по той же причине, что и у правила об ограничениях Plugin; какие значения оно читает и какие сущности Components оставляет непрочитанными, описано в разделе «The discipline rules» в aggrega-lint.md.

Соединение и цель, к которой оно ведёт, не называют один ключ

Рекомендация, выдаваемая при проверке сущности Release на соответствие соглашениям публикации; она никогда ничего не останавливает, и сборка её не выдаёт. Сервер, проверяющий ключ, хранит проверяемый ключ в собственном слоте, а вызывающая сторона предъявляет ключ в соединении, через которое она обращается к серверу. Ни одна из сторон не видит ключ другой, поэтому это один ключ лишь потому, что их авторы пишут один и тот же локатор на обоих концах. Это условие сообщает о соединении, цель которого объявляет слот для ключа, требуемого от вызывающих сторон, когда это не так: соединение несёт учётные данные, а слот ключа цели не заполнен; слот ключа цели заполнен, а соединение учётных данных не несёт; или оба заполнены, но локаторы записаны по-разному.

В отличие от правил выше, это правило читает весь Release, а не одну сущность, поэтому оно встречается только при проверке сущности Release и никогда на этапе публикации, который проверяет одну сущность отдельно; где бы о нём ни сообщалось, это рекомендация. Результат называет компонент, соединение, цель и оба слота и никогда не приводит ни один из локаторов. Сбор метрик — соединение на сокете 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 цели, — чтобы ключ, предъявляемый вызывающей стороной, и ключ, проверяемый сервером, нельзя было записать по-разному; или, если соединение не должно предъявлять ключ, уберите из него учётные данные. Какие слоты читаются, что сравнивается и как отключить правило, описано в разделе «The discipline rules» в aggrega-lint.md.

Публикуемое изменение нарушает то, что допускает рубрика эволюции

Отказ при проверке, предшествующей публикации, а не при сборке. Публикуемая версия сравнивается с ранее опубликованной версией, и разница между ними классифицируется по документированной рубрике. Это условие сообщает, что разница относится к тем, против которых рубрика возражает.

Ему нужен опубликованный предшественник для сравнения, поэтому это правило и описанная ниже проверка повышения версии — два правила в группе, которые не могут выполняться только над локальным содержимым: если реестр не запрашивается, сравнивать не с чем, и проверка пропускается, а не считается пройденной.

Её сообщение начинается так:

the version being published changes the published predecessor in a way the documented evolution rubric objects to (публикуемая версия изменяет опубликованного предшественника так, что документированная рубрика эволюции возражает)

Как исправить: прочитайте классификацию в диагностике — она называет, против чего в изменении возразила рубрика, — и либо сделайте изменение совместимым, либо опубликуйте его под версией, которая его допускает. Рубрика изложена в разделе «The version-bump rubric» в aggrega-lint.md.

Предложенная версия повышена меньше, чем требует изменение

Отказ при проверке, предшествующей публикации, а не при сборке. Публикуемое изменение классифицируется по рубрике эволюции, и предложенная для него версия — меньший шаг, чем требует эта классификация: например, удаление или сужение, предложенное как patch. Избыточное повышение версии всегда принимается; останавливает здесь недостаточное.

В отличие от правил выше, это решается здесь, а не плагином соглашений. Какое повышение предложено, известно только в момент публикации, а компиляция в это время не выполняется, поэтому сравнение классификации с предложенной версией выполняется именно тогда.

Её сообщение начинается так:

the version bump being published is smaller than the evolution check’s classification of the change requires (публикуемое повышение версии меньше, чем требует классификация изменения проверкой эволюции)

Как исправить: публикуйте под версией, которую требует классификация; диагностика её называет. Если вы считаете, что изменение меньше, чем его классифицировали, рубрика в разделе «The version-bump rubric» в aggrega-lint.md описывает, что относит изменение к каждому классу. У первой публикации сущности нет предшественника, поэтому сравнение пропускается и отмечается как невыполненное, а не как пройденное.

Импорт остановился на полпути перевода источника

Отказ при преобразовании внешнего описания источника в черновые файлы авторинга, а не при сборке. Импортёр сообщил диагностику, достаточно серьёзную, чтобы остановить преобразование, поэтому результат частичный: часть источника стала черновыми файлами авторинга, а часть — нет.

Частичный результат сделан намеренно, а не является обломками. Условие называет итог, а не причину: то, что не удалось преобразовать, сообщается в диагностиках рядом с ним — по одной на каждую конструкцию, которую импортёр не смог перенести, словами самого импортёра. Именно это условие позволяет вызывающей стороне отличить «импорт остановился и дал часть ответа» от «импорт полностью не удался» — это разные ситуации с разными дальнейшими шагами.

Её сообщение начинается так:

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>) (источник распознают несколько импортёров (источник, распознан как …). Передайте —format, чтобы указать, в каком формате его читать (например, —format … или —format …))

Как исправить: укажите формат — --format в aggrega import или format в инструменте импорта ассистента и в методе сеанса aggrega/import. Если один из импортёров никогда не должен распознавать такой источник, изменить нужно сигнатуры этого импортёра, которые его автор объявляет в самоотчёте 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>) (ни один импортёр не распознаёт источник (источник). Передайте —format, чтобы указать его явно (например, —format … или —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))

Если ни один импортёр не объявляет шаблона файлов, отказ предлагает импортировать отдельно один из файлов директории и сообщает, что ни один импортёр в каталоге не объявляет шаблонов файлов, через которые читается директория.

Как исправить: укажите формат — --format в aggrega import или format в инструменте импорта ассистента и в методе сеанса aggrega/import; каждый из них формулирует отказ в терминах принимаемого им поля и начинает его с короткого кода этого условия; ответ сеанса также содержит в своих данных оба кода условия. Для директории импортируйте отдельно тот один файл, который вы имели в виду, — сигнатура, не называющая ни одного файла, применяется к файлу, импортируемому отдельно, как бы он ни назывался, — или укажите один из форматов, перечисленных в отказе. Если источник должен был быть распознан, изменить нужно сигнатуры импортёра, обслуживающего его формат, которые его автор объявляет в самоотчёте 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 (импортёр, обслуживающий формат источника, не объявляет шаблонов файлов, поэтому читает один файл и не может прочитать каталог (формат, импортёр, каталог). Вместо этого импортируйте отдельно один из файлов каталога; импортёр сможет читать каталог, как только объявит шаблоны, по которым именуются его файлы)

Как исправить: импортируйте отдельно один файл этого формата. Чтобы импортёр читал каталоги своего формата, его автор объявляет шаблоны, по которым именуются его файлы, — files сигнатуры распознавания в самоотчёте describe(), который записывает его сущность 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 (ни один файл каталога не соответствует шаблонам файлов, которые объявляет импортёр, обслуживающий формат источника (формат, импортёр, каталог, шаблоны файлов). Укажите каталог с файлом, соответствующим одному из этих шаблонов, или формат импортёра, шаблоны которого соответствуют файлам этого каталога)

Как исправить: импортируйте каталог, содержащий файлы этого формата, — шаблон сопоставляется с концом пути файла внутри каталога, поэтому учитывается файл на любой глубине, — или укажите формат, в котором находятся файлы каталога. В aggrega-import.md описано, что читает импорт каталога.

A file read from the directory and a file named in the importer’s with.sources have the same name (Файл, прочитанный из каталога, и файл, указанный в with.sources импортёра, имеют одинаковое имя)

Отказ при преобразовании стороннего описания источника в черновые авторские файлы, а не при сборке. Указанный источник — каталог, и его файлы попадают к импортёру как именованные источники, каждый под своим путём внутри каталога. Запись plugins.importer, подключающая импортёр, указывает собственные файлы в with.sources, которые тоже попадают к нему как именованные источники, каждый под своим базовым именем, — и одно имя оказывается у обоих. По имени импортёр отличает один источник от другого, поэтому передача обоих привела бы к тому, что один из них затенял бы другой без указания, какой именно; вместо этого импорт останавливается, ничего не передав.

Её сообщение начинается так:

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 сохраняет своё базовое имя, поэтому он сталкивается с одноимённым файлом на верхнем уровне каталога; файл во вложенном каталоге содержит этот каталог в своём имени. В разделе Какой импортёр превращает источник в черновики описан with.sources записи.

An import’s target names a capability no Recipe in the catalog binds to (Цель импорта называет возможность, к которой не привязана ни одна сущность Recipe в каталоге)

Отказ при преобразовании стороннего описания источника в черновые авторские файлы, а не при сборке. Импорту была задана цель — --target у aggrega import или target у инструмента импорта ассистента и метода aggrega/import сеанса, — чтобы он создал черновик Manifest, сопоставляющий каждый тип компонента в черновике с Recipe этого провайдера. Цель — это возможность провайдера, сопоставляемая с spec.capability, к которой привязана каждая сущность Recipe в каталоге рабочего пространства, и ни одна сущность Recipe там не привязана к указанной. Manifest, созданный для неё, не сопоставлял бы ничего, и каждый тип компонента тогда выглядел бы отсутствующим в каталоге, хотя ошибочен сам параметр — чаще всего это опечатка.

Ничего не запускается и ничего не записывается. Импорт останавливается сразу после загрузки каталога, до распознавания формата источника и до запуска импортёра, поэтому черновик не создаётся и ни один файл не записывается, в том числе при пробном запуске.

Её сообщение начинается так:

no Recipe in the workspace’s catalog binds to the capability the import’s target names

Остальная часть сообщения называет цель в точности так, как она задана, и возможности, к которым привязаны сущности Recipes каталога, каждую по одному разу и в отсортированном порядке, затем способ исправления:

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, сообщение говорит об этом вместо списка, а исправление состоит в том, чтобы добавить в каталог Recipe этого провайдера.

Как исправить: укажите одну из возможностей, перечисленных в сообщении, — например, compose или helm, как их записывает spec.capability сущности Recipe, — или не указывайте цель, и тогда черновик Manifest не создаётся. Если нужного провайдера в каталоге пока не обслуживает ни одна сущность Recipe, добавьте его Recipes в папку каталога, которую рабочее пространство читает первой. В aggrega-import.md описано, что создаёт импорт с заданной целью.

Дочерняя сущность Release наследует каталог границы, который разрешается туда, куда записывает родительская

Предупреждение. Сущность Release расширяет другую и наследует от неё выходной каталог границы, а этот каталог не содержит переменной шаблона — поэтому он разрешается в один и тот же путь для обеих, и сборка дочерней записывает туда же, куда и сборка родительской.

Наследование каталога — поддерживаемая форма, а не ошибка. Каталог является шаблоном, поэтому родитель записывает его один раз, а потомок, заполняющий параметр, разрешает его в другое место без какого-либо дублирования; именно поэтому потомку не нужно повторять топологию границ родителя. Узкий, но реальный случай — тот остаточный, о котором здесь идёт речь: без переменной в каталоге нечего разрешать иначе.

Это не может остановить сборку, и это свойство правила, а не осторожность в его отношении. Запись по одному и тому же разрешённому пути автор может подразумевать вполне законно — потомок, который заменяет только рендерящие Recipes, чтобы сравнить их вывод, или меняет только размеры, — поэтому правило, останавливающее сборку на основании такого вывода, отвергало бы допустимый ввод по догадке.

Её сообщение начинается так:

inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to

Как исправить: если обе сущности должны были записывать в разные места, поместите в каталог ссылку на параметр и позвольте каждой сущности Release заполнить её. Если запись по одному пути — именно то, что вы имели в виду, ничего менять не нужно: предупреждение сообщило вам, что произойдёт, а сборка в любом случае создаёт свой вывод.

Поиск остановки по короткому коду, который вывела сборка

Заголовок в квадратных скобках у останавливающей диагностики называет категорию, к которой относится сбой, и, если сбой соответствует одному из описанных здесь условий, короткий код этого условия — букву E и четыре цифры, как в [CATALOG_ERROR E0209]. Номер выдаётся один раз и затем не меняется, поэтому короткий код, вставленный в отчёт или поиск, по-прежнему называет то же условие, что и в момент записи. Два других идентификатора условия и то, какой из трёх когда использовать, описаны в sentinels.md.

Собственная строка сообщения условия начинается с фиксированного предложения, описывающего условие. Всё, что следует за этим предложением, зависит от конкретного случая — ошибочный документ, заданный автором ключ, недопустимое значение и совет для этого случая, — и записи выше приводят полную форму сообщения для условия, которое описывает каждая из них. Фиксированное предложение — та часть, которая всегда одинакова, поэтому именно по ней и следует искать совпадение.

Таблица ниже сопоставляет одно с другим в пределах этой страницы: для каждого описанного здесь условия — короткий код, который выводит сборка, и предложение, с которого начинается строка его сообщения, напротив записи выше, объясняющей, как исправить исходные файлы. Заголовки записей приведены дословно, поэтому поиск одного из них на этой странице приводит к его записи. Таблица всех условий находит короткий код среди всех условий, которые объявляет компилятор, включая те, которые здесь не описаны.

Если одна запись указана напротив двух коротких кодов, она охватывает два разных условия, и каждое регистрирует своё предложение; чтобы понять, о каком из них сообщила сборка, читайте предложения, а не общий заголовок.

aggrega explain <code> выполняет этот поиск за вас в терминале: команда принимает любой из кодов условия и выводит условие вместе с описывающей его записью выше. Она описана в aggrega explain.

Короткий кодНачинается сОписано в
E0001cliplugin: no plugin resolver configuredСредство запуска плагинов командной строки собрано без способа находить плагины
E0003malformed attachment requirementMalformed attachment requirement (Некорректное требование присоединения)
E0004annotation contribution overridden by an explicit valueЯвное значение вытеснило значение, заданное аннотацией
E0005policy violationA governance plugin rejected the build (Плагин управления отклонил сборку)
E0006required attachment slot unfilledRequired attachment slot not bound (Обязательный слот присоединения не привязан)
E0007selector violationНарушение межузловой типобезопасности через selector:
E0008attachment slot selector unsatisfiedThe Feature filling an attachment slot does not satisfy the slot’s selector (Feature, заполняющая слот прикрепления, не удовлетворяет селектору слота)
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 ReleaseНесовпадение типа Feature между Aggregate и Release
E0014inject entry carries both `value:` and `from:`; schema requires exactly oneЗапись inject: содержит и литерал, и исходный ключ
E0015uses-edge inject dictates a delivery mechanism the socket does not permituses edge dictates delivery on a socket that allowlists none (Ребро задаёт доставку в сокете, список разрешённых которого пуст); uses edge dictates a delivery mechanism outside the socket’s allowlist (Ребро задаёт механизм доставки вне списка разрешённых сокета)
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 (Плагин преобразования аннотаций называет компонент, который ему не передавался, или внедряет значение, которое не принимает ни одна аннотация)
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: referenceФорма workload: и поля рядом с ней не согласуются
E0020schedule is not a valid cron expressionЗначение schedule: у workload не является выражением, которое принимает проверка
E0021persistentTemplate volume requires form: statefulФорма workload: и поля рядом с ней не согласуются
E0022pipeline PATCH target is not parseable structured YAML/JSONШаг конвейера адресует документы, которых у узла нет
E0023form: reference requires an endpointФорма workload: и поля рядом с ней не согласуются
E0024schedule requires form: scheduledФорма workload: и поля рядом с ней не согласуются
E0025form: scheduled requires a scheduleФорма workload: и поля рядом с ней не согласуются
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: записан не в форме с голым именем
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 declareAn artifacts: template reads a pillar the Recipe does not declare (Шаблон artifacts читает опору, которую 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 (Библиотечный импорт называет библиотеку или запись, которых нет в каталоге)
E0031artifact-library import references an ArtifactLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (Библиотечный импорт называет библиотеку или запись, которых нет в каталоге)
E0032assembled output collision: two 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 (Привязка доставляет ключ, уже занятый другим источником inject)
E0035provider expected to assemble its dispatch group provides no boundary assemblerThe plugin serving a provider cannot assemble what that provider combines (Плагин, обслуживающий провайдер, не может собрать то, что этот провайдер объединяет)
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 supportedСоединение проходит между собранными выводами двух разных провайдеров
E0038derived name collision: one name is derived more than once in one key spaceОдно и то же имя выводится внутри вывода более одного раза
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 (Библиотечный импорт адресует свою библиотеку по расположению в реестре)
E0041multiple contributors share an instance ID at the same dispatch pathКонфликт идентификаторов экземпляров между границами, собираемыми по одному пути
E0042locals entry references a sibling defined later in the same blockЗапись locals: ссылается на соседнюю запись, определённую ниже в том же блоке (locals: entry references a sibling defined later in the same block)
E0043template references a key the locals block does not declareКлюч locals: не существует
E0044mapping-library import references an entry not present in the MappingLibraryA library $import: names a library or an entry the catalog does not hold (Библиотечный импорт называет библиотеку или запись, которых нет в каталоге)
E0045valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)Библиотечный $import: записан не в форме с голым именем
E0046mapping-library import references a MappingLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (Библиотечный импорт называет библиотеку или запись, которых нет в каталоге)
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 componentШаг конвейера адресует документы, которых у узла нет
E0051pipeline PATCH targets an assembler provider's pre-assembly fragmentsПатч конвейера адресует вывод, который ещё не собран
E0052pipeline PATCH targets a document the node did not emitШаг конвейера адресует документы, которых у узла нет
E0053pipeline plugin is not compatible with the rendering providerПлагин шага конвейера не заявляет провайдер, рендерящий то, что шаг адресует
E0054provider rejected node inputA provider refused a node’s input (Провайдер отклонил входные данные узла)
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 setШаблон provides: ссылается на несамодостаточный корень (provides: template references a non-self-contained root)
E0058provider render is not deterministicA provider rendered the same input twice and produced different output (Провайдер дважды отрисовал одни и те же входные данные и получил разный результат)
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 (Неизвестный провайдер)
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 (Компонент объявляет механизм inject, которому присоединённая сущность Feature ничего не сопоставляет)
E0063workload-library import references an entry not present in the WorkloadLibraryA library $import: names a library or an entry the catalog does not hold (Библиотечный импорт называет библиотеку или запись, которых нет в каталоге)
E0064workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)Библиотечный $import: записан не в форме с голым именем
E0065workload-library import references a WorkloadLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (Библиотечный импорт называет библиотеку или запись, которых нет в каталоге)
E0066uses edge target does not existВисячая цель uses
E0067active toggle did not resolve to a booleanПереключатель active: не разрешается в true или false
E0068max sub-aggregate nesting depth exceededПревышена глубина вложенности подагрегатов
E0069mutator patch rejectedПатч плагина преобразования меток выходит за пределы меток узлов
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 falseРебро uses указывает на компонент, удалённый переключателем active:
E0078producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption callПлагин просит хост разобрать источник, когда для него уже выполняется разбор
E0079wasm: recorded command mirror does not match plugin describe()Записанный набор команд сущности Plugin не совпадает с плагином
E0080wasm: entity contract claim does not match plugin describe()Заявления сущности 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()Записанная версия сущности 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 pluginФормат разбора или импорта объявлен более чем одним плагином
E0091format is advertised by more than one parser pluginФормат разбора или импорта объявлен более чем одним плагином
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 (Возможность обслуживается более чем одним плагином провайдера)
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 directoryДве сущности каталога в одном каталоге имеют общую идентичность
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 keyimplements сущности Recipe не совпадает с сопоставленным типом компонента
E0097no importer plugin advertises the requested formatНи один плагин не объявляет запрошенный формат разбора или импорта
E0098no parser plugin advertises the requested formatНи один плагин не объявляет запрошенный формат разбора или импорта
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 (Привязка в plugins.providers называет плагин, который не обслуживает эту возможность)
E0101no provider-rendering plugin version satisfies the recipe's provider version pinНи одна версия плагина provider не удовлетворяет закреплению provider в сущности Recipe
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 timeResolving a source: coordinate registers a narrower function set (Разрешение координаты регистрирует более узкий набор функций)
E0111resolve: source-template parse errorResolving a source: coordinate registers a narrower function set (Разрешение координаты регистрирует более узкий набор функций)
E0112resolve: source-template references .provides (invalid reverse reference)Resolving a source: coordinate registers a narrower function set (Разрешение координаты регистрирует более узкий набор функций)
E0113resolve: sub-aggregate inclusion depth exceededThe chain of module imports is deeper than the pin walk descends (Цепочка импортов модулей глубже, чем спускается обход закрепления)
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 (Схема в компактной форме объявляет поле, буквально названное type)
E0116compactform: constraint not valid for declared typeA compact-form constraint does not apply to the type it was written on (Ограничение компактной формы неприменимо к типу, для которого оно записано)
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 (Схема в компактной форме использует ключевое слово, неизвестное компактной форме)
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 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 (Lock-файл не соответствует своей схеме)
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 dispatchУ вида сущности нет медиатипа артефакта
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 expansionСсылка на библиотеку раскрывается сама в себя
E0147registrytrust: advertised trust config is malformedРеестр отдаёт документ доверия, который невозможно прочитать как таковой
E0148registrytrust: registry advertises no trust configРеестр не публикует документ доверия
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 publishesКлюч inject from отсутствует в provides цели
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+pillarДве привязки аннотаций Manifest претендуют на один слот маршрутизации
E0161manifest annotation binding uses reserved prefixA Manifest annotation binding claims the reserved aggrega.ai/ prefix (Привязка аннотации Manifest заявляет зарезервированный префикс aggrega.ai/)
E0162missing required feature: attach a Feature of the required type to the componentRequired feature not attached (Обязательная функция не присоединена)
E0163required uses socket not populatedОбязательный сокет uses: не заполнен
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 публикует ключ provides, который его Component не объявляет
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 (Ссылка aggregate: или manifest: сущности Release ни во что не разрешается)
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 (Сокет uses не объявлен в usesSchema сущности-владельца)
E0172release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)Release достиг разрешения, минуя путь загрузки
E0173declared parameter is read by no reference in the AggregateОбъявленный параметр ничем не читается
E0174uses socket name is a near miss for a declared socketИмя сокета в uses: отличается от объявленного сокета на одну правку
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 kindКлюч source: в Recipe называет вид, который ничто не умеет получать
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>}Поле «встроенное или импорт» не записано ни в одной из двух форм
E0189artifactlibrary: entry must be a mapping of filename to a string bodyТело записи библиотеки не имеет формы, которую хранит эта библиотека
E0190schemalibrary: forbidden JSON Schema keywordСхема использует ключевое слово JSON Schema, которое библиотека не допускает
E0191mappinglibrary: entry body must be a string scalarТело записи библиотеки не имеет формы, которую хранит эта библиотека
E0192a document nests too many levels deepДокумент вложен глубже, чем спускается читатель
E0193parameters: shape must be an inline object or {$import: <local-path>}A Release’s parameters: block is written in neither of its two shapes (Блок parameters: сущности Release не записан ни в одной из двух форм)
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>}Поле «встроенное или импорт» не записано ни в одной из двух форм
E0198wellKnownAnnotations: a key is declared at a scope the provider's contract does not renderПровайдер объявляет общеизвестную аннотацию в области, которую он не отрисовывает
E0199workloadlibrary: entry body must be a string scalarТело записи библиотеки не имеет формы, которую хранит эта библиотека
E0200workload: shape must be a string scalar or {$import: <path-or-library-identity>}Поле «встроенное или импорт» не записано ни в одной из двух форм
E0201assertion name declared twice across the extends chainИмя утверждения объявлено дважды вдоль цепочки extends:
E0202cyclic extends chainCyclic extends chain (Циклическая цепочка extends); Cyclic extends on Components or Features (Циклическое extends у сущностей Components или Features)
E0204FeatureRecipe: valuesMapping requires sourceA FeatureRecipe’s valuesMapping requires source (Поле valuesMapping сущности FeatureRecipe требует source)
E0205inheritance merge failedЦепочку 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 failedПредикат x-aggrega-when: или x-aggrega-validate: не удаётся вычислить
E0218validator/jsonschema: schema resolution failedОбъявленная схема не может быть разрешена
E0220extends chain exceeds maximum depthЦепочка 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 (Возможность привязана более чем к одному плагину провайдера)
E0226registry alias is already used by 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 (Подключение governance не объявляет роль или объявляет неизвестную роль)
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 rangeПозиция в редакторе выходит за пределы документа
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 (Провайдер указал для участника каталог, который не является одним каталогом)
E0251recipe source is an empty string, which names neither sourceless mode nor sourced modeВ Recipe 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Привязка аннотации объявляет один путь в обоих списках опор
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`Компонент композиции не размещён ни в одной границе
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 (Провайдер так и не принял имя, составленное компилятором)
E0265provider does not support the node's input kindworkload: requires a provider that can synthesize (workload: требует провайдера, способного к синтезу)
E0266a schema `$import:` could not be appliedA schema $import: cannot be applied (Не удаётся применить $import: схемы)
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 (Сборке провайдера передан фрагмент, который его собственная нарезка не создавала)
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 (Провайдер вернул два выходных файла по одному пути)
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Шаблон читает отображаемое имя, которое провайдер узла не сообщает
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 writtenПравка дала бы документ, который отклоняет его схема
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 reservesКлюч аннотации использует префикс, зарезервированный платформой
E0278the entity's name does not follow the documented name shape for its kindИмя сущности не соответствует форме, ожидаемой для её вида
E0279a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot followСхема использует динамическую ссылку, которую нельзя разрешить заранее
E0280a schema in the entity declares an identifier of its own, where the platform owns that schema's identityСхема объявляет идентификатор, которым владеет платформа
E0281the entity's category label does not match the category directory the entity is filed underМетка категории сущности Component и её каталог называют разные категории
E0282the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchemaРасширение схемы записано непосредственно в содержимое схемы
E0283the Plugin entity declares no runtime resource cap of its own, so the platform defaults applyСущность Plugin не закрепляет ни одного ограничения среды выполнения, поэтому действуют ограничения платформы
E0284an attachment slot admits only secret material and does not declare that it handles itСлот вложения допускает только секретные данные, но не указывает, что обрабатывает их
E0285the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refusedСущность Recipe публикует ключ provides, который её Component не объявляет, — проверка при публикации
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 (Рабочая нагрузка объявляет форму, которую 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 не может содержать преобразование)
E0289a plugin could not resolve something it requires to exactly one valueA health probe cannot be turned into a compose healthcheck (Проверку работоспособности невозможно преобразовать в healthcheck compose); 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 (Два компонента упорядочивают одну пару преобразований противоположно); 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 (Заданное автором имя экспорта совпадает с тем, которое сборка выводит для межстековой ссылки); 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 (Количество ресурсов невозможно преобразовать в значение compose); A resource quantity the helm provider emits is not a quantity (Количество ресурса, выводимое провайдером helm, не является количеством); A service type the helm provider cannot render (Тип сервиса, который провайдер helm не может отрисовать); A Kubernetes version the helm provider cannot render a chart for (Версия Kubernetes, для которой провайдер helm не может отрисовать chart); 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 breakСсылка на запись библиотеки содержит пробельные символы
E0296release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never bothЗвенья цепочки Release расходятся в форме маршрутизации
E0297inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes toДочерняя сущность Release наследует каталог границы, который разрешается туда, куда записывает родительская
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-файл рядом с ней не содержит закрепления)
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 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 machineФайла .wasm плагина нет на этой машине
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 (Привязка провайдера называет возможность, содержащую двоеточие)
E0313plugins.providers entry names a capability no provider-rendering plugin the build reads servesПривязка провайдера называет возможность, которую не обслуживает ни один плагин, читаемый сборкой
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 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 доставляют один ключ, более поздняя — через injectMapping своей сущности FeatureRecipe)
E0319connection alias is already used by another connection of the same componentДва соединения одного компонента под одним псевдонимом
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 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 (Прикрепление под другим именем подходит к слоту, который компонент оставляет пустым)
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 (Провайдер не поддерживает 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 (Число исключённых единиц, возвращённое провайдером, не соответствует переданным ему записям 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 (Запись plugins.importer закрепляет версию своего импортёра, которой нет в каталоге)
E0338importer is attached by more than one plugins.importer entryAn importer is attached by more than one plugins.importer entry (Импортёр подключён более чем одной записью plugins.importer)
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 writtenA name the operation writes holds a part Windows cannot hold (Имя, которое записывает операция, содержит часть, которую 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 (Файл, прочитанный из каталога, и файл, указанный в with.sources импортёра, имеют одинаковое имя)
E0344an entry this publication carries cannot be used on WindowsОпубликованный архив содержит запись, которую 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 credentialАннотация метрик Component и его ключ 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 (Цель импорта называет возможность, к которой не привязана ни одна сущность Recipe в каталоге)
E0350no importer recognises the sourceNo importer recognises the source (Ни один импортёр не распознаёт источник)
E0351provider does not support boundary artifactsThe provider does not support boundary artifacts (Провайдер не поддерживает артефакты границы)
E0352boundary output directory does not name a directory beneath the output rootВыходной каталог границы не является каталогом внутри корня вывода
E0353boundary-level Feature instance name is not a directory nameFeature уровня границы называется . или ..
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 (Сопоставление name в сущности Manifest не называет ничего в сборке)
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 (Не удаётся прочитать вывод injectMapping присоединённой сущности Feature)
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 (Вывод injectMapping присоединённой сущности Feature записывает доставки под ключом, по которому ничего не доставляется)
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 (Конвейер объявляет один идентификатор шага дважды)
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-плагины, которые применяют их собственные соглашения.

Осиротевшие учётные данные

Сущность Feature с учётными данными, подключённая без контракта доставки inject:, не является ошибкой компиляции. Ядро компилятора сохраняет объявление в графе IR и не выдаёт предупреждения. Корпоративные плагины линтера могут обнаруживать этот шаблон и предупреждать о нём; корпоративные рендереры также могут неявно монтировать осиротевшие секреты согласно собственным соглашениям Black-Box. Поскольку обе интерпретации допустимы, ядро компилятора не встаёт ни на одну из сторон.