Файл ответов импорта
Некоторые значения не может содержать ни один источник: образ приложения, собранного из вашего собственного кода, адрес электронной почты учётной записи владельца, модель, которую источник не называет, имя Secret в Kubernetes. aggrega import записывает каждое такое значение в черновик как пустую строку под комментарием, поясняющим, что это, и получает его от вас один раз — из файла ответов или через вопрос в терминале. Ответы хранятся в файле ответов import-answers.yaml, так что каждый последующий импорт того же источника читает их оттуда и ничего не спрашивает.
На этой странице описано, где находится файл, что он содержит, как в него попадают значения и что делает импорт, когда значение всё ещё отсутствует. Для чего нужен импорт, а также пошаговые примеры от источника до сборки описаны в разделе Импорт.
Какие значения ожидаются
После создания черновиков импорт проверяет каждый черновой документ по его собственной схеме, а также по схеме каталога каждой сущности Component, Feature и каждого соединения, которые объявляет документ. Значение является ожидаемым, когда оно всё ещё пусто там, где эта схема его требует, или там, где схема объявляет ключ, а ничто его не предоставило. Каждое ожидаемое значение описывается собственным описанием его ключа в схеме; если схема его не даёт — комментарием, который черновик записывает над ключом.
Пока какое-либо значение ожидается, импорт не загружает зависимости черновика сущности Release; он загружает их, как только на каждое значение получен ответ (см. Повторный запуск и --sync).
Где находится файл
| Источник — это | Файл ответов — это |
|---|---|
| файл | import-answers.yaml в том же каталоге, что и файл источника |
| каталог | import-answers.yaml внутри каталога источника |
--answers <file> указывает другой файл. Относительный путь разрешается относительно каталога, в котором вы запускаете команду. Если в черновиках недостаёт значений, а файл ответов не является файлом по умолчанию рядом с источником, запись, которую импорт создаёт рядом с черновиками, .aggrega-import.json, указывает его, поэтому последующий aggrega import --sync в тот же каталог читает его без повторного указания. Запись никогда не содержит ответов.
Ответом для секрета является имя того, откуда берётся секрет, но никогда не сам секрет (см. Секреты), поэтому файл ответов можно хранить вместе с источником в системе контроля версий.
Что он содержит
Файл имеет формат YAML. Его ключи верхнего уровня — это файлы-черновики, по пути, по которому создаётся каждый из них. Под каждым из них ключ — это путь ключа через точку для недостающего значения в этом документе, а его значение — ответ. Описание ключа из схемы записывается как комментарий над ним. Сегмент пути ключа, который пуст или содержит точку, пробельный символ или кавычку, записывается в двойных кавычках. Файл, который не читается в такой форме, останавливает импорт с указанием файла и причины, и ничего не записывается.
Например, импорт Google ADK, созданный с --target helm, имеет два недостающих значения в своей сущности Release: образ агента, который вы собираете из своего проекта, и источник ключа API Gemini для агента. Когда на оба дан ответ, файл ответов в каталоге источника support_agent/ выглядит так:
# Values the import could not draft from the source, keyed by the drafted file and the key path inside# it. Write each one beside its key; an import of the same source, and a sync, read them from here and# ask nothing. A secret is never written here: its key asks where the secret comes from — a variable# name, ${NAME}, or the name of a Kubernetes Secret.release.yaml: # Container image running the application built on ADK, serving its API on infra.port on every # interface. spec.components.support-agent.infra.image: "ghcr.io/example/support-agent:1.0.0" # The origin of the secret value, written by the operator in the Release. Read exactly as # values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes # from, never the value. spec.components.support-agent.uses.model.gemini-2-5-flash.features.credential.infra.origin: "google-api-key"Оба ответа — ваши: ghcr.io/example/support-agent:1.0.0 обозначает образ, который вы собираете и публикуете, а google-api-key — имя объекта Kubernetes Secret, хранящего ключ в пространстве имён, в которое вы развёртываете.
Каждый ответ — это одно значение, и импорт записывает его в черновик как строку вместо пустого, ничего больше в черновике не меняя. Ответ, записанный в сущность Aggregate, созданную как черновик, читается ровно так, как вы его ввели, включая {{. Пустой ответ оставляет значение недостающим.
Как вводятся значения
Импорт сначала берёт ответ на каждое недостающее значение из файла ответов. Для каждого значения, на которое файл не даёт ответа, он спрашивает вас, по одному вопросу за раз — но только если стандартный ввод и стандартный вывод оба являются терминалом и --dry-run не указан:
- каждый вопрос называет файл-черновик и путь ключа и сформулирован на основе описания из схемы;
- вопросы записываются в стандартный поток ошибок, поэтому стандартный вывод содержит только результат импорта;
- нажатие Enter откладывает значение на потом, а завершение ввода прекращает вопросы.
Каждый ваш ответ записывается в черновики и в файл ответов, а файл ответов указывается среди записанных файлов. Запуск, который ничего не меняет в файле ответов, не записывает его повторно.
Секреты
На значение секрета — такое, которое его схема помечает как конфиденциальное — отвечают тем, откуда берётся секрет, и никогда самим секретом. Его вопрос спрашивает именно об этом, а ответом служит одно из следующих имён:
| Ответ | Пример |
|---|---|
| имя переменной | OPENAI_API_KEY |
| ссылка на переменную | ${OPENAI_API_KEY} |
| имя Kubernetes Secret | openai-api-key |
Импорт проверяет, что ответ имеет форму одного из этих имён, и отклоняет всё остальное:
- в терминале ответ отклоняется, отображается причина, и вопрос задаётся снова;
- в файле ответов импорт останавливается, называя файл ответов, черновой файл и ключ — но никогда не ответ, который может быть самим секретом — и ничего не записывает.
Проверка читает форму ответа, поэтому секрет, который случайно выглядит как имя, от имени не отличается. Сам секрет остаётся там, куда указывает имя: в переменной или в Secret.
Без терминала
В непрерывной интеграции, через конвейер (pipe) и из инструмента импорта ассистента (aggrega mcp) ничего не спрашивается, а импорт редактора ничего не спрашивает во время выполнения. Импорт, которому после чтения файла ответов всё ещё не хватает значений:
- записывает черновики, оставляя каждое недостающее значение пустым;
- записывает файл ответов, в котором присутствует каждый недостающий ключ с пустым ответом;
- называет каждое недостающее значение в стандартном потоке ошибок в виде предупреждения с указанием чернового файла, пути ключа и его описания;
- не загружает зависимости черновой сущности Release;
- завершается со статусом 1 и одним предложением о том, сколько значений не хватает и куда их записать:
2 values the drafts leave empty are still owed, listed in the answers file <path>/support_agent/import-answers.yaml: write each beside its key there, then run the import againЗапишите каждый ответ рядом с его ключом, затем выполните aggrega import <source> --sync в тот же каталог: он создаёт черновики для цели, заданной предыдущему импорту, записывает каждый ответ в черновики и ничего не спрашивает. Обычный aggrega import в каталог, который уже содержит черновую сущность Aggregate, останавливается, называя --sync, и ничего не записывает. Импорт в новый выходной каталог тоже читает файл ответов: файл по умолчанию или тот, который указан в --answers.
Инструмент импорта ассистента принимает файл ответов как answers, указанный относительно корня рабочей области или абсолютным путём. Вызов, которому всё ещё не хватает значений, завершается ошибкой с этим предложением и содержит рядом с ним результат импорта, включая предупреждения. Импорт в редакторе тоже принимает файл ответов, и то же предложение завершает его диагностику.
Оба также перечисляют как данные каждое ещё требуемое значение в owed: черновой файл, путь ключа в виде списка ключей, вопрос, принадлежит ли значение секрету, и для секрета — каким должен быть его ответ (secretAdvice из редактора, secret_advice из инструмента импорта ассистента). Отправьте каждый ответ обратно в answered — черновой файл, путь ключа и ответ — вместе с sync, и импорт проверит его, сохранит в файле ответов и запишет в черновики, как он делает с ответом, введённым в терминале. Ответ секрета, который не является именем, не сохраняется и не записывается: значение остаётся в owed, а вместо совета указывается причина.
После импорта, записывающего свои черновики, редактор предлагает запросить каждое ещё незаполненное значение в отдельном поле ввода и отправляет ответы обратно этим способом; после предварительного просмотра он ничего не предлагает, поскольку при --dry-run ничего не спрашивается. Вопросы описаны в разделе Ответы на значения, которые импорт ещё не заполнил.
При --dry-run ничего не спрашивается и ничего не записывается, включая файл ответов. Каждое недостающее значение по-прежнему называется в стандартном потоке ошибок, а код выхода — это код самого пробного запуска.
Повторный запуск и --sync
aggrega import --sync читает тот же файл ответов, что и предыдущий импорт: указанный в --answers, иначе указанный в записи рядом с черновиками, иначе файл по умолчанию рядом с источником. Он записывает каждый ответ в черновики вместо пустого значения и, если файл ответов отвечает на каждое недостающее значение, ничего не спрашивает.
Как только недостающих значений не остаётся и рабочая область не находится в автономном режиме, импорт загружает зависимости черновой сущности Release так же, как это делает aggrega pull, записывая release.lock, поэтому aggrega validate и aggrega build сразу работают с черновиками. При --offline ничего не загружается, и импорт называет команду aggrega pull --release <path>, которую следует выполнить далее.
Один файл ответов для нескольких целей
Один и тот же источник, оформленный в черновики для разных целей, может требовать разных значений: приведённая выше сущность Release для Google ADK, созданная с --target compose, требует только образа, а та же сущность Release, созданная с --target helm, требует также указать, откуда берётся ключ Gemini API агента. Один файл ответов обслуживает оба случая:
- импорт добавляет ключи, которых требуют его черновики, и задаёт полученные ответы;
- ответ для ключа, которого эти черновики не требуют, сохраняется в файле и не применяется;
- все остальные ключи и комментарии в файле остаются без изменений.
Файл ответов читается, только если черновикам требуется какое-либо значение. В этом случае информационная строка в стандартном потоке ошибок называет каждый сохранённый и не применённый ответ — здесь для импорта Flowise, созданного с --target compose, которому требуется только адрес электронной почты владельца, при чтении файла ответов, где также названы два объекта Secret Kubernetes, которые тот же импорт требует с --target helm:
info: the answers file <path>/import-answers.yaml also answers spec.components.flowise.features.owner_password.infra.origin in release.yaml, spec.components.flowise.uses.model.chatopenai-0.features.credential.infra.origin in release.yaml, which these drafts do not leave empty; those answers are kept there and not appliedЕсли черновикам ничего не требуется — например, для импорта Langflow, созданного с --target compose, который читает каждый секрет из переменной, — файл ответов не читается, такая строка не выводится, а файл остаётся как есть.
См. также
aggrega import— справка по команде, включая все флаги.- Импорт — что создаёт импорт в черновиках, и пошаговое руководство для каждого исходного формата.