aggrega validate
aggrega validate проверяет корректность: схему, структуру столпов, разрешение ссылок между документами, цепочки extends, поддержку провайдером вида входных данных и (для отрисовываемой сущности) то, что она действительно отрисовывается. У команды три режима, выбираемых аргументом, которые применяют одну и ту же дисциплину корректности в трёх масштабах: весь каталог (без аргумента), замыкание зависимостей одной сущности Release (--release) и один файл сущности (путь к сущности). В каждом масштабе ответ даётся на один и тот же вопрос — «корректно ли это содержимое?» — для разных частей каталога.
Корректность отличается от соглашений. aggrega validate проверяет, правильно ли сформировано содержимое и будет ли оно скомпилировано; aggrega lint проверяет, следует ли содержимое дисциплине публикации каталога (именование, соответствие директориям категорий, размер повышения версии и прочее). Обе команды повторяют три масштаба друг друга, поэтому вы можете проверить любое из измерений с нужной вам степенью детализации.
aggrega validate ничего не записывает на диск и не читает состояние времени выполнения. Команда выполняет те же разрешение и валидацию, что и сборка, останавливаясь перед отрисовкой (или, для одной сущности, изолируя её).
Путь к сущности можно передать позиционным аргументом. Флаг --release, переданный вместе с путём к сущности, не выбирает масштаб сущности Release: сущность по-прежнему проверяется отдельно, но в терминах этой сущности Release — см. Проверка сущности в терминах сущности Release.
Корректность всего каталога (без аргумента)
aggrega validate без аргумента загружает все сущности каталога из настроенных директорий каталога и проверяет их от начала до конца. Прежде чем что-либо загрузить, он читает каждый YAML-файл в них, и документ Aggrega среди них, который не удаётся загрузить, останавливает запуск, как описано ниже. Затем:
- Структура опоры схемы — блок
spec.schema:каждой сущности Component и Feature раскрывается и проверяется (та же проверка опоры схемы, что применяет сборка), включая раскрытие компактной формы. - Разрешение ссылок между документами — ссылки
$refи$importна записи SchemaLibrary разрешаются, а сущность SchemaLibrary, которую невозможно разрешить или которая некорректна по иной причине, отклоняется. - Цепочки
extends— каждая сущность, объявляющаяextends, разрешается относительно своего родителя, и проверяется объединённая форма родитель+потомок. Родитель, которого нет в директориях каталога, читается там, где его читает сборка: из кэша артефактов, по закреплению, которое lock-файл сущности Release записывает для него, — из lock-файлов сущностей Releases, для которых выполняется проход, или каждой сущности Release в рабочем пространстве, когда оно проверяется за один проход. Поэтому база, опубликованная в реестре, проходит проверку, как толькоaggrega pullполучит и закрепит её, а родитель, которого нет ни там, ни там, останавливает запуск с указаниемaggrega pull --release <release>. Ничего не загружается. - Объявленные селекторы — каждый селектор меток, который документ сущности Component или Feature объявляет на сокете зависимости в
spec.usesSchemaили на слоте вложения вspec.featuresSchema— в том числе, для Component, на слотах, которые объявляет сокет, — читается по грамматике селекторов, независимо от того, подключено ли что-либо к сокету или заполняет ли что-либо слот. См. объявленные селекторы. - Коллизии расположений OCI — две различные идентичности каталога, которые публиковались бы в одно и то же расположение реестра, явно отклоняются, чтобы сборка никогда молча не перезаписала опубликованные байты одной сущности байтами другой.
- Provider: возможность по входному виду — сущность Recipe или FeatureRecipe, объявляющая блок
workload:, привязанный к провайдеру, который не умеет выполнять синтез, помечается как ошибка, поскольку её сборка никогда не завершится успешно.
Это общекаталожный аналог проверки отдельной сущности Release при сборке — место, где сломанная сущность каталога должна обнаружиться до того, как до неё дойдёт какая-либо сущность Release. Проверка явно останавливается на документе Aggrega, который не удаётся загрузить, и при любом нарушении опоры схемы, неразрешимой или некорректной библиотеке, ошибке разрешения extends, объявленном селекторе, отвергаемом грамматикой, коллизии расположений или ошибке поддержки вида входных данных. Находки о перекрытии опор схемы и сужении при расширении, а также каждое ключевое слово x-aggrega-*, которое сущность Component или Feature записывает непосредственно в содержимое своей схемы, выводятся как рекомендательные строки notice:, которые никогда не меняют код выхода.
Документ Aggrega, который не удаётся загрузить, останавливает запуск. YAML-файл в директории каталога является документом Aggrega, если одна из его строк начинается без отступа с apiVersion: и значения, начинающегося с aggrega.ai/, в кавычках или без. Такой файл, который не удаётся прочитать, YAML которого не разбирается или чьи kind или metadata не имеют формы оболочки сущности — например, metadata, записанный списком, — останавливает запуск с E0175 после того, как директории прочитаны, с указанием каждого такого файла и причины, которую дало чтение или парсер; ничего не проверяется, и строка catalog validation passed не выводится. Документ, который загружается, но объявляет kind, которого нет ни в одном каталоге, — например, Componnent с опечаткой или вовсе без kind, — останавливает тот же запуск с E0371 и указывается рядом с ними вместе с видом, который он объявляет; документы Manifest и Release, а также документ Workload, который сущность Recipe импортирует из собственной директории, пропускаются. Любой другой YAML — шаблоны Helm-чарта, которые не разбираются до рендеринга, значения чарта, определения рабочих процессов — пропускается.
Какие директории читаются, зависит от устройства рабочего пространства:
-
Рабочее пространство, конфигурация которого не задаёт собственных директорий каталога для Release, проверяется один раз по своему стеку поиска: сначала директории
--catalog, затемworkspace.catalog_dirs, затем директорияcatalogв корне рабочего пространства, если она есть. -
Рабочее пространство, которое перечисляет Releases в
workspace.releases, может хранить каталог в нескольких вариантах рядом, каждый из которых читается своей сущностью Release, и загрузка их всех сразу поместила бы все варианты в один каталог, где сущность одного варианта затеняла бы сущность другого. Поэтому оно проверяется отдельно для каждой сущности Release в рабочем пространстве, по директориям, которые читает эта Release, причём директории--catalogидут первыми в каждом проходе; сущность Release, не названная в конфигурации, читает список рабочего пространства. Каждый проход выводится под строкой с названием его Release и прочитанных директорий, за которой следует результат этого прохода:Release release-compose.yaml reads catalog-composecatalog validation passed (schema-pillar + library + extends + oci-location)Release release-helm-synth.yaml reads catalog-helm-synthcatalog validation passed (schema-pillar + library + extends + oci-location)Releases, читающие в точности одни и те же директории, разделяют один проход, в котором названа каждая из них. Сущность Release, не читающая ни одной директории (её запись содержит
catalog_dirs: []), выводится как не имеющая ничего для проверки, а остальные проходы выполняются как обычно. Каждый проход выводится независимо от того, что обнаружил предыдущий, поскольку сломанная сущность в одном варианте ничего не говорит о другом, и команда завершается с ошибкой, если завершился с ошибкой любой проход, называя Releases, чьи директории не прошли проверку. Releases рабочего пространства — это его документы Release: YAML-файлы, у которыхkindравенRelease, расположенные где угодно под корнем рабочего пространства вне скрытых директорий иnode_modules,vendorиdist.
Запуск, которому ни в одном проходе нечего читать, отклоняется, а не выводится как чистый каталог: поместите сущности в catalog/, передайте --catalog или задайте workspace.catalog_dirs — либо, в рабочем пространстве, перечисляющем Releases, собственные catalog_dirs сущности Release в workspace.releases. Команда никогда неявно не перебирает текущую рабочую директорию, поэтому никогда не затягивает посторонние деревья.
Инструмент validate команды aggrega mcp, запрошенный для всего каталога, проверяет те же проходы; в рабочем пространстве, перечисляющем Releases, его ответ содержит каждый из них в passes — Releases, прочитанные директории и собственный вердикт прохода — рядом с вердиктом по всем проходам.
Библиотека, которая есть только в кэше артефактов
Кэш артефактов хранит то, что туда поместила загрузка, и кэшированная сущность SchemaLibrary считается содержимым каталога, только если элемент lock-файла сущности Release ручается за её дайджест, — см. Что такое кэш и чем он не является. Когда $ref: ни во что не разрешается, а в кэше есть библиотека, которую не закрепляет ни один элемент lock-файла и не предоставляет ни одна директория каталога, читаемая проверкой, за отчётом следует строка remediation:, называющая каждую такую библиотеку и действие, подходящее для области, в которой произошёл сбой:
- Без аргумента, а также с путём к сущности, независимо от того, указан ли
--release, validate читает библиотеки только из директорий каталога, никогда через запись lock-файла, поэтому записанный элемент не изменил бы его вердикт. Строка сообщает об этом и указывает на создание библиотеки в директории каталога или наaggrega pull --release <release>, за которым следуетaggrega validate --release <release>, проверяющий Release по библиотекам, закреплённым в его lock-файле. - Только с
--releasevalidate читает lock-файл сущности Release, поэтому строка называетaggrega pull --release <release>, который разрешает библиотеку и записывает её элемент, или создание библиотеки в директории каталога.
Эта строка не меняет ни вердикт, ни код выхода.
Объявленные селекторы
Сущность Component или Feature ограничивает селекторами меток, что можно подключить к её сокетам зависимостей и что может заполнить её слоты вложений, — это selector: каждой записи spec.usesSchema и каждой записи spec.featuresSchema, а для Component — selector: каждого слота, который сокет объявляет в собственном featuresSchema. Сборка читает селектор только там, где до него что-то доходит: ребро, проведённое через сокет, или вложение, заполняющее слот. Поэтому область всего каталога и область отдельной сущности читают каждый селектор, который объявляет документ сущности Component или Feature, независимо от того, подключено ли что-либо к сокету или заполняет ли что-либо слот, и селектор, который отвергает грамматика, — список значений без закрывающей скобки, удвоенная запятая, ключ, содержащий = или !, — проваливает проверку. Это грамматика, описанная в разделе строковая грамматика.
Этот отказ — тот же, что сообщает сборка, когда доходит до того же селектора, с тем же кодом и в тех же словах: E0007 для селектора сокета и E0008 для селектора слота; он называет селектор, сокет или слот, который его объявляет, и причину, по которой грамматика не смогла его прочитать. Он регистрируется как ошибка каталога в файле сущности:
selector violation (
"<selector>", declared on socket"<socket>", which could not be evaluated:"<why it could not be read>"). Correct the selector on the socket’s declaration in the component type’s usesSchema. (нарушение селектора: селектор, объявленный на сокете, не удалось вычислить. Исправьте селектор в объявлении сокета в usesSchema типа компонента.)
Каждый документ читается так, как его написал автор, поэтому селектор, который объявляет базовая сущность, сообщается один раз — для собственного файла базовой сущности, — а не по разу для каждой расширяющей её сущности. appliesTo и appliesToAnyOf сущности Feature здесь не читаются: они читаются там, где вычисляется вложение этой Feature.
Область всего каталога сообщает каждый отвергнутый селектор в отдельной строке selector: и завершается неудачей с их количеством; область отдельной сущности сообщает о них как о неудаче своего уровня формы — с --release рядом с путём к сущности или без него, поскольку эта форма и есть область отдельной сущности, запущенная в терминах Release (см. проверка сущности в терминах Release). Один лишь --release, проверяющий замыкание зависимостей Release, и сборка читают селектор только там, где до него доходит ребро или заполнение, и останавливаются на нём именно там.
Корректность в рамках сущности Release (--release)
aggrega validate --release <release-path> проверяет ровно те сущности, до которых доходят разрешённые зависимости одной сущности Release, а не весь каталог и не одну сущность. Замыкание вычисляется тем же механизмом, что использует сборка, поэтому проверяемые сущности — это ровно те сущности, которые разрешила бы сборка этой сущности Release, и над этим замыканием команда:
- разрешает цепочки
extendsв пределах замыкания, завершаясь ошибкой при ошибке разрешения; - проверяет столпы схемы каждой разрешённой сущности (в пределах замыкания), завершаясь ошибкой при ошибке столпа схемы;
- выполняет ту же проверку соответствия значений перед рендерингом, что и сборка: подставляет параметры сущности Release в заданные автором значения (поэтому значение
{{ .parameters.* }}проверяется в разрешённом виде, а не как шаблон) и проверяет результат по составным схемам замыкания, включая соответствие составной схеме родителя и потомка для сущности, использующейextends. Значение, нарушающее свою схему, приводит к ненулевому коду выхода; - оценивает каждое утверждение Recipe и FeatureRecipe относительно значений, в которые разрешается сущность Release, так же как сборка оценивает их перед рендерингом: сущность Recipe каждого компонента привязывается так, как её отображает сущность Manifest, её
localsиprovidesразрешаются, и первое не выполнившееся утверждение — вызывающееfailили такое, чей шаблон останавливается на ключе, которого не находит, — проваливает проверку с тем условием и тем предложением, с которыми останавливается сборка. Шаблонlocalsилиprovides, который не удаётся вычислить, тоже проваливает проверку, как проваливает и сборку. Провайдеру, через который рендерит каждая сущность Recipe, задаётся вопрос об имени, которое он даёт ресурсам этого компонента, — так же как его задаёт сборка, посколькуprovidesсущности Recipe может читать это имя; ничего не рендерится. Эти утверждения оцениваются, только если ничто из перечисленного выше ещё не провалилось, поэтому сущность Release сообщает о самой ранней ошибке, на которой остановилась бы сборка; - выводит находки о перекрытии столпов схемы и о сужении при расширении в виде информационных строк
notice:, которые никогда не меняют код выхода; - показывает каждое ключевое слово
x-aggrega-*, которое читаемая ею сущность записывает непосредственно в содержимое своей схемы, строкойwarning:, один раз на сущность, так же как его показывает сборка, — это тоже никогда не меняет код выхода.
Благодаря этому --release — настоящая проверка перед сборкой: она ловит то, что отвергла бы сборка, ещё до сборки — проверка зависимостей сборки без рендеринга. Рендеринг не выполняется, и загрузка по сети не запускается: замыкание разрешается из локального каталога (и из закреплений lock-файла сущности Release, если он есть); набор зависимостей, закреплённых в реестре и требующих lock-файла, приводит к честной ошибке неразрешимой ссылки, а не к загрузке. О сужении сообщается как о совете, оно никогда не принуждается.
Lock-файл, который больше не соответствует тому, во что разрешается Release, отклоняет проверку с остановкой, которую выводит aggrega build. Если рядом с Release лежит lock-файл, --release сверяет его с тем, во что разрешается Release, с помощью сравнения на расхождение, которое сборка выполняет перед отрисовкой, сразу после разрешения зависимостей Release и до запуска любой из проверок выше. Lock-файл, от которого разошлись закреплённая сущность, библиотека, плагин или сам файл Release, останавливает проверку отказом сборки E0130 — каждая разошедшаяся запись, затем aggrega pull --release <release>, который это устраняет, — и ненулевым кодом выхода, поэтому проверка никогда не пропускает lock-файл, который сборка отвергает из-за расхождения. Без аргумента и с путём к сущности validate не подчиняется lock-файлу: проверка всего каталога читает закрепления lock-файла только для того, чтобы найти родителя extends, а проверка одной сущности не читает lock-файл.
Поскольку выполняются те же проверки, что и при сборке, запускаются и те же подключённые плагины-шлюзы, поэтому действует та же запись доверенных идентичностей плагинов, что и для сборки. У рабочего пространства, подключающего плагин, который возвращает вердикт «принять или отклонить», рядом с его сущностью Release есть запись доверия плагинов, и --release сверяет с ней конфигурацию до запуска любого из этих плагинов: записанный шлюз, который конфигурация больше не подключает, останавливает проверку, а плагин, разрешённый из кэша, заполняемого aggrega pull, чей артефакт не совпадает с записанным, отклоняется, а не запускается. У рабочего пространства, которое ничего не записало, записи нет, и для этой сверки это ничего не меняет. --release также называет каждый отзыв, записанный для того, от чего зависит Release, в стандартном потоке ошибок в виде строки deprecation: в той формулировке, которую выводит aggrega build: как маркер, который lock-файл записывает для закреплённой ссылки, так и маркер, который запись доверия записывает для плагина, подключённого в роли вердикта. Отзыв не меняет ни вердикт, ни код выхода, а запись доверия, которая существует, но не может быть прочитана, останавливает проверку, а не принимается за запись, в которой ничего не записано.
Плагин, прочитанный из кэша, также проверяется на подпись, записанную в его элементе, как и при сборке, — в момент загрузки. Если в его элементе записана проверенная подпись, материал подписи, на который указывает этот факт, снова проверяется в кэше, и плагин, чей материал отсутствует или отличается, отклоняется — как и плагин, чей материал создан для другого плагина, чем прочитанный, а именно так выглядит signature, скопированная из другого элемента, независимо от требования к подписи. Если конфигурация доверия рабочего пространства требует подписи, плагин из кэша, в элементе которого подпись не записана, — или для которого в записи нет элемента, в том числе при удалённой записи, — тоже отклоняется, при тех же настройках, при которых aggrega pull отклонила бы его как неподписанный, поэтому skip_signature_verification и реестр advisory позволяют ему запуститься. Отказ проваливает проверку и попадает в её диагностику с указанием плагина и aggrega pull --release <release> — команды, которая проверяет его подпись в реестре, записывает её и кэширует указанный ею пакет, перезаписывая кэшированную копию, больше не совпадающую с дайджестом; на плагин, предоставляемый из одной из ваших директорий каталога или из копии внутри бинарного файла компилятора, это требование никогда не распространяется. На две другие области ничего из этого не распространяется: они не читают подключения плагинов рабочего пространства, поэтому такие плагины в них не запускаются.
То же касается плагинов, которые изменяют граф, а не оценивают его. Подключение label-transform или annotation-transform формирует то, каким будет результат рендеринга, поэтому lock-файл закрепляет и его идентичность, и читаемые им исходные файлы, — и --release запускает эти подключения так же, как сборка: восстанавливая их из lock-файла, сверяя каждое с записанным дайджестом и читая исходное содержимое из lock-файла, а не файл на диске. Два следствия полезно знать заранее:
- Подключение плагина-преобразования в
.aggrega-config.yamlне меняет поведение--release, пока вы не выполните pull. Это то же правило, которому следует сборка, и по той же причине: набор подключений — входные данные, определяющие байты, поэтому он принимается при pull, а не в момент редактирования. - Кэшированный плагин, чьи байты больше не совпадают с дайджестом, записанным в lock-файле, отклоняется — точно так же, как при сборке.
Если у сущности Release нет lock-файла, --release всё равно выполняет проверку: вместо отказа выводится предупреждение о том, что идентичность плагина проверить не удалось, и указывается, что запустить. См. предупреждения.
Возврат скомпилированного графа
--ir-graph записывает граф, разрешённый этой проверкой, в стандартный вывод в формате JSON перед строкой вердикта. Флаг лишь добавляет вывод: выполняются те же проверки, пишется та же диагностика, и код выхода тот же, что и без него. Возвращается тот граф, над которым выполнялась проверка, поэтому он не может описывать иное разрешение, чем то, о котором сообщает вердикт.
Флаг применим только к этой области — области всего каталога и одной сущности используют синтезированную обвязку, а не сущность Release, и граф не разрешают, — и запрос его в других областях отклоняется, а не молча игнорируется. Если выполнение останавливается до разрешения графа, в стандартный вывод ничего не пишется, а собственная диагностика команды сообщает, что её остановило.
Обратите внимание на соседний флаг. --response-format задаёт объём собственного отчёта команды (detailed или concise); --ir-graph запрашивает второй документ рядом с этим отчётом. Один задаёт объём, другой — предмет, и ни один не влияет на вердикт.
Значения, объявленные автором как конфиденциальные, скрываются в графе — включая values и infra соединения, если сокет потребляющего компонента объявляет лист конфиденциальным, — в структурированной форме, описанной в разделе aggrega inspect. --unredacted вместе с --ir-graph выводит их, на условиях, указанных для aggrega inspect --unredacted: флаг затрагивает только граф и ничего другого из того, что пишет команда, и всё, куда попадает вывод, получает эти значения в открытом виде. Без --ir-graph флаг отклоняется, поскольку раскрывать было бы нечего.
Корректность отдельной сущности (путь к сущности)
aggrega validate <entity-path> проверяет один файл сущности каталога. Команда применяет многоуровневый набор проверок и останавливается на первом блокирующем сбое, чтобы нарушение схемы явно проявилось до какой-либо работы с каталогом:
- Заполнители (любой вид) — значение, которое требуется виду, но оставлено в файле пустой строкой. Все они сообщаются сразу, до остальных проверок, каждое с указанием того, что оно принимает; см. заполнители, которые ещё нужно заполнить.
- Оболочка схемы (любой вид) — та же проверка JSON Schema для каждой сущности, которую загрузчик каталога выполняет на каждой границе разбора.
- Форма (любой вид) — структурная проверка, специфичная для вида. Для Component или Feature она включает чтение по грамматике селекторов каждого селектора меток, который файл объявляет на сокете зависимости или на слоте вложения; см. объявленные селекторы.
- Структура опор (Component и Feature) — проверка опор
spec.schema:с использованием сущностей SchemaLibraries каталога для раскрытия$refмежду документами.
Для сущности Component или Feature проверки на этом заканчиваются: оболочка схемы, форма и структура опор. У отдельной сущности Component нет заданных автором values или infra для изолированного рендеринга, поэтому рендерить нечего — её корректность полностью покрывается уровнями схемы и опор. Каждое ключевое слово x-aggrega-*, которое содержимое её схемы записывает непосредственно, сообщается среди рекомендательных заметок в стандартном потоке ошибок строкой warning:, называющей ключевое слово, место, где оно стоит, и декларативную таблицу, которую следует написать вместо него; это никогда не меняет вердикт или код выхода.
Сущность Recipe дополнительно рендерится изолированно. Это лишь одна сторона корректности отдельной сущности, а не главное в ней: после прохождения уровней схемы и формы validate находит в каталоге сущность Component, указанную в implements сущности Recipe, синтезирует вокруг единственного экземпляра этой сущности Component, привязанного к проверяемой сущности Recipe, минимальные Aggregate, Manifest и Release и прогоняет над ними настоящий конвейер компиляции — сначала разрешение и защитные условия (без рендеринга), затем настоящий рендеринг изолированного вывода. Каждое обязательное значение и каждое обязательное поле infra без значения по умолчанию заполняется заполнителем объявленного типа — значения в синтезированной сущности Aggregate, infra в синтезированной сущности Release, — а все остальные значения и поля infra получают значения по умолчанию из схемы через резолвер; сущность Release направляет экземпляр в синтезированную границу по умолчанию и не объявляет ни values:, ни вычислительных ресурсов, которых не объявила сущность Aggregate. Заполнитель — это значение, которое принимают собственные объявленные ограничения поля: константа или первое значение из enum, число в пределах границ, строка нужной длины и в нужном format, семантическая версия, если её требует pattern, столько элементов списка, сколько требуется, и все свойства, которые требует объект. Любой другой pattern, условие validate: или when:, композиция схем и ограничение на то, какие элементы содержит список, не учитываются, поэтому поле, полагающееся на них, может всё же отвергнуть свой заполнитель; тогда validate сообщает об этом отказе словами самой схемы. Отрендеренные артефакты выводятся, чтобы автор увидел изолированный вывод до подключения сущности к полной сущности Aggregate. Поскольку окружение для отдельной сущности заполняет только эти обязательные поля, не создаёт соединений и не присоединяет ни одной сущности Feature, сущность Recipe, шаблоны которой читают значение, поставляемое только соединением или присоединённой сущностью Feature, не может быть отрендерена изолированно; validate сообщает о таком рендеринге как о непредпринятом, а не о неудачном. Утверждение, вызывающее fail, сообщается как предупреждение, а не как провал проверки — см. проваленное утверждение — это предупреждение. Рендеринг, остановившийся по любой другой причине, не завершён, и validate сообщает о нём с исходной диагностикой рендеринга вплоть до предложения, называющего причину остановки.
Сущность Recipe, чей source: нужно загрузить, вообще не рендерится, а у сущности Recipe, рендеринг которой останавливается при чтении значения, поставляемого только соединением или присоединённой сущностью Feature, этот рендеринг откладывается — см. что не проверяет корректность отдельной сущности ниже.
Сущность FeatureRecipe проходит проверку схемы и формы; её рендеринг пропускается, поскольку FeatureRecipe рендерится только при присоединении к компоненту-хосту, а синтез хоста, проходящего защитные условия, для произвольной сущности Feature не предпринимается.
Проверка сущности в терминах сущности Release
Рабочее пространство может дать каждой сущности Release собственные каталоги — см. Собственные каталоги для сущности Release — и так хранить рядом по одному варианту каталога на каждую сущность Release. Путь к сущности, указанный сам по себе, проверяется по собственным каталогам рабочего пространства, где ссылка в один из этих вариантов — сущность Component, которую реализует Recipe, сущность SchemaLibrary, на которую ссылается опора, — не находится. Укажите --release рядом с путём к сущности, и те же проверки выполнятся в терминах этой сущности Release: ссылки сущности разрешаются через каталоги, которые конфигурация рабочего пространства задаёт этой сущности Release, с добавленным в начало --catalog, если он указан, — это те каталоги, которые читает сборка этой сущности Release.
Пример MariaDB + Adminer содержит четыре таких варианта. Сущность Component его варианта synth берёт настройки хранилища из сущности SchemaLibrary, которая есть только в вариантах synth и chart, поэтому она проходит валидацию в терминах сущности Release, которая с ней собирается:
$ aggrega validate catalog-helm-synth/component/mariadb.yaml --release release-helm-synth.yamlEntity: catalog-helm-synth/component/mariadb.yamlKind: ComponentSchema: validPillars: validи не проходит, называя библиотеку, которую не удалось разрешить, в терминах сущности Release, каталоги которой её не содержат, — --release release-compose.yaml или вообще без --release в рабочем пространстве, не перечисляющем собственных каталогов.
Сущность Recipe проверяется так же. Сущность Recipe варианта synth реализует core/datastore/mariadb, которого нет в собственных каталогах рабочего пространства, поэтому, указанная одна, она не проходит с render: implements target "core/datastore/mariadb" not found in catalog (render: цель implements «core/datastore/mariadb» не найдена в каталоге). С указанием сущности Release, которая с ней собирается, она разрешает сущность Component этой сущности Release и рендерится изолированно:
$ aggrega validate catalog-helm-synth/recipe/helm/mariadb-synth/1.0.0/recipe.yaml --release release-helm-synth.yamlEntity: catalog-helm-synth/recipe/helm/mariadb-synth/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.Resolution: validRender: 3 artifact(s)после чего следуют три отрендеренных артефакта. Каждый вариант этого примера объявляет core/datastore/mariadb, поэтому сущность Recipe проходит валидацию в терминах каждой из его четырёх сущностей Releases; в терминах сущности Release, каталоги которой не содержат такой сущности Component, она не проходит, называя цель, как и без --release. Строки Attachments: объяснены в разделе обязательный слот присоединения или требование присутствия.
Это по-прежнему область отдельной сущности. Проверки, отчёт и код выхода — те, что описаны в этом разделе, — сущность Component или Feature с селектором сокета или слота, который отвергает грамматика, проваливается здесь точно так же, как и без --release, см. объявленные селекторы, — и никакое замыкание не проверяется: --release называет сущность Release, через каталоги которой читаются ссылки сущности, а не замыкание для проверки, — поэтому --ir-graph рядом с путём к сущности отвергается. Значение --release, указывающее на несуществующий файл или на каталог, отвергается до каких-либо проверок.
Каталог, указанный в конфигурации рабочего пространства и не являющийся каталогом — например, на его месте ничего нет, — для этой сущности Release или для рабочего пространства, если --release не указан, отклоняется ещё до какой-либо проверки, так же как его отклоняет каждая команда, читающая эти каталоги (Откуда читаются локальные сущности): отказ называет запись, файл конфигурации и строку, в которых она указана, и параметр, а вердикт не выносится. Проверка сущности в редакторе через aggrega serve выдаёт тот же отказ как единственную запись для файла сущности, на уровне ошибки, а инструмент validate в aggrega mcp отклоняет с ним вызов.
Ещё не заполненные заполнители
Значение, которое требуется виду, но которое файл оставляет пустой строкой, является заполнителем, и validate сообщает о нём раньше всего остального. Документ, созданный командой aggrega scaffold, содержит заполнитель везде, где его виду нужно значение, которое можете указать только вы, поэтому именно здесь вы узнаёте, какие из них остались. Вот созданный документ FeatureRecipe, в котором заполнена только версия:
Entity: my-feature-recipe.yamlKind: FeatureRecipe2 placeholders still owed in my-feature-recipe.yaml; an empty required value is not a value, so each of these needs one before the document validates: 7:3: spec.capability takes what its schema describes: The explicit provider capability this recipe binds to (e.g., 'helm', 'terraform', 'compose') — the provider kind that renders it. 8:3: spec.implements takes what its schema describes: Declares which catalog Feature type this recipe is able to implement (including credential Features labeled feature.aggrega.ai/kind: secret; exact version, major-compatible range '^', or unversioned).Все заполнители в файле называются сразу, в порядке следования в документе, с указанием строки и столбца и того, что требуется в каждом. Требуемое считывается из собственной схемы вида: допустимые значения, если схема их перечисляет, семантическая версия, например 1.0.0, если схема её требует, а в остальных случаях — первое предложение собственного описания поля в схеме.
Какие значения учитываются, тоже определяется по схеме. Значение учитывается, если вид требует его на верхнем уровне документа или внутри объекта, который вид также требует, а файл задаёт для него пустую строку. Ключ, который файл полностью опускает, проверка схемы сообщает как отсутствующее свойство. Необязательное поле, оставленное пустым, не является заполнителем, как и поле, обязательное только внутри списка или словаря, который вы решили написать. Если сама схема перечисляет пустую строку среди допустимых значений поля, пустое значение является значением, а не заполнителем.
Значение требуется, даже если схема приняла бы его пустым. Схема допускает пустую строку для полей capability и implements сущностей Recipe и FeatureRecipe, но пустое значение не называет ни провайдера, ни тип, поэтому validate сообщает об обоих как о заполнителях, как и о любых других. Если проверка схемы тоже отвергает этот файл — пустая версия, метка типа без значения, — отчёт содержит код этой проверки, E0215, как показывает пример на странице aggrega scaffold; если проверка схемы его принимает, как выше, отчёт не содержит кода. Находка в том же файле, не касающаяся пустого значения, всё равно сообщается — словами самой проверки схемы — перед списком.
Такое прочтение относится к проверке одной сущности, с --release рядом с путём к сущности или без него. Проверка всего каталога, встретив тот же документ, сообщает то, что сообщает проверка схемы, поэтому FeatureRecipe с пустым implements в каталоге её проходит; область Release и aggrega build такое прочтение тоже не применяют.
Вид, который эта область не принимает
Проверка одной сущности принимает Component, Feature, Recipe, FeatureRecipe, Workload и Plugin. Файл любого другого вида отвергается, и в отказе названы принимаемые виды, а для вида сущности — область, которая действительно проверяет документ этого вида:
kind "Aggregate" in "aggregate.yaml" is not a single-entity validation target; the kinds this scope accepts are Component, Feature, Recipe, FeatureRecipe, Workload and Plugin. An Aggregate is checked by the whole-catalog scope when it sits in a catalog directory, and by the Release scope over a Release that deploys itОбласть всего каталога — это запуск без аргумента, а область Release — --release без пути к сущности:
| Вид | Чем проверяется |
|---|---|
| Aggregate | проверка всего каталога, если файл находится в каталоге; --release для сущности Release, которая его развёртывает |
| Manifest | --release для сущности Release, которая его называет |
| Release | --release <release-path> |
| SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary | проверка всего каталога, если файл находится в каталоге |
Проверка всего каталога читает только то, что находится в настроенных каталогах, поэтому сущность Aggregate, хранящаяся в корне рабочего пространства рядом со своей сущностью Release, проверяется через --release для этой сущности Release.
Проваленное утверждение — это предупреждение
Утверждение, вызывающее fail, — объявленное в Recipe или в сущности Component из её implements, — сообщается как предупреждение, и проверка из-за него не проваливается. Синтезированная сущность Release содержит заполнители и значения по умолчанию из схемы вместо значений, которые задаёт реальная сущность Release, поэтому утверждение о таком значении, образе или наличии предварительного условия здесь проваливается независимо от того, корректна ли Recipe, и validate не может отличить утверждение, ожидающее сущность Release, от сломанного. Вердикт по утверждению оставлен сборке, у которой сущность Release есть всегда.
Предупреждение выводится в стандартный поток ошибок, начинается с warning: и идёт после всех информационных замечаний. Оно содержит полное сообщение утверждения — сущность, экземпляр, имя утверждения и предложение, написанное его автором, — и завершается ещё одним предложением:
A Release must satisfy this assertion before a build of it can pass.Отчёт в стандартном выводе сообщает, где остановился запуск, и команда завершается с кодом 0. Собственное утверждение Recipe останавливает рендеринг, поэтому отчёт содержит Render: stopped on a failed assertion, reported as a warning после Resolution: valid. Утверждение Component вычисляется до какого-либо рендеринга, поэтому отчёт содержит Resolution: stopped on a failed assertion, reported as a warning, а затем Render: not attempted (the run stopped on that assertion). В обоих случаях ничего не рендерится, поэтому артефакты не выводятся.
Предупреждением является только утверждение, вызывающее fail. Утверждение, которое останавливается на ключе, который оно читает, но не находит, или которое не разбирается, — это ошибка в тексте самого утверждения, а не проваленное утверждение, и оценивается оно как любая другая остановка. Любая другая ошибка остаётся вердиктом проверки.
aggrega build для сущности Release, которая не удовлетворяет утверждению, останавливается на нём с ошибкой, называя утверждение и приводя предложение его автора, как и всегда, а aggrega validate --release для этой сущности Release завершается на нём неудачей с той же ошибкой. Проверка сущности в редакторе через aggrega serve выдаёт то же предупреждение, отображаемое на собственном ключе утверждения там, где его объявляет Recipe, а инструмент validate в aggrega mcp отвечает valid: true с предупреждением среди своих notices.
Что не проверяет проверка одной сущности
Четыре проверки реальной сборки недоступны для сборки одной сущности, и validate отказывается от каждой, а не сообщает находку, за которую не может поручиться.
Источник, который нужно загрузить
Проверка одной сущности не читает lock-файл, не читает и не записывает кэш и не выполняет сетевых запросов. Поэтому у Recipe, чей source: называет что-то получаемое по транспорту — репозиторий чартов OCI или HTTPS, репозиторий Git, — нет инфраструктурного кода для рендеринга: чарт или модуль не существует там, где запуск может его достать, и файл, который проверяется, ни в чём не виноват. Validate сообщает об этом, выводит это как отдельный от рендеринга результат и завершается с кодом 0:
Entity: catalog/recipe/helm/openbao/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validResolution: validRender: not attempted (this Recipe's source is fetched) Validating one entity on its own reads no lockfile, reads and writes no cache, and makes no network request, so the chart or module this Recipe names is never retrieved and there is nothing to render from. To render it, build a Release that deploys a component this Recipe implements.Всё, что выше этой строки, проверено и сообщено как корректное. Поэтому код завершения для такой Recipe означает меньше, чем для отрендеренной: схема, форма и разрешение корректны, рендеринг не доказан, — и отчёт указывает, какой из двух случаев перед вами.
От источника, который уже есть в рабочем пространстве, проверка не отказывается. Относительный source: ./module не требует загрузки, поэтому его рендеринг выполняется как любой другой, а сбой в нём — реальная находка, сообщаемая как Render: not completed in isolation с ненулевым кодом завершения. Строка выше появляется только для источника, который нужно получить.
Чтобы по-настоящему отрендерить Recipe с загружаемым источником, запустите aggrega build для сущности Release, которая развёртывает компонент, реализуемый этой Recipe: сборка разрешает источник через lock-файл этой сущности Release и локальный кэш, и именно они дают байты, которые validate получить не может.
Обязательный сокет uses
Вторая — заполнены ли сокеты uses с required: true у сущности Component из implements.
Обязательный сокет заполняется подключением ребра к другому компоненту — из собственного блока uses сущности Aggregate или из сущности Release, подключающей сокет, который объявляет Component. Синтезированная обвязка содержит единственный экземпляр, поэтому в ней нет второго компонента, на который могло бы указывать такое ребро, и никакое составление синтезированных документов не может его создать: придумать соседа означало бы придумать вычислительные ресурсы, которые обвязка никогда не объявляла. Поэтому validate называет сокеты, которые не проверил, и продолжает разрешение и рендеринг:
Sockets: required uses sockets not checked (backend, cache, registry) Validating a Recipe on its own places its Component in a build of one, so no other component exists for a required socket to be wired to. Whether each of these sockets is populated is checked when the Component is deployed in an Aggregate.Эта строка появляется, только если Component объявляет хотя бы один обязательный сокет, и в ней перечислены только обязательные — необязательный сокет никогда не указывается, потому что оставить его неподключённым не является находкой ни в какой области. Recipe, чей Component не объявляет обязательных сокетов, такой строки не выводит, и её отчёт не меняется.
Само правило не ослабляется и не дублируется; оно проверяется в той области, которая может на него ответить. aggrega build применяет его полностью к поверхностям рёбер сущностей Aggregate и Release вместе и останавливается на обязательном сокете, который ничем не подключён. Поэтому Recipe, прошедший проверку отдельной сущности, всё равно должен удовлетворять правилу обязательных сокетов, когда его Component развёртывается, и отчёт говорит об этом, а не оставляет молчаливого различия между тем, что проверил validate, и тем, что проверит сборка.
Обязательный слот присоединения или требование наличия
Третья — заполнены ли слоты присоединения с required: true у сущности Component из implements — именованные точки привязки, которые объявляет её featuresSchema, — и присутствует ли присоединение каждого типа Feature, которого требуют её требования наличия.
Обязательный слот заполняется присоединением сущности Feature под этим именем в Aggregate или в Release, на компоненте или в области над ним — там, где развёртывается Component, а не в Recipe. Синтезированная обвязка не присоединяет ни одной Feature, поэтому ничто из того, что она собирает, не может заполнить такой слот. Поэтому validate называет слоты, которые не проверил, и продолжает разрешение и рендеринг точно так же, как для обязательных сокетов:
Attachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.Эта строка появляется, только если Component объявляет хотя бы один обязательный слот, и в ней перечислены только обязательные; Recipe, чей Component их не объявляет, такой строки не выводит. Откладывается только само требование: ограничение метки слота и допустимые механизмы доставки сохраняются в объявленном виде. Шаблон, который не разбирается, по-прежнему проваливает запуск, как и собственная ошибка Recipe, например Workload, который провайдер не может синтезировать, — если только Recipe не читает также значение, которое поставляет только соединение или присоединённая Feature, как описано в следующем разделе.
Требование наличия — аннотация features.aggrega.ai/requiredType.<label> на Component, требующая, чтобы какое-либо присоединение несло названный в ней тип Feature, — откладывается по той же причине: обвязка ничего не присоединяет, поэтому ничто из собранного ею не может нести этот тип. Validate называет каждое непроверенное требование по его метке и требуемому типу и продолжает разрешение и рендеринг. example/compute/service из стандартной библиотеки объявляет одно такое требование, поэтому её Recipe перед двумя отрендеренными артефактами сообщает:
$ aggrega validate aggrega-catalog/recipe/helm/service/1.0.0/recipe.yaml --catalog aggrega-catalogEntity: aggrega-catalog/recipe/helm/service/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: presence mandates not checked (monitoring: core/prometheus-exporter) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to carry a type the Component requires. Whether an attachment of each of these types is present is checked when a Release that deploys the Component is built.Resolution: validRender: 2 artifact(s)Требование, объявление которого невозможно вычислить, — префикс аннотации без метки после него или значение, не являющееся типом Feature, — не откладывается: это собственная ошибка сущности Component, которую не исправит никакое присоединение, и validate проваливает на ней запуск, как и сборка.
Каждое правило проверяется там, где на него можно ответить. aggrega pull, aggrega build и aggrega validate --release вычисляют оба правила по реальным присоединениям сущности Release, и каждая из команд останавливается на обязательном слоте, который ничем не заполнен, и на требуемом типе, который не несёт ни одно присоединение.
Значение, которое поставляет только соединение или присоединённая Feature
Четвёртая — рендерится ли Recipe, когда его соединения и присоединённые Features поставляют то, что читают его шаблоны.
Шаблоны Recipe читают то, что доставляет соединение, в .context.inject и .context.uses, а то, что доставляет присоединённая Feature, — в .features. Синтезированная обвязка не подключает соединений и не присоединяет Feature, поэтому любое такое чтение ничего не находит: чтение в .context.inject.env встречает пустой канал доставки, а range по .context.uses не встречает ни одного соединения. Validate сначала рендерит Recipe, и завершившийся рендеринг отображается как обычно. Если рендеринг останавливается, а шаблоны Recipe — включая импортируемые ими файлы и записи библиотек — читают что-либо из этих трёх мест, validate сообщает, что рендеринг не выполнялся, называет значения, которые Recipe там читает, выводит предложение, на котором остановился рендеринг, и завершается с кодом 0. Вариант с чартом из примера MariaDB + Adminer читает учётные данные базы данных из канала доставки, который заполняют два присоединённых секрета:
$ aggrega validate catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml --release release-helm-chart.yamlEntity: catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.Resolution: validRender: not attempted (this Recipe reads values a build of one cannot supply) Validating a Recipe on its own places its Component in a build that wires no connection and attaches no Feature, so nothing supplies what its templates read under .context.inject, .context.uses or .features. Its render stopped, and whether on one of those values or on a fault of its own is not judged here. To render it, build a Release that deploys a component this Recipe implements. Reads: .context.inject.env.MARIADB_PASSWORD, .context.inject.env.MARIADB_ROOT_PASSWORD The render stopped: rendering: [CATALOG_ERROR] instance instance: rendering node "instance": [CATALOG_ERROR] catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml: recipe "mariadb-chart" valuesMapping: [CATALOG_ERROR] valuesMapping[mariadb-chart]: template "valuesMapping[mariadb-chart]" execute: template: valuesMapping[mariadb-chart]:7:30: executing "valuesMapping[mariadb-chart]" at <.context.inject.env.MARIADB_ROOT_PASSWORD>: nil pointer evaluating interface {}.MARIADB_ROOT_PASSWORDЧтение, которое ничего не находит и ничего не останавливает, не откладывается: range по .context.uses, который ничего не выводит в завершившемся рендеринге, отображается как тот рендеринг, которым он был.
Решает то, что читает Recipe, а не то, на чём остановился рендеринг, и у этого есть следствие, о котором стоит знать заранее: собственная ошибка Recipe, который также читает такое значение, — например, опечатка в ключе — отображается как невыполненный рендеринг вместе с остальным, а не как сбой. Строка The render stopped: содержит собственное предложение рендеринга, чтобы вы видели, что это было, а сборка сущности Release, развёртывающей Component, оценивает рендеринг полностью.
Две ошибки по-прежнему проваливают запуск, что бы ни читал Recipe, потому что никакое соединение или Feature их не меняет: шаблон, который не разбирается, и ссылка, которую рендеринг отвергает, — корень, не определённый в контексте рендеринга, или опечатка в ключе под корнем с фиксированной формой, например .context.instance_idd. Объявленное в Recipe утверждение, вызывающее fail, ни откладывается, ни считается сбоем, что бы ни читал Recipe: оно отображается как предупреждение, как и всегда для проваленного утверждения. Если шаблоны Recipe не читают ни одного из трёх мест, его рендеринг оценивается полностью, и остановившийся рендеринг проваливается с предложением, называющим причину.
Инструмент validate в aggrega mcp выносит тот же вердикт по тому же Recipe: отложенный таким образом рендеринг отвечает как корректный без диагностик, а приведённые выше строки содержатся в тексте, который инструмент возвращает рядом с ними.
Загрузка каталога в режиме отдельной сущности терпима к ошибкам: несвязанная сломанная сущность в другом месте каталога пропускается, а не прерывает проверку, поэтому она никогда не мешает проверять целевую сущность изолированно.
Пропущенный файл всё равно объясняет сущность Component, которая из-за него пропала. Если цель implements сущности Recipe не найдена и ровно один пропущенный файл объявляет эту сущность Component, отчёт начинается с собственного отказа этого файла — его пути, нарушаемого им ограничения и короткого кода условия в заголовке, — затем следует note:, сообщающий, что файл пропущен при загрузке, поэтому каталог ничего не содержит под объявленной им идентичностью, а затем сбой implements target … not found in catalog как причина, по которой этот файл был нужен. Если ни один пропущенный файл не объявляет эту сущность Component или её объявляют несколько, первым идёт сбой «не найдено», а каждый пропущенный файл перечисляется под ним в note: catalog files skipped at load. Именно такое объяснение даёт aggrega build о пропущенном файле, и то же объяснение дают проверка сущностей в редакторе через aggrega serve и инструмент validate из aggrega mcp. Каталог, из которого ничего не пропущено, сообщает ровно так же, как и в остальных случаях.
Как validate соотносится с lint и build
Три команды отвечают на три разных вопроса:
aggrega validate— корректно ли это? Схема, столпы, ссылки,extends, возможности по виду входных данных и изолированный рендеринг. Команда не читает состояние среды выполнения и не создаёт артефактов.aggrega lint— соответствует ли это соглашениям о публикации каталога? Именование, соответствие каталогов категориям, префиксы аннотаций, размер повышения версии и остальная необязательная дисциплина публикации. Lint повторяет три области действия validate, но никогда не проверяет корректность.aggrega build— скомпилировать полное развёртывание. Для build требуется полное замыкание Aggregate + Manifest + Release, и команда создаёт артефакты, родные для провайдера. В ходе компиляции она проверяет собственное замыкание зависимостей, а затем выполняет рендеринг.aggrega validate --release— это та же проверка зависимостей сама по себе, без рендеринга; validate для одной сущности изолирует рендеринг одной сущности Recipe без полной сущности Aggregate.
Примеры
Проверить весь каталог:
aggrega validate --catalog ./catalogПроверить ровно то, от чего зависит одна сущность Release, перед её сборкой:
aggrega validate --release releases/production.yamlПроверить одну сущность и — для сущности Recipe — увидеть её изолированный отрисованный вывод:
aggrega validate core/datastore/postgres/recipes/helm.yamlПроверить одну сущность в терминах сущности Release, которой конфигурация рабочего пространства задаёт собственные каталоги:
aggrega validate core/datastore/postgres/recipes/helm.yaml --release releases/production.yamlСм. также
- ./aggrega-lint.md — аналог для проверки соглашений в тех же трёх областях.
- ./aggrega-build.md — компилирует полную пару Aggregate + Release в артефакты; в ходе компиляции проверяет её замыкание зависимостей.
- ./aggrega-inspect.md — запрос к графу IR после разрешения без перехода к рендерингу.
- ../errors/warnings.md — рекомендательные замечания, которые validate выводит строками
notice:.
Синтаксис
aggrega validate [entity-path] [flags]Описание
Check CORRECTNESS across three symmetric scopes.
With no argument, validate checks the WHOLE catalog: schema-pillarstructure, cross-document library resolution, extends chains, and providerinput-kind capabilities, over every catalog entity. Where the workspaceconfiguration gives its Releases catalog directories of their own underworkspace.releases, it checks the catalog once for each Release, over thedirectories that Release reads, and reports each pass under a line namingits Releases and those directories; Releases reading the same directoriesshare one pass.
With --release, validate checks the entities a Release's dependency closurereaches: closure-scoped pillars, extends, and pre-render authored-valueconformance — the same correctness a build applies, scoped to that Release.It then evaluates the Recipe and FeatureRecipe assertions against the valuesthat Release resolves to, as a build does before it renders, and reports afailing assertion as a build reports it. Nothing is rendered.
With an entity path, validate checks one entity file. The kinds it acceptsas a single-entity target are Component, Feature, Recipe, FeatureRecipe,Workload and Plugin. A value the kind requires that the file leaves empty isreported first, as a placeholder still owed: every one is named at once, withwhat it takes, read from the kind's own schema. That reading is this scope'salone; a whole-catalog run, a Release's closure and a build do not apply it.Each kind then has its schema checked, then the checks its own kind carries:pillar structure for a Component or Feature; shape for a Workload,FeatureRecipe or Plugin; and for a Recipe, shape plus an end-to-end compileagainst a minimal generated harness, so its resolution, its guards and arender of its output are all exercised. Where that Recipe's source is onethat has to be fetched, the render is reported as not attempted instead:validating one entity on its own reads no lockfile, reads and writes no cacheand makes no network request, so the chart or module it names is neverretrieved and there is nothing to render from. A render that stops while theRecipe's templates read what only a connection or an attached Featuresupplies — anything under .context.inject, .context.uses or .features — isreported as not attempted too: the generated harness wires no connection andattaches no Feature, so that render cannot be judged there, and a fault ofthe Recipe's own beside such a read is set aside with it. A template thatdoes not parse and a reference the render refuses still fail. An assertionthat calls fail, the Recipe's own or one its Component declares, is printedas a warning closed by a sentence saying a Release must satisfy it before abuild can pass, and does not fail the check: the generated harness sets noneof a real Release's values, so it cannot tell an assertion waiting on one fromone that is broken, and a build still halts on it. Any other kind is refused heretoday, and the refusal names the scope that checks it instead: a whole-catalogrun reaches an Aggregate and the library kinds when they sit in a catalogdirectory, and --release reaches a Release, the Manifest it names and theAggregate it deploys.
With an entity path and --release together, the entity is checked in thatRelease's terms: its references — the Component a Recipe implements, alibrary a pillar refers to — resolve through the catalog directories theworkspace configuration gives that Release rather than the workspace's own,so a workspace keeping one catalog variant per Release checks an entityagainst the variant that Release builds with. The checks are the entitypath's; no closure is validated.
The command writes nothing to disk.Флаги
| Флаг | По умолчанию | Описание |
|---|---|---|
--catalog | [] | Каталог; можно указывать несколько раз. Каждый —catalog <dir> добавляется в начало стека поиска каталогов (побеждает первое совпадение): catalog_dirs рабочего пространства либо, для сущности Release, которой конфигурация рабочего пространства задаёт собственные каталоги в workspace.releases, каталоги этой сущности Release; стек завершается каталогом с именем catalog в корне рабочего пространства, если он есть. Список catalog_dirs, записанный пустым, означает, что локальный каталог не читается вовсе. |
--ir-graph | false | Дополнительно выводит граф IR, вычисленный в этом запуске, в stdout в формате JSON, помимо всего, что эта команда уже выводит. Значения, объявленные автором как конфиденциальные, в нём скрываются; чтобы вывести их, передайте —unredacted. Применяется к области —release — единственной области, которая разрешает сущность Release в граф. Этот флаг выбирает ДОКУМЕНТ, тогда как —response-format задаёт объём собственного отчёта команды; ни один из них не влияет на вердикт и код завершения |
--no-unsupported-field-warnings | false | Отключает класс предупреждений о неподдерживаемых полях: уведомления, которые целевая платформа выдаёт для созданного вами содержимого, которое она не может учесть, — поля сущности Workload, которое она не может выразить (как, например, целевая платформа с меньшей точностью, такая как compose), или аннотации aggrega.ai/, на которую она не реагирует для входного вида узла. Остальные предупреждения рендеринга по-прежнему выводятся. Влияет только на отображение; не меняет результат рендеринга. Применяется к области сущности — единственной области, которая выполняет рендеринг |
--plugin | — | Путь к исходному файлу .wasm для проверки на соответствие его самоотчёту describe() — проверка перед публикацией. Без аргумента требует —type; с аргументом-сущностью Plugin сверяет двоичный файл с объявленными в сущности типом, заявленными возможностями, зеркалом команд и записью функций хоста. |
--release | — | Путь к YAML-файлу сущности Release. Без аргумента-сущности проверяет её разрешённое замыкание зависимостей; с аргументом-сущностью проверяет эту сущность в терминах сущности Release, разрешая её ссылки через каталоги, которые конфигурация рабочего пространства задаёт этой сущности Release. Относительный путь разрешается относительно каталога, в котором вы запускаете команду, а не корня рабочего пространства. Если этот каталог не входит ни в одно рабочее пространство и корень не указан, по абсолютному пути рабочее пространство находится из собственной папки сущности Release |
--response-format | detailed | Объём вывода для области —release — замыкания сущности Release без аргумента-сущности: detailed (по умолчанию) выводит все диагностические сообщения и рекомендательные строки; concise выводит число диагностических сообщений и только первое из них. Вердикт и код завершения в обоих случаях одинаковы. |
--type | — | Тип плагина для проверки —plugin только двоичного файла, сверяемый с типом из самоотчёта двоичного файла. Имеет смысл только с —plugin; если тип задаёт сущность Plugin, не указывайте его (несовпадающее значение приводит к остановке). |
--unredacted | false | Выводит значения, объявленные автором как конфиденциальные, вместо того чтобы скрывать их. Всё, куда попадает вывод, — терминал, конвейер, файл, запись экрана — тогда содержит эти значения в открытом виде. Действует только на граф, который выводит —ir-graph, поэтому требует —ir-graph |