aggrega build
aggrega build компилирует пару Aggregate + Release в нативные для провайдеров артефакты (манифесты Helm, распространяемые чарты Helm, YAML для docker-compose) в каталог dist/ в корне рабочего пространства, как описано в разделе Вывод. Сущность Release — единственная точка входа: она называет Aggregate и Manifest, объявляет границы и направляет компоненты к провайдерам.
Общие флаги
Два флага несут поведение, которое приведённый ниже справочник по флагам не может передать сам по себе:
--catalog <dir>— каталог, содержащий сущности каталога — авторские виды Component, Feature, Recipe и FeatureRecipe вместе с видами библиотек, Aggregates и Plugins, — загружаемые рекурсивно. Каждый каталог--catalogпросматривается раньше настроенных, в указанном порядке. Чтобы просматривать локальный каталог проекта наряду с общим, передайте оба (--catalog ./catalog --catalog ../shared-catalog) или перечислите их вcatalog_dirs. С--detailлюбая сущность, затенённая каталогом с более высоким приоритетом, выводится в stderr вместе с остальными предупреждениями сборки. Несуществующий каталог--catalogостанавливает сборку с указанием его имени. Так же действует каталог изcatalog_dirs, который на самом деле не является каталогом: сборка останавливается до того, как что-либо будет прочитано или записано, с указанием этой записи, а также файла конфигурации и строки, где она указана, — см. Откуда читаются локальные сущности. Сборка, остановившаяся из-за того, что ссылка не разрешилась ни во что, называет в примечании под сообщением об остановке каждый файл в этих каталогах, который объявляет apiVersion Aggrega — строку, которая начинается без отступа сapiVersion:и имеет значение, начинающееся сaggrega.ai/, — и не смог быть загружен, например не разбирается как YAML, с причиной, которую указал сам парсер, среди файлов каталога, пропущенных при загрузке; файл YAML, объявляющий другую apiVersion или не объявляющий её вовсе, не является документом Aggrega и там никогда не называется.--detail— сообщает, что сделал шаг pull: ту же временную диагностику событий pull, которую выдаётaggrega pull --detail. Есть ли что сообщать, определяется тем, был ли шаг pull запрошен — с помощью--auto-pullили включениемauto_pull, — а не тем, существует ли уже lockfile: запрошенный шаг pull выполняется в любом случае, заполняя отсутствующий lockfile и соблюдая закрепления в существующем. Если шаг pull не выполняется, флаг выводит однострочное примечание в stdout и продолжает работу — он никогда не выдумывает уровень разрешения, которого нет в зафиксированном lockfile. Чтобы увидеть состояние разрешения зависимостей сущности Release после pull, используйтеaggrega inspect.
--dry-run описан в разделе Предварительный просмотр сборки без записи, а --trace и --trace-unredacted — в разделах Вывод трассировки и Показ скрытых значений ниже.
Заполнение lockfile в ходе сборки
По умолчанию сборка работает с зависимостями только на чтение: ей нужен lockfile, и она его не записывает. --auto-pull и настройка рабочего пространства auto_pull добавляют в сборку шаг pull, так что одна команда разрешает зависимости сущности Release и компилирует с тем, что было разрешено.
Изменение сущности Release замечается lockfile. Lockfile записывает Release — и каждую сущность Release, которую она расширяет, — по дайджесту её содержимого, поэтому сборка только на чтение для Release, изменённой после pull, останавливается до какого-либо рендеринга, называя файл и предлагая выполнить aggrega pull --release <release>, который записывает изменение, соблюдая все остальные закрепления. Изменение комментария или пробелов тоже учитывается, потому что дайджест охватывает байты как есть. Сборка с автоматическим pull сама выполняет этот шаг pull, поэтому она записывает изменение и выполняет сборку.
Release рендерится один раз. То, какие внешние входные данные потребляет Release, следует из её рендеринга, а не из того, что объявляют её документы, поэтому шаг pull рендерит Release, чтобы это выяснить, — и этот рендеринг и есть рендеринг сборки. Поэтому сборка с автоматическим pull стоит одного рендеринга, как и обычная сборка при уже имеющемся lockfile.
Флаги, влияющие на рендеринг, применяются к нему. --trace, --verify-determinism, --disable-plugin-cache и --no-unsupported-field-warnings действуют на рендеринг, выполняемый сборкой с автоматическим pull, на тех же условиях, что и на рендеринг обычной сборки, поэтому, запросив трассировку или проверку детерминированности в сборке одной командой, вы их получите. --dry-run — исключение, и это отказ, а не молчание: пробный запуск ничего не записывает, а шаг pull записывает, поэтому такое сочетание останавливается до начала работы (см. Предварительный просмотр сборки без записи).
Как сборка читает то, что закрепляет lockfile
Закрепление в lockfile указывает на содержимое — дайджест, — а не на место. Для сущности это дайджест того, что несёт её публикация: её документа и файлов, которые он называет, поэтому копия сущности в каталоге и запись кэша с её публикацией несут одно и то же закрепление, как описано в разделе Lockfile. Сборка читает каждую закреплённую зависимость из источников, уже имеющихся на машине: сначала из каталогов, как и везде, затем из кэша содержимого в .aggrega/cache. При этом чтении реестр не запрашивается; загрузку выполняет только шаг pull, если сборка его запускает.
Запись кэша, которая больше не соответствует своему закреплению, пропускается. Если сущность отредактирована на месте — новое тело под той же version, — в кэше содержимого под этим именем и версией остаётся прежнее тело. Если в каталоге есть копия, дайджест содержимого которой совпадает с закреплением, сборка читает эту копию и никогда не читает запись, сообщая об этом в стандартный поток ошибок с указанием записи и обоих дайджестов:
reuse: cache entry for <name>:<version> holds <digest the entry holds>, not the pinned <pinned digest>; passed over for <catalog file>, which holds the pinned bytesЕсли ни один каталог не содержит сущность, в качестве зависимости читается полная запись кэша, содержащая ровно закреплённые байты, поэтому сущность, удалённая из своего каталога после загрузки её опубликованной копии, по-прежнему собирается из этой копии.
Если ни один источник не содержит закреплённых байтов, сборка останавливается до какого-либо рендеринга с ошибкой E0135 — или E0133, если манифест записи кэша не тот, что закреплён в lockfile. Сообщение об остановке называет закрепление, запись кэша и содержащийся в ней дайджест, а также каждую копию сущности в каталогах с её дайджестом либо сообщает, что ни один каталог её не содержит. Решение — выполнить pull при доступном реестре: он заново загружает закреплённую версию и сверяет загруженное с закреплением; о том, что делает pull, если реестр больше не отдаёт эти байты, см. Соблюдение и обновление.
Рендеринг, который aggrega pull выполняет для обнаружения внешних входных данных, а также сборка или предпросмотр через aggrega serve или aggrega mcp читают свои закрепления так же.
Внешние входные данные во время сборки
Рендеринг может запросить содержимое по удалённому URL — например, схему значений чарта с удалённой ссылкой, — но сборка никогда не загружает такое содержимое, чтобы добавить его к тому, что может читать рендеринг. Запрос URL, который уже закреплён в lockfile, обслуживается из хранилища входных данных рабочего пространства и проверяется по записанному дайджесту до того, как хотя бы один байт попадёт в рендеринг. Запрос незакреплённого URL останавливает сборку с указанием URL и шага, который его закрепляет; настройки, превращающей эту остановку в загрузку, нет, поскольку незаметное расширение набора входных данных, которые читает сборка, — это именно то, чего воспроизводимая сборка делать не должна.
Если копия закреплённых входных данных в хранилище пропала, именно эти входные данные загружаются повторно по дайджесту, уже записанному в lockfile, и проверяются по нему до того, как что-либо будет записано или возвращено. Это не может изменить то, что видит рендеринг, — дайджест был зафиксирован при закреплении входных данных, — поэтому так восстанавливается хранилище, а не расширяется замыкание, и lockfile остаётся неизменным побайтно. В автономном режиме нет транспорта даже для этого, и вместо загрузки отсутствующая копия останавливает сборку с указанием режима.
Закрепление происходит при разрешении зависимостей сущности Release, поэтому то, что может читать сборка, определено до начала сборки. aggrega pull — это тот самый шаг, и он единственный.
Запись доверия к плагинам
Несколько аспектов поведения сборки зависят от plugins-trust.yaml — зафиксированного в репозитории файла рядом с lock-файлом сущности Release, который записывает, в какой плагин разрешилось каждое подключение, возвращающее вердикт: подключение plugins.governance в роли ir-verdict или render-verdict и каждое подключение plugins.linter. Его записывает aggrega pull, а его поля описывает схема записи доверия к плагинам; ниже описано только то, что с ним делает сама сборка.
Сборка сверяется с записью до запуска любого из этих плагинов. Плагин, полученный из кэша, дайджест артефакта которого не совпадает с записанным, отклоняется, а не запускается — именно так обычно разрешается такое подключение, а в aggrega pull описано, на какие другие способы его разрешения записанный дайджест не распространяется. Запись, которой больше не соответствует ни одно подключение в .aggrega-config.yaml, останавливает сборку: удаление проверки не меняет ни одного байта отрисованного результата, поэтому результат, полученный без проверенной проверки, выглядит точно так же, как результат, одобренный ею. Остановка называет плагин и предлагает два способа исправления в зависимости от того, что вы имели в виду, — подключить его снова, если удаление было ошибкой, или явно запросить удаление, если нет, — и выводит готовую к запуску команду. Подключение, которого в записи ещё нет, считается впервые увиденным, и ни одна из проверок на нём не останавливается.
Сборка сверяет каждый из этих плагинов с подписью, записанной в его записи, точно так же, как сверяет запись lock-файла с тем, что в ней записано. Если запись содержит проверенную signature, сборка до начала отрисовки заново хэширует пакет подписи, указанный этим фактом, в кэше и останавливается с E0144, если пакет отсутствует или отличается. Для плагина, считываемого из кэша содержимого, она также считывает из этого пакета, для какого артефакта была сделана подпись, и останавливается с E0332, если подпись сделана для другого плагина, чем тот, который прочитала сборка, — так выглядит signature, скопированная из другой записи, — независимо от требования к подписи. Для плагина, полученного из кэша содержимого, любой из этих отказов указывает aggrega pull --release <release>: следующий pull снова проверяет подпись плагина, записывает собственную подпись плагина и кэширует указанный ею пакет, перезаписывая кэшированную копию, которая больше не соответствует своему дайджесту. Если конфигурация доверия рабочего пространства требует подписи для плагина, который сборка считывает из кэша содержимого, — при тех же настройках, при которых aggrega pull отклонил бы его без подписи, так что skip_signature_verification и реестр advisory позволяют сборке продолжить так же, как позволяют pull, — запись без подписи или отсутствие записи для плагина вообще останавливает сборку с E0331, называя плагин, plugins-trust.yaml и настройки, требующие подписи. Способ исправления — aggrega pull --release <release>, который при каждом запуске проверяет подпись плагина в его реестре и записывает её. Плагин, полученный из одного из ваших каталогов или из копии внутри бинарного файла компилятора, этому требованию никогда не подлежит. Как и вся остальная сборка, эта проверка читает файлы, уже находящиеся на машине, и ни к какому реестру не обращается.
Сборка называет каждый отзыв, который содержит запись, наряду с каждым, который содержит lock-файл. Отметка, которую команда aggrega pull записала для одного из этих плагинов, сообщается строкой deprecation: с указанием плагина, записанного уровня и сообщения издателя — при любом уровне, — а build.halt_on_deprecated_severity решает, останавливает ли она также сборку, по тому же правилу, которое применяется к закреплённой ссылке. Все остальные поверхности, сообщающие о сущности Release, называют тот же набор теми же словами, и ни одна из них на нём не останавливается: aggrega validate --release, aggrega lint --release, aggrega inspect --closure, ответ языкового сервера о валидации и замыкании, а также describe и validate инструментов ассистента. Запись, которая существует, но не может быть прочитана, останавливает сборку, а не проходит как запись, в которой ничего не записано.
aggrega build --upgrade перезаписывает этот файл. Он подразумевает --auto-pull и выполняет простое полное обновление, которое заново разрешает каждую зависимость и поэтому заново разрешает и перезаписывает каждую записанную идентичность, а также удаляет каждую запись, которой не соответствует ни одно подключение. Поэтому если после сборки с обновлением этот файл оказался изменён, причина в этом: флаг охватывает все зависимости, а записанные идентичности входят в то, что разрешается заново, хотя они и не являются закреплениями lock-файла. В отличие от aggrega pull --upgrade, флаг сборки не принимает цель, поэтому его нельзя сузить до одного плагина: чтобы принять или удалить одну идентичность, выполните вместо этого aggrega pull --upgrade --release <release> <plugin>, который оставляет все остальные закрепления и все остальные записанные идентичности нетронутыми.
Поскольку он охватывает всё, он спрашивает перед началом. aggrega build --upgrade запрашивает подтверждение обновления на тех же условиях, что и простой aggrega pull --upgrade, — это одно и то же действие, поэтому они задают один и тот же вопрос. Передайте --yes, чтобы ответить заранее при неинтерактивном использовании; если стандартный ввод не является терминалом и --yes не указан, сборка отказывается, а не ждёт ответа, который никто не может дать. Сборка без обновления ничего не спрашивает.
Разрешение рабочего пространства и детерминированность
Обязательная по схеме ссылка manifest: сущности Release разрешается относительно файла
Release. Относительная запись catalog_dirs (и относительный путь к плагину в файловой системе) разрешается
относительно каталога того .aggrega-config.yaml, в котором она объявлена: «относительный»
всегда означает «относительно файла, в котором вы это написали», поэтому путь означает одно и то же,
откуда бы вы ни вызывали aggrega. Флаг --catalog, у которого нет
объявляющего файла, разрешается относительно текущего рабочего каталога. Ссылки на реестр
(oci://…, ссылка на хаб) остаются как есть.
Корень рабочего пространства — это каталог ближайшего родительского .aggrega-config.yaml с блоком workspace: или каталог, указанный в --workspace-root. Когда корень закреплён таким образом, сборка не зависит от места вызова: запуск aggrega build из корня проекта и из подкаталога даёт побайтово идентичные IR и отрисованные артефакты, поскольку каталог, в котором выполняется поиск, и исходные пути, записанные в выходные данные, не смещаются вместе с рабочим каталогом. (Без маркера workspace: и без --workspace-root корнем является рабочий каталог, и выходные данные привязываются к нему — если только рабочий каталог ни к чему не привязан, а --release не указывает сущность Release абсолютным путём: тогда корень снова определяется от собственной папки Release, так что каталог поиска и пути, записанные в выходные данные, относятся к проекту, которому принадлежит Release, откуда бы вы ни запускали команду. См. configuration.md.) Если и таким образом рабочее пространство не найдено и ничто его не указывает, сборка предупреждает в стандартном потоке ошибок, что папка, использованная ею как корень, не находится ни в каком рабочем пространстве, и называет команду, которая делает её рабочим пространством; сборка, которой предписано сначала разрешить зависимости, отклоняется до какой-либо загрузки, поскольку кэш, заполняемый этим разрешением, был бы записан в эту папку и сделал бы её рабочим пространством. Сборка, которая ничего предварительно не разрешает, всё равно выполняет отрисовку, но по той же причине внешний вход, закреплённый в lock-файле и уже отсутствующий в кэше, повторно не загружается: плагину, который запрашивает его, вместо него передаётся текст отказа, так же как ему передаётся текст автономного режима, и сборка сообщает, как этот плагин с ним поступает. Если --workspace-root или AGGREGA_WORKSPACE_ROOT указывает несуществующую папку, это отклоняется прежде, чем сборка сделает что-либо ещё, с указанием того, какой из двух параметров её задал.
Переменные окружения
Параметры рабочего пространства, которые читает сборка, можно переопределить через окружение — с приоритетом выше закоммиченной конфигурации и ниже любого флага: AGGREGA_OFFLINE, AGGREGA_AUTO_PULL, AGGREGA_CATALOG_DIRS (список путей с разделителем ОС; указывайте абсолютные пути), AGGREGA_ARTIFACT_CACHE_DIR, AGGREGA_DEFAULT_REGISTRY и AGGREGA_WORKSPACE_ROOT. Полный список и модель приоритетов см. в environment-variables.md.
Вывод
Отрисованные артефакты помещаются в dist/ под корнем рабочего пространства, из какой бы папки ни была запущена команда — из самого корня, из папки под ним или из папки в другом месте, если корень указан через --workspace-root или AGGREGA_WORKSPACE_ROOT, — а заключительная строка называет этот каталог полностью:
Build completed: 4 files written to <workspace>/distЗдесь <workspace> обозначает корень рабочего пространства, который строка выводит полным путём. Если рабочее пространство не найдено и ничто его не указывает, корнем считается папка, из которой была запущена команда, поэтому dist/ записывается туда. Если dist является ссылкой, ведущей за пределы рабочего пространства, он отклоняется до того, как в нём что-либо будет удалено или записано. Сущность Release, не объявляющая границ, записывает файлы по провайдерам: dist/<provider>/<files>. Объявленная граница без directory: записывает файлы по границам и по провайдерам: dist/boundaries/<boundary-path>/<provider>/<files>. Заданные оператором переопределения directory: и subDirectory: на границах Release меняют целевой путь; свёртка по (path, provider) объединяет участников, которые разрешаются в один и тот же вычисленный путь.
Файлы, которые сборка не записывала
Сборка записывает собственные файлы и не удаляет ничего, чего она не записывала, за одним исключением: dist/boundaries/, который сборка полностью генерирует заново, очищается перед записью, поэтому файл, оставленный там сборкой другого варианта, не переходит в дерево, которое его больше не создаёт. Всё остальное в dist/ остаётся как есть — и файл, записанный более ранней сборкой, который эта сборка больше не создаёт, и файл, помещённый туда параметром directory: границы при одном из прежних запусков, и файл, который вы положили туда сами, — потому что сборка не может отличить оставшийся файл от файла, который вы храните там намеренно.
Вместо этого она сообщает вам об этом. Записав свои файлы, сборка просматривает сам dist/ и каждый каталог под ним, в который она записала файл или через который прошла, чтобы записать файл глубже, и называет каждый находящийся там файл, который она не записала в этом запуске, в одном предупреждении в стандартный поток ошибок. Файлы называются по путям относительно dist/, в отсортированном порядке, поэтому одно и то же дерево при каждом запуске сообщается одинаково:
warning: the output directory holds 2 file(s) this build did not write, in directories it wrote into; nothing was removed, so they sit beside this build's output: "app/stale-from-earlier-run.yaml", "beside-the-tree.txt"Затем завершающая строка их подсчитывает:
Build completed: 1 file written to <workspace>/dist, beside 2 files this build did not writeКаталог, в который сборка ничего не записала и под которым тоже ничего не записала, не просматривается, поэтому ваша собственная папка, хранящаяся в dist/, не перечисляется по файлам. Сборка, не нашедшая ни одного такого файла, не выводит предупреждения, и её завершающая строка — та, что показана в разделе Вывод. В любом случае файлы, которые записывает сборка, — это те же самые байты. Чтобы сравнить две сборки или начать с нуля, удалите dist/ перед сборкой.
Запрос aggrega/build в aggrega serve и инструмент ассистента build (aggrega mcp) пишут через один и тот же шаг, поэтому называют те же файлы той же фразой: демон — как одно из notices своего ответа, а инструмент — как последнее из своих advisories. Пробный запуск ничего не записывает, поэтому ничего из этого не сообщает.
Отступы в YAML
Каждый отрисованный YAML-артефакт — файлы docker-compose, шаблоны и значения чартов Helm, а также манифесты Kubernetes — выводится с единой шириной отступа. Ширина задаётся параметром build.yaml_indent в .aggrega-config.yaml и по умолчанию равна 2 (общепринятая ширина для этих форматов):
build: yaml_indent: 2 # default; accepts 2 through 9Ширина применяется в единой точке сериализации, общей для всех рендереров, поэтому вывод остаётся побайтно идентичным между запусками на одних и тех же входных данных. Значения вне диапазона [2, 9] отклоняются при проверке схемы конфигурации.
Возврат скомпилированного графа
--ir-graph записывает граф, в который разрешилась эта сборка, в стандартный вывод в формате JSON. Флаг аддитивен: артефакты по-прежнему записываются в dist/, сводка по-прежнему выводится, а отрисованные байты не меняются. Граф выводится раньше всего остального, что сборка туда печатает, — один документ JSON и один завершающий перевод строки, — поэтому потребитель, декодирующий поток, считывает его и останавливается.
Возвращаемый граф — тот самый, который использовала отрисовка, поэтому он описывает именно ту сборку, что создала лежащие рядом артефакты, а не повторное разрешение той же сущности Release. Флаг сочетается с --dry-run: граф записывается, а за ним следует отчёт об артефактах, и ничего не записывается на диск.
Значения, объявленные автором как конфиденциальные, в нём скрываются — включая values и infra соединения, если сокет потребляющего компонента объявляет лист конфиденциальным, — в структурированном виде, описанном в aggrega inspect. --unredacted вместе с --ir-graph вместо этого выводит их на условиях, изложенных для aggrega inspect --unredacted: флаг действует только на граф и ни на что другое — у файлов трассировки есть собственный --trace-unredacted, а отрисованные артефакты никогда не скрываются, — и всё, куда попадает вывод, затем содержит эти значения в открытом виде. Без --ir-graph флаг отклоняется, потому что раскрывать ему было бы нечего.
Тот же флаг с тем же значением есть у aggrega inspect и aggrega validate.
Предварительный просмотр сборки без записи
--dry-run выполняет ту же компиляцию, что и сборка, — те же проверки зависимостей, тот же рендеринг, те же провайдеры — и выводит то, что было бы сгенерировано, вместо того чтобы записывать это. Для каждого артефакта сообщаются путь, который он занял бы, и содержимое, которое он содержал бы:
aggrega build --release releases/production.yaml --dry-run==> <workspace>/dist/main/helm/webapp-configmap-webapp.yaml <==apiVersion: v1kind: ConfigMap...
Total build time: 2.5sDry run: 1 file would be written to <workspace>/dist; nothing was writtenАртефакты выводятся в том порядке, в котором их записывает сборка, поэтому одни и те же входные данные дают одни и те же байты в той же последовательности, а выводимый путь — это путь, по которому записала бы сборка: внутри корня рабочего пространства, указанного полностью там, где выше стоит <workspace>.
Что не записывается. Выходной каталог остаётся в точности таким, какой он есть: он также не очищается, поэтому результат предыдущей сборки переживает пробный запуск без изменений. Lock-файл не записывается. В .trace/ ничего не записывается.
Внешние входные данные ведут себя точно так же, как при обычной сборке, на условиях, изложенных в разделе Внешние входные данные во время сборки. Поэтому пробный запуск читает то же зафиксированное замыкание, которое прочитала бы заменяемая им сборка, и показывает то, что эта сборка записала бы.
Если в доступе к ссылке было отказано, запуск перечисляет все ссылки, до которых не удалось добраться, и указывает на команду, которая их фиксирует:
note: the lockfile does not pin every external reference this render requested, so the following were declined and the render stopped short of the artifacts it would otherwise emit: - https://charts.example.com/values-schema.json Run `aggrega pull --release releases/production.yaml` to pin the inputs the render needs, then run the dry run againВыполните aggrega pull один раз, и у пробного запуска будет всё необходимое; больше ничего в нём не меняется.
Пробному запуску нужен lock-файл, и он никогда его не заполняет. По умолчанию сборка работает только на чтение, и пробный запуск придерживается этого, каким бы способом ни было запрошено заполнение. --auto-pull и --upgrade отклоняются сразу (см. ниже); настройка рабочего пространства auto_pull переопределяется для этого одного вызова, поэтому рабочее пространство, которое по умолчанию выполняет заполнение, всё равно можно просмотреть заранее. Без lock-файла пробный запуск останавливается с тем же способом устранения, что и обычная сборка только на чтение: сначала выполните aggrega pull.
Флаги, которые он отклоняет. Три флага выполняют запись, поэтому их сочетание с пробным запуском не имеет честного результата: если проигнорировать запись, запрошенное заполнение бесследно исчезнет, а если выполнить её, будет нарушено единственное обещание пробного запуска. Каждое такое сочетание останавливает работу до её начала, называя переданный вами флаг и шаг, который следует выполнить вместо этого:
| В сочетании с | Причина отказа |
|---|---|
--auto-pull | заполняет lock-файл; выполните aggrega pull отдельным шагом |
--upgrade | заново разрешает все зависимости и перезаписывает lock-файл; выполните aggrega pull --upgrade отдельным шагом |
--trace | записывает файлы для каждого узла в .trace/; выполните сборку с трассировкой без --dry-run |
Всё остальное сочетается как обычно. --verify-determinism рендерит каждый узел дважды и сравнивает байты, ничего из них не записывая, а --catalog, --quiet, --progress, --debug и фильтры предупреждений ведут себя точно так же, как при сборке с записью.
Для чего он нужен и для чего нет. Пробный запуск отвечает на вопрос «что сгенерирует этот Release», а на него может ответить только рендеринг, поэтому он не заменяет ни aggrega validate, которая проверяет корректность без рендеринга, ни aggrega inspect, которая запрашивает граф до рендеринга. Используйте пробный запуск, когда нужный вам ответ — сами артефакты: чтобы проверить, как изменение сущности Release влияет на результат, или проверить правку сущности Recipe, прежде чем что-либо фиксировать в dist/.
Вывод трассировки
Флаг --trace включает отладочный дамп по каждому узлу, фиксирующий каждое промежуточное состояние компилятора. Вывод размещается в .trace/ в корне рабочего пространства, рядом с dist/ (никогда не внутри него; такое соседнее расположение следует соглашению .git/, .terraform/, node_modules/ и сохраняет dist/ пригодным исключительно для развёртывания).
Структура каталогов организована по границам и по экземплярам:
.trace/└── boundaries/ └── <boundary-path>/ └── <instance-id>/ ├── 01-pillars-initial.yaml ├── 02-provides-evaluation.yaml ├── 03-inject-hydration.yaml ├── 04-inject-mapping.yaml ├── 05-source-resolution.yaml ├── 06-source-locals.yaml ├── 07-values-mapping.yaml ├── 08-workload-synthesis.yaml ├── 09-artifact-evaluation/ │ └── <per-artifact-file>.yaml ├── 09b-feature-rendering-boundary.yaml ├── 10-engine-synthesis/ │ └── <per-synthesized-file>.yaml ├── 11-engine-emission.log └── 12-labels-injected.logКаждый слот фиксирует определённое состояние компилятора:
01-pillars-initial.yaml— снимок для узла того контекста, который читает шаблон, сделанный после разрешения и до каких-либо изменений на отдельных этапах. Содержит.values,.infra,.context,.parameters,.metadata.02-provides-evaluation.yaml— разрешённые выходные данныеprovides:после вычисления provides.03-inject-hydration.yaml— объединённый конвейер.context.injectпосле гидратации inject (представление вышестоящихprovidesсо стороны потребителя).04-inject-mapping.yaml— конвейер.context.injectпосле перезаписейinjectMappingсущности FeatureRecipe.05-source-resolution.yaml— разобранное содержимоеsource:, которое получит провайдер. Присутствует, только если сущность Recipe объявляетsource:.06-source-locals.yaml— разрешённый блокlocals:. Разрешение источника публикует.localsдо вычисления шаблонаsource:, поэтому этот слот записывается независимо от того, объявляет ли сущность Recipesource:.07-values-mapping.yaml— отрисованный выводvaluesMapping:(словарь, который получает провайдер). Присутствует, только если сущность Recipe объявляетvaluesMapping:.08-workload-synthesis.yaml— контекст в том виде, в каком он был, когда вычислялся шаблонworkload:и разбирался его вывод. Присутствует, только если сущность Recipe объявляетworkload:(встроенно или с загрузкой через$import:). Сам разобранныйWorkloadв этом слоте отсутствует: он появляется начиная с09-artifact-evaluation/, когда он уже окончательно сформирован, а не находится в процессе.09-artifact-evaluation/— по одному файлу на каждый вычисленный артефакт. Присутствует, только если сущность Recipe объявляетartifacts:(с записями, заданными встроенно или загружаемыми через$import:для каждой записи).09b-feature-rendering-boundary.yaml— контекст в момент завершения рендеринга узла, после того как присоединённые к нему сущности FeatureRecipes сгенерировали свои ресурсы, а рядом с ним — разобранныйworkload. Записывается для каждого узла.10-engine-synthesis/— по одному файлу на каждый синтезированный манифест, созданный провайдером из сущности Workload (режим workload для helm/compose). Присутствует, только если провайдер выполнял путь синтеза.11-engine-emission.log— сводка после вывода (число файлов, пути вывода) для узла.12-labels-injected.log— метки и аннотации происхождения, записанные в отрисованный вывод для узла.
Начиная с 03-inject-hydration.yaml, слот, показывающий контекст узла, содержит блок .context.inject всякий раз, когда захваченный им канал доставляет хотя бы один ключ под любым механизмом: env, file, arg или механизмом с другим именем, в который записывает сопоставление inject, injectMapping сущности FeatureRecipe или собственный блок inject: компонента. Узел, единственная доставка которого — такой пользовательский механизм, тоже показывает этот блок: этот механизм — под его собственным именем, а его ключи — в all, и объявленное чувствительным значение в обоих местах читается как <redacted>. Слот, снятый, когда канал ничего не доставляет, не содержит блока .context.inject.
Запись трассировки неблокирующая: трассировка записывается на диск параллельно с компиляцией, а не на её пути. Ввод-вывод трассировки не влияет на задержку компиляции — одна и та же компиляция завершается за одно и то же реальное время независимо от того, включён --trace или нет.
Значения, объявленные чувствительными, в трассировке
Данные, которые автор объявил чувствительными, — лист схемы с sensitive: true или ключ доставки, материал которого получен из такого ключа provides, — записываются в трассировку как фиксированный текст <redacted>. Ключ сохраняется, заменяется только значение, поэтому слот по-прежнему показывает, какие листья и какие ключи доставки несёт узел. Необъявленный соседний элемент в том же блоке выводит своё значение дословно: подстановка следует объявлению и ничему другому.
Значение, которое сущность FeatureRecipe доставляет через собственный injectMapping, также скрывается. Это путь, которому передаёт доставку слот, объявляющий пустой список inject, и путь, по которому идёт реализация учётных данных только через inject. Ключ доставки, который записывает такое сопоставление, сам является шаблоном, поэтому никакое объявление его не называет; вместо этого читается собственный текст сопоставления. Если этот текст ссылается на лист values или infra, который подключённая сущность Feature объявляет как sensitive: true, каждый ключ доставки, созданный сопоставлением, читается как <redacted>, включая ключ, не несущий ничего чувствительного, поскольку оценка выполняется для подключения целиком, а не для каждого ключа. Сопоставление, которое не ссылается ни на что объявленное, выводит свои ключи дословно.
Значение, вычисленное шаблоном из данных, объявленных чувствительными, также скрывается, даже если его собственный ключ не несёт объявления. Его определяет ссылка, написанная автором: скрывается запись locals:, шаблон которой читает объявленный чувствительным лист, и так же скрывается поле source:, которое это делает. Оценка консервативна: шаблон, обращающийся ко всему объекту, обращается к каждому объявленному листу под ним, поэтому {{ range $k, $v := .values.creds }} скрывает свой вывод, если что-либо под creds объявлено, а запись locals:, читающая уже скрытый соседний элемент, в свою очередь скрывается. Соседняя запись той же формы, не читающая ничего объявленного, выводится дословно.
Значение, передаваемое по ребру uses, скрывается в соответствии с объявлениями цели, а не потребляющего узла, и скрывается на обеих поверхностях, куда его доставляет ребро. .context.uses.<alias>.provides воспроизводит то, что опубликовал целевой компонент, поэтому эти значения регулирует схема цели: ключ provides, который цель объявила чувствительным, читается как <redacted> в слоте потребителя, даже если потребитель не объявляет ничего. Когда собственный блок inject ребра направляет этот ключ на ключ доставки потребляющего компонента, .context.inject также скрывает этот ключ доставки — по тому же правилу, которому уже следует сопоставление inject подключения, читая то же объявление. Скрытие выполняется для каждого ребра отдельно, поэтому два ребра, публикующие ключ provides с одинаковым именем, разрешаются независимо: то, чья цель его объявила, скрывается, а другое выводится дословно. Остальная часть ребра — его цель, его сокет, его метки и собственные имена ключей сопоставления inject — не регулируется объявлением provides цели и выводится дословно.
Значения values и infra конкретного соединения, заданные на самом ребре, напротив, регулируются сокетом потребляющего компонента: valueSchema и infraSchema, которые объявляет этот сокет и которые являются контрактами, по которым проверяется эта конфигурация. Лист, который любой из контрактов объявляет как sensitive: true, читается как <redacted> в .context.uses.<alias>.values или .context.uses.<alias>.infra, причём ключ сохраняется; то же относится к листу, имеющему значение по умолчанию, объявленное контрактом; необъявленный соседний лист выводится дословно. Объявления цели здесь роли не играют, а скрытие выполняется для каждого соединения отдельно, поэтому лист с тем же именем на соединении, сокет которого объявляет его читаемым, выводится дословно.
Подключения, записанные на соединении, показываются под ребром этого соединения, в .context.uses.<alias>.features.<slot>, и каждое скрывается в соответствии с объявлениями своей сущности Feature — теми же, что регулируют эту Feature, когда компонент владеет ею напрямую. Лист values или infra, который Feature объявляет как sensitive: true, читается как <redacted>, как и ключ разрешённого provides подключения, который Feature объявляет чувствительным; каждый ключ сохраняется. Тип, версия и метки подключения, а также каждый лист и ключ provides, которые его Feature оставляет необъявленными, выводятся дословно, поэтому опубликованный локатор остаётся читаемым рядом с материалом, на который он указывает. Скрытие выполняется для каждого соединения и слота отдельно, поэтому одна и та же Feature, записанная на двух соединениях, разрешается на каждом. Слот, объявляющий sensitive: true — на компоненте или на его сокете, — сообщает, что подключение обрабатывает секретный материал, и сам по себе не скрывает ни одного листа: какие листья скрываются, объявляет Feature. Собственные подключения компонента не входят в блоки, которые показывает слот, поскольку трассировка не содержит блока .features; то, что из них читает шаблон workload:, охватывается повторным рендерингом, описанным ниже.
Разобранный Workload является повторным рендерингом, а не снимком документа, который выпустила сборка, и слоты, которые его содержат, — 09-artifact-evaluation/, 10-engine-synthesis/ и 09b-feature-rendering-boundary.yaml, — сообщают об этом в записи workload_note рядом с ним. Отрендеренный документ никак не фиксирует, из какого объявления получен тот или иной символ, поэтому внутри него нет ключа, по которому можно выполнить подстановку. Вместо этого трассировка показывает тот же шаблон workload:, вычисленный повторно в контексте, где данные, объявленные чувствительными, уже читаются как <redacted>. Поскольку шаблон видит строку там, где была строка, результат сохраняет форму выпущенного документа: те же поля на тех же местах, где <redacted> стоит на собственной позиции скрытого значения, а окружающий литеральный текст не изменён.
Два отличия повторного рендеринга от выпущенного документа, оба указаны в примечании:
- Шаблон, который ветвится по содержимому значения, рендерится иначе. Сравнение
eqс конкретным значением, проверка длины, хеш или кодирование значения: каждое видит<redacted>и даёт другой результат — другую ветвь, другую длину, другой дайджест. Поэтому трассировка никогда не утверждает, что показывает выпущенный документ. - Данные, которые не называет ни одно объявление, передаются без изменений. Подстановка охватывает то, что называет ось: объявленный лист
values/infra, помеченный ключ доставки, ключprovides, который собственная сущность Component компонента объявляет чувствительным, объявленныйprovidesпотребляемой цели, лист собственныхvaluesилиinfraсоединения, который его сокет объявляет чувствительным, объявленный лист или ключprovidesподключения, которым компонент владеет сам (читается в.features.<name>) или которое записано на соединении, а также значениеlocals:илиsource:, вычисленное из них. Это те же данные, которые скрываются при отказе, вызванном шаблоном. Данные, попадающие в шаблон любым другим путём, например ключprovides, не названный ни одним объявлением, значение которого сущность Recipe вычислила из объявленного листа, появляются в повторном рендеринге ровно так же, как в выпущенном документе.
Если повторный рендеринг вообще невозможно получить, слот сохраняет ключ workload: и заменяет документ строкой, которая сообщает об этом и называет --trace-unredacted. Это сообщение намеренно: проекцию, которая просто исчезла, невозможно было бы отличить от сущности Recipe, вовсе не объявляющей workload:.
Прежде чем считать .trace/ безопасным, стоит учесть одно ограничение: dist/ не редактируется. Отрендеренные артефакты выпускаются ровно в том виде, в каком их создал рендеринг, поскольку именно они развёртываются, и повторный рендеринг трассировки их никогда не затрагивает — одни и те же входные данные рендерятся побайтно идентично независимо от того, включён ли --trace.
Считайте, что .trace/ содержит секретный материал, и обращайтесь с ним так же, как с dist/.
Отображение скрытых значений
--trace-unredacted вместе с --trace записывает в файлы трассировки значения, объявленные чувствительными, вместо подставляемого на их место текста. Этот флаг нужен потому, что иногда отлаживается именно скрытое значение: учётные данные, пришедшие не из того прикрепления, выглядят так же, как правильные, если и те и другие отображаются как скрытые.
Так же фиксируется документ, который сборка действительно выпустила: когда ничего не скрыто, подставлять нечего, поэтому слоты workload: содержат выпущенный документ, а не его повторный рендеринг, и запись workload_note отсутствует.
Его ограничивают три свойства:
- Каждый записанный им файл сообщает, что он собой представляет. Каждый файл трассировки, созданный запуском, начинается с комментария, который называет флаг и указывает, что ниже значения, объявленные чувствительными, приведены в открытом виде, поэтому файл, позднее приложенный к отчёту об ошибке или оставленный в общем каталоге, несёт собственное предупреждение. Комментарий допустим в формате самого файла, поэтому файл по-прежнему разбирается.
- Он затрагивает
.trace/и ничего больше. Отрендеренные артефакты побайтно идентичны с ним и без него: он меняет то, что показывает отладочный файл, но никогда не меняет то, что производит сборка, — а макетыaggrega inspectи текст диагностики, который выводит неудачная сборка, идентичны в обоих состояниях. - Он действует только в рамках вызова. Для него нет параметра конфигурации, поэтому его нельзя включить один раз и оставить включённым для всех, кто будет собирать рабочее пространство после. Запрос его без
--traceостанавливает сборку с сообщением, называющим оба флага, вместо того чтобы принять запрос, который невозможно выполнить.
Независимо от трассировки сборка выводит одно предупреждение на каждый ключ доставки, который несёт материал, объявленный чувствительным, в виде литерального значения, называя компонент, целевую платформу, прикрепление и ключ доставки. Оно никогда не останавливает сборку, и --no-unsupported-field-warnings его не подавляет: этот флаг охватывает то из написанного вами, что целевая платформа не может поддержать, — это другой класс.
Ключевое слово, два места, где его можно указать, точная формулировка предупреждения и полный предел того, чего достигает такое объявление, описаны в vocabulary/compact-form-authoring.md, раздел «Объявление листа чувствительным».
Когда использовать --trace
- Диагностика того, почему отрисованный манифест не содержит ожидаемого значения: пройдите по дампам каждого прохода, чтобы найти первый слот, в котором значение отсутствует.
- Проверка детерминированности после обновления компилятора: две компиляции одних и тех же входных данных с
--traceдают побайтово идентичные дампы трассировки; любое расхождение по слотам локализует регрессию. - Итеративная разработка каталога: сравнение снимков
04-inject-mapping.yamlи06-source-locals.yamlпоказывает, что видят шаблоны сущности Recipe во время вычисления.
Примеры
Скомпилировать сущность Release с использованием локального каталога:
aggrega build --release releases/production.yamlСкомпилировать с отдельным каталогом:
aggrega build --release releases/production.yaml --catalog ../platform-catalog/Посмотреть, что сгенерирует сущность Release, ничего не записывая:
aggrega build --release releases/production.yaml --dry-runСкомпилировать с дампами трассировки для отладки:
aggrega build --release releases/production.yaml --traceПосле компиляции изучите .trace/boundaries/<boundary>/<instance>/, чтобы увидеть состояние после каждого прохода. Каталог .trace/ перезаписывается при каждом запуске с --trace; предыдущее состояние трассировки между компиляциями не сохраняется.
Перекрёстные ссылки
aggrega-pull— загрузка сущностей каталога из реестра OCI в локальный каталог.aggrega-validate— проверка корректности каталога, замыкания сущности Release или отдельной сущности без генерации артефактов; та же проверка зависимостей, что выполняет сборка, но без рендеринга.aggrega-lint— проверка соглашений о публикации каталога в тех же трёх областях.aggrega-inspect— запрос к графу IR после финализации графа без перехода к рендерингу.- Ошибки — формат вывода категоризированных ошибок, который отображается в CLI.
Синтаксис
aggrega build [flags]Описание
Compile an Aggregate and Release pair into provider-native artifacts under eachboundary's output directory.
The Release is the single entry point: it names the Aggregate and the Manifest,declares the boundaries, and routes each component to a provider. What aprovider emits is the provider's own shape — Helm manifests, a redistributableHelm chart, docker-compose YAML — so the output directory holds whatever theproviders this Release routes to produce.
The output directory is dist/ beneath the workspace root, whichever folder thecommand is run from, and the closing line names it in full. A run that finds noworkspace uses the folder it was run from as the root, and writes dist/ there.
Build is read-only by default and needs a lockfile. Run "aggrega pull" first tocreate one, or pass --auto-pull to fill it in-process for this build.
Given identical input, build writes byte-identical output, which is what makesthe rendered tree reviewable as a diff.Флаги
| Флаг | По умолчанию | Описание |
|---|---|---|
--auto-pull | false | Выполнить шаг pull перед сборкой: разрешить зависимости сущности Release в lockfile и кеш внутри процесса, а затем собрать с ними. Это то же заполнение внутри процесса, которое выполняет параметр рабочего пространства auto_pull, но включённое для одной сборки без изменения конфигурации рабочего пространства. Сам по себе флаг выполняет инкрементальное заполнение: существующие закрепления соблюдаются, а ссылки без закрепления разрешаются и добавляются |
--catalog | [] | Каталог; можно указывать несколько раз. Каждый —catalog <dir> добавляется в начало стека поиска каталогов (побеждает первое совпадение): catalog_dirs рабочего пространства либо, для сущности Release, которой конфигурация рабочего пространства задаёт собственные каталоги в workspace.releases, каталоги этой сущности Release; стек завершается каталогом с именем catalog в корне рабочего пространства, если он есть. Список catalog_dirs, записанный пустым, означает, что локальный каталог не читается вовсе. |
--debug | false | Выводить подробную человекочитаемую диагностику в stderr — время выполнения каждой фазы и количество сущностей и зависимостей. Имеет приоритет над —quiet: подробный вывод выдаётся всегда. Отличается от —trace, который записывает машиночитаемые промежуточные файлы для каждого узла в .trace/ |
--detail | false | По умолчанию сборка работает только на чтение и не выводит сведений о разрешении. Когда выполняется шаг pull — потому что передан —auto-pull или в рабочем пространстве включён auto_pull, — сборка заполняет lockfile внутри процесса независимо от того, существует ли он уже, и этот флаг выводит для каждой разрешённой сущности, что сделало заполнение: заново загрузило из реестра, повторно использовало слот кеша, нашло в локальном каталоге, взяло из бинарного файла компилятора или отметило как внешнюю (собственная сущность Aggregate или Manifest сущности Release, прочитанная из файла или записи, которые указывает Release). Если шаг pull не выполняется, вместо строк по сущностям выводится одна строка об этом. Только stdout; не сохраняется |
--disable-plugin-cache | false | Не использовать постоянный дисковый кеш компиляции плагинов для этой сборки и компилировать гостевые модули плагинов заново в кеше в памяти, который удаляется по окончании сборки. По умолчанию выключено: общий дисковый кеш повторно используется между сборками. Не влияет на результат рендеринга |
--dry-run | false | Выполнить рендеринг сущности Release и вывести то, что было бы сгенерировано, вместо записи: предполагаемый путь и содержимое каждого артефакта выводятся в stdout, а выходной каталог и lockfile не изменяются. Внешние входные данные ведут себя точно так же, как при обычной сборке: закреплённые данные берутся из хранилища с адресацией по содержимому (и загружаются заново по дайджесту, если blob отсутствует), а рендеринг, запрашивающий незакреплённый внешний URL, останавливается с указанием этого URL, — поэтому пробный запуск показывает именно то, что записала бы сборка. Не сочетается с —auto-pull, —upgrade и —trace, поскольку каждый из них выполняет запись: запускайте заполнение зависимостей или сборку с трассировкой отдельным шагом. Сочетается с —policy-input, файлы которого в этом случае — единственное, что он записывает |
--ir-graph | false | Дополнительно вывести граф IR, вычисленный этим запуском, в stdout в формате JSON, помимо всего, что уже выдаёт эта команда. Значения, объявленные автором конфиденциальными, в него не включаются; чтобы вывести их, передайте —unredacted. Артефакты по-прежнему записываются, и сводка по-прежнему выводится; граф выводится раньше них |
--no-unsupported-field-warnings | false | Отключить класс предупреждений о неподдерживаемых полях: уведомления, которые цель выдаёт о написанном вами, что она не может учесть, — поле сущности Workload, которое она не может выразить (как цель с меньшей точностью, например compose), или аннотацию aggrega.ai/, на которую она не реагирует для типа входных данных узла. Остальные предупреждения рендеринга по-прежнему выводятся. Влияет только на отображение; не меняет результат рендеринга |
--policy-input | — | Записывать в этот каталог полезную нагрузку, которую каждая роль управления передаёт присоединённому там плагину, в виде одной строки JSON: в точности то, что сборка передаёт плагину, причём каждое значение, которое сборка от него скрывает, скрыто и здесь. Для annotation-transform, label-transform и ir-verdict файл — это документ input, который читает политика в этой роли. Для render-verdict движок политик перестраивает полезную нагрузку, прежде чем её прочитает политика, — из неё разбираются documents каждого артефакта, — поэтому политику render-verdict на встроенном движке проверяют в сборке, присоединив её так, чтобы она сообщала на уровне warn или info; для плагина, .wasm которого вы собрали сами, aggrega plugin run-local --plugin <plugin.wasm> --export verdict_render --with @<dir>/render-verdict.json запускает его на этом файле. Роль, к которой ничего не присоединено, тоже записывается — как полезная нагрузка, которую получило бы присоединение без источников и без настроек, поэтому политику можно написать до того, как её присоединить. Каждая роль записывается в <role>.json (annotation-transform, label-transform, ir-verdict, render-verdict); если присоединения одной роли получают разные полезные нагрузки — у одного есть собственные источники или настройки либо преобразование меняет то, что читает следующее, — каждое вместо этого записывается в <role>.<position>.<plugin>.json, где position — номер присоединения этой роли, считая с 1 в порядке, в котором их перечисляет конфигурация рабочего пространства, а plugin — последний сегмент ссылки на плагин без версии, с экранированием любого символа, недопустимого в имени файла. Файлы с такими именами, уже находящиеся в каталоге, заменяются, а ничто другое там не затрагивается. Файлы записываются независимо от того, завершилась сборка или остановилась, а сборка, остановившаяся до запуска какой-либо роли, называет каждую роль, для которой не записала файла. Их запрос не меняет ни одного артефакта и ни одного вердикта. Сочетается с —dry-run, который тогда записывает эти файлы и ничего больше: выходной каталог и lockfile не изменяются |
--progress | false | Принудительно включить отображение хода сборки, даже если stderr не является терминалом, выводя по одной простой строке на каждый завершённый шаг с его временем. По умолчанию — auto: интерактивный список фаз показывается, только если stderr — терминал, интерпретирующий escape-последовательности; терминал без такой поддержки получает те же простые строки, а перенаправленный или конвейерный вывод не получает ничего. —quiet и —debug переопределяют —progress |
--quiet | false | Отключить отображение хода сборки в stderr. Не влияет на stdout. Имеет приоритет над —progress |
--release | — | Путь к YAML-файлу сущности Release (обязательно). Относительный путь разрешается относительно каталога, в котором вы запускаете команду, а не корня рабочего пространства. Если этот каталог не входит ни в одно рабочее пространство и корень не указан, по абсолютному пути рабочее пространство находится от собственной папки сущности Release |
--trace | false | записывать промежуточные файлы для каждого узла в .trace/ в корне рабочего пространства, рядом с dist/, для последующего анализа |
--trace-unredacted | false | Записывать объявленные конфиденциальными значения в файлы .trace/ вместо заменяющего их текста |
--unredacted | false | Выводить значения, объявленные автором конфиденциальными, вместо их скрытия. Всё, куда попадает вывод, — терминал, конвейер, файл, запись экрана — тогда содержит эти значения в открытом виде. Влияет только на граф, который записывает —ir-graph, поэтому требует —ir-graph; для файлов .trace/ вместо него используется —trace-unredacted |
--upgrade | false | Сделать шаг auto-pull полным обновлением: удалить существующий lockfile и заново разрешить все зависимости по текущему состоянию реестра, поднимая каждую до наивысшей доступной версии вместо соблюдения существующих закреплений. Подразумевает —auto-pull: сам по себе флаг выполняет pull с полным обновлением перед сборкой. Он не принимает цели, поэтому его нельзя ограничить одной зависимостью: чтобы принять или удалить одно закрепление, выполните вместо этого aggrega pull —upgrade —release |
--verify-determinism | false | Выполнить рендеринг каждого узла дважды и сравнить сгенерированные байты, останавливая сборку, если два рендеринга какого-либо узла различаются. По умолчанию выключено. Используйте, чтобы убедиться, что провайдер выполняет рендеринг детерминированно — одинаковые входные данные дают побайтово идентичный результат, — на что опираются гарантии GitOps-diff и побайтово идентичного вывода |
--yes | false | Заранее ответить на запрос подтверждения —upgrade для неинтерактивного использования. Влияет только на этот запрос: сборка без обновления ничего не спрашивает, поэтому передача флага там ничего не меняет |